Esta documentación está archivada y no tiene mantenimiento.

DataSet.ReadXml (Método) (XmlReader, XmlReadMode)

Actualización: noviembre 2007

Lee el esquema y los datos XML del objeto DataSet mediante el objeto System.Xml.XmlReader y la enumeración XmlReadMode especificados.

Espacio de nombres:  System.Data
Ensamblado:  System.Data (en System.Data.dll)

public XmlReadMode ReadXml(
	XmlReader reader,
	XmlReadMode mode
)
public XmlReadMode ReadXml(
	XmlReader reader,
	XmlReadMode mode
)
public function ReadXml(
	reader : XmlReader, 
	mode : XmlReadMode
) : XmlReadMode

Parámetros

reader
Tipo: System.Xml.XmlReader
Objeto XmlReader desde el que se va a leer.
mode
Tipo: System.Data.XmlReadMode
Uno de los valores de XmlReadMode.

Valor devuelto

Tipo: System.Data.XmlReadMode
XmlReadMode utilizado para leer los datos.

El método ReadXml ofrece una forma de leer sólo los datos o los datos y el esquema en un objeto DataSet a partir de un documento XML, mientras que el método ReadXmlSchema sólo lee el esquema. Para leer los datos y el esquema, utilice una de las sobrecargas de ReadXML que incluye el parámetro mode y establezca su valor en ReadSchema.

Tenga en cuenta que esto también se aplica a los métodos WriteXml y WriteXmlSchema, respectivamente. Para escribir datos XML, o el esquema y los datos del DataSet, utilice el método WriteXml. Para escribir únicamente el esquema, utilice el método WriteXmlSchema.

Si se especifica un esquema en línea, éste se utiliza para extender la estructura relacional existente antes de cargar los datos. Si hay algún conflicto (por ejemplo, la misma columna de la misma tabla está definida con tipos de datos distintos), se provoca una excepción.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende por deducción, según sea necesario, de acuerdo con la estructura del documento XML. Si el esquema no se puede extender por deducción para exponer todos los datos, se produce una excepción.

5ak5359z.alert_note(es-es,VS.90).gifNota:

DataSet no asocia un elemento XML con su correspondiente DataColumn o DataTable cuando caracteres XML válidos, como ("_"), se consideran caracteres de escape en el código XML serializado. DataSet sólo considera caracteres de escape los caracteres XML no válidos en nombres de elementos XML y, por consiguiente, sólo puede usar los mismos. Cuando algún carácter válido del nombre de un elemento XML se considera carácter de escape, el elemento se pasa por alto durante el procesamiento.

Si el esquema XML de un DataSet incluye targetNamespace, no se podrán leer los datos, y pueden aparecer excepciones al llamar a ReadXml para cargar el DataSet con XML que contenga elementos con un espacio de nombres sin cualificar. Para leer elementos incompletos, establezca elementFormDefault en "qualified" en el esquema XML, como se muestra en el siguiente ejemplo.

 <xsd:schema id="MyDataSet" 
    elementFormDefault="qualified" 
    targetNamespace="http://www.tempuri.org/MyDataSet.xsd" 
    xmlns="http://www.tempuri.org/MyDataSet.xsd" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
 </xsd:schema>
5ak5359z.alert_note(es-es,VS.90).gifNota:

Si el esquema del DataSet contiene elementos del mismo nombre pero de tipo diferente en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema en el DataSet con ReadXml especificando XmlReadMode.ReadSchema. Esta excepción no se produce si se utiliza la versión 1.0 de .NET Framework.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 1.0
Mostrar: