Bagikan melalui

DataSet.WriteXml Metode

  • Referensi

Definisi

Ruang nama:
System.Data
Rakitan:
System.Data.Common.dll
Rakitan:
System.Data.dll
Rakitan:
netstandard.dll

Menulis data XML, dan secara opsional skema, dari DataSet.

Overload

WriteXml(XmlWriter, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(String, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataSet ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(TextWriter, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(Stream, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan Stream dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(String)

Menulis data saat ini untuk ke DataSet file yang ditentukan.
WriteXml(TextWriter)

Menulis data saat ini untuk DataSet menggunakan yang ditentukan TextWriter.
WriteXml(XmlWriter)

Menulis data saat ini untuk DataSet ke yang ditentukan XmlWriter.
WriteXml(Stream)

Menulis data saat ini untuk DataSet menggunakan yang ditentukan Stream.

WriteXml(XmlWriter, XmlWriteMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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

yang XmlWriter akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Contoh

Contoh berikut membuat System.IO.FileStream objek yang digunakan untuk membuat baru XmlTextWriter. Objek XmlTextWriter digunakan dengan WriteXml metode untuk menulis dokumen 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

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, atur parameter ke modeWriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String, XmlWriteMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini, dan secara opsional skema, untuk DataSet ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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

Nama file (termasuk jalur) yang akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Pengecualian

SecurityException

FileIOPermission tidak diatur ke Write.

Contoh

Contoh berikut menggunakan WriteXml metode untuk menulis dokumen 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

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, atur parameter ke modeWriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(TextWriter, XmlWriteMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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

Objek yang TextWriter digunakan untuk menulis dokumen.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Contoh

Contoh berikut pertama-tama membuat sederhana DataSet dengan satu DataTable, dua kolom, dan sepuluh baris. DataSet Skema dan data ditulis ke disk dengan memanggil WriteXml metode . DataSet Detik dibuat dan ReadXml metode ini digunakan untuk mengisinya dengan skema dan 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

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, atur parameter ke modeWriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream, XmlWriteMode)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan Stream dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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

Objek yang Stream digunakan untuk menulis ke file.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, atur parameter ke modeWriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini untuk ke DataSet file yang ditentukan.

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

Nama file (termasuk jalur) yang akan ditulis.

Pengecualian

SecurityException

FileIOPermission tidak diatur ke Write.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(TextWriter)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini untuk DataSet menggunakan yang ditentukan 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

Objek TextWriter yang akan ditulis.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(XmlWriter)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini untuk ke DataSet yang ditentukan 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

yang XmlWriter akan ditulis.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream)

Sumber:
DataSet.cs
Sumber:
DataSet.cs
Sumber:
DataSet.cs

Menulis data saat ini untuk DataSet menggunakan yang ditentukan 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

Objek yang Stream digunakan untuk menulis ke file.

Contoh

Contoh berikut membuat System.IO.FileStream objek. Objek kemudian digunakan dengan WriteXml metode untuk menulis dokumen 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

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataSet ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan mode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataSetdalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk