XmlReadMode XmlReadMode XmlReadMode XmlReadMode Enum

Определение

Указывает, как считывать XML-данные и реляционную схему в объект DataSet.Specifies how to read XML data and a relational schema into a DataSet.

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

Поля

Auto Auto Auto Auto 0

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

DiffGram DiffGram DiffGram DiffGram 4

Считывает DiffGram, применяя изменения из DiffGram к объекту DataSet.Reads a DiffGram, applying changes from the DiffGram to the DataSet. Семантика идентична семантике операции Merge(DataSet).The semantics are identical to those of a Merge(DataSet) operation. Как и в случае операции Merge(DataSet), значения RowState сохраняются.As with the Merge(DataSet) operation, RowState values are preserved. Входные данные метода ReadXml(XmlReader) с DiffGrams могут быть получены только с использованием выходных данных метода WriteXml(Stream) в виде DiffGram.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

Целевой объект DataSet должен иметь ту же схему, что и DataSet, для которого WriteXml вызывается как DiffGram.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. В противном случае происходит сбой операции слияния DiffGram и возникает исключение.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment Fragment Fragment Fragment 5

Считывает XML-фрагменты, которые созданы при выполнении запросов FOR XML к экземпляру SQL Server.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Когда для режима XmlReadMode задано значение Fragment, пространство имен по умолчанию читается как встроенная схема.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema IgnoreSchema IgnoreSchema IgnoreSchema 2

Пропускает любую встроенную схему и считывает данные в существующую схему DataSet.Ignores any inline schema and reads data into the existing DataSet schema. Если какие-либо данные не соответствуют существующей схеме, они удаляются (включая данные из разных пространств имен, определенных для объекта DataSet).If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Если данные являются DiffGram, значение IgnoreSchema имеет такую же функциональность, что и DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema InferSchema InferSchema InferSchema 3

Игнорирует все встроенные схемы, выводит схему из данных и загружает их.Ignores any inline schema, infers schema from the data and loads the data. Если объект DataSet уже содержит схему, текущая схема расширяется за счет добавления новых таблиц или столбцов в существующие таблицы.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. Если добавляемая таблица уже существует, но с другим пространством имен, или если добавляемые столбцы конфликтуют с существующими, выдается исключение.An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

InferTypedSchema InferTypedSchema InferTypedSchema InferTypedSchema 6

Игнорирует все встроенные схемы, выводит строго типизированную схему из данных и загружает их.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. Если тип не может быть выведен из данных, он интерпретируется как строковые данные.If the type cannot be inferred from the data, it is interpreted as string data. Если объект DataSet уже содержит схему, текущая схема расширяется за счет добавления либо новых таблиц, либо столбцов в существующие таблицы.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. Если добавляемая таблица уже существует, но с другим пространством имен, или если добавляемые столбцы конфликтуют с существующими, выдается исключение.An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

ReadSchema ReadSchema ReadSchema ReadSchema 1

Считывает любую встроенную схему и загружает данные.Reads any inline schema and loads the data. Если объект DataSet уже содержит схему, новая таблица может быть в нее добавлена, но если какая-либо таблица во внутренней схеме уже существует в объекте DataSet, выдается исключение.If the DataSet already contains schema, new tables may be added to the schema, but an exception is thrown if any tables in the inline schema already exist in the DataSet.

Комментарии

Члены этого перечисления используются при задании ReadMode параметр DataSet.ReadXml метод.Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Примечание

Auto режим может выполняться медленнее, чем задано параметром XmlReadMode явно определенный параметр.Auto mode may be slower than setting XmlReadMode to an explicit option.

Auto Выполняет наиболее подходящий из этих действий:Auto performs the most appropriate of these actions:

  • Если данные являются DiffGram, наборов XML в режим чтения для DiffGram.If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Если набор данных уже имеет схему, или если документ содержит схему в строке, наборов XML в режим чтения для ReadSchema.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • Если документ не содержит схему в строке набора данных еще не имеет схемы, наборов XML в режим чтения для InferSchema.If the dataset does not already have a schema and the document does not contain an in-line schema, sets the XML read mode to InferSchema.

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