DataTable.ReadXml DataTable.ReadXml DataTable.ReadXml DataTable.ReadXml Method

Definición

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

Sobrecargas

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

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

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

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

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

Lee los datos y el esquema XML en el objeto DataTable desde el archivo especificado.Reads XML schema and data into the DataTable from the specified file.

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

Lee datos y el esquema XML en el objeto DataTable mediante el objeto XmlReader especificado.Reads XML Schema and Data into the DataTable using the specified XmlReader.

Comentarios

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataTable 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 DataTable 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 incluyen XmlReadMode el parámetro y establezca su valor en ReadSchema.To read both data and schema, use one of the ReadXML overloads that include the XmlReadMode 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 DataTabledatos de, use el WriteXml método.To write XML data, or both schema and data from the DataTable, 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.

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

Lee los datos y el esquema XML en el objeto DataTable mediante el objeto Stream especificado.Reads XML schema and data into the DataTable 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 se 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 DataTable crea un que contiene dos columnas y diez filas.The following example creates a DataTable containing two columns and ten rows. En el ejemplo se DataTable escribe el esquema y los datos en una secuencia de memoria, WriteXml invocando el método.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. En el ejemplo se crea DataTable un segundo y ReadXml se llama al método para rellenarlo con el esquema y los datos.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithStream()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    newTable.ReadXml(xmlStream);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    // Display the contents of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithStream()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim newTable As New DataTable
  newTable.ReadXml(xmlStream)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

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

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, ByVal label As String)
  ' Display the contents of the supplied DataTable:
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Comentarios

El actual DataTable y sus descendientes se cargan con los datos del proporcionado Stream.The current DataTable and its descendents are loaded with the data from the supplied Stream. El comportamiento de este método es idéntico al del DataSet.ReadXml método, salvo que en este caso, los datos se cargan solo para la tabla actual y sus descendientes.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataTable 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 DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

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 DataTabledatos de, use el WriteXml método.To write XML data, or both schema and data from the DataTable, 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.

Consulte también:

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

Lee los datos y el esquema XML en el objeto DataTable mediante el objeto TextReader especificado.Reads XML schema and data into the DataTable 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

Objeto TextReader que se va a usar para leer los datos.The TextReader that will be used to read the data.

Devoluciones

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

Ejemplos

En el ejemplo siguiente se DataTable crea un que contiene dos columnas y diez filas.The following example creates a DataTable containing two columns and ten rows. En el ejemplo se DataTable escribe el esquema y los datos en una secuencia de memoria, WriteXml invocando el método.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. En el ejemplo se crea DataTable un segundo y ReadXml se llama al método para rellenarlo con el esquema y los datos.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.IO.StreamReader reader = 
        new System.IO.StreamReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.IO.StreamReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

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

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Comentarios

El actual DataTable y sus descendientes se cargan con los datos del proporcionado TextReader.The current DataTable and its descendents are loaded with the data from the supplied TextReader. El comportamiento de este método es idéntico al del DataSet.ReadXml método, salvo que en este caso, los datos se cargan solo para la tabla actual y sus descendientes.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataTable 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 DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

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 DataTabledatos de, use el WriteXml método.To write XML data, or both schema and data from the DataTable, 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.

Consulte también:

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

Lee los datos y el esquema XML en el objeto DataTable desde el archivo especificado.Reads XML schema and data into the DataTable from 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 del que se van a leer los datos.The name of the file from which to read the data.

Devoluciones

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

Ejemplos

En el ejemplo siguiente se DataTable crea un que contiene dos columnas y diez filas.The following example creates a DataTable containing two columns and ten rows. En el ejemplo se DataTable escribe el esquema y los datos en el disco.The example writes the DataTable schema and data to disk. En el ejemplo se crea DataTable un segundo y ReadXml se llama al método para rellenarlo con el esquema y los datos.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithString()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    string fileName = "C:\\TestData.xml";
    table.WriteXml(fileName, XmlWriteMode.WriteSchema);

    DataTable newTable = new DataTable();
    newTable.ReadXml(fileName);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithString()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a file.
  Dim fileName As String = "C:\TestData.xml"
  table.WriteXml(fileName, XmlWriteMode.WriteSchema)

  Dim newTable As New DataTable
  newTable.ReadXml(fileName)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable

  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

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

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Comentarios

El actual DataTable y sus descendientes se cargan con los datos del archivo mencionado en el proporcionado String.The current DataTable and its descendents are loaded with the data from the file named in the supplied String. El comportamiento de este método es idéntico al del DataSet.ReadXml método, salvo que en este caso, los datos se cargan solo para la tabla actual y sus descendientes.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataTable 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 DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

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 DataTabledatos de, use el WriteXml método.To write XML data, or both schema and data from the DataTable, 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.

using System.Data;  
public class A {  
   static void Main(string[] args) {  
      DataTable tabl = new DataTable("mytable");  
      tabl.Columns.Add(new DataColumn("id", typeof(int)));  
      for (int i = 0; i < 10; i++) {  
         DataRow row = tabl.NewRow();  
         row["id"] = i;  
         tabl.Rows.Add(row);  
      }  
      tabl.WriteXml("f.xml", XmlWriteMode.WriteSchema);  
      DataTable newt = new DataTable();  
      newt.ReadXml("f.xml");  
   }  
}  
Consulte también:

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

Lee datos y el esquema XML en el objeto DataTable mediante el objeto XmlReader especificado.Reads XML Schema and Data into the DataTable 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 que se va a usar para leer los datos.The XmlReader that will be used to read the data.

Devoluciones

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

Ejemplos

En el ejemplo siguiente se DataTable crea un que contiene dos columnas y diez filas.The following example creates a DataTable containing two columns and ten rows. En el ejemplo se DataTable escribe el esquema y los XmlReaderdatos en un.The example writes the DataTable schema and data to an XmlReader. En el ejemplo se crea DataTable un segundo y ReadXml se llama al método para rellenarlo con el XmlReader esquema y los datos de la instancia.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data from the XmlReader instance.

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.Xml.XmlTextReader reader = 
        new System.Xml.XmlTextReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

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

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.Xml.XmlTextReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

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

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Comentarios

El actual DataTable y sus descendientes se cargan con los datos del archivo mencionado en el proporcionado XmlReader.The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. El comportamiento de este método es idéntico al del ReadXml método, salvo que en este caso, los datos se cargan solo para la tabla actual y sus descendientes.The behavior of this method is identical to that of the ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema DataTable 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 DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

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 DataTabledatos de, use el WriteXml método.To write XML data, or both schema and data from the DataTable, 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.

Consulte también:

Se aplica a