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

Definición

Escribe datos XML y, de forma opcional, el esquema del DataSet.Writes XML data, and optionally the schema, from the DataSet.

Sobrecargas

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto XmlWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet en el archivo indicado mediante la enumeración XmlWriteMode especificada.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto TextWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto Stream y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Escribe los datos actuales para el DataSet en el archivo especificado.Writes the current data for the DataSet to the specified file.

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

Escribe los datos actuales para el objeto DataSet mediante el objeto TextWriter especificado.Writes the current data for the DataSet using the specified TextWriter.

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

Escribe los datos actuales para el DataSet en el XmlWriter especificado.Writes the current data for the DataSet to the specified XmlWriter.

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

Escribe los datos actuales para el objeto DataSet mediante el objeto Stream especificado.Writes the current data for the DataSet using the specified Stream.

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto XmlWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)

Parámetros

writer
XmlWriter XmlWriter XmlWriter XmlWriter

XmlWriter con el que se va a escribir.The XmlWriter with which to write.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Uno de los valores de XmlWriteMode.One of the XmlWriteMode values.

Ejemplos

En el ejemplo siguiente se System.IO.FileStream crea un objeto que se usa para crear XmlTextWriterun nuevo.The following example creates a System.IO.FileStream object that is used to create a new XmlTextWriter. El XmlTextWriter objeto se utiliza con el WriteXml método para escribir un documento 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

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, establezca mode el parámetro WriteSchemaen.To write both data and schema, set the mode parameter to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet en el archivo indicado mediante la enumeración XmlWriteMode especificada.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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)

Parámetros

fileName
String String String String

Nombre del archivo (incluida la ruta) en el que se va a escribir.The file name (including the path) to which to write.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Uno de los valores de XmlWriteMode.One of the XmlWriteMode values.

Excepciones

Ejemplos

En el ejemplo siguiente se WriteXml usa el método para escribir un documento 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

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, establezca mode el parámetro WriteSchemaen.To write both data and schema, set the mode parameter to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Seguridad

FileIOPermission
para leer y escribir archivos.for reading and writing files. Enumeración asociada:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Consulte también:

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto TextWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)

Parámetros

writer
TextWriter TextWriter TextWriter TextWriter

Objeto TextWriter que se utiliza para escribir el documento.A TextWriter object used to write the document.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Uno de los valores de XmlWriteMode.One of the XmlWriteMode values.

Ejemplos

En el ejemplo siguiente se crea primero DataSet un simple DataTablecon una, dos columnas y diez filas.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. El DataSet esquema y los datos se escriben en el disco mediante WriteXml la invocación del método.The DataSet schema and data are written to disk by invoking the WriteXml method. Se crea DataSet un segundo y el ReadXml método se usa para rellenarlo con el esquema y los datos.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

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, establezca mode el parámetro WriteSchemaen.To write both data and schema, set the mode parameter to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

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

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto Stream y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit

Parámetros

stream
Stream Stream Stream Stream

Objeto Stream utilizado para escribir en un archivo.A Stream object used to write to a file.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Uno de los valores de XmlWriteMode.One of the XmlWriteMode values.

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, establezca mode el parámetro WriteSchemaen.To write both data and schema, set the mode parameter to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

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

Escribe los datos actuales para el DataSet en el archivo especificado.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)

Parámetros

fileName
String String String String

Nombre del archivo (incluida la ruta) en el que se va a escribir.The file name (including the path) to which to write.

Excepciones

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, use una de las sobrecargas que incluye mode el parámetro y establezca su valor en WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Seguridad

FileIOPermission
para leer y escribir archivos.for reading and writing files. Enumeración asociada:FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Consulte también:

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

Escribe los datos actuales para el objeto DataSet mediante el objeto TextWriter especificado.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)

Parámetros

writer
TextWriter TextWriter TextWriter TextWriter

Objeto TextWriter con el que se va a escribir.The TextWriter object with which to write.

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, use una de las sobrecargas que incluye mode el parámetro y establezca su valor en WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

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

Escribe los datos actuales para el DataSet en el XmlWriter especificado.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);
member this.WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)

Parámetros

writer
XmlWriter XmlWriter XmlWriter XmlWriter

XmlWriter con el que se va a escribir.The XmlWriter with which to write.

Implementaciones

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, use una de las sobrecargas que incluye mode el parámetro y establezca su valor en WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

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

Escribe los datos actuales para el objeto DataSet mediante el objeto Stream especificado.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

Parámetros

stream
Stream Stream Stream Stream

Objeto Stream utilizado para escribir en un archivo.A Stream object used to write to a file.

Ejemplos

En el ejemplo siguiente se System.IO.FileStream crea un objeto.The following example creates a System.IO.FileStream object. Después, el objeto se utiliza con WriteXml el método para escribir un documento 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

Comentarios

El WriteXml método proporciona una manera de escribir solo datos, o bien datos y esquema de un DataSet en un documento XML, mientras que el WriteXmlSchema método solo escribe el esquema.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. Para escribir los datos y el esquema, use una de las sobrecargas que incluye mode el parámetro y establezca su valor en WriteSchema.To write both data and schema, use one of the overloads that includes the mode parameter, and set its value to WriteSchema.

Tenga en cuenta que lo mismo se aplica ReadXml a ReadXmlSchema los métodos y, respectivamente.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Para leer datos XML, o el DataSetesquema y los datos en, use el ReadXml método.To read XML data, or both schema and data into the DataSet, use the ReadXml method. Para leer solo el esquema, use el ReadXmlSchema método.To read just the schema, use the ReadXmlSchema method.

Nota

Se InvalidOperationException producirá una excepción si un tipo de columna DataRow en el que se lee IDynamicMetaObjectProvider o se escribe para implementa y no IXmlSerializableimplementa.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.

Consulte también:

Se aplica a