DataSet.WriteXml Methode
Definition
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 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 |
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 |
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 |
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 |
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)
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
- 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 schemas aus einem DataSet XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Um sowohl Daten als auch Schema zu schreiben, legen Sie den mode
Parameter auf WriteSchema
.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
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.
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
FileIOPermission ist nicht auf Write festgelegt.
Beispiele
Im folgenden Beispiel wird die WriteXml Methode zum Schreiben eines XML-Dokuments verwendet.
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, nur Daten oder schemas aus einem DataSet XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Um sowohl Daten als auch Schema zu schreiben, legen Sie den mode
Parameter auf WriteSchema
.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
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.
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 Objekt mit einer DataTable, zwei Spalten und zehn Zeilen erstellt. Das Schema und die Daten werden auf den Datenträger geschrieben, indem sie DataSet die WriteXml Methode aufrufen. 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, nur Daten oder schemas aus einem DataSet XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Um sowohl Daten als auch Schema zu schreiben, legen Sie den mode
Parameter auf WriteSchema
.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
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.
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
- mode
- XmlWriteMode
Einer der XmlWriteMode-Werte.
Hinweise
Die WriteXml
Methode bietet eine Möglichkeit, nur Daten oder schemas aus einem DataSet XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Um sowohl Daten als auch Schema zu schreiben, legen Sie den mode
Parameter auf WriteSchema
.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
WriteXml(String)
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
FileIOPermission ist nicht auf Write festgelegt.
Hinweise
Die WriteXml
Methode bietet eine Möglichkeit, nur Daten oder schemas 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
fest.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
WriteXml(TextWriter)
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, nur Daten oder schemas 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
fest.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
WriteXml(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
Hinweise
Die WriteXml
Methode bietet eine Möglichkeit, nur Daten oder schemas 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
fest.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.
Siehe auch
Gilt für
WriteXml(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
Beispiele
Das folgende Beispiel erstellt eine System.IO.FileStream Objekt. Das Objekt wird dann mit der WriteXml Methode zum Schreiben eines XML-Dokuments verwendet.
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 schemas 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
fest.
Beachten Sie, dass der gleiche "true" für die ReadXml und ReadXmlSchema Methoden bzw. Verwenden Sie die ReadXml
Methode, um XML-Daten zu lesen oder sowohl Schema als auch Daten in die DataSet
Methode zu lesen. Um nur das Schema zu lesen, verwenden Sie die ReadXmlSchema
Methode.
Hinweis
Es InvalidOperationException wird ausgelöst, wenn ein Spaltentyp im Lese- oder Schreibvorgang in DataRow
Implementierungen IDynamicMetaObjectProvider gelesen oder geschrieben wird und nicht implementiert IXmlSerializablewird.