DataSet.WriteXml Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Escribe datos XML y, opcionalmente, el esquema, desde el DataSet.

Sobrecargas

WriteXml(XmlWriter, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el XmlWriter especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
WriteXml(String, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet en el archivo especificado mediante el XmlWriteModeespecificado. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
WriteXml(TextWriter, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el TextWriter especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
WriteXml(Stream, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el Stream especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
WriteXml(String)	Escribe los datos actuales del DataSet en el archivo especificado.
WriteXml(TextWriter)	Escribe los datos actuales de la DataSet mediante el TextWriterespecificado.
WriteXml(XmlWriter)	Escribe los datos actuales de la DataSet en el XmlWriterespecificado.
WriteXml(Stream)	Escribe los datos actuales de la DataSet mediante el Streamespecificado.

WriteXml(XmlWriter, XmlWriteMode)

Source:

DataSet.cs

Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el XmlWriter especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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

La XmlWriter con la que se va a escribir.

mode

XmlWriteMode

Uno de los valores de XmlWriteMode.

Ejemplos

En el ejemplo siguiente se crea un objeto System.IO.FileStream que se usa para crear un nuevo XmlTextWriter. El objeto XmlTextWriter se usa con el método WriteXml para escribir un documento XML.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Create an XmlTextWriter with the fileStream.
    System.Xml.XmlTextWriter xmlWriter =
        new System.Xml.XmlTextWriter(stream,
        System.Text.Encoding.Unicode);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(xmlWriter);
    xmlWriter.Close();
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
    If thisDataSet Is Nothing Then
        Return
    End If

    ' Create a file name to write to.
    Dim filename As String = "XmlDoc.xml"

    ' Create the FileStream to write with.
    Dim stream As New System.IO.FileStream _
       (filename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter with the fileStream.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
       (stream, System.Text.Encoding.Unicode)

    ' Write to the file with the WriteXml method.
    thisDataSet.WriteXml(xmlWriter)
    xmlWriter.Close()
End Sub

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, establezca el parámetro mode en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(String, XmlWriteMode)

Source:

DataSet.cs

Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet en el archivo especificado mediante el XmlWriteModeespecificado. Para escribir el esquema, establezca el valor del parámetro mode en 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

Nombre de archivo (incluida la ruta de acceso) a la que se va a escribir.

mode

XmlWriteMode

Uno de los valores de XmlWriteMode.

Excepciones

SecurityException

FileIOPermission no se establece en Write.

Ejemplos

En el ejemplo siguiente se usa el método WriteXml para escribir un documento XML.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename);
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
    If thisDataSet Is Nothing Then
        Return
    End If

    ' Create a file name to write to.
    Dim filename As String = "XmlDoc.xml"

    ' Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename)
End Sub

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, establezca el parámetro mode en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(TextWriter, XmlWriteMode)

Source:

DataSet.cs

Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el TextWriter especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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

Objeto TextWriter usado para escribir el documento.

mode

XmlWriteMode

Uno de los valores de XmlWriteMode.

Ejemplos

En el ejemplo siguiente se crea primero un DataSet simple con una DataTable, dos columnas y diez filas. El esquema y los datos de DataSet se escriben en disco invocando el método WriteXml. Se crea un segundo DataSet y el método ReadXml se usa para rellenarlo con el esquema y los datos.

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 método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, establezca el parámetro mode en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(Stream, XmlWriteMode)

Source:

DataSet.cs

Escribe los datos actuales y, opcionalmente, el esquema, para el DataSet mediante el Stream especificado y XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en 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

Public Sub WriteXml (stream As Stream, mode As XmlWriteMode)

Parámetros

stream

Stream

Objeto Stream usado para escribir en un archivo.

mode

XmlWriteMode

Uno de los valores de XmlWriteMode.

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, establezca el parámetro mode en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(String)

Source:

DataSet.cs

Escribe los datos actuales del DataSet en el archivo especificado.

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

Nombre de archivo (incluida la ruta de acceso) a la que se va a escribir.

Excepciones

SecurityException

FileIOPermission no se establece en Write.

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, use una de las sobrecargas que incluye el parámetro mode y establezca su valor en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(TextWriter)

Source:

DataSet.cs

Escribe los datos actuales de la DataSet mediante el TextWriterespecificado.

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

Objeto TextWriter con el que se va a escribir.

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, use una de las sobrecargas que incluye el parámetro mode y establezca su valor en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(XmlWriter)

Source:

DataSet.cs

Escribe los datos actuales de la DataSet en el XmlWriterespecificado.

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

La XmlWriter con la que se va a escribir.

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, use una de las sobrecargas que incluye el parámetro mode y establezca su valor en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET

WriteXml(Stream)

Source:

DataSet.cs

Escribe los datos actuales de la DataSet mediante el Streamespecificado.

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)

Parámetros

stream

Stream

Objeto Stream usado para escribir en un archivo.

Ejemplos

En el ejemplo siguiente se crea un objeto System.IO.FileStream. A continuación, el objeto se usa con el método WriteXml para escribir un documento XML.

private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(stream);
}

Private Sub WriteXmlToFile(thisDataSet As DataSet)
     If thisDataSet Is Nothing Then
         Return
     End If 

    ' Create a file name to write to.
     Dim filename As String = "XmlDoc.xml"

     ' Create the FileStream to write with.
     Dim stream As New System.IO.FileStream _
        (filename, System.IO.FileMode.Create)

     ' Write to the file with the WriteXml method.
     thisDataSet.WriteXml(stream)
End Sub

Comentarios

El método WriteXml proporciona una manera de escribir solo datos, o tanto datos como esquemas de un DataSet en un documento XML, mientras que el método WriteXmlSchema escribe solo el esquema. Para escribir datos y esquemas, use una de las sobrecargas que incluye el parámetro mode y establezca su valor en WriteSchema.

Tenga en cuenta que lo mismo sucede con los métodos ReadXml y ReadXmlSchema, respectivamente. Para leer datos XML, o tanto el esquema como los datos en la DataSet, use el método ReadXml. Para leer solo el esquema, use el método ReadXmlSchema.

Nota

Se producirá un InvalidOperationException si un tipo de columna en el DataRow que se lee o se escribe para implementar IDynamicMetaObjectProvider y no implementa IXmlSerializable.

Consulte también

• usar conjuntos de datos en ADO.NET