DataSet.WriteXml Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
É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 |
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 |
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 |
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 |
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)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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
- 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 .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 des données uniquement, ou des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, définissez le paramètre sur mode
WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(String, XmlWriteMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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
FileIOPermission n'a pas la valeur 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 des données uniquement, ou des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, définissez le paramètre sur mode
WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(TextWriter, XmlWriteMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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 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 des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, définissez le paramètre sur mode
WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(Stream, XmlWriteMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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
- mode
- XmlWriteMode
Une des valeurs de l'objet XmlWriteMode.
Remarques
La WriteXml
méthode permet d’écrire des données uniquement, ou des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, définissez le paramètre sur mode
WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(String)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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
FileIOPermission n'a pas la valeur Write.
Remarques
La WriteXml
méthode permet d’écrire des données uniquement, ou des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, utilisez l’une des surcharges qui inclut le mode
paramètre et définissez sa valeur sur WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(TextWriter)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
É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 des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, utilisez l’une des surcharges qui inclut le mode
paramètre et définissez sa valeur sur WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(XmlWriter)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
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
Remarques
La WriteXml
méthode permet d’écrire des données uniquement, ou des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, utilisez l’une des surcharges qui inclut le mode
paramètre et définissez sa valeur sur WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .
Voir aussi
S’applique à
WriteXml(Stream)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
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
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 des données et un schéma à partir d’un DataSet dans un document XML, tandis que la WriteXmlSchema méthode écrit uniquement le schéma. Pour écrire des données et un schéma, utilisez l’une des surcharges qui inclut le mode
paramètre et définissez sa valeur sur WriteSchema
.
Notez qu’il en va de même pour les ReadXml méthodes et ReadXmlSchema , respectivement. Pour lire des données XML, ou des schémas et des données dans , DataSet
utilisez la ReadXml
méthode . Pour lire uniquement le schéma, utilisez la ReadXmlSchema
méthode .
Notes
Un InvalidOperationException est levée si un type de colonne dans le DataRow
en cours de lecture ou d’écriture dans implémente IDynamicMetaObjectProvider et n’implémente IXmlSerializablepas .