DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml Method

Definición

Lee esquema y datos XML en el objeto DataSet.Reads XML schema and data into the DataSet.

Sobrecargas

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto XmlReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Lee el esquema y los datos XML del DataSet mediante el archivo y el XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto Stream y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto TextReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lee el esquema y los datos XML del DataSet mediante el archivo especificado.Reads XML schema and data into the DataSet using the specified file.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto TextReader especificado.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto Stream especificado.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto XmlReader especificado.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto XmlReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode

Parámetros

reader
XmlReader XmlReader XmlReader XmlReader

Objeto XmlReader desde el que se va a leer.The XmlReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno de los valores de XmlReadMode.One of the XmlReadMode values.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye un targetNamespace, es posible que no se lean los datos y que se produzcan ReadXml excepciones al llamar DataSet a para cargar el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Lee el esquema y los datos XML del DataSet mediante el archivo y el XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (string fileName, System.Data.XmlReadMode mode);
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String, mode As XmlReadMode) As XmlReadMode

Parámetros

fileName
String String String String

Nombre del archivo (incluida la ruta) desde el que se va a leer.The filename (including the path) from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno de los valores de XmlReadMode.One of the XmlReadMode values.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Excepciones

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye un targetNamespace, es posible que no se lean los datos y que se produzcan ReadXml excepciones al llamar DataSet a para cargar el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Seguridad

FileIOPermission
para leer y escribir archivos.for reading and writing files. Enumeración asociada:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Consulte también:

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto Stream y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode

Parámetros

stream
Stream Stream Stream Stream

Objeto Stream desde el que se va a leer.The Stream from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno de los valores de XmlReadMode.One of the XmlReadMode values.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Lo mismo se aplica a los WriteXml métodos WriteXmlSchema y, respectivamente.The same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Cuando se usa ReadXml y se establece XmlReadMode en Diffgram, el contenido del destino DataSet y el original DataSet pueden diferir debido al modo en que se genera y procesa el DiffGram.When you use ReadXml and you set XmlReadMode to Diffgram, the content of the target DataSet and the original DataSet may differ because of how the diffgram is generated and processed. Para obtener más información acerca de los DiffGrams, vea DiffGrams.For more information on diffgrams, see DiffGrams.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye targetNamespace, no se pueden leer los datos y pueden producirse excepciones al llamar ReadXml a para cargar DataSet el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto TextReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode

Parámetros

reader
TextReader TextReader TextReader TextReader

Objeto TextReader desde el que se va a leer.The TextReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

Uno de los valores de XmlReadMode.One of the XmlReadMode values.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye targetNamespace, no se pueden leer los datos y pueden producirse excepciones al llamar ReadXml a para cargar DataSet el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lee el esquema y los datos XML del DataSet mediante el archivo especificado.Reads XML schema and data into the DataSet using the specified file.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
member this.ReadXml : string -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String) As XmlReadMode

Parámetros

fileName
String String String String

Nombre del archivo (incluida la ruta) desde el que se va a leer.The filename (including the path) from which to read.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Excepciones

Ejemplos

En el ejemplo siguiente se crea primero DataSet un simple DataTablecon una, dos columnas y diez filas.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. El DataSet esquema y los datos se escriben en el disco mediante WriteXml la invocación del método.The DataSet schema and data are written to disk by invoking the WriteXml method. Se crea DataSet un segundo y el ReadXml método se usa para rellenarlo con el esquema y los datos.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

   private void DemonstrateReadWriteXMLDocumentWithStreamReader()
   {
       // Create a DataSet with one table and two columns.
       DataSet OriginalDataSet = new DataSet("dataSet");
       OriginalDataSet.Namespace= "NetFrameWork";
       DataTable table = new DataTable("table");
       DataColumn idColumn = new DataColumn("id", 
           Type.GetType("System.Int32"));
       idColumn.AutoIncrement= true;

       DataColumn itemColumn = new DataColumn("item");
       table.Columns.Add(idColumn);
       table.Columns.Add(itemColumn);
       OriginalDataSet.Tables.Add(table);

       // Add ten rows.
       DataRow newRow;
       for(int i = 0; i < 10; i++)
       {
           newRow = table.NewRow();
           newRow["item"]= "item " + i;
           table.Rows.Add(newRow);
       }
       OriginalDataSet.AcceptChanges();

       // Print out values of each table in the DataSet 
       // using the function defined below.
       PrintValues(OriginalDataSet, "Original DataSet");

       // Write the schema and data to an XML file.
       string xmlFilename = "XmlDocument.xml";

       // Use WriteXml to write the document.
       OriginalDataSet.WriteXml(xmlFilename);

       // Dispose of the original DataSet.
       OriginalDataSet.Dispose();

       // Create a new DataSet.
       DataSet newDataSet = new DataSet("New DataSet");

       // Read the XML document into the DataSet.
       newDataSet.ReadXml(xmlFilename);

       // Print out values of each table in the DataSet 
       // using the function defined below.
       PrintValues(newDataSet,"New DataSet");
   }

   private void PrintValues(DataSet dataSet, string label)
   {
       Console.WriteLine("\n" + label);
       foreach(DataTable table in dataSet.Tables)
       {
           Console.WriteLine("TableName: " + table.TableName);
           foreach(DataRow row in table.Rows)
           {
               foreach(DataColumn column in table.Columns)
               {
                   Console.Write("\table " + row[column] );
               }
               Console.WriteLine();
           }
       }
   }
Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the schema and data to an XML file.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename)

    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename)

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        Dim row As DataRow
        For Each row In  table.Rows
            Dim column As DataColumn
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                    row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye un targetNamespace, es posible que no se lean los datos y que se produzcan ReadXml excepciones al llamar DataSet a para cargar el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Seguridad

FileIOPermission
para leer y escribir archivos.for reading and writing files. Enumeración asociada:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Consulte también:

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto TextReader especificado.Reads XML schema and data into the DataSet using the specified TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

Parámetros

reader
TextReader TextReader TextReader TextReader

TextReader desde el que se van a leer el esquema y los datos.The TextReader from which to read the schema and data.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Ejemplos

En el ejemplo siguiente se crea primero DataSet un simple DataTablecon una, dos columnas y diez filas.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. El DataSet esquema y los datos se escriben en el disco mediante WriteXml la invocación del método.The DataSet schema and data are written to disk by invoking the WriteXml method. Se crea DataSet un segundo y el ReadXml método se usa para rellenarlo con el esquema y los datos.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

   private void DemonstrateReadWriteXMLDocumentWithFileStream()
   {
       // Create a DataSet with one table and two columns.
       DataSet originalDataSet = new DataSet("dataSet");
       DataTable table = new DataTable("table");
       DataColumn idColumn = new DataColumn("id", 
           Type.GetType("System.Int32"));
       idColumn.AutoIncrement= true;

       DataColumn itemColumn = new DataColumn("item");
       table.Columns.Add(idColumn);
       table.Columns.Add(itemColumn);
       originalDataSet.Tables.Add(table);
       // Add ten rows.

       DataRow newRow;
       for(int i = 0; i < 10; i++)
       {
           newRow = table.NewRow();
           newRow["item"]= "item " + i;
           table.Rows.Add(newRow);
       }
       originalDataSet.AcceptChanges();

       // Print out values of each table in the DataSet  
       // using the function defined below.
       PrintValues(originalDataSet, "Original DataSet");

       // Write the schema and data to XML file with FileStream.
       string xmlFilename = "XmlDocument.xml";
       System.IO.FileStream streamWrite = new System.IO.FileStream
           (xmlFilename, System.IO.FileMode.Create);

       // Use WriteXml to write the XML document.
       originalDataSet.WriteXml(streamWrite);

       // Close the FileStream.
       streamWrite.Close();
      
       // Dispose of the original DataSet.
       originalDataSet.Dispose();
       // Create a new DataSet.
       DataSet newDataSet = new DataSet("New DataSet");
      
       // Read the XML document back in. 
       // Create new FileStream to read schema with.
       System.IO.FileStream streamRead = new System.IO.FileStream
           (xmlFilename,System.IO.FileMode.Open);
       newDataSet.ReadXml(streamRead);

       // Print out values of each table in the DataSet 
       // using the function defined below.
       PrintValues(newDataSet,"New DataSet");
   }

   private void PrintValues(DataSet dataSet, string label)
   {
       Console.WriteLine("\n" + label);
       foreach(DataTable table in dataSet.Tables)
       {
           Console.WriteLine("TableName: " + table.TableName);
           foreach(DataRow row in table.Rows)
           {
               foreach(DataColumn column in table.Columns)
               {
                   Console.Write("\table " + row[column] );
               }
               Console.WriteLine();
           }
       }
   }
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye targetNamespace, no se pueden leer los datos y pueden producirse excepciones al llamar ReadXml a para cargar DataSet el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

Las clases que heredan TextReader de la clase StreamReader incluyen StringReader las clases y.Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto Stream especificado.Reads XML schema and data into the DataSet using the specified Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Parámetros

stream
Stream Stream Stream Stream

Objeto que deriva de Stream.An object that derives from Stream.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Ejemplos

En el ejemplo siguiente se crea primero DataSet un simple DataTablecon una, dos columnas y diez filas.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. El DataSet esquema y los datos se escriben en el disco mediante WriteXml la invocación del método.The DataSet schema and data are written to disk by invoking the WriteXml method. Se crea DataSet un segundo y el ReadXml método se usa para rellenarlo con el esquema y los datos.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

   private void DemonstrateReadWriteXMLDocumentWithFileStream()
   {
       // Create a DataSet with one table and two columns.
       DataSet originalDataSet = new DataSet("dataSet");
       DataTable table = new DataTable("table");
       DataColumn idColumn = new DataColumn("id", 
           Type.GetType("System.Int32"));
       idColumn.AutoIncrement= true;

       DataColumn itemColumn = new DataColumn("item");
       table.Columns.Add(idColumn);
       table.Columns.Add(itemColumn);
       originalDataSet.Tables.Add(table);
       // Add ten rows.

       DataRow newRow;
       for(int i = 0; i < 10; i++)
       {
           newRow = table.NewRow();
           newRow["item"]= "item " + i;
           table.Rows.Add(newRow);
       }
       originalDataSet.AcceptChanges();

       // Print out values of each table in the DataSet  
       // using the function defined below.
       PrintValues(originalDataSet, "Original DataSet");

       // Write the schema and data to XML file with FileStream.
       string xmlFilename = "XmlDocument.xml";
       System.IO.FileStream streamWrite = new System.IO.FileStream
           (xmlFilename, System.IO.FileMode.Create);

       // Use WriteXml to write the XML document.
       originalDataSet.WriteXml(streamWrite);

       // Close the FileStream.
       streamWrite.Close();
      
       // Dispose of the original DataSet.
       originalDataSet.Dispose();
       // Create a new DataSet.
       DataSet newDataSet = new DataSet("New DataSet");
      
       // Read the XML document back in. 
       // Create new FileStream to read schema with.
       System.IO.FileStream streamRead = new System.IO.FileStream
           (xmlFilename,System.IO.FileMode.Open);
       newDataSet.ReadXml(streamRead);

       // Print out values of each table in the DataSet 
       // using the function defined below.
       PrintValues(newDataSet,"New DataSet");
   }

   private void PrintValues(DataSet dataSet, string label)
   {
       Console.WriteLine("\n" + label);
       foreach(DataTable table in dataSet.Tables)
       {
           Console.WriteLine("TableName: " + table.TableName);
           foreach(DataRow row in table.Rows)
           {
               foreach(DataColumn column in table.Columns)
               {
                   Console.Write("\table " + row[column] );
               }
               Console.WriteLine();
           }
       }
   }
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye targetNamespace, no se pueden leer los datos y pueden producirse excepciones al llamar ReadXml a para cargar DataSet el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML, como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema, as the following example demonstrates.

<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>  

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto XmlReader especificado.Reads XML schema and data into the DataSet using the specified XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parámetros

reader
XmlReader XmlReader XmlReader XmlReader

Objeto XmlReader desde el que se va a leer.The XmlReader from which to read.

Devoluciones

XmlReadMode utilizado para leer los datos.The XmlReadMode used to read the data.

Ejemplos

En el ejemplo siguiente se crea primero DataSet un simple DataTablecon una, dos columnas y diez filas.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. El DataSet esquema y los datos se escriben en el disco mediante WriteXml la invocación del método.The DataSet schema and data are written to disk by invoking the WriteXml method. Se crea DataSet un segundo y el ReadXml método se usa para rellenarlo con el esquema y los datos.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

   private void DemonstrateReadWriteXMLDocumentWithXMLReader()
   {
       // Create a DataSet with one table and two columns.
       DataSet OriginalDataSet = new DataSet("dataSet");
       OriginalDataSet.Namespace= "NetFrameWork";
       DataTable table = new DataTable("table");
       DataColumn idColumn = new DataColumn("id", 
           Type.GetType("System.Int32"));
       idColumn.AutoIncrement= true;

       DataColumn itemColumn = new DataColumn("item");
       table.Columns.Add(idColumn);
       table.Columns.Add(itemColumn);
       OriginalDataSet.Tables.Add(table);

       // Add ten rows.
       DataRow newRow;
       for(int i = 0; i < 10; i++)
       {
           newRow = table.NewRow();
           newRow["item"]= "item " + i;
           table.Rows.Add(newRow);
       }
       OriginalDataSet.AcceptChanges();

       // Print out values of each table in the DataSet 
       // using the function defined below.
       PrintValues(OriginalDataSet, "Original DataSet");

       // Write the XML schema and data to file with FileStream.
       string xmlFilename = "XmlDocument.xml";

       // Create FileStream    
       System.IO.FileStream fsWriteXml = 
           new System.IO.FileStream
           (xmlFilename, System.IO.FileMode.Create);

       // Create an XmlTextWriter to write the file.
       System.Xml.XmlTextWriter xmlWriter = 
           new System.Xml.XmlTextWriter
           (fsWriteXml, System.Text.Encoding.Unicode);

       // Use WriteXml to write the document.
       OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema); 

       // Close the FileStream.
       fsWriteXml.Close();
      
       // Dispose of the original DataSet.
       OriginalDataSet.Dispose();

       // Create a new DataSet.
       DataSet newDataSet = new DataSet("New DataSet");
      
       // Read the XML document back in. 
       // Create new FileStream to read schema with.
       System.IO.FileStream fsReadXml = 
           new System.IO.FileStream
           (xmlFilename, System.IO.FileMode.Open);

       // Create an XmlTextReader to read the file.
       System.Xml.XmlTextReader xmlReader = 
           new System.Xml.XmlTextReader(fsReadXml);

       // Read the XML document into the DataSet.
       newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);

       // Close the XmlTextReader
       xmlReader.Close();

       // Print out values of each table in the DataSet 
       // fusing the unction defined below.
       PrintValues(newDataSet,"New DataSet");
   }

   private void PrintValues(DataSet dataSet, string label)
   {
       Console.WriteLine("\n" + label);
       foreach(DataTable table in dataSet.Tables)
       {
           Console.WriteLine("TableName: " + table.TableName);
           foreach(DataRow row in table.Rows)
           {
               foreach(DataColumn column in table.Columns)
               {
                   Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
               }
               Console.WriteLine();
           }
       }
   }
Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the XML schema and data to file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Create FileStream    
    Dim fsWriteXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter to write the file.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
        (fsWriteXml, System.Text.Encoding.Unicode)

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)

    ' Close the FileStream.
    fsWriteXml.Close()
        
    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
        
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim fsReadXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Open)

    ' Create an XmlTextReader to read the file.
    Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)

    ' Close the XmlTextReader
    xmlReader.Close()
        
    ' Print out values of each table in the DataSet using the 
    ' function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
    
 Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName)
         For Each row In  table.Rows
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())

             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataSet en un desde un documento XML, ReadXmlSchema mientras que el método solo lee el esquema.The ReadXml method provides a way to read either data only, or both data and schema into a DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Para leer los datos y el esquema, use una de ReadXML las sobrecargas que incluye mode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Tenga en cuenta que lo mismo se aplica WriteXml a WriteXmlSchema los métodos y, respectivamente.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Para escribir datos XML, o tanto el esquema como los DataSetdatos de, use el WriteXml método.To write XML data, or both schema and data from the DataSet, use the WriteXml method. Para escribir solo el esquema, use el WriteXmlSchema método.To write just the schema, use the WriteXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Si se especifica un esquema en línea, el esquema en línea se utiliza para extender la estructura relacional existente antes de cargar los datos.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Si hay conflictos (por ejemplo, la misma columna en la misma tabla definida con tipos de datos diferentes), se produce una excepción.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, en función de la estructura del documento XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se produce una excepción.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Nota

No asocia un elemento XML con su correspondiente DataColumn o DataTable cuando los caracteres XML legales como ("") se convierten en un carácter de escape en el XML serializado. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. El DataSet propio solo escapa caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir el mismo.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Cuando los caracteres válidos en el nombre del elemento XML se convierten en caracteres de escape, el elemento se omite durante el procesamiento.When legal characters in XML element name are escaped, the element is ignored while processing.

Si el esquema XML de un DataSet incluye un targetNamespace, es posible que no se lean los datos y que se produzcan ReadXml excepciones al llamar DataSet a para cargar el elemento con XML que contiene elementos sin espacio de nombres calificado.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Para leer elementos incompletos, elementFormDefault establezca el valor de "Qualified" en el esquema XML como se muestra en el ejemplo siguiente.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<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>  

System.Xml.XmlTextReader hereda de XmlReader.System.Xml.XmlTextReader inherits from XmlReader.

Nota

Si el esquema DataSet de contiene elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema DataSet en con ReadXml especificando XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1,0.This exception does not occur if you are using .NET Framework version 1.0.

Consulte también:

Se aplica a