DataTable.ReadXml Methode

Definition

Liest ein XML-Schema und XML-Daten in das DataTable.Reads XML schema and data into the DataTable.

Überlädt

ReadXml(Stream)

Liest mit dem angegebenen DataTable das XML-Schema und die XML-Daten in die Stream.Reads XML schema and data into the DataTable using the specified Stream.

ReadXml(TextReader)

Liest mit dem angegebenen DataTable das XML-Schema und die XML-Daten in die TextReader.Reads XML schema and data into the DataTable using the specified TextReader.

ReadXml(String)

Liest das XML-Schema und die XML-Daten in die DataTable aus der angegebenen Datei.Reads XML schema and data into the DataTable from the specified file.

ReadXml(XmlReader)

Liest das XML-Schema und die XML-Daten mit dem angegebenen DataTable in die XmlReader.Reads XML Schema and Data into the DataTable using the specified XmlReader.

Hinweise

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataTable aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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. Verwenden Sie zum Lesen von Daten und Schemas eine der ReadXML -über Ladungen, die XmlReadMode den-Parameter enthalten, und legen ReadSchemaSie dessen Wert auf fest.To read both data and schema, use one of the ReadXML overloads that include the XmlReadMode parameter, and set its value to ReadSchema.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataTable, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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)

Liest mit dem angegebenen DataTable das XML-Schema und die XML-Daten in die Stream.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

Parameter

stream
Stream

Ein von Stream abgeleitetes Objekt.An object that derives from Stream

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird eine DataTable erstellt, die zwei Spalten und zehn Zeilen enthält.The following example creates a DataTable containing two columns and ten rows. Im Beispiel werden das DataTable Schema und die Daten durch Aufrufen der WriteXml -Methode in einen Speicherstream geschrieben.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. Im Beispiel wird eine Sekunde DataTable erstellt und die ReadXml -Methode aufgerufen, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die aktuelle DataTable und die untergeordneten Elemente werden mit den Daten aus der bereit Streamgestellten geladen.The current DataTable and its descendents are loaded with the data from the supplied Stream. Das Verhalten dieser Methode ist mit der der- DataSet.ReadXml Methode identisch, mit dem Unterschied, dass Daten in diesem Fall nur für die aktuelle Tabelle und deren Nachfolger geladen werden.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.

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataTable aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataTable, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Siehe auch

ReadXml(TextReader)

Liest mit dem angegebenen DataTable das XML-Schema und die XML-Daten in die TextReader.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

Parameter

reader
TextReader

Der TextReader, der verwendet wird, um die Daten zu lesen.The TextReader that will be used to read the data.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird eine DataTable erstellt, die zwei Spalten und zehn Zeilen enthält.The following example creates a DataTable containing two columns and ten rows. Im Beispiel werden das DataTable Schema und die Daten durch Aufrufen der WriteXml -Methode in einen Speicherstream geschrieben.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. Im Beispiel wird eine Sekunde DataTable erstellt und die ReadXml -Methode aufgerufen, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die aktuelle DataTable und die untergeordneten Elemente werden mit den Daten aus der bereit TextReadergestellten geladen.The current DataTable and its descendents are loaded with the data from the supplied TextReader. Das Verhalten dieser Methode ist mit der der- DataSet.ReadXml Methode identisch, mit dem Unterschied, dass Daten in diesem Fall nur für die aktuelle Tabelle und deren Nachfolger geladen werden.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.

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataTable aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataTable, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Siehe auch

ReadXml(String)

Liest das XML-Schema und die XML-Daten in die DataTable aus der angegebenen Datei.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

Parameter

fileName
String

Der Name der Datei, aus der die Daten gelesen werden sollen.The name of the file from which to read the data.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird eine DataTable erstellt, die zwei Spalten und zehn Zeilen enthält.The following example creates a DataTable containing two columns and ten rows. Im Beispiel werden das DataTable Schema und die Daten auf den Datenträger geschrieben.The example writes the DataTable schema and data to disk. Im Beispiel wird eine Sekunde DataTable erstellt und die ReadXml -Methode aufgerufen, um Sie mit Schema und Daten zu füllen.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

Hinweise

Die aktuellen DataTable und die untergeordneten Elemente werden mit den Daten aus der Datei geladen, die in Stringder angegebenen Datei mit dem Namen benannt ist.The current DataTable and its descendents are loaded with the data from the file named in the supplied String. Das Verhalten dieser Methode ist mit der der- DataSet.ReadXml Methode identisch, mit dem Unterschied, dass Daten in diesem Fall nur für die aktuelle Tabelle und deren Nachfolger geladen werden.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.

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataTable aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataTable, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.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");  
   }  
}  

Siehe auch

ReadXml(XmlReader)

Liest das XML-Schema und die XML-Daten mit dem angegebenen DataTable in die XmlReader.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

Parameter

reader
XmlReader

Der XmlReader, der verwendet wird, um die Daten zu lesen.The XmlReader that will be used to read the data.

Gibt zurück

Der zum Lesen der Daten verwendete XmlReadMode.The XmlReadMode used to read the data.

Beispiele

Im folgenden Beispiel wird eine DataTable erstellt, die zwei Spalten und zehn Zeilen enthält.The following example creates a DataTable containing two columns and ten rows. Im Beispiel werden das DataTable Schema und die Daten in XmlReadereine geschrieben.The example writes the DataTable schema and data to an XmlReader. Im Beispiel wird eine Sekunde DataTable erstellt und die ReadXml -Methode aufgerufen, um Sie mit dem Schema und XmlReader den Daten der-Instanz auszufüllen.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

Hinweise

Die aktuellen DataTable und die untergeordneten Elemente werden mit den Daten aus der Datei geladen, die in XmlReaderder angegebenen Datei mit dem Namen benannt ist.The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. Das Verhalten dieser Methode ist mit der der- ReadXml Methode identisch, mit dem Unterschied, dass Daten in diesem Fall nur für die aktuelle Tabelle und deren Nachfolger geladen werden.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.

Die ReadXml -Methode bietet eine Möglichkeit zum Lesen von Daten oder Daten und Schemas in einem DataTable aus einem XML-Dokument, während die ReadXmlSchema -Methode nur das Schema liest.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.

Beachten Sie, dass der gleiche "true" für die WriteXml und WriteXmlSchema Methoden bzw.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Schreiben von XML-Daten oder Schema und Daten aus der DataTable, verwenden Sie die WriteXml Methode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Um nur das Schema zu schreiben, verwenden WriteXmlSchema Sie die-Methode.To write just the schema, use the WriteXmlSchema method.

Hinweis

Eine InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in DataRow der, aus der gelesen oder geschrieben IDynamicMetaObjectProvider wird, IXmlSerializableimplementiert und nicht implementiert.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.

Wenn ein Inline Schema angegeben wird, wird das Inline Schema verwendet, um die vorhandene relationale Struktur zu erweitern, bevor die Daten geladen werden.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. Wenn Konflikte auftreten (z. b. dieselbe Spalte in derselben Tabelle, die mit unterschiedlichen Datentypen definiert wurde), wird eine Ausnahme ausgelöst.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Wenn kein Inline Schema angegeben wird, wird die relationale Struktur nach Bedarf nach Bedarf entsprechend der Struktur des XML-Dokuments erweitert.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Wenn das Schema nicht über einen Typrückschluss erweitert werden kann, um alle Daten verfügbar zu machen, wird eine Ausnahme ausgelöst.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Hinweis

Der DataSet weist kein XML-Element mit dem entsprechenden DataColumn oder DataTable zu, wenn zulässige XML-Zeichen wie ("") im serialisierten XML-Code mit Escapezeichen versehen werden.The DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("") are escaped in the serialized XML. Der DataSet selbst schützt ungültige XML-Zeichen in XML-Elementnamen und kann daher nur denselben nutzen.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Wenn juristische Zeichen im XML-Elementnamen mit Escapezeichen versehen werden, wird das Element bei der Verarbeitung ignoriert.When legal characters in XML element name are escaped, the element is ignored while processing.

Siehe auch

Gilt für: