DataTable.WriteXml Methode

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt den aktuellen Inhalt der DataTable als XML.

Überlädt

WriteXml(TextWriter, Boolean)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
WriteXml(TextWriter, XmlWriteMode)	Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest.
WriteXml(String, XmlWriteMode)	Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest.
WriteXml(Stream, XmlWriteMode)	Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest.
WriteXml(XmlWriter, Boolean)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.
WriteXml(XmlWriter, XmlWriteMode)	Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest.
WriteXml(Stream, XmlWriteMode, Boolean)	Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
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. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
WriteXml(String, Boolean)	Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
WriteXml(Stream, Boolean)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
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. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
WriteXml(String)	Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.
WriteXml(TextWriter)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.
WriteXml(Stream)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.
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. Um das Schema zu schreiben, legen Sie den Wert für den `mode`-Parameter auf `WriteSchema` fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den `writeHierarchy`-Parameter auf `true` fest.
WriteXml(XmlWriter)	Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.

Beispiele

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

Hinweis

In diesem Beispiel wird gezeigt, wie Sie eine der überladenen Versionen von WriteXml verwenden. Weitere Beispiele, die möglicherweise verfügbar sind, 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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 fest WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die -Methode, um XML-Daten oder schema- und daten in das DataTableReadXml -Format zu lesen. Verwenden Sie die -Methode, um nur das ReadXmlSchema Schema zu lesen.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in dem, aus DataRow dem gelesen oder geschrieben wird, implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.

WriteXml(TextWriter, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

public:
 void WriteXml(System::IO::TextWriter ^ writer, bool writeHierarchy);

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.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Beispiele

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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Normalerweise schreibt die WriteXml -Methode die Daten nur für die aktuelle Tabelle. Um die Daten für die aktuelle Tabelle und alle zugehörigen verwandten Tabellen zu schreiben, rufen Sie die -Methode auf, wobei der writeHierarchy Parameter auf truefestgelegt ist.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(TextWriter, XmlWriteMode)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

public:
 void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode);

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.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(String, XmlWriteMode)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

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

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die -Methode, um XML-Daten oder sowohl Das Schema als auch die Daten in den DataTableReadXml zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema -Methode.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn ein Spaltentyp in der DataRow aus gelesen oder in geschrieben wird implementiert IDynamicMetaObjectProvider und nicht implementiert IXmlSerializable.

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(Stream, XmlWriteMode)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode);

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 Stream, in den die Daten geschrieben werden.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(XmlWriter, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, bool writeHierarchy);

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.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie zum Schreiben der Daten für die aktuelle Tabelle und deren gesamte untergeordnete Tabellen die -Methode auf, wobei der writeHierarchy Parameter auf festgelegt ist true.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(XmlWriter, XmlWriteMode)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode);

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.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

Hinweise

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(Stream, XmlWriteMode, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

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

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 Stream, in den die Daten geschrieben werden.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Normalerweise speichert die WriteXml -Methode daten nur für die aktuelle Tabelle. Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Um die Daten für die aktuelle Tabelle und alle ihre untergeordneten, verwandten Tabellen zu schreiben, rufen Sie die -Methode auf, wobei der writeHierarchy Parameter auf festgelegt ist true.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(TextWriter, XmlWriteMode, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt mit dem angegebenen DataTable und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

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

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.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Beispiele

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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Normalerweise speichert die WriteXml -Methode daten nur für die aktuelle Tabelle. Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(String, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

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, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(Stream, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

public:
 void WriteXml(System::IO::Stream ^ stream, bool writeHierarchy);

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 Stream, in den die Daten geschrieben werden.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

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

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

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

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt mit dem angegebenen DataTable und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

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

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.

mode: XmlWriteMode

Einer der XmlWriteMode-Werte.

writeHierarchy: Boolean

Wenn true, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(String)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt der DataTable als XML mit 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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(TextWriter)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen TextWriter im XML-Format.

public:
 void WriteXml(System::IO::TextWriter ^ writer);

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.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(Stream)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen Stream im XML-Format.

public:
 void WriteXml(System::IO::Stream ^ 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 Stream, in den die Daten geschrieben werden.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 enthält, und legen Sie den Wert auf fest WriteSchema.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(String, XmlWriteMode, Boolean)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt mit der angegebenen Datei und im angegebenen DataTable die aktuellen Daten und bei Bedarf das Schema für das XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.

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, wird der Inhalt der aktuellen Tabelle und ihrer Nachfolgerelemente geschrieben. Wenn false (der Standardwert), werden nur die Daten der aktuellen Tabelle geschrieben.

Hinweise

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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataTable in ein 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 fest WriteSchema.

Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Um die Daten für die aktuelle Tabelle und alle untergeordneten, verwandten Tabellen zu schreiben, rufen Sie die -Methode auf, wobei der writeHierarchy Parameter auf festgelegt ist true.

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

WriteXml(XmlWriter)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Schreibt den aktuellen Inhalt des DataTable mithilfe des angegebenen XmlWriter im XML-Format.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);

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.

Hinweise

Hinweis

Weitere Informationen

"DataTables"

Gilt für:

Teilen über

DataTable.WriteXml Methode

Definition

Überlädt

Beispiele

Hinweise

WriteXml(TextWriter, Boolean)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

WriteXml(TextWriter, XmlWriteMode)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(String, XmlWriteMode)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(Stream, XmlWriteMode)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, XmlWriteMode)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(Stream, XmlWriteMode, Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(TextWriter, XmlWriteMode, Boolean)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

WriteXml(String, Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(Stream, Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(String)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(TextWriter)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(Stream)

Parameter

Hinweise

Weitere Informationen

Gilt für:

WriteXml(String, XmlWriteMode, Boolean)

Parameter