DataTable.WriteXml DataTable.WriteXml DataTable.WriteXml DataTable.WriteXml Method

Définition

Écrit le contenu actuel du DataTable au format XML.Writes the current contents of the DataTable as XML.

Surcharges

WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de TextWriter spécifié.Writes the current contents of the DataTable as XML using the specified TextWriter. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des TextWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide du fichier et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable dans le fichier spécifié à l'aide du XmlWriteMode spécifié.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de XmlWriter spécifié.Writes the current contents of the DataTable as XML using the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des XmlWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable dans le fichier spécifié à l'aide du XmlWriteMode spécifié.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des TextWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean)

Écrit le contenu actuel du DataTable au format XML à l'aide du fichier spécifié.Writes the current contents of the DataTable as XML using the specified file. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(Stream, Boolean) WriteXml(Stream, Boolean) WriteXml(Stream, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de Stream spécifié.Writes the current contents of the DataTable as XML using the specified Stream. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des XmlWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Écrit le contenu actuel du DataTable au format XML à l'aide du fichier spécifié.Writes the current contents of the DataTable as XML using the specified file.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de TextWriter spécifié.Writes the current contents of the DataTable as XML using the specified TextWriter.

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de Stream spécifié.Writes the current contents of the DataTable as XML using the specified Stream.

WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide du fichier et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de XmlWriter spécifié.Writes the current contents of the DataTable as XML using the specified XmlWriter.

Exemples

L’application console suivante crée deux DataTable instances, ajoute chacune à un DataSet, crée un DataRelation associant les deux tables, puis utilise la WriteXml méthode pour écrire les données contenues dans la table parente dans un TextWriter.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. L’exemple illustre le comportement lors de la writeHierarchy définition du paramètre sur chacune de ses valeurs.The example demonstrates the behavior when setting the writeHierarchy parameter to each of its values.

Notes

Cet exemple montre comment utiliser l’une des versions surchargées de WriteXml.This example shows how to use one of the overloaded versions of WriteXml. Pour obtenir d’autres exemples qui peuvent être disponibles, consultez les rubriques sur les surcharges individuelles.For other examples that might be available, see the individual overload topics.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
    PrintOutput(writer, "Customer table, without hierarchy");

    writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter writer, string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(writer.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
  PrintOutput(writer, "Customer table, without hierarchy")

  writer = New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal writer As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(writer.ToString())
End Sub

L'exemple affiche la sortie suivante dans la fenêtre de console :The example displays the following output in the console window:

==============================  
Customer table, without hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
</NewDataSet>  
==============================  
Customer table, with hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
          <xs:element name="Table2">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="OrderID" type="xs:int" />  
                <xs:element name="CustomerID" type="xs:int" minOccurs="0" />  
                <xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />  
  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
      <xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m  
sdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="OrderID" />  
      </xs:unique>  
      <xs:keyref name="CustomerOrder" refer="Constraint1">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="CustomerID" />  
      </xs:keyref>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
  <Table2>  
    <OrderID>1</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>2</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>3</OrderID>  
    <CustomerID>2</CustomerID>  
    <OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>4</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>5</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>6</OrderID>  
    <CustomerID>4</CustomerID>  
    <OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
</NewDataSet>  

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de TextWriter spécifié.Writes the current contents of the DataTable as XML using the specified TextWriter. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::TextWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter writer, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * bool -> unit
Public Sub WriteXml (writer As TextWriter, writeHierarchy As Boolean)

Paramètres

writer
TextWriter TextWriter TextWriter TextWriter

TextWriter avec lequel écrire le contenu.The TextWriter with which to write the content.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Exemples

L’application console suivante crée deux DataTable instances, ajoute chacune à un DataSet, crée un DataRelation associant les deux tables, puis utilise la WriteXml méthode pour écrire les données contenues dans la table parente dans un TextWriter.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. L’exemple illustre le comportement lors de la writeHierarchy définition du trueparamètre sur.The example demonstrates the behavior when setting the writeHierarchy parameter to true.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter stream, 
    string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(stream.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal stream As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(stream.ToString())
End Sub

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table en cours et de toutes ses tables connexes, appelez la méthode avec le writeHierarchy paramètre défini sur true.To write the data for the current table and all its descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des TextWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to 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 TextWriter TextWriter TextWriter

TextWriter utilisé pour écrire le document.The TextWriter used to write the document.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de XmlWriteMode.One of the XmlWriteMode values.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide du fichier et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to 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 String String String

Nom du fichier dans lequel les données seront écrites.The name of the file to which the data will be written.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.One of the XmlWriteMode values.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable dans le fichier spécifié à l'aide du XmlWriteMode spécifié.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to 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

Paramètres

stream
Stream Stream Stream Stream

Flux de données dans lequel les données seront écrites.The stream to which the data will be written.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de XmlWriteMode.One of the XmlWriteMode values.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de XmlWriter spécifié.Writes the current contents of the DataTable as XML using the specified XmlWriter.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter writer, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * bool -> unit
Public Sub WriteXml (writer As XmlWriter, writeHierarchy As Boolean)

Paramètres

writer
XmlWriter XmlWriter XmlWriter XmlWriter

XmlWriter à l'aide duquel écrire le contenu.The XmlWriter with which to write the contents.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, writeHierarchy appelez la méthode trueavec le paramètre défini sur.To write the data for the current table and its entire descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des XmlWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to 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 XmlWriter XmlWriter XmlWriter

XmlWriter utilisé pour écrire le document.The XmlWriter used to write the document.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de XmlWriteMode.One of the XmlWriteMode values.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable dans le fichier spécifié à l'aide du XmlWriteMode spécifié.Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode * bool -> unit

Paramètres

stream
Stream Stream Stream Stream

Flux de données dans lequel les données seront écrites.The stream to which the data will be written.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de XmlWriteMode.One of the XmlWriteMode values.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, la WriteXml méthode enregistre les données uniquement pour la table actuelle.Normally, the WriteXml method saves data only for the current table. La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, appelez writeHierarchy la méthode avec truele paramètre défini sur.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des TextWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

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

Paramètres

writer
TextWriter TextWriter TextWriter TextWriter

TextWriter utilisé pour écrire le document.The TextWriter used to write the document.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.One of the XmlWriteMode values.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Exemples

L’application console suivante crée deux DataTable instances, ajoute chacune à un DataSet, crée un DataRelation associant les deux tables, puis utilise la WriteXml méthode pour écrire les données contenues dans la table parente dans un TextWriter.The following console application creates two DataTable instances, adds each to a DataSet, creates a DataRelation relating the two tables, and then uses the WriteXml method to write the data contained within the parent table to a TextWriter. L’exemple illustre le comportement lors de la writeHierarchy définition du paramètre sur chacune de ses valeurs.The example demonstrates the behavior when setting the writeHierarchy parameter to each of its values.

static void Main()
{
    DataSet ds = new DataSet();
    DataTable customerTable = GetCustomers();
    DataTable orderTable = GetOrders();

    ds.Tables.Add(customerTable);
    ds.Tables.Add(orderTable);
    ds.Relations.Add("CustomerOrder",
        new DataColumn[] { customerTable.Columns[0] },
        new DataColumn[] { orderTable.Columns[1] }, true);

    System.IO.StringWriter writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
    PrintOutput(writer, "Customer table, without hierarchy");

    writer = new System.IO.StringWriter();
    customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
    PrintOutput(writer, "Customer table, with hierarchy");

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
    table.Columns.Add("Name", typeof(System.String));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetOrders()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create three columns; OrderID, CustomerID, and OrderDate.
    table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
    table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));

    // Set the OrderID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { table.Columns[0] };

    table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
    table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
    table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
    table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
    table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
    table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
    table.AcceptChanges();
    return table;
}

private static void PrintOutput(System.IO.TextWriter writer, 
    string caption)
{
    Console.WriteLine("==============================");
    Console.WriteLine(caption);
    Console.WriteLine("==============================");
    Console.WriteLine(writer.ToString());
}
Sub Main()
  Dim ds As New DataSet
  Dim customerTable As DataTable = GetCustomers()
  Dim orderTable As DataTable = GetOrders()

  ds.Tables.Add(customerTable)
  ds.Tables.Add(orderTable)
  ds.Relations.Add("CustomerOrder", _
   New DataColumn() {customerTable.Columns(0)}, _
   New DataColumn() {orderTable.Columns(1)}, True)

  Dim writer As New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
  PrintOutput(writer, "Customer table, without hierarchy")

  writer = New System.IO.StringWriter
  customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
  PrintOutput(writer, "Customer table, with hierarchy")

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetOrders() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create three columns, OrderID, CustomerID, and OrderDate.
  table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
  table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))

  ' Set the OrderID column as the primary key column.
  table.PrimaryKey = New DataColumn() {table.Columns(0)}

  table.Rows.Add(New Object() {1, 1, #12/2/2003#})
  table.Rows.Add(New Object() {2, 1, #1/3/2004#})
  table.Rows.Add(New Object() {3, 2, #11/13/2004#})
  table.Rows.Add(New Object() {4, 3, #5/16/2004#})
  table.Rows.Add(New Object() {5, 3, #5/22/2004#})
  table.Rows.Add(New Object() {6, 4, #6/15/2004#})
  table.AcceptChanges()
  Return table
End Function

Private Function GetCustomers() As DataTable
  ' Create sample Customers table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID", _
      GetType(System.Int32))
  table.Columns.Add("Name", GetType(System.String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {1, "Mary"})
  table.Rows.Add(New Object() {2, "Andy"})
  table.Rows.Add(New Object() {3, "Peter"})
  table.Rows.Add(New Object() {4, "Russ"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintOutput( _
   ByVal writer As System.IO.TextWriter, ByVal caption As String)

  Console.WriteLine("==============================")
  Console.WriteLine(caption)
  Console.WriteLine("==============================")
  Console.WriteLine(writer.ToString())
End Sub

L'exemple affiche la sortie suivante dans la fenêtre de console :The example displays the following output in the console window:

==============================  
Customer table, without hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
</NewDataSet>  
==============================  
Customer table, with hierarchy  
==============================  
<NewDataSet>  
  <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema  
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
    <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">  
      <xs:complexType>  
        <xs:choice minOccurs="0" maxOccurs="unbounded">  
          <xs:element name="Table1">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="ID" type="xs:int" />  
                <xs:element name="Name" type="xs:string" minOccurs="0" />  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
          <xs:element name="Table2">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element name="OrderID" type="xs:int" />  
                <xs:element name="CustomerID" type="xs:int" minOccurs="0" />  
                <xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />  
  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:choice>  
      </xs:complexType>  
      <xs:unique name="Constraint1" msdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table1" />  
        <xs:field xpath="ID" />  
      </xs:unique>  
      <xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m  
sdata:PrimaryKey="true">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="OrderID" />  
      </xs:unique>  
      <xs:keyref name="CustomerOrder" refer="Constraint1">  
        <xs:selector xpath=".//Table2" />  
        <xs:field xpath="CustomerID" />  
      </xs:keyref>  
    </xs:element>  
  </xs:schema>  
  <Table1>  
    <ID>1</ID>  
    <Name>Mary</Name>  
  </Table1>  
  <Table1>  
    <ID>2</ID>  
    <Name>Andy</Name>  
  </Table1>  
  <Table1>  
    <ID>3</ID>  
    <Name>Peter</Name>  
  </Table1>  
  <Table1>  
    <ID>4</ID>  
    <Name>Russ</Name>  
  </Table1>  
  <Table2>  
    <OrderID>1</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>2</OrderID>  
    <CustomerID>1</CustomerID>  
    <OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>3</OrderID>  
    <CustomerID>2</CustomerID>  
    <OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>4</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>5</OrderID>  
    <CustomerID>3</CustomerID>  
    <OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
  <Table2>  
    <OrderID>6</OrderID>  
    <CustomerID>4</CustomerID>  
    <OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>  
  </Table2>  
</NewDataSet>  

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, la WriteXml méthode enregistre les données uniquement pour la table actuelle.Normally, the WriteXml method saves data only for the current table. La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, appelez writeHierarchy la méthode avec truele paramètre défini sur.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean)

Écrit le contenu actuel du DataTable au format XML à l'aide du fichier spécifié.Writes the current contents of the DataTable as XML using the specified file. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

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

Paramètres

fileName
String String String String

Fichier dans lequel écrire les données XML.The file to which to write the XML data.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, appelez writeHierarchy la méthode avec truele paramètre défini sur.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(Stream, Boolean) WriteXml(Stream, Boolean) WriteXml(Stream, Boolean)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de Stream spécifié.Writes the current contents of the DataTable as XML using the specified Stream. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::IO::Stream ^ stream, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * bool -> unit

Paramètres

stream
Stream Stream Stream Stream

Flux de données dans lequel les données seront écrites.The stream to which the data will be written.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

Utilisez la WriteXmlSchema méthode pour écrire le schéma d’un DataTable dans un document XML.Use the WriteXmlSchema method to write the schema for a DataTable to an XML document. Le schéma comprend des définitions de tables, de relations et de contraintes.The schema includes table, relation, and constraint definitions.

Le schéma XML est écrit à l’aide de la norme XSD.The XML schema is written using the XSD standard.

Pour écrire les données dans un document XML, utilisez la WriteXml méthode.To write the data to an XML document, use the WriteXml method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, appelez writeHierarchy la méthode avec truele paramètre défini sur.To write the data for the current table and all of its descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide des XmlWriter et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

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

Paramètres

writer
XmlWriter XmlWriter XmlWriter XmlWriter

XmlWriter utilisé pour écrire le document.The XmlWriter used to write the document.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de XmlWriteMode.One of the XmlWriteMode values.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table actuelle et de l’ensemble de ses descendants, les tables associées, writeHierarchy appelez la méthode trueavec le paramètre défini sur.To write the data for the current table and its entire descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Écrit le contenu actuel du DataTable au format XML à l'aide du fichier spécifié.Writes the current contents of the DataTable as XML using the specified file.

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 String String String

Fichier dans lequel écrire les données XML.The file to which to write the XML data.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de TextWriter spécifié.Writes the current contents of the DataTable as XML using the specified TextWriter.

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 TextWriter TextWriter TextWriter

TextWriter avec lequel écrire le contenu.The TextWriter with which to write the content.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de Stream spécifié.Writes the current contents of the DataTable as XML using the specified Stream.

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

Paramètres

stream
Stream Stream Stream Stream

Flux de données dans lequel les données seront écrites.The stream to which the data will be written.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le paramètre et affectez-lui la XmlWriteMode WriteSchemavaleur.To write both data and schema, use one of the overloads that includes the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean)

Écrit les données en cours, et éventuellement le schéma, de DataTable à l'aide du fichier et XmlWriteMode spécifiés.Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema. Pour enregistrer les données pour la table et tous ses descendants, affectez au paramètre writeHierarchy la valeur true.To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

public:
 void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (string fileName, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : string * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode, writeHierarchy As Boolean)

Paramètres

fileName
String String String String

Nom du fichier dans lequel les données seront écrites.The name of the file to which the data will be written.

mode
XmlWriteMode XmlWriteMode XmlWriteMode XmlWriteMode

Une des valeurs de l'objet XmlWriteMode.One of the XmlWriteMode values.

writeHierarchy
Boolean Boolean Boolean Boolean

Si true, écrivez le contenu de la table en cours et de tous ses descendants.If true, write the contents of the current table and all its descendants. Si false (valeur par défaut), écrivez les données pour la table en cours uniquement.If false (the default value), write the data for the current table only.

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, la WriteXml méthode enregistre les données uniquement pour la table actuelle.Normally, the WriteXml method saves data only for the current table. Si vous souhaitez enregistrer les données de la table actuelle et de la totalité du schéma, WriteXml la méthode permet d’écrire des données uniquement, ou à la fois les données et le DataTable schéma d’un dans un document XML WriteXmlSchema , tandis que la méthode écrit uniquement le schéma.If you want to save the data for the current table and all of schema, the WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Normalement, WriteXml la méthode écrit les données uniquement pour la table actuelle.Normally the WriteXml method writes the data only for the current table. Pour écrire les données de la table en cours et de toutes les tables liées descendantes, appelez la writeHierarchy méthode avec le trueparamètre défini sur.To write the data for the current table and all descendant, related tables, call the method with the writeHierarchy parameter set to true.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Écrit le contenu actuel de l’objet DataTable sous forme XML à l’aide de XmlWriter spécifié.Writes the current contents of the DataTable as XML using the specified 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 XmlWriter XmlWriter XmlWriter

XmlWriter à l'aide duquel écrire le contenu.The XmlWriter with which to write the contents.

Implémente

Remarques

La WriteXml méthode permet d’écrire des données uniquement, ou à la fois les données et le schéma DataTable d’un dans un document XML, WriteXmlSchema tandis que la méthode écrit uniquement le schéma.The WriteXml method provides a way to write either data only, or both data and schema from a DataTable into an XML document, whereas the WriteXmlSchema method writes only the schema. Pour écrire à la fois les données et le schéma, utilisez l’une des surcharges qui incluent le XmlWriteMode paramètre et affectez-lui la WriteSchemavaleur.To write both data and schema, use one of the overloads that include the XmlWriteMode parameter, and set its value to WriteSchema.

Notez que c’est également le cas pour ReadXml les ReadXmlSchema méthodes et, respectivement.Note that the same is true for the ReadXml and ReadXmlSchema methods, respectively. Pour lire des données XML, ou à la fois le DataTableschéma et les données dans, utilisez la ReadXml méthode.To read XML data, or both schema and data into the DataTable, use the ReadXml method. Pour lire uniquement le schéma, utilisez la ReadXmlSchema méthode.To read just the schema, use the ReadXmlSchema method.

Notes

Une InvalidOperationException est levée si un type de colonne dans le DataRow lu à partir de IDynamicMetaObjectProvider ou écrit pour implémente et n’implémente IXmlSerializablepas.An InvalidOperationException will be thrown if a column type in the DataRow being read from or written to implements IDynamicMetaObjectProvider and does not implement IXmlSerializable.

Voir aussi

S’applique à