DataSet.WriteXml DataSet.WriteXml DataSet.WriteXml DataSet.WriteXml Method

Definition

Schreibt XML-Daten und bei Bedarf das Schema aus dem DataSet.Writes XML data, and optionally the schema, from the DataSet.

Überlädt

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

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

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

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

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

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

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

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

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.Writes the current data for the DataSet to the specified file.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das TextWriter.Writes the current data for the DataSet using the specified TextWriter.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das Stream.Writes the current data for the DataSet using the specified Stream.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

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

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

Parameter

writer
XmlWriter XmlWriter XmlWriter XmlWriter

Der XmlWriter, mit dem geschrieben werden soll.The XmlWriter with which to write.

Beispiele

Das folgende Beispiel erstellt eine System.IO.FileStream -Objekt, das verwendet wird, zum Erstellen eines neuen XmlTextWriter.The following example creates a System.IO.FileStream object that is used to create a new XmlTextWriter. Die XmlTextWriter Objekt wird verwendet, mit der WriteXml Methode, um ein XML-Dokument zu schreiben.The XmlTextWriter object is used with the WriteXml method to write an XML document.

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 ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, legen die mode Parameter WriteSchema.To write both data and schema, set the mode parameter to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

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

public:
 void WriteXml(System::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 String String String

Der Name der Datei, in die geschrieben werden soll, einschließlich des Pfades.The file name (including the path) to which to write.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die WriteXml Methode, um ein XML-Dokument zu schreiben.The following example uses the WriteXml method to write an XML document.

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 ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, legen die mode Parameter WriteSchema.To write both data and schema, set the mode parameter to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Siehe auch

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

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

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

Parameter

writer
TextWriter TextWriter TextWriter TextWriter

Ein TextWriter-Objekt, mit dem das Dokument geschrieben wird.A TextWriter object used to write the document.

Beispiele

Das folgende Beispiel erstellt zuerst eine einfache DataSet mit einem DataTable, zwei Spalten und zehn Zeilen.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Die DataSet Schema und Daten werden geschrieben, auf den Datenträger durch den Aufruf der WriteXml Methode.The DataSet schema and data are written to disk by invoking the WriteXml method. Ein zweites DataSet wird erstellt und die ReadXml Methode wird verwendet, um mit dem Schema und Daten zu füllen.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

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 ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, legen die mode Parameter WriteSchema.To write both data and schema, set the mode parameter to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

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

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

Parameter

stream
Stream Stream Stream Stream

Ein Stream-Objekt, mit dem in eine Datei geschrieben wird.A Stream object used to write to a file.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, entweder ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, legen die mode Parameter WriteSchema.To write both data and schema, set the mode parameter to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.Writes the current data for the DataSet to the specified file.

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

Parameter

fileName
String String String String

Der Name der Datei, in die geschrieben werden soll, einschließlich des Pfades.The file name (including the path) to which to write.

Ausnahmen

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, entweder ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, verwenden Sie eine der Überladungen, die umfasst die mode Parameter, und legen Sie dessen Wert auf WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Siehe auch

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das TextWriter.Writes the current data for the DataSet using the specified TextWriter.

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

Parameter

writer
TextWriter TextWriter TextWriter TextWriter

Das TextWriter-Objekt, mit dem geschrieben werden soll.The TextWriter object with which to write.

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, entweder ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, verwenden Sie eine der Überladungen, die umfasst die mode Parameter, und legen Sie dessen Wert auf WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.Writes the current data for the DataSet to the specified XmlWriter.

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

Parameter

writer
XmlWriter XmlWriter XmlWriter XmlWriter

Der XmlWriter, mit dem geschrieben werden soll.The XmlWriter with which to write.

Implementiert

Hinweise

Die WriteXml Methode bietet eine Möglichkeit, entweder ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, verwenden Sie eine der Überladungen, die umfasst die mode Parameter, und legen Sie dessen Wert auf WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das Stream.Writes the current data for the DataSet using the specified Stream.

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

Parameter

stream
Stream Stream Stream Stream

Ein Stream-Objekt, mit dem in eine Datei geschrieben wird.A Stream object used to write to a file.

Beispiele

Das folgende Beispiel erstellt eine System.IO.FileStream Objekt.The following example creates a System.IO.FileStream object. Das Objekt wird anschließend zusammen mit den WriteXml Methode, um ein XML-Dokument zu schreiben.The object is then used with the WriteXml method to write an XML document.

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 ausschließlich Daten zu schreiben oder Schemas und Daten aus einer DataSet in eine XML-Dokument, während die WriteXmlSchema Methode schreibt nur das Schema.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Um Schemas und Daten zu schreiben, verwenden Sie eine der Überladungen, die umfasst die mode Parameter, und legen Sie dessen Wert auf WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Zum Lesen von XML-Daten oder Schema und Daten in die DataSet, verwenden Sie die ReadXml Methode.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Um nur das Schema zu lesen, verwenden die ReadXmlSchema Methode.To read just the schema, use the ReadXmlSchema method.

Hinweis

Ein InvalidOperationException wird ausgelöst, wenn der Spaltentyp in einer der DataRow , die gelesen oder geschrieben, um implementiert IDynamicMetaObjectProvider und implementiert nicht IXmlSerializable.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Siehe auch

Gilt für: