Teilen über

DataSet.WriteXml Methode

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Schreibt XML-Daten und bei Bedarf das Schema aus dem DataSet.

Überlädt

WriteXml(XmlWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataSet 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(String, XmlWriteMode)

Schreibt im angegebenen DataSet 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(TextWriter, XmlWriteMode)

Schreibt mit dem angegebenen DataSet 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(Stream, XmlWriteMode)

Schreibt mit dem angegebenen DataSet und im angegebenen Stream 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)

Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.
WriteXml(TextWriter)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das TextWriter.
WriteXml(XmlWriter)

Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.
WriteXml(Stream)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das Stream.

WriteXml(XmlWriter, XmlWriteMode)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt mit dem angegebenen DataSet 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.

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 XmlWriter, mit dem geschrieben werden soll.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.

Beispiele

Im folgenden Beispiel wird ein System.IO.FileStream -Objekt erstellt, das verwendet wird, um eine neue XmlTextWriterzu erstellen. 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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataSet in ein XML-Dokument zu schreiben, während die WriteXmlSchema -Methode nur das Schema schreibt. Legen Sie zum Schreiben von Daten und Schemas den mode Parameter 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 DataSetReadXml -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.

Weitere Informationen

Gilt für:

WriteXml(String, XmlWriteMode)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt im angegebenen DataSet 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.

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 geschrieben werden soll, einschließlich des Pfades.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.

Ausnahmen

SecurityException

FileIOPermission ist nicht auf Write festgelegt.

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

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

Weitere Informationen

Gilt für:

WriteXml(TextWriter, XmlWriteMode)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt mit dem angegebenen DataSet 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.

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

Ein TextWriter-Objekt, mit dem das Dokument geschrieben wird.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.

Beispiele

Im folgenden Beispiel wird zunächst ein einfaches DataSet mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das DataSet Schema und die Daten werden durch Aufrufen der -Methode auf den WriteXml Datenträger geschrieben. Eine zweite DataSet wird erstellt, und die ReadXml -Methode wird verwendet, um sie mit Schema und Daten zu fü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

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

Weitere Informationen

Gilt für:

WriteXml(Stream, XmlWriteMode)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt mit dem angegebenen DataSet und im angegebenen Stream 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.

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

Ein Stream-Objekt, mit dem in eine Datei geschrieben wird.

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 DataSet in ein XML-Dokument zu schreiben, während die WriteXmlSchema -Methode nur das Schema schreibt. Legen Sie zum Schreiben von Daten und Schemas den mode Parameter 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 DataSetReadXml -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.

Weitere Informationen

Gilt für:

WriteXml(String)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt die aktuellen Daten für das DataSet in die 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 Name der Datei, in die geschrieben werden soll, einschließlich des Pfades.

Ausnahmen

SecurityException

FileIOPermission ist nicht auf Write festgelegt.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthält, 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 DataSetReadXml -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.

Weitere Informationen

Gilt für:

WriteXml(TextWriter)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das TextWriter.

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

Das TextWriter-Objekt, mit dem geschrieben werden soll.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthält, 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 DataSetReadXml -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.

Weitere Informationen

Gilt für:

WriteXml(XmlWriter)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.

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 geschrieben werden soll.

Hinweise

Die WriteXml -Methode bietet eine Möglichkeit, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthält, 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 DataSetReadXml -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.

Weitere Informationen

Gilt für:

WriteXml(Stream)

Quelle:
DataSet.cs
Quelle:
DataSet.cs
Quelle:
DataSet.cs

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das Stream.

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

Ein Stream-Objekt, mit dem in eine Datei geschrieben wird.

Beispiele

Das folgende Beispiel erstellt eine System.IO.FileStream Objekt. 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, entweder nur Daten oder sowohl Daten als auch Schema aus einem DataSet 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 mode Parameter enthält, 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 DataSetReadXml -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.

Weitere Informationen

Gilt für: