Leer en inglés

Compartir a través de


DataSet.WriteXml Método

Definición

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
Source:
DataSet.cs
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);

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();
}

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(String, XmlWriteMode)

Source:
DataSet.cs
Source:
DataSet.cs
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 (string fileName, System.Data.XmlWriteMode mode);

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

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);
}

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(TextWriter, XmlWriteMode)

Source:
DataSet.cs
Source:
DataSet.cs
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);

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();
        }
    }
}

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(Stream, XmlWriteMode)

Source:
DataSet.cs
Source:
DataSet.cs
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);

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(String)

Source:
DataSet.cs
Source:
DataSet.cs
Source:
DataSet.cs

Escribe los datos actuales del DataSet en el archivo especificado.

public void WriteXml (string fileName);

Parámetros

fileName
String

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

Excepciones

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(TextWriter)

Source:
DataSet.cs
Source:
DataSet.cs
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);

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(XmlWriter)

Source:
DataSet.cs
Source:
DataSet.cs
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);

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(Stream)

Source:
DataSet.cs
Source:
DataSet.cs
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);

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);
}

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

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1