Auf Englisch lesen

Freigeben über


DataSet.WriteXml Methode

Definition

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.

C#
public void WriteXml (System.Xml.XmlWriter? writer, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);

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.

C#
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();
}

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
public void WriteXml (string fileName, System.Data.XmlWriteMode mode);

Parameter

fileName
String

Der Name der Datei, in die geschrieben werden soll, einschließlich des Pfades.

mode
XmlWriteMode

Einer der XmlWriteMode-Werte.

Ausnahmen

FileIOPermission ist nicht auf Write festgelegt.

Beispiele

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

C#
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);
}

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
public void WriteXml (System.IO.TextWriter? writer, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode);

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.

C#
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();
        }
    }
}

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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.

C#
public void WriteXml (System.IO.Stream? stream, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode);

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(String)

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

Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.

C#
public void WriteXml (string fileName);

Parameter

fileName
String

Der Name der Datei, in die geschrieben werden soll, einschließlich des Pfades.

Ausnahmen

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(TextWriter)

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

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

C#
public void WriteXml (System.IO.TextWriter? writer);
C#
public void WriteXml (System.IO.TextWriter writer);

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(XmlWriter)

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

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

C#
public void WriteXml (System.Xml.XmlWriter? writer);
C#
public void WriteXml (System.Xml.XmlWriter writer);

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(Stream)

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

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

C#
public void WriteXml (System.IO.Stream? stream);
C#
public void WriteXml (System.IO.Stream 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.

C#
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);
}

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:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1