XmlReadMode XmlReadMode XmlReadMode XmlReadMode Enum

Definición

Especifica cómo leer datos XML y un esquema relacional en un 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
Herencia

Campos

Auto Auto Auto Auto 0

Modo de lectura predeterminado.The default read mode.

DiffGram DiffGram DiffGram DiffGram 4

Lee un DiffGram, aplicando los cambios del DiffGram a DataSet.Reads a DiffGram, applying changes from the DiffGram to the DataSet. La semántica es idéntica a la de una operación Merge(DataSet).The semantics are identical to those of a Merge(DataSet) operation. Al igual que ocurre con la operación Merge(DataSet), se conservan los valores RowState.As with the Merge(DataSet) operation, RowState values are preserved. La entrada a ReadXml(XmlReader) mediante DiffGrams sólo se puede obtener si se utiliza la salida de WriteXml(Stream) como un DiffGram.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

El objeto DataSet de destino debe tener el mismo esquema que el objeto DataSet en el que se ha llamado a WriteXml como DiffGram.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. En caso contrario, se produce un error en la operación Merge de DiffGram y se inicia una excepción.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment Fragment Fragment Fragment 5

Lee fragmentos XML, como los que se generan al ejecutar consultas FOR XML, en una instancia de SQL Server.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Al establecer XmlReadMode en Fragment, se lee el espacio de nombres predeterminado como el esquema en línea.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema IgnoreSchema IgnoreSchema IgnoreSchema 2

Omite cualquier esquema alineado y lee los datos del esquema del DataSet existente.Ignores any inline schema and reads data into the existing DataSet schema. Si los datos no coinciden con el esquema existente, se descartan (incluidos los datos de espacios de nombres distintos definidos para el DataSet).If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Si los datos constituyen un DiffGram, IgnoreSchema tiene la misma funcionalidad que DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema InferSchema InferSchema InferSchema 3

Omite cualquier esquema en línea, deduce el esquema a partir de los datos y los carga.Ignores any inline schema, infers schema from the data and loads the data. Si el DataSet ya contiene un esquema, se extiende el esquema actual mediante la adición de nuevas tablas o la adición de columnas a las tablas existentes.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. Se producirá una excepción si la tabla deducida ya existe con un espacio de nombres distinto, o si cualquiera de las columnas deducidas entra en conflicto con las columnas existentes.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

Omite cualquier esquema en línea, deduce el esquema fuertemente tipado a partir de los datos y los carga.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. Si el tipo no se puede deducir de los datos, se interpreta como datos de cadena.If the type cannot be inferred from the data, it is interpreted as string data. Si el DataSet ya contiene un esquema, se extiende el esquema actual mediante la adición de nuevas tablas o columnas a las tablas existentes.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. Se producirá una excepción si la tabla deducida ya existe con un espacio de nombres distinto, o si cualquiera de las columnas deducidas entra en conflicto con las columnas existentes.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

Lee cualquier esquema en línea y carga los datos.Reads any inline schema and loads the data. Si el DataSet ya contiene un esquema, se pueden agregar al mismo las nuevas tablas, aunque se producirá una excepción si cualquier tabla del esquema en línea ya existe en el 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.

Comentarios

Utilice los miembros de esta enumeración al establecer el ReadMode parámetro de la DataSet.ReadXml método.Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Nota

Auto el modo puede ser más lento que la opción XmlReadMode en una opción explícita.Auto mode may be slower than setting XmlReadMode to an explicit option.

Auto Lleva a cabo la más adecuada de estas acciones:Auto performs the most appropriate of these actions:

  • Si los datos son un DiffGram, conjuntos de XML en modo lectura a DiffGram.If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Si el conjunto de datos ya tiene un esquema, o si el documento contiene un esquema en línea, conjuntos de XML en modo lectura a ReadSchema.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • Si el conjunto de datos aún no tiene un esquema y el documento no contiene un esquema en línea, conjuntos de XML en modo lectura a 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.

Se aplica a