XmlReadMode Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica cómo leer datos XML y un esquema relacional en un DataSet.
public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode =
Public Enum XmlReadMode
- Herencia
Campos
Auto | 0 | Modo de lectura predeterminado. |
DiffGram | 4 | Lee un DiffGram, aplicando los cambios del DiffGram a DataSet. La semántica es idéntica a la de una operación Merge(DataSet). Al igual que ocurre con la operación Merge(DataSet), se conservan los valores RowState. La entrada a ReadXml(XmlReader) mediante DiffGrams sólo se puede obtener si se utiliza la salida de WriteXml(Stream) como un 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. En caso contrario, se produce un error en la operación Merge de DiffGram y se inicia una excepción. |
Fragment | 5 | Lee fragmentos XML, como los que se generan al ejecutar consultas FOR XML, en una instancia de SQL Server. Al establecer XmlReadMode en |
IgnoreSchema | 2 | Omite cualquier esquema alineado y lee los datos del esquema del DataSet existente. Si los datos no coinciden con el esquema existente, se descartan (incluidos los datos de espacios de nombres distintos definidos para el DataSet). Si los datos constituyen un DiffGram, |
InferSchema | 3 | Omite cualquier esquema en línea, deduce el esquema a partir de los datos y los carga. 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. 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. |
InferTypedSchema | 6 | Omite cualquier esquema en línea, deduce el esquema fuertemente tipado a partir de los datos y los carga. Si el tipo no se puede deducir de los datos, se interpreta como datos de cadena. 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. 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. |
ReadSchema | 1 | Lee cualquier esquema en línea y carga los datos. 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. |
Comentarios
Use los miembros de esta enumeración al establecer el ReadMode
parámetro del DataSet.ReadXml método .
Nota
Auto
el modo puede ser más lento que establecer XmlReadMode en una opción explícita.
Auto
realiza las acciones más adecuadas:
Si los datos son diffGram, establece el modo de lectura XML en
DiffGram
.Si el conjunto de datos ya tiene un esquema o si el documento contiene un esquema en línea, establece el modo
ReadSchema
de lectura XML en .Si el conjunto de datos aún no tiene un esquema y el documento no contiene un esquema en línea, establece el modo
InferSchema
de lectura XML en .