DataSet.WriteXml Méthode

Définition

Espace de noms:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
WriteXml(XmlWriter, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées XmlWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur WriteSchema.
WriteXml(String, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour le DataSet fichier spécifié à l’aide du fichier spécifié XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur WriteSchema.
WriteXml(TextWriter, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées TextWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur WriteSchema.
WriteXml(Stream, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées Stream et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur WriteSchema.
WriteXml(String)

Écrit les données actuelles du DataSet fichier spécifié.
WriteXml(TextWriter)

Écrit les données actuelles pour l’utilisation DataSet de l’élément TextWriterspécifié.
WriteXml(XmlWriter)

Écrit les données actuelles pour le DataSet fichier spécifié XmlWriter.
WriteXml(Stream)

Écrit les données actuelles pour l’utilisation DataSet de l’élément Streamspécifié.

WriteXml(XmlWriter, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées XmlWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur 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)

Paramètres

writer
XmlWriter

Avec XmlWriter lequel écrire.

mode
XmlWriteMode

Une des XmlWriteMode valeurs.

Exemples

L’exemple suivant crée un System.IO.FileStream objet utilisé pour créer un objet XmlTextWriter. L’objet XmlTextWriter 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 uniquement des données ou des données et un schéma à partir d’un DataSet document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, définissez le mode paramètre sur WriteSchema.

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(String, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour le DataSet fichier spécifié à l’aide du fichier spécifié XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur 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)

Paramètres

fileName
String

Nom de fichier (y compris le chemin d’accès) auquel écrire.

mode
XmlWriteMode

Une des XmlWriteMode valeurs.

Exceptions

SecurityException

FileIOPermission n’est pas défini sur Write.

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 uniquement des données ou des données et un schéma à partir d’un DataSet document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, définissez le mode paramètre sur WriteSchema.

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(TextWriter, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées TextWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur 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)

Paramètres

writer
TextWriter

Objet TextWriter utilisé pour écrire le document.

mode
XmlWriteMode

Une des XmlWriteMode valeurs.

Exemples

L’exemple suivant crée 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 le 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 uniquement des données ou des données et un schéma à partir d’un DataSet document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire à la fois les données et le schéma, définissez le mode paramètre sur WriteSchema.

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(Stream, XmlWriteMode)

Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées Stream et XmlWriteMode. Pour écrire le schéma, définissez la valeur du mode paramètre sur 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)

Paramètres

stream
Stream

Objet Stream utilisé pour écrire dans un fichier.

mode
XmlWriteMode

Une des XmlWriteMode valeurs.

Remarques

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

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(String)

Écrit les données actuelles du DataSet 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 de fichier (y compris le chemin d’accès) auquel écrire.

Exceptions

SecurityException

FileIOPermission n’est pas défini sur Write.

Remarques

La WriteXml méthode permet d’écrire uniquement des données ou des données et un schéma à partir d’un DataSet 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 définissez sa valeur WriteSchemasur .

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(TextWriter)

Écrit les données actuelles pour l’utilisation DataSet de l’élément TextWriterspécifié.

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

Objet TextWriter avec lequel écrire.

Remarques

La WriteXml méthode permet d’écrire uniquement des données ou des données et un schéma à partir d’un DataSet 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 définissez sa valeur WriteSchemasur .

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(XmlWriter)

Écrit les données actuelles pour le DataSet fichier spécifié 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)

Paramètres

writer
XmlWriter

Avec XmlWriter lequel écrire.

Remarques

La WriteXml méthode permet d’écrire uniquement des données ou des données et un schéma à partir d’un DataSet 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 définissez sa valeur WriteSchemasur .

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à

WriteXml(Stream)

Écrit les données actuelles pour l’utilisation DataSet de l’élément Streamspécifié.

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 System.IO.FileStream objet. 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 uniquement des données ou des données et un schéma à partir d’un DataSet 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 définissez sa valeur WriteSchemasur .

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

Remarque

Une InvalidOperationException exception est levée si un type de colonne dans l’objet DataRow lu ou écrit pour implémenter IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .

Voir aussi

S’applique à