XmlReadMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, как считывать XML-данные и реляционную схему в объект DataSet.
public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode =
Public Enum 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 задано значение |
IgnoreSchema | 2 | Пропускает любую встроенную схему и считывает данные в существующую схему DataSet. Если какие-либо данные не соответствуют существующей схеме, они удаляются (включая данные из разных пространств имен, определенных для объекта DataSet). Если данные являются DiffGram, значение |
InferSchema | 3 | Игнорирует все встроенные схемы, выводит схему из данных и загружает их. Если объект DataSet уже содержит схему, текущая схема расширяется за счет добавления новых таблиц или столбцов в существующие таблицы. Если добавляемая таблица уже существует, но с другим пространством имен, или если добавляемые столбцы конфликтуют с существующими, выдается исключение. |
InferTypedSchema | 6 | Игнорирует все встроенные схемы, выводит строго типизированную схему из данных и загружает их. Если тип не может быть выведен из данных, он интерпретируется как строковые данные. Если объект DataSet уже содержит схему, текущая схема расширяется за счет добавления либо новых таблиц, либо столбцов в существующие таблицы. Если добавляемая таблица уже существует, но с другим пространством имен, или если добавляемые столбцы конфликтуют с существующими, выдается исключение. |
ReadSchema | 1 | Считывает любую встроенную схему и загружает данные. Если объект DataSet уже содержит схему, новая таблица может быть в нее добавлена, но если какая-либо таблица во внутренней схеме уже существует в объекте DataSet, выдается исключение. |
Комментарии
Используйте члены этого перечисления при задании ReadMode
параметра DataSet.ReadXml метода .
Примечание
Auto
Режим может быть медленнее, чем установка XmlReadMode явного параметра.
Auto
выполняет наиболее подходящие из следующих действий:
Если данные являются DiffGram, для режима чтения XML устанавливается значение
DiffGram
.Если в наборе данных уже есть схема или документ содержит встроенную схему, для режима чтения XML устанавливается значение
ReadSchema
.Если в наборе данных еще нет схемы, а документ не содержит встроенной схемы, для режима чтения XML устанавливается значение
InferSchema
.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по