DataSet.WriteXml Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje dane XML i opcjonalnie schemat z DataSet.

Przeciążenia

WriteXml(XmlWriter, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego XmlWriter i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru `mode` na wartość `WriteSchema`.
WriteXml(String, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat dla DataSet do określonego pliku przy użyciu określonego XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru `mode` na wartość `WriteSchema`.
WriteXml(TextWriter, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego TextWriter i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru `mode` na wartość `WriteSchema`.
WriteXml(Stream, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego Stream i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru `mode` na wartość `WriteSchema`.
WriteXml(String)	Zapisuje bieżące dane dla DataSet do określonego pliku.
WriteXml(TextWriter)	Zapisuje bieżące dane dla DataSet przy użyciu określonego TextWriter.
WriteXml(XmlWriter)	Zapisuje bieżące dane dla DataSet do określonego XmlWriter.
WriteXml(Stream)	Zapisuje bieżące dane dla DataSet przy użyciu określonego Stream.

WriteXml(XmlWriter, XmlWriteMode)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego XmlWriter i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na wartość WriteSchema.

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)

Parametry

writer: XmlWriter

XmlWriter, za pomocą którego należy napisać.

mode: XmlWriteMode

Jedna z wartości XmlWriteMode.

Przykłady

Poniższy przykład tworzy obiekt System.IO.FileStream używany do tworzenia nowego XmlTextWriter. Obiekt XmlTextWriter jest używany z metodą WriteXml do pisania dokumentu XML.

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

Uwagi

Metoda WriteXml umożliwia zapisywanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy metoda WriteXmlSchema zapisuje tylko schemat. Aby zapisać zarówno dane, jak i schemat, ustaw parametr mode na wartość WriteSchema.

Należy pamiętać, że to samo dotyczy odpowiednio metod ReadXml i ReadXmlSchema. Aby odczytać dane XML lub zarówno schemat, jak i dane do DataSet, użyj metody ReadXml. Aby odczytać tylko schemat, użyj metody ReadXmlSchema.

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(String, XmlWriteMode)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet do określonego pliku przy użyciu określonego XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na wartość 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)

Parametry

fileName: String

Nazwa pliku (w tym ścieżka), do której ma być zapisywany.

mode: XmlWriteMode

Jedna z wartości XmlWriteMode.

Wyjątki

SecurityException

FileIOPermission nie jest ustawiona na wartość Write.

Przykłady

W poniższym przykładzie użyto metody WriteXml do zapisania dokumentu XML.

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

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(TextWriter, XmlWriteMode)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego TextWriter i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na wartość WriteSchema.

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)

Parametry

writer: TextWriter

Obiekt TextWriter używany do zapisywania dokumentu.

mode: XmlWriteMode

Jedna z wartości XmlWriteMode.

Przykłady

Poniższy przykład najpierw tworzy prosty DataSet z jednym DataTable, dwie kolumny i dziesięć wierszy. Schemat i dane DataSet są zapisywane na dysku przez wywołanie metody WriteXml. Zostanie utworzona druga DataSet, a metoda ReadXml zostanie użyta do wypełnienia go schematem i danymi.

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

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(Stream, XmlWriteMode)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet przy użyciu określonego Stream i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na wartość WriteSchema.

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)

Parametry

stream: Stream

Obiekt Stream używany do zapisywania w pliku.

mode: XmlWriteMode

Jedna z wartości XmlWriteMode.

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(String)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane dla DataSet do określonego pliku.

public:
 void WriteXml(System::String ^ fileName);

public void WriteXml (string fileName);

member this.WriteXml : string -> unit

Public Sub WriteXml (fileName As String)

Parametry

fileName: String

Nazwa pliku (w tym ścieżka), do której ma być zapisywany.

Wyjątki

SecurityException

FileIOPermission nie jest ustawiona na wartość Write.

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(TextWriter)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane dla DataSet przy użyciu określonego 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)

Parametry

writer: TextWriter

Obiekt TextWriter, z którym ma być zapisywany.

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(XmlWriter)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane dla DataSet do określonego 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)

Parametry

writer: XmlWriter

XmlWriter, za pomocą którego należy napisać.

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

WriteXml(Stream)

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Źródło:: DataSet.cs

Zapisuje bieżące dane dla DataSet przy użyciu określonego 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)

Parametry

stream: Stream

Obiekt Stream używany do zapisywania w pliku.

Przykłady

Poniższy przykład tworzy obiekt System.IO.FileStream. Obiekt jest następnie używany z metodą WriteXml do pisania dokumentu XML.

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

Uwagi

Nuta

InvalidOperationException zostanie zgłoszony, jeśli typ kolumny w DataRow odczytywania lub zapisywania w celu implementowania IDynamicMetaObjectProvider i nie implementuje IXmlSerializable.

Zobacz też

używanie zestawów danych w ADO.NET

Dotyczy

Udostępnij za pośrednictwem

DataSet.WriteXml Metoda

Definicja

Przeciążenia

WriteXml(XmlWriter, XmlWriteMode)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

WriteXml(String, XmlWriteMode)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

WriteXml(TextWriter, XmlWriteMode)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

WriteXml(Stream, XmlWriteMode)

Parametry

Uwagi

Zobacz też

Dotyczy

WriteXml(String)

Parametry

Wyjątki

Uwagi

Zobacz też

Dotyczy

WriteXml(TextWriter)

Parametry

Uwagi

Zobacz też

Dotyczy

WriteXml(XmlWriter)

Parametry

Uwagi

Zobacz też

Dotyczy

WriteXml(Stream)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby