XmlReadMode Перечисление

Определение

Пространство имен:
System.Data
Сборки:
netstandard.dll, System.Data.Common.dll
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.dll
Исходный код:
XmlReadMode.cs
Исходный код:
XmlReadMode.cs
Исходный код:
XMLDiffLoader.cs

Указывает, как считывать XML-данные и реляционную схему в DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Наследование
Object
ValueType
Enum
XmlReadMode

Поля

Имя Значение Описание
Auto 0

Режим чтения по умолчанию.
ReadSchema 1

Считывает любую встроенную схему и загружает данные. DataSet Если уже содержит схему, в схему могут быть добавлены новые таблицы, но исключение создается, если в встроенной схеме уже существуют какие-либо таблицы.DataSet
IgnoreSchema 2

Игнорирует любую встроенную схему и считывает данные в существующую DataSet схему. Если какие-либо данные не соответствуют существующей схеме, она удаляется (включая данные из разных пространств имен, определенных для него DataSet). Если данные являются DiffGram, имеет те же функции, IgnoreSchema что DiffGramи данные.
InferSchema 3

Игнорирует любую встроенную схему, зачисливает схему из данных и загружает данные. DataSet Если схема уже содержится, текущая схема расширяется путем добавления новых таблиц или добавления столбцов в существующие таблицы. Исключение возникает, если выводная таблица уже существует, но с другим пространством имен или если любой из выводимых столбцов конфликтует с существующими столбцами.
DiffGram 4

Считывает DiffGram, применяя изменения из DiffGram к .DataSet Семантика идентична семантике Merge(DataSet) операции. Как и в Merge(DataSet) случае операции, RowState значения сохраняются. ReadXml(XmlReader) Входные данные для DiffGrams должны быть получены только с помощью выходных данных из WriteXml(Stream) DiffGram.

Целевой объект DataSet должен иметь ту же схему, в DataSet которой WriteXml вызывается DiffGram. В противном случае операция слияния DiffGram завершается ошибкой, и создается исключение.
Fragment 5

Считывает фрагменты XML, такие как созданные путем выполнения запросов FOR XML, в экземпляре SQL Server. Если XmlReadMode задано значение Fragment, пространство имен по умолчанию считывается как встроенная схема.
InferTypedSchema 6

Игнорирует любую встроенную схему, вводит строго типизированную схему из данных и загружает данные. Если тип не может быть выведен из данных, он интерпретируется как строковые данные. DataSet Если схема уже содержится, текущая схема расширена, добавляя новые таблицы или добавляя столбцы в существующие таблицы. Исключение возникает, если выводная таблица уже существует, но с другим пространством имен или если любой из выводимых столбцов конфликтует с существующими столбцами.

Комментарии

Используйте члены этого перечисления при настройке ReadMode параметра DataSet.ReadXml метода.

Note

Auto режим может быть медленнее, чем параметр XmlReadMode явного параметра.

Auto выполняет наиболее подходящие из этих действий:

  • Если данные являются DiffGram, задает режим DiffGramчтения XML.

  • Если набор данных уже имеет схему или документ содержит встроенную схему, задает режим ReadSchemaчтения XML.

  • Если набор данных еще не имеет схемы и документ не содержит встроенную схему, задает режим чтения XML.InferSchema

Применяется к