DataSet.WriteXml Méthode

Définition

Écrit des données XML, et éventuellement le schéma, à partir du DataSet.

Surcharges

WriteXml(XmlWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des XmlWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(String, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet dans le fichier spécifié à l'aide du XmlWriteMode spécifié. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(TextWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des TextWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(Stream, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des Stream et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(String)

Écrit les données en cours de DataSet dans le fichier spécifié.

WriteXml(TextWriter)

Écrit les données en cours de DataSet à l'aide du TextWriter spécifié.

WriteXml(XmlWriter)

Écrit les données en cours de DataSet dans le XmlWriter spécifié.

WriteXml(Stream)

Écrit les données en cours de DataSet à l'aide du Stream spécifié.

WriteXml(XmlWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des XmlWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.Xml.XmlWriter? writer, System.Data.XmlWriteMode mode);
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)

Paramètres

writer
XmlWriter

XmlWriter à l'aide duquel effectuer l'écriture.

mode
XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.

Exemples

L’exemple suivant crée un System.IO.FileStream objet qui est utilisé pour créer un nouveau XmlTextWriter . L' XmlTextWriter objet est utilisé avec la WriteXml méthode pour écrire un document 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

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, affectez au paramètre la valeur mode WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(String, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet dans le fichier spécifié à l'aide du XmlWriteMode spécifié. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

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)

Paramètres

fileName
String

Nom du fichier (chemin d'accès inclus) dans lequel effectuer l'écriture.

mode
XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.

Exceptions

Exemples

L’exemple suivant utilise la WriteXml méthode pour écrire un document 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

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, affectez au paramètre la valeur mode WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(TextWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des TextWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

public:
 void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.TextWriter? writer, System.Data.XmlWriteMode mode);
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)

Paramètres

writer
TextWriter

Objet TextWriter utilisé pour écrire le document.

mode
XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.

Exemples

L’exemple suivant crée tout d’abord un simple DataSet avec une DataTable , deux colonnes et dix lignes. Le DataSet schéma et les données sont écrits sur le disque en appelant la WriteXml méthode. Une seconde DataSet est créée et la ReadXml méthode est utilisée pour la remplir avec le schéma et les données.

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

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, affectez au paramètre la valeur mode WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(Stream, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des Stream et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.Stream? stream, System.Data.XmlWriteMode mode);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode)

Paramètres

stream
Stream

Objet Stream utilisé pour écrire dans un fichier.

mode
XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, affectez au paramètre la valeur mode WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(String)

Écrit les données en cours de DataSet dans le fichier spécifié.

public:
 void WriteXml(System::String ^ fileName);
public void WriteXml (string fileName);
member this.WriteXml : string -> unit
Public Sub WriteXml (fileName As String)

Paramètres

fileName
String

Nom du fichier (chemin d'accès inclus) dans lequel effectuer l'écriture.

Exceptions

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le mode paramètre et affectez-lui la valeur WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(TextWriter)

Écrit les données en cours de DataSet à l'aide du TextWriter spécifié.

public:
 void WriteXml(System::IO::TextWriter ^ writer);
public void WriteXml (System.IO.TextWriter? writer);
public void WriteXml (System.IO.TextWriter writer);
member this.WriteXml : System.IO.TextWriter -> unit
Public Sub WriteXml (writer As TextWriter)

Paramètres

writer
TextWriter

ObjetTextWriter avec lequel écrire.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le mode paramètre et affectez-lui la valeur WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(XmlWriter)

Écrit les données en cours de DataSet dans le XmlWriter spécifié.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);
public void WriteXml (System.Xml.XmlWriter? writer);
public void WriteXml (System.Xml.XmlWriter writer);
member this.WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)

Paramètres

writer
XmlWriter

XmlWriter à l'aide duquel effectuer l'écriture.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le mode paramètre et affectez-lui la valeur WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à

WriteXml(Stream)

Écrit les données en cours de DataSet à l'aide du Stream spécifié.

public:
 void WriteXml(System::IO::Stream ^ stream);
public void WriteXml (System.IO.Stream? stream);
public void WriteXml (System.IO.Stream stream);
member this.WriteXml : System.IO.Stream -> unit
Public Sub WriteXml (stream As Stream)

Paramètres

stream
Stream

Objet Stream utilisé pour écrire dans un fichier.

Exemples

L'exemple suivant crée un objet System.IO.FileStream. L’objet est ensuite utilisé avec la WriteXml méthode pour écrire un document 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

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le mode paramètre et affectez-lui la valeur WriteSchema .

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement. Pour lire des données XML, ou à la fois le schéma et les données dans DataSet , utilisez la ReadXml méthode. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de ou écrit pour implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable .

Voir aussi

S’applique à