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

Определение

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

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

Поля

Auto 0

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

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, пространство имен по умолчанию читается как встроенная схема.

IgnoreSchema 2

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

InferSchema 3

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

InferTypedSchema 6

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

ReadSchema 1

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

Комментарии

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

Примечание

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

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

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

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

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

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