Especifica cómo leer datos XML y un esquema relacional en un
DataSet.
Espacio de nombres: System.Data
Ensamblado: System.Data (en system.data.dll)
Sintaxis
Visual Basic (Declaración)
Public Enumeration XmlReadMode
Dim instance As XmlReadMode
public enum class XmlReadMode
Miembros
| | Nombre de miembro | Descripción |
|---|
.gif) | Auto | Predeterminado. Realiza la acción más apropiada de las que se muestran a continuación: Si los datos constituyen un DiffGram, establece XmlReadMode en DiffGram. O bien Si el conjunto de datos ya tiene un esquema o el documento contiene un esquema en línea, establece XmlReadMode en ReadSchema. O bien Si el conjunto de datos aún no tiene un esquema y el documento no contiene un esquema en línea, establece XmlReadMode en InferSchema. |
| DiffGram | Lee un DiffGram, aplicando los cambios del DiffGram a DataSet. La semántica es idéntica a la de una operación Merge. Al igual que ocurre con la operación Merge, se conservan los valores RowState. La entrada a ReadXml mediante DiffGrams sólo se puede obtener si se utiliza la salida de WriteXml como un DiffGram. El DataSet de destino debe tener el mismo esquema que el DataSet en el que se llama a WriteXml como DiffGram. De lo contrario, se producirá un error en la operación de combinación de DiffGram y se producirá una excepción. |
| Fragment | Lee fragmentos XML, como los que se generan al ejecutar consultas FOR XML, en una instancia de SQL Server. Al establecer XmlReadMode en Fragment, se lee el espacio de nombres predeterminado como el esquema en línea. |
| IgnoreSchema | Omite cualquier esquema en línea 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, IgnoreSchema tiene la misma funcionalidad que DiffGram. |
| InferSchema | 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 | Omite cualquier esquema en línea, deduce el esquema con establecimiento inflexible de tipos 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 | 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
Utilice los miembros de esta enumeración al establecer el parámetro ReadMode del método ReadXml.
.gif) Nota |
|---|
|
El modo Auto puede resultar más lento que establecer XmlReadMode en una opción explícita. |
Plataformas
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 2.0, 1.0
Vea también