DataTable.WriteXml Methode

Definition

Schreibt den aktuellen Inhalt des DataTable XML-Codes.

Überlädt

Name Beschreibung
WriteXml(TextWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(TextWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.

WriteXml(String, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.

WriteXml(Stream, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.

WriteXml(XmlWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter.

WriteXml(XmlWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.

WriteXml(Stream, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(TextWriter, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(String, Boolean)

Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(Stream, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(String)

Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei.

WriteXml(TextWriter)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter.

WriteXml(Stream)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream.

WriteXml(String, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.

WriteXml(XmlWriter)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf die einzelnen Werte.

Note

In diesem Beispiel wird gezeigt, wie Sie eine der überladenen Versionen von WriteXml verwenden. Weitere Beispiele, die verfügbar sein können, finden Sie in den einzelnen Überladungsthemen.

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:

==============================
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, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

WriteXml(TextWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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

Der TextWriter Inhalt, mit dem der Inhalt geschrieben werden soll.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf 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, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten verknüpften Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(TextWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf 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

Die TextWriter zum Schreiben des Dokuments verwendete Datei.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(String, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf 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.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(Stream, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf 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
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode)

Parameter

stream
Stream

Der Datenstrom, in den die Daten geschrieben werden.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen 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 Inhalt, mit dem der Inhalt geschrieben werden soll.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und deren gesamte absteigende Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf 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

Die XmlWriter zum Schreiben des Dokuments verwendete Datei.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(Stream, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode, writeHierarchy As Boolean)

Parameter

stream
Stream

Der Datenstrom, in den die Daten geschrieben werden.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(TextWriter, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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

Die TextWriter zum Schreiben des Dokuments verwendete Datei.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Beispiele

Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf die einzelnen Werte.

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:

==============================
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, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(String, Boolean)

Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(Stream, Boolean)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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
Public Sub WriteXml (stream As Stream, writeHierarchy As Boolean)

Parameter

stream
Stream

Der Datenstrom, in den die Daten geschrieben werden.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Verwenden Sie die WriteXmlSchema Methode, um das Schema für ein DataTable XML-Dokument zu schreiben. Das Schema enthält Tabellen-, Beziehungs- und Einschränkungsdefinitionen.

Das XML-Schema wird mit dem XSD-Standard geschrieben.

Verwenden Sie die WriteXml Methode, um die Daten in ein XML-Dokument zu schreiben.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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

Die XmlWriter zum Schreiben des Dokuments verwendete Datei.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und deren gesamte absteigende Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(String)

Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei.

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.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(TextWriter)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen 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

Der TextWriter Inhalt, mit dem der Inhalt geschrieben werden soll.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(Stream)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream.

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

Parameter

stream
Stream

Der Datenstrom, in den die Daten geschrieben werden.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(String, XmlWriteMode, Boolean)

Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf 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.

mode
XmlWriteMode

Einer der XmlWriteMode Werte.

writeHierarchy
Boolean

Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Wenn Sie die Daten für die aktuelle Tabelle und das gesamte Schema speichern möchten, bietet die WriteXml Methode eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle nachfolgerbezogenen Tabellen zu schreiben, auf die der writeHierarchy Parameter festgelegt ist true.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für:

WriteXml(XmlWriter)

Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen 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 Inhalt, mit dem der Inhalt geschrieben werden soll.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.

Note

Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.

Weitere Informationen

Gilt für: