DataSet.WriteXml Metoda

Definicja

Zapisuje dane XML i opcjonalnie schemat z DataSet .Writes XML data, and optionally the schema, from the DataSet.

Przeciążenia

WriteXml(XmlWriter, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych XmlWriter i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet określonego pliku przy użyciu określonego XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych TextWriter i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych Stream i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String)

Zapisuje bieżące dane dla DataSet określonego pliku.Writes the current data for the DataSet to the specified file.

WriteXml(TextWriter)

Zapisuje bieżące dane za DataSet pomocą określonego TextWriter .Writes the current data for the DataSet using the specified TextWriter.

WriteXml(XmlWriter)

Zapisuje bieżące dane dla określonego elementu DataSet XmlWriter .Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(Stream)

Zapisuje bieżące dane za DataSet pomocą określonego Stream .Writes the current data for the DataSet using the specified Stream.

WriteXml(XmlWriter, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych XmlWriter i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to 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 Przy użyciu którego ma zostać zapisany.The XmlWriter with which to write.

mode
XmlWriteMode

Jedna z XmlWriteMode wartości.One of the XmlWriteMode values.

Przykłady

Poniższy przykład tworzy System.IO.FileStream obiekt, który jest używany do utworzenia nowego XmlTextWriter .The following example creates a System.IO.FileStream object that is used to create a new XmlTextWriter. XmlTextWriterObiekt jest używany z WriteXml metodą do pisania dokumentu XML.The XmlTextWriter object is used with the WriteXml method to write an XML document.

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

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, ustaw mode parametr na WriteSchema .To write both data and schema, set the mode parameter to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(String, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat dla DataSet określonego pliku przy użyciu określonego XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to 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 (wraz z ścieżką), do którego ma zostać zapisany.The file name (including the path) to which to write.

mode
XmlWriteMode

Jedna z XmlWriteMode wartości.One of the XmlWriteMode values.

Wyjątki

FileIOPermission nie jest ustawiona na Write .FileIOPermission is not set to Write.

Przykłady

Poniższy przykład używa WriteXml metody do pisania dokumentu XML.The following example uses the WriteXml method to write an XML document.

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

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, ustaw mode parametr na WriteSchema .To write both data and schema, set the mode parameter to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(TextWriter, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych TextWriter i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to 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

TextWriterObiekt używany do pisania dokumentu.A TextWriter object used to write the document.

mode
XmlWriteMode

Jedna z XmlWriteMode wartości.One of the XmlWriteMode values.

Przykłady

Poniższy przykład tworzy najpierw prostą DataSet z jedną DataTable , dwie kolumną i dziesięciu wierszami.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. DataSetSchemat i dane są zapisywane na dysku przez wywołanie WriteXml metody.The DataSet schema and data are written to disk by invoking the WriteXml method. DataSetZostanie utworzona sekunda, a ReadXml Metoda zostanie użyta do wypełnienia jej schematem i danymi.A second DataSet is created and the ReadXml method is used to fill it with schema and 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

Uwagi

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, ustaw mode parametr na WriteSchema .To write both data and schema, set the mode parameter to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(Stream, XmlWriteMode)

Zapisuje bieżące dane i opcjonalnie schemat DataSet przy użyciu określonych Stream i XmlWriteMode .Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Aby zapisać schemat, ustaw wartość mode parametru na WriteSchema .To write the schema, set the value for the mode parameter to 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

StreamObiekt używany do zapisu w pliku.A Stream object used to write to a file.

mode
XmlWriteMode

Jedna z XmlWriteMode wartości.One of the XmlWriteMode values.

Uwagi

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, ustaw mode parametr na WriteSchema .To write both data and schema, set the mode parameter to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(String)

Zapisuje bieżące dane dla DataSet określonego pliku.Writes the current data for the DataSet to the specified file.

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 (wraz z ścieżką), do którego ma zostać zapisany.The file name (including the path) to which to write.

Wyjątki

FileIOPermission nie jest ustawiona na Write .FileIOPermission is not set to Write.

Uwagi

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, użyj jednego z przeciążeń zawierających mode parametr i ustaw jego wartość na WriteSchema .To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(TextWriter)

Zapisuje bieżące dane za DataSet pomocą określonego TextWriter .Writes the current data for the DataSet using the specified 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

TextWriterObiekt, z którego ma zostać zapisany.The TextWriter object with which to write.

Uwagi

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, użyj jednego z przeciążeń zawierających mode parametr i ustaw jego wartość na WriteSchema .To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(XmlWriter)

Zapisuje bieżące dane dla określonego elementu DataSet XmlWriter .Writes the current data for the DataSet to the specified 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 Przy użyciu którego ma zostać zapisany.The XmlWriter with which to write.

Uwagi

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, użyj jednego z przeciążeń zawierających mode parametr i ustaw jego wartość na WriteSchema .To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy

WriteXml(Stream)

Zapisuje bieżące dane za DataSet pomocą określonego Stream .Writes the current data for the DataSet using the specified 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

StreamObiekt używany do zapisu w pliku.A Stream object used to write to a file.

Przykłady

Poniższy przykład tworzy System.IO.FileStream obiekt.The following example creates a System.IO.FileStream object. Obiekt jest następnie używany z WriteXml metodą do pisania dokumentu XML.The object is then used with the WriteXml method to write an XML document.

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

WriteXmlMetoda umożliwia zapisanie tylko danych lub zarówno danych, jak i schematu z DataSet do dokumentu XML, podczas gdy WriteXmlSchema Metoda zapisuje tylko schemat.The WriteXml method provides a way to write either data only, or both data and schema from a DataSet into an XML document, whereas the WriteXmlSchema method writes only the schema. Aby zapisać dane i schemat, użyj jednego z przeciążeń zawierających mode parametr i ustaw jego wartość na WriteSchema .To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Należy zauważyć, że ta sama wartość dotyczy ReadXml ReadXmlSchema metod i.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Aby odczytać dane XML lub schemat i dane do DataSet , użyj ReadXml metody.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Aby odczytać tylko schemat, użyj ReadXmlSchema metody.To read just the schema, use the ReadXmlSchema method.

Uwaga

InvalidOperationExceptionZostanie zgłoszony, jeśli typ kolumny w DataRow trakcie odczytu lub zapisu do implementuje IDynamicMetaObjectProvider i nie implementuje IXmlSerializable .An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Dotyczy