DataSet.WriteXml Methode

Definition

Namespace:: System.Data

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 XML-Daten und optional das Schema aus dem DataSet.

Überlädt

Name	Beschreibung
WriteXml(XmlWriter, XmlWriteMode)	Schreibt die aktuellen Daten und optional das Schema für die DataSet Verwendung der angegebenen XmlWriter 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 DataSet angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den `mode` Parameter auf `WriteSchema`.
WriteXml(TextWriter, XmlWriteMode)	Schreibt die aktuellen Daten und optional das Schema für die DataSet Verwendung der angegebenen TextWriter 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 DataSet Verwendung der angegebenen Stream und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den `mode` Parameter auf `WriteSchema`.
WriteXml(String)	Schreibt die aktuellen Daten für die DataSet angegebene Datei.
WriteXml(TextWriter)	Schreibt die aktuellen Daten für die DataSet Verwendung der angegebenen TextWriter.
WriteXml(XmlWriter)	Schreibt die aktuellen Daten für die DataSet angegebene XmlWriter.
WriteXml(Stream)	Schreibt die aktuellen Daten für die DataSet Verwendung der angegebenen Stream.

WriteXml(XmlWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataSet 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

Der XmlWriter zu schreibende Code.

mode: XmlWriteMode

Einer der XmlWriteMode Werte.

Beispiele

Im folgenden Beispiel wird ein System.IO.FileStream Objekt erstellt, das zum Erstellen eines neuen XmlTextWriterObjekts verwendet wird. Das XmlTextWriter Objekt wird mit der WriteXml Methode verwendet, um ein XML-Dokument zu schreiben.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Create an XmlTextWriter with the fileStream.
    System.Xml.XmlTextWriter xmlWriter =
        new System.Xml.XmlTextWriter(stream,
        System.Text.Encoding.Unicode);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(xmlWriter);
    xmlWriter.Close();
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
    If thisDataSet Is Nothing Then
        Return
    End If

    ' Create a file name to write to.
    Dim filename As String = "XmlDoc.xml"

    ' Create the FileStream to write with.
    Dim stream As New System.IO.FileStream _
       (filename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter with the fileStream.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
       (stream, System.Text.Encoding.Unicode)

    ' Write to the file with the WriteXml method.
    thisDataSet.WriteXml(xmlWriter)
    xmlWriter.Close()
End Sub

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Zum Schreiben von Daten und Schemas legen Sie den mode Parameter 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 DataSetXml-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

Using DataSets in ADO.NET

Gilt für:

WriteXml(String, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataSet 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::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 Dateiname (einschließlich des Pfads), in den geschrieben werden soll.

mode: XmlWriteMode

Einer der XmlWriteMode Werte.

Ausnahmen

SecurityException

FileIOPermissionist nicht auf .Write

Beispiele

Im folgenden Beispiel wird die WriteXml Methode verwendet, um ein XML-Dokument zu schreiben.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename);
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
    If thisDataSet Is Nothing Then
        Return
    End If

    ' Create a file name to write to.
    Dim filename As String = "XmlDoc.xml"

    ' Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename)
End Sub

Hinweise

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(TextWriter, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataSet 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

Ein TextWriter Objekt, das zum Schreiben des Dokuments verwendet wird.

mode: XmlWriteMode

Einer der XmlWriteMode Werte.

Beispiele

Im folgenden Beispiel wird zunächst eine einfache DataSet Zeile mit einer , zwei DataTableSpalten und zehn Zeilen erstellt. Das Schema und die DataSet Daten werden durch Aufrufen der WriteXml Methode auf den Datenträger geschrieben. Eine Sekunde DataSet wird erstellt, und die ReadXml Methode wird verwendet, um sie mit Schema und Daten auszufüllen.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Hinweise

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(Stream, XmlWriteMode)

Schreibt die aktuellen Daten und optional das Schema für die DataSet Verwendung der angegebenen Stream und XmlWriteMode. 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

Ein Stream Objekt, das zum Schreiben in eine Datei verwendet wird.

mode: XmlWriteMode

Einer der XmlWriteMode Werte.

Hinweise

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(String)

Schreibt die aktuellen Daten für die DataSet angegebene 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

Der Dateiname (einschließlich des Pfads), in den geschrieben werden soll.

Ausnahmen

SecurityException

FileIOPermissionist nicht auf .Write

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(TextWriter)

Schreibt die aktuellen Daten für die DataSet Verwendung der 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

Das TextWriter Objekt, mit dem geschrieben werden soll.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(XmlWriter)

Schreibt die aktuellen Daten für die DataSet angegebene 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 zu schreibende Code.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

WriteXml(Stream)

Schreibt die aktuellen Daten für die DataSet Verwendung der 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

Ein Stream Objekt, das zum Schreiben in eine Datei verwendet wird.

Beispiele

Im folgenden Beispiel wird ein System.IO.FileStream Objekt erstellt. Das Objekt wird dann mit der WriteXml Methode verwendet, um ein XML-Dokument zu schreiben.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(stream);
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
     If thisDataSet Is Nothing Then
         Return
     End If 

    ' Create a file name to write to.
     Dim filename As String = "XmlDoc.xml"

     ' Create the FileStream to write with.
     Dim stream As New System.IO.FileStream _
        (filename, System.IO.FileMode.Create)

     ' Write to the file with the WriteXml method.
     thisDataSet.WriteXml(stream)
End Sub

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthalten, und legen Sie den Wert auf WriteSchema.

Note

Weitere Informationen

Using DataSets in ADO.NET

Gilt für:

Feedback

War diese Seite hilfreich?