DataTable.WriteXml Methode

Definition

Schreibt den aktuellen Inhalt der DataTable als XML.Writes the current contents of the DataTable as XML.

Überlädt

WriteXml(TextWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified TextWriter. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String, XmlWriteMode)

Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode)

Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode, Boolean)

Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter, XmlWriteMode, Boolean)

Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String, Boolean)

Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.Writes the current contents of the DataTable as XML using the specified file. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(Stream, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.Writes the current contents of the DataTable as XML using the specified Stream. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String)

Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.Writes the current contents of the DataTable as XML using the specified file.

WriteXml(TextWriter)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified TextWriter.

WriteXml(Stream)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.Writes the current contents of the DataTable as XML using the specified Stream.

WriteXml(String, XmlWriteMode, Boolean)

Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(XmlWriter)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified XmlWriter.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable -Instanzen, fügt Sie einer DataSethinzu, erstellt DataRelation eine, die die beiden Tabellen miteinander in Beziehung WriteXml setzt, und verwendet dann die-Methode, um die in der übergeordneten Tabelle enthaltenen Daten in einen TextWriterzuschreiben.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy -Parameters auf die einzelnen Werte.The example demonstrates the behavior when setting the writeHierarchy parameter to each of its values.

Hinweis

In diesem Beispiel wird gezeigt, wie eine der überladenen Versionen von "Write texml" verwendet wird.This example shows how to use one of the overloaded versions of WriteXml. Weitere Beispiele, die möglicherweise verfügbar sind, finden Sie in den Themen zu den einzelnen Überladungen.For other examples that might be available, see the individual overload topics.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
    PrintOutput(writer, "Customer table, without hierarchy");

    writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter writer, string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(writer.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
  PrintOutput(writer, "Customer table, without hierarchy")

  writer = New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal writer As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(writer.ToString())
End Sub

Im Beispiel wird die folgende Ausgabe im Konsolenfenster angezeigt:The example displays the following output in the console window:

==============================  
Customer table, without hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
</NewDataSet>  
==============================  
Customer table, with hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
          <xs:element name="Table2">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="OrderID" type="xs:int" />  
                <xs:element name="CustomerID" type="xs:int" minOccurs="0" />  
                <xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />  
  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
      <xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m  
sdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="OrderID" />  
      </xs:unique>  
      <xs:keyref name="CustomerOrder" refer="Constraint1">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="CustomerID" />  
      </xs:keyref>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
  <Table2>  
    <OrderID>1</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>2</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>3</OrderID>  
    <CustomerID>2</CustomerID>  
    <OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>4</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>5</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>6</OrderID>  
    <CustomerID>4</CustomerID>  
    <OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
</NewDataSet>  

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

WriteXml(TextWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified TextWriter. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::TextWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter writer, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * bool -> unit
Public Sub WriteXml (writer As TextWriter, writeHierarchy As Boolean)

Parameter

writer
TextWriter

TextWriter, mit dem der Inhalt geschrieben werden soll.The TextWriter with which to write the content.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable -Instanzen, fügt Sie einer DataSethinzu, erstellt DataRelation eine, die die beiden Tabellen miteinander in Beziehung WriteXml setzt, und verwendet dann die-Methode, um die in der übergeordneten Tabelle enthaltenen Daten in einen TextWriterzuschreiben.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy -para truemeters auf.The example demonstrates the behavior when setting the writeHierarchy parameter to true.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter stream, 
    string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(stream.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal stream As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(stream.ToString())
End Sub

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verknüpften Tabellen zu schreiben, müssen Sie die writeHierarchy -Methode aufrufen true, wobei der-Parameter auf festgelegt ist.To write the data for the current table and all its descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(TextWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

public:
 void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)

Parameter

writer
TextWriter

Der zum Schreiben des Dokuments verwendete TextWriter.The TextWriter used to write the document.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(String, XmlWriteMode)

Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

public:
 void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode);
public void WriteXml (string fileName, System.Data.XmlWriteMode mode);
member this.WriteXml : string * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode)

Parameter

fileName
String

Der Name der Datei, in die die Daten geschrieben werden.The name of the file to which the data will be written.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(Stream, XmlWriteMode)

Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit

Parameter

stream
Stream

Der Stream, in den die Daten geschrieben werden.The stream to which the data will be written.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(XmlWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified XmlWriter.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter writer, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * bool -> unit
Public Sub WriteXml (writer As XmlWriter, writeHierarchy As Boolean)

Parameter

writer
XmlWriter

Der XmlWriter, mit dem der Inhalt geschrieben werden soll.The XmlWriter with which to write the contents.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und den gesamten Nachfolger, verknüpfte Tabellen, zu schreiben, müssen Sie writeHierarchy die-Methode trueaufrufen, wobei der-Parameter auf gesetzt ist.To write the data for the current table and its entire descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(XmlWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)

Parameter

writer
XmlWriter

Der zum Schreiben des Dokuments verwendete XmlWriter.The XmlWriter used to write the document.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(Stream, XmlWriteMode, Boolean)

Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode * bool -> unit

Parameter

stream
Stream

Der Stream, in den die Daten geschrieben werden.The stream to which the data will be written.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise speichert WriteXml die-Methode Daten nur für die aktuelle Tabelle.Normally, the WriteXml method saves data only for the current table. Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verknüpften Tabellen zu schreiben, müssen Sie die- writeHierarchy Methode aufrufen, truewobei der-Parameter auf festgelegt ist.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(TextWriter, XmlWriteMode, Boolean)

Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode, writeHierarchy As Boolean)

Parameter

writer
TextWriter

Der zum Schreiben des Dokuments verwendete TextWriter.The TextWriter used to write the document.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable -Instanzen, fügt Sie einer DataSethinzu, erstellt DataRelation eine, die die beiden Tabellen miteinander in Beziehung WriteXml setzt, und verwendet dann die-Methode, um die in der übergeordneten Tabelle enthaltenen Daten in einen TextWriterzuschreiben.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy -Parameters auf die einzelnen Werte.The example demonstrates the behavior when setting the writeHierarchy parameter to each of its values.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
    PrintOutput(writer, "Customer table, without hierarchy");

    writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter writer, 
    string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(writer.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
  PrintOutput(writer, "Customer table, without hierarchy")

  writer = New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal writer As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(writer.ToString())
End Sub

Im Beispiel wird die folgende Ausgabe im Konsolenfenster angezeigt:The example displays the following output in the console window:

==============================  
Customer table, without hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
</NewDataSet>  
==============================  
Customer table, with hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
          <xs:element name="Table2">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="OrderID" type="xs:int" />  
                <xs:element name="CustomerID" type="xs:int" minOccurs="0" />  
                <xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />  
  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
      <xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m  
sdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="OrderID" />  
      </xs:unique>  
      <xs:keyref name="CustomerOrder" refer="Constraint1">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="CustomerID" />  
      </xs:keyref>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
  <Table2>  
    <OrderID>1</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>2</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>3</OrderID>  
    <CustomerID>2</CustomerID>  
    <OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>4</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>5</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>6</OrderID>  
    <CustomerID>4</CustomerID>  
    <OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
</NewDataSet>  

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise speichert WriteXml die-Methode Daten nur für die aktuelle Tabelle.Normally, the WriteXml method saves data only for the current table. Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verknüpften Tabellen zu schreiben, müssen Sie die- writeHierarchy Methode aufrufen, truewobei der-Parameter auf festgelegt ist.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(String, Boolean)

Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.Writes the current contents of the DataTable as XML using the specified file. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::String ^ fileName, bool writeHierarchy);
public void WriteXml (string fileName, bool writeHierarchy);
member this.WriteXml : string * bool -> unit
Public Sub WriteXml (fileName As String, writeHierarchy As Boolean)

Parameter

fileName
String

Die Datei, in die die XML-Daten geschrieben werden sollen.The file to which to write the XML data.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verknüpften Tabellen zu schreiben, müssen Sie die- writeHierarchy Methode aufrufen, truewobei der-Parameter auf festgelegt ist.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(Stream, Boolean)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.Writes the current contents of the DataTable as XML using the specified Stream. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::Stream ^ stream, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * bool -> unit

Parameter

stream
Stream

Der Stream, in den die Daten geschrieben werden.The stream to which the data will be written.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Verwenden Sie WriteXmlSchema die-Methode, um das Schema DataTable für ein in ein XML-Dokument zu schreiben.Use the WriteXmlSchema method to write the schema for a DataTable to an XML document. Das Schema umfasst Tabellen-, Beziehungs-und Einschränkungs Definitionen.The schema includes table, relation, and constraint definitions.

Das XML-Schema wird mit dem XSD-Standard geschrieben.The XML schema is written using the XSD standard.

Verwenden Sie die WriteXml -Methode, um die Daten in ein XML-Dokument zu schreiben.To write the data to an XML document, use the WriteXml method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verknüpften Tabellen zu schreiben, müssen Sie die- writeHierarchy Methode aufrufen, truewobei der-Parameter auf festgelegt ist.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode, writeHierarchy As Boolean)

Parameter

writer
XmlWriter

Der zum Schreiben des Dokuments verwendete XmlWriter.The XmlWriter used to write the document.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und den gesamten Nachfolger, verknüpfte Tabellen, zu schreiben, müssen Sie writeHierarchy die-Methode trueaufrufen, wobei der-Parameter auf gesetzt ist.To write the data for the current table and its entire descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(String)

Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.Writes the current contents of the DataTable as XML using the specified file.

public:
 void WriteXml(System::String ^ fileName);
public void WriteXml (string fileName);
member this.WriteXml : string -> unit
Public Sub WriteXml (fileName As String)

Parameter

fileName
String

Die Datei, in die die XML-Daten geschrieben werden sollen.The file to which to write the XML data.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(TextWriter)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified TextWriter.

public:
 void WriteXml(System::IO::TextWriter ^ writer);
public void WriteXml (System.IO.TextWriter writer);
member this.WriteXml : System.IO.TextWriter -> unit
Public Sub WriteXml (writer As TextWriter)

Parameter

writer
TextWriter

TextWriter, mit dem der Inhalt geschrieben werden soll.The TextWriter with which to write the content.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(Stream)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.Writes the current contents of the DataTable as XML using the specified Stream.

public:
 void WriteXml(System::IO::Stream ^ stream);
public void WriteXml (System.IO.Stream stream);
member this.WriteXml : System.IO.Stream -> unit

Parameter

stream
Stream

Der Stream, in den die Daten geschrieben werden.The stream to which the data will be written.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der über Ladungen, die den XmlWriteMode -Parameter enthält, und legen Sie WriteSchemaihren Wert auf fest.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

WriteXml(String, XmlWriteMode, Boolean)

Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (string fileName, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : string * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode, writeHierarchy As Boolean)

Parameter

fileName
String

Der Name der Datei, in die die Daten geschrieben werden.The name of the file to which the data will be written.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.One of the XmlWriteMode values.

writeHierarchy
Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben.If true, write the contents of the current table and all its descendants. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.If false (the default value), write the data for the current table only.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise speichert WriteXml die-Methode Daten nur für die aktuelle Tabelle.Normally, the WriteXml method saves data only for the current table. Wenn Sie die Daten für die aktuelle Tabelle und das gesamte Schema speichern möchten, bietet die WriteXml -Methode eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.If you want to save the data for the current table and all of schema, the WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema method.

Normalerweise WriteXml schreibt die-Methode nur die Daten für die aktuelle Tabelle.Normally the WriteXml method writes the data only for the current table. Um die Daten für die aktuelle Tabelle und alle nachfolgenden, verknüpften Tabellen zu schreiben, müssen Sie writeHierarchy die-Methode truemit dem auf festgelegten-Parameter aufrufen.To write the data for the current table and all descendant, related tables, call the method with the writeHierarchy parameter set to true.

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.

Siehe auch

WriteXml(XmlWriter)

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.Writes the current contents of the DataTable as XML using the specified XmlWriter.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);
public void WriteXml (System.Xml.XmlWriter writer);
member this.WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)

Parameter

writer
XmlWriter

Der XmlWriter, mit dem der Inhalt geschrieben werden soll.The XmlWriter with which to write the contents.

Implementiert

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit zum Schreiben von Daten oder Daten und Schemas aus einem DataTable in ein XML-Dokument, während die WriteXmlSchema -Methode nur das Schema schreibt.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Verwenden Sie zum Schreiben von Daten und Schemas eine der-über Ladungen, die XmlWriteMode den-Parameter enthalten, und legen WriteSchemaSie Ihren Wert auf fest.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Verwenden Sie die ReadXml -Methode, um XML-Daten oder sowohl DataTabledas Schema als auch die Daten im zu lesen.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Um nur das Schema zu lesen, verwenden ReadXmlSchema Sie die-Methode.To read just the schema, use the ReadXmlSchema 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.

Siehe auch

Gilt für: