DataSet.WriteXml Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

XML verilerini ve isteğe bağlı olarak şemasını dosyasından DataSetyazar.

Aşırı Yüklemeler

WriteXml(XmlWriter, XmlWriteMode)	Belirtilen XmlWriter ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.
WriteXml(String, XmlWriteMode)	Belirtilen dosyasını kullanarak geçerli verileri ve isteğe bağlı olarak şemasını DataSet belirtilen XmlWriteModedosyaya yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.
WriteXml(TextWriter, XmlWriteMode)	Belirtilen TextWriter ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.
WriteXml(Stream, XmlWriteMode)	Belirtilen Stream ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.
WriteXml(String)	için DataSet geçerli verileri belirtilen dosyaya yazar.
WriteXml(TextWriter)	Belirtilen TextWriterkullanarak için DataSet geçerli verileri yazar.
WriteXml(XmlWriter)	için DataSet geçerli verileri belirtilen XmlWriteröğesine yazar.
WriteXml(Stream)	Belirtilen Streamkullanarak için DataSet geçerli verileri yazar.

WriteXml(XmlWriter, XmlWriteMode)

Kaynak:

DataSet.cs

Belirtilen XmlWriter ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.

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)

Parametreler

writer

XmlWriter

XmlWriter Yazacakları.

mode

XmlWriteMode

Değerlerden XmlWriteMode biri.

Örnekler

Aşağıdaki örnek, yeni XmlTextWriterbir System.IO.FileStream oluşturmak için kullanılan bir nesnesi oluşturur. XmlTextWriter nesnesi, xml belgesi yazmak için yöntemiyle birlikte WriteXml kullanılır.

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

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini mode olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri Kullanma

WriteXml(String, XmlWriteMode)

Kaynak:

DataSet.cs

Belirtilen dosyasını kullanarak geçerli verileri ve isteğe bağlı olarak şemasını DataSet belirtilen XmlWriteModedosyaya yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.

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)

Parametreler

fileName

String

Yazıldığı dosya adı (yol dahil).

mode

XmlWriteMode

Değerlerden XmlWriteMode biri.

Özel durumlar

SecurityException

FileIOPermission olarak ayarlanmadı Write.

Örnekler

Aşağıdaki örnek, xml belgesi yazmak için yöntemini kullanır WriteXml .

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

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini mode olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri Kullanma

WriteXml(TextWriter, XmlWriteMode)

Kaynak:

DataSet.cs

Belirtilen TextWriter ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.

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)

Parametreler

writer

TextWriter

TextWriter Belgeyi yazmak için kullanılan nesne.

mode

XmlWriteMode

Değerlerden XmlWriteMode biri.

Örnekler

Aşağıdaki örnek ilk olarak bir DataTable, iki sütun ve on satır içeren basit DataSet bir oluşturur. Şema DataSet ve veriler, yöntemi çağrılarak diske WriteXml yazılır. Bir saniye DataSet oluşturulur ve ReadXml şema ve verilerle doldurmak için yöntemi kullanılır.

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

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini mode olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri Kullanma

WriteXml(Stream, XmlWriteMode)

Kaynak:

DataSet.cs

Belirtilen Stream ve XmlWriteModekullanımı için geçerli verileri ve isteğe bağlı olarak şemayı DataSet yazar. Şemayı yazmak için parametresinin mode değerini olarak WriteSchemaayarlayın.

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)

Parametreler

stream

Stream

Dosyaya Stream yazmak için kullanılan nesne.

mode

XmlWriteMode

Değerlerden XmlWriteMode biri.

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini mode olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri Kullanma

WriteXml(String)

Kaynak:

DataSet.cs

için DataSet geçerli verileri belirtilen dosyaya yazar.

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

public void WriteXml (string fileName);

member this.WriteXml : string -> unit

Public Sub WriteXml (fileName As String)

Parametreler

fileName

String

Yazıldığı dosya adı (yol dahil).

Özel durumlar

SecurityException

FileIOPermission olarak ayarlanmadı Write.

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem veri hem de şema yazmak için parametresini içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri Kullanma

WriteXml(TextWriter)

Kaynak:

DataSet.cs

Belirtilen TextWriterkullanarak için DataSet geçerli verileri yazar.

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)

Parametreler

writer

TextWriter

TextWriter Yazıldığı nesne.

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem veri hem de şema yazmak için parametresini içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak WriteSchemaayarlayın.

Aynı değerin sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şemayı hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri kullanma

WriteXml(XmlWriter)

Kaynak:

DataSet.cs

için DataSet geçerli verileri belirtilen XmlWriteröğesine yazar.

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)

Parametreler

writer

XmlWriter

XmlWriter Yazacakları.

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak WriteSchemaayarlayın.

Bunun sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şema hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri kullanma

WriteXml(Stream)

Kaynak:

DataSet.cs

Belirtilen Streamkullanarak için DataSet geçerli verileri yazar.

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)

Parametreler

stream

Stream

Dosyaya Stream yazmak için kullanılan nesne.

Örnekler

Aşağıdaki örnek bir System.IO.FileStream nesne oluşturur. Nesne daha sonra bir XML belgesi yazmak için yöntemiyle WriteXml birlikte kullanılır.

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

Açıklamalar

WriteXml yöntemi bir XML belgesine yalnızca veri veya hem veri hem de şema DataSet yazmak için bir yol sağlarkenWriteXmlSchema, yöntem yalnızca şemayı yazar. Hem verileri hem de şemayı yazmak için parametresini içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak WriteSchemaayarlayın.

Bunun sırasıyla ve ReadXmlSchema yöntemleri için ReadXml de geçerli olduğunu unutmayın. XML verilerini veya içine hem şema hem de verileri DataSetokumak için yöntemini kullanın ReadXml . Yalnızca şemayı okumak için yöntemini kullanın ReadXmlSchema .

Not

InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.

Ayrıca bkz.

• ADO.NET'de DataSet'leri kullanma