DataSet.WriteXml DataSet.WriteXml DataSet.WriteXml DataSet.WriteXml Method

定义

DataSet 写 XML 数据,还可以选择写架构。Writes XML data, and optionally the schema, from the DataSet.

重载

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

使用指定的 XmlWriterXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

使用指定的 XmlWriteModeDataSet 的当前数据和架构(可选)写入指定的文件。Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

使用指定的 TextWriterXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

使用指定的 StreamXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

DataSet 的当前数据写入指定的文件。Writes the current data for the DataSet to the specified file.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

使用指定的 DataSetTextWriter 写当前数据。Writes the current data for the DataSet using the specified TextWriter.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

DataSet 的当前数据写入指定的 XmlWriterWrites the current data for the DataSet to the specified XmlWriter.

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

使用指定的 DataSetStream 写当前数据。Writes the current data for the DataSet using the specified Stream.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

使用指定的 XmlWriterXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo 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);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)

参数

writer
XmlWriter XmlWriter XmlWriter XmlWriter

用于写入的 XmlWriterThe XmlWriter with which to write.

示例

下面的示例创建一个System.IO.FileStream用于创建新XmlTextWriter的对象。The following example creates a System.IO.FileStream object that is used to create a new XmlTextWriter. XmlTextWriter 对象WriteXml与方法一起用于写入 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

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请mode将参数WriteSchema设置为。To write both data and schema, set the mode parameter to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

使用指定的 XmlWriteModeDataSet 的当前数据和架构(可选)写入指定的文件。Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo 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)

参数

fileName
String String String String

要向其写入的文件的名称(包括路径)。The file name (including the path) to which to write.

异常

示例

下面的示例使用WriteXml方法来编写 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

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请mode将参数WriteSchema设置为。To write both data and schema, set the mode parameter to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

安全性

FileIOPermission
用于读取和写入文件。for reading and writing files. 关联的枚举:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

另请参阅

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

使用指定的 TextWriterXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo 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);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)

参数

writer
TextWriter TextWriter TextWriter TextWriter

TextWriter 对象用于写文档。A TextWriter object used to write the document.

示例

下面的示例首先创建一个简单DataSet的, DataTable其中包含一个、两个列和10个行。The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. 通过调用方法将DataSet架构和数据写入磁盘。 WriteXmlThe DataSet schema and data are written to disk by invoking the WriteXml method. 将创建DataSet第二个ReadXml ,并使用方法来填充架构和数据。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

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请mode将参数WriteSchema设置为。To write both data and schema, set the mode parameter to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

使用指定的 StreamXmlWriteMode 写入 DataSet 的当前数据和架构(可选)。Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. 若要写入架构,请将 mode 参数的值设置为 WriteSchemaTo 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);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit

参数

stream
Stream Stream Stream Stream

用于写入文件的 Stream 对象。A Stream object used to write to a file.

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请mode将参数WriteSchema设置为。To write both data and schema, set the mode parameter to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

DataSet 的当前数据写入指定的文件。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)

参数

fileName
String String String String

要向其写入的文件的名称(包括路径)。The file name (including the path) to which to write.

异常

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请使用包含mode参数的重载之一,并将其值设置为。 WriteSchemaTo write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

安全性

FileIOPermission
用于读取和写入文件。for reading and writing files. 关联的枚举:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

另请参阅

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

使用指定的 DataSetTextWriter 写当前数据。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);
member this.WriteXml : System.IO.TextWriter -> unit
Public Sub WriteXml (writer As TextWriter)

参数

writer
TextWriter TextWriter TextWriter TextWriter

要进行写入的 TextWriter 对象。The TextWriter object with which to write.

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请使用包含mode参数的重载之一,并将其值设置为。 WriteSchemaTo write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

DataSet 的当前数据写入指定的 XmlWriterWrites the current data for the DataSet to the specified XmlWriter.

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)

参数

writer
XmlWriter XmlWriter XmlWriter XmlWriter

用于写入的 XmlWriterThe XmlWriter with which to write.

实现

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请使用包含mode参数的重载之一,并将其值设置为。 WriteSchemaTo write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

使用指定的 DataSetStream 写当前数据。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);
member this.WriteXml : System.IO.Stream -> unit

参数

stream
Stream Stream Stream Stream

用于写入文件的 Stream 对象。A Stream object used to write to a file.

示例

下面的示例创建一个System.IO.FileStream对象。The following example creates a System.IO.FileStream object. 然后,将对象与WriteXml方法一起使用以写入 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

注解

方法提供了一种方法,用于将数据(或中的DataSet数据和架构)写入WriteXmlSchema XML 文档,而方法只写入架构。 WriteXmlThe 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. 若要同时编写数据和架构,请使用包含mode参数的重载之一,并将其值设置为。 WriteSchemaTo write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

请注意,对于ReadXmlReadXmlSchema方法也是如此。Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. 若要将 XML 数据或架构和数据读入到DataSet中,请ReadXml使用方法。To read XML data, or both schema and data into the DataSet, use the ReadXml method. 若要仅读取架构,请使用ReadXmlSchema方法。To read just the schema, use the ReadXmlSchema method.

备注

如果在中读取或写入的DataRow列类型实现IDynamicMetaObjectProvider且不实现IXmlSerializable,则将引发。InvalidOperationExceptionAn InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

另请参阅

适用于