DataTable.ReadXml DataTable.ReadXml DataTable.ReadXml DataTable.ReadXml Method

Définition

Lit le schéma et les données XML dans le DataTable.Reads XML schema and data into the DataTable.

Surcharges

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lit le schéma et les données XML dans le DataTable à l'aide du Stream spécifié.Reads XML schema and data into the DataTable using the specified Stream.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lit le schéma et les données XML dans le DataTable à l'aide du TextReader spécifié.Reads XML schema and data into the DataTable using the specified TextReader.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lit le schéma et les données XML dans le DataTable à partir du fichier spécifié.Reads XML schema and data into the DataTable from the specified file.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lit le schéma et les données XML dans le DataTable à l'aide du XmlReader spécifié.Reads XML Schema and Data into the DataTable using the specified XmlReader.

Remarques

La ReadXml méthode permet de lire les données uniquement, ou à la fois les données et le schéma DataTable dans un à partir d’un document ReadXmlSchema XML, tandis que la méthode lit uniquement le schéma.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez l’une ReadXML des surcharges qui incluent XmlReadMode le paramètre ReadSchemaet affectez-lui la valeur.To read both data and schema, use one of the ReadXML overloads that include the XmlReadMode parameter, and set its value to ReadSchema.

Notez que c’est également le cas pour WriteXml les WriteXmlSchema méthodes et, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou à la fois le schéma DataTableet les données WriteXml à partir du, utilisez la méthode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Pour écrire uniquement le schéma, utilisez la WriteXmlSchema méthode.To write just the schema, use the WriteXmlSchema 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.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lit le schéma et les données XML dans le DataTable à l'aide du Stream spécifié.Reads XML schema and data into the DataTable using the specified Stream.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Paramètres

stream
Stream Stream Stream Stream

Objet qui dérive de Stream.An object that derives from Stream

Retours

XmlReadMode utilisé pour lire les données.The XmlReadMode used to read the data.

Exemples

L’exemple suivant crée un DataTable contenant deux colonnes et dix lignes.The following example creates a DataTable containing two columns and ten rows. L’exemple écrit le DataTable schéma et les données dans un flux de mémoire, en appelant WriteXml la méthode.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. L’exemple crée une seconde DataTable et appelle la ReadXml méthode pour la remplir avec le schéma et les données.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithStream()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    newTable.ReadXml(xmlStream);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    // Display the contents of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithStream()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim newTable As New DataTable
  newTable.ReadXml(xmlStream)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, ByVal label As String)
  ' Display the contents of the supplied DataTable:
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Remarques

Le actuel DataTable et ses descendants sont chargés avec les données du fourni Stream.The current DataTable and its descendents are loaded with the data from the supplied Stream. Le comportement de cette méthode est identique à celui de la DataSet.ReadXml méthode, sauf que dans ce cas, les données sont chargées uniquement pour la table actuelle et ses descendants.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

La ReadXml méthode permet de lire les données uniquement, ou à la fois les données et le schéma DataTable dans un à partir d’un document ReadXmlSchema XML, tandis que la méthode lit uniquement le schéma.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Notez que c’est également le cas pour WriteXml les WriteXmlSchema méthodes et, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou à la fois le schéma DataTableet les données WriteXml à partir du, utilisez la méthode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Pour écrire uniquement le schéma, utilisez la WriteXmlSchema méthode.To write just the schema, use the WriteXmlSchema 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.

Si un schéma Inline est spécifié, le schéma Inline est utilisé pour étendre la structure relationnelle existante avant de charger les données.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. En cas de conflit (par exemple, la même colonne dans la même table définie avec des types de données différents), une exception est levée.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si aucun schéma inline n’est spécifié, la structure relationnelle est étendue à l’aide de l’inférence, si nécessaire, en fonction de la structure du document XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si le schéma ne peut pas être étendu par le biais de l’inférence afin d’exposer toutes les données, une exception est levée.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Notes

N’associe pas un élément XML à son correspondant DataColumn ou DataTable lorsque des caractères XML légaux tels que (« _ ») sont placés dans une séquence d’échappement dans le XML sérialisé. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("_") are escaped in the serialized XML. Le DataSet lui-même échappe uniquement les caractères XML illégaux dans les noms d’éléments XML et peut donc uniquement consommer le même.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque des caractères légaux dans le nom d’élément XML sont placés dans une séquence d’échappement, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Voir aussi

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lit le schéma et les données XML dans le DataTable à l'aide du TextReader spécifié.Reads XML schema and data into the DataTable using the specified TextReader.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode

Paramètres

reader
TextReader TextReader TextReader TextReader

TextReader qui sera utilisé pour lire les données.The TextReader that will be used to read the data.

Retours

XmlReadMode utilisé pour lire les données.The XmlReadMode used to read the data.

Exemples

L’exemple suivant crée un DataTable contenant deux colonnes et dix lignes.The following example creates a DataTable containing two columns and ten rows. L’exemple écrit le DataTable schéma et les données dans un flux de mémoire, en appelant WriteXml la méthode.The example writes the DataTable schema and data to a memory stream, by invoking the WriteXml method. L’exemple crée une seconde DataTable et appelle la ReadXml méthode pour la remplir avec le schéma et les données.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.IO.StreamReader reader = 
        new System.IO.StreamReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.IO.StreamReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Remarques

Le actuel DataTable et ses descendants sont chargés avec les données du fourni TextReader.The current DataTable and its descendents are loaded with the data from the supplied TextReader. Le comportement de cette méthode est identique à celui de la DataSet.ReadXml méthode, sauf que dans ce cas, les données sont chargées uniquement pour la table actuelle et ses descendants.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

La ReadXml méthode permet de lire les données uniquement, ou à la fois les données et le schéma DataTable dans un à partir d’un document ReadXmlSchema XML, tandis que la méthode lit uniquement le schéma.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Notez que c’est également le cas pour WriteXml les WriteXmlSchema méthodes et, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou à la fois le schéma DataTableet les données WriteXml à partir du, utilisez la méthode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Pour écrire uniquement le schéma, utilisez la WriteXmlSchema méthode.To write just the schema, use the WriteXmlSchema 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.

Si un schéma Inline est spécifié, le schéma Inline est utilisé pour étendre la structure relationnelle existante avant de charger les données.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. En cas de conflit (par exemple, la même colonne dans la même table définie avec des types de données différents), une exception est levée.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si aucun schéma inline n’est spécifié, la structure relationnelle est étendue à l’aide de l’inférence, si nécessaire, en fonction de la structure du document XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si le schéma ne peut pas être étendu par le biais de l’inférence afin d’exposer toutes les données, une exception est levée.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Notes

N’associe pas un élément XML à son correspondant DataColumn ou DataTable lorsque des caractères XML légaux tels que (« _ ») sont placés dans une séquence d’échappement dans le XML sérialisé. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("_") are escaped in the serialized XML. Le DataSet lui-même échappe uniquement les caractères XML illégaux dans les noms d’éléments XML et peut donc uniquement consommer le même.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque des caractères légaux dans le nom d’élément XML sont placés dans une séquence d’échappement, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Voir aussi

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lit le schéma et les données XML dans le DataTable à partir du fichier spécifié.Reads XML schema and data into the DataTable from the specified file.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
member this.ReadXml : string -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String) As XmlReadMode

Paramètres

fileName
String String String String

Nom du fichier à partir duquel lire les données.The name of the file from which to read the data.

Retours

XmlReadMode utilisé pour lire les données.The XmlReadMode used to read the data.

Exemples

L’exemple suivant crée un DataTable contenant deux colonnes et dix lignes.The following example creates a DataTable containing two columns and ten rows. L’exemple écrit le DataTable schéma et les données sur le disque.The example writes the DataTable schema and data to disk. L’exemple crée une seconde DataTable et appelle la ReadXml méthode pour la remplir avec le schéma et les données.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data.

private static void DemonstrateReadWriteXMLDocumentWithString()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    string fileName = "C:\\TestData.xml";
    table.WriteXml(fileName, XmlWriteMode.WriteSchema);

    DataTable newTable = new DataTable();
    newTable.ReadXml(fileName);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithString()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a file.
  Dim fileName As String = "C:\TestData.xml"
  table.WriteXml(fileName, XmlWriteMode.WriteSchema)

  Dim newTable As New DataTable
  newTable.ReadXml(fileName)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable

  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Remarques

Le actuel DataTable et ses descendants sont chargés avec les données du fichier nommé dans le fourni String.The current DataTable and its descendents are loaded with the data from the file named in the supplied String. Le comportement de cette méthode est identique à celui de la DataSet.ReadXml méthode, sauf que dans ce cas, les données sont chargées uniquement pour la table actuelle et ses descendants.The behavior of this method is identical to that of the DataSet.ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

La ReadXml méthode permet de lire les données uniquement, ou à la fois les données et le schéma DataTable dans un à partir d’un document ReadXmlSchema XML, tandis que la méthode lit uniquement le schéma.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Notez que c’est également le cas pour WriteXml les WriteXmlSchema méthodes et, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou à la fois le schéma DataTableet les données WriteXml à partir du, utilisez la méthode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Pour écrire uniquement le schéma, utilisez la WriteXmlSchema méthode.To write just the schema, use the WriteXmlSchema 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.

Si un schéma Inline est spécifié, le schéma Inline est utilisé pour étendre la structure relationnelle existante avant de charger les données.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. En cas de conflit (par exemple, la même colonne dans la même table définie avec des types de données différents), une exception est levée.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si aucun schéma inline n’est spécifié, la structure relationnelle est étendue à l’aide de l’inférence, si nécessaire, en fonction de la structure du document XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si le schéma ne peut pas être étendu par le biais de l’inférence afin d’exposer toutes les données, une exception est levée.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Notes

N’associe pas un élément XML à son correspondant DataColumn ou DataTable lorsque des caractères XML légaux tels que (« _ ») sont placés dans une séquence d’échappement dans le XML sérialisé. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("_") are escaped in the serialized XML. Le DataSet lui-même échappe uniquement les caractères XML illégaux dans les noms d’éléments XML et peut donc uniquement consommer le même.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque des caractères légaux dans le nom d’élément XML sont placés dans une séquence d’échappement, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

using System.Data;  
public class A {  
   static void Main(string[] args) {  
      DataTable tabl = new DataTable("mytable");  
      tabl.Columns.Add(new DataColumn("id", typeof(int)));  
      for (int i = 0; i < 10; i++) {  
         DataRow row = tabl.NewRow();  
         row["id"] = i;  
         tabl.Rows.Add(row);  
      }  
      tabl.WriteXml("f.xml", XmlWriteMode.WriteSchema);  
      DataTable newt = new DataTable();  
      newt.ReadXml("f.xml");  
   }  
}  
Voir aussi

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lit le schéma et les données XML dans le DataTable à l'aide du XmlReader spécifié.Reads XML Schema and Data into the DataTable using the specified XmlReader.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode

Paramètres

reader
XmlReader XmlReader XmlReader XmlReader

XmlReader qui sera utilisé pour lire les données.The XmlReader that will be used to read the data.

Retours

XmlReadMode utilisé pour lire les données.The XmlReadMode used to read the data.

Exemples

L’exemple suivant crée un DataTable contenant deux colonnes et dix lignes.The following example creates a DataTable containing two columns and ten rows. L’exemple écrit le DataTable schéma et les données dans XmlReaderun.The example writes the DataTable schema and data to an XmlReader. L’exemple crée une seconde DataTable et appelle la ReadXml méthode pour la remplir avec le schéma et les données XmlReader de l’instance.The example creates a second DataTable and calls the ReadXml method to fill it with schema and data from the XmlReader instance.

private static void DemonstrateReadWriteXMLDocumentWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintValues(table, "Original table");

    // Write the schema and data to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    System.Xml.XmlTextReader reader = 
        new System.Xml.XmlTextReader(xmlStream);
    DataTable newTable = new DataTable();
    newTable.ReadXml(reader);

    // Print out values in the table.
    PrintValues(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintValues(DataTable table, string label)
{
    Console.WriteLine(label);
    foreach (DataRow row in table.Rows)
    {
        foreach (DataColumn column in table.Columns)
        {
            Console.Write("\t{0}", row[column]);
        }
        Console.WriteLine();
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
  Dim table As DataTable = CreateTestTable("XmlDemo")
  PrintValues(table, "Original table")

  ' Write the schema and data to XML in a memory stream.
  Dim xmlStream As New System.IO.MemoryStream()
  table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)

  ' Rewind the memory stream.
  xmlStream.Position = 0

  Dim reader As New System.Xml.XmlTextReader(xmlStream)
  Dim newTable As New DataTable
  newTable.ReadXml(reader)

  ' Print out values in the table.
  PrintValues(newTable, "New Table")
End Sub

Private Function CreateTestTable(ByVal tableName As String) _
  As DataTable
  ' Create a test DataTable with two columns and a few rows.
  Dim table As New DataTable(tableName)
  Dim column As New DataColumn("id", GetType(System.Int32))
  column.AutoIncrement = True
  table.Columns.Add(column)

  column = New DataColumn("item", GetType(System.String))
  table.Columns.Add(column)

  ' Add ten rows.
  Dim row As DataRow
  For i As Integer = 0 To 9
    row = table.NewRow()
    row("item") = "item " & i
    table.Rows.Add(row)
  Next i

  table.AcceptChanges()
  Return table
End Function

Private Sub PrintValues(ByVal table As DataTable, _
  ByVal label As String)
  Console.WriteLine(label)
  For Each row As DataRow In table.Rows
    For Each column As DataColumn In table.Columns
      Console.Write("{0}{1}", ControlChars.Tab, row(column))
    Next column
    Console.WriteLine()
  Next row
End Sub

Remarques

Le actuel DataTable et ses descendants sont chargés avec les données du fichier nommé dans le fourni XmlReader.The current DataTable and its descendents are loaded with the data from the file named in the supplied XmlReader. Le comportement de cette méthode est identique à celui de la ReadXml méthode, sauf que dans ce cas, les données sont chargées uniquement pour la table actuelle et ses descendants.The behavior of this method is identical to that of the ReadXml method, except that in this case, data is loaded only for the current table and its descendants.

La ReadXml méthode permet de lire les données uniquement, ou à la fois les données et le schéma DataTable dans un à partir d’un document ReadXmlSchema XML, tandis que la méthode lit uniquement le schéma.The ReadXml method provides a way to read either data only, or both data and schema into a DataTable from an XML document, whereas the ReadXmlSchema method reads only the schema.

Notez que c’est également le cas pour WriteXml les WriteXmlSchema méthodes et, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou à la fois le schéma DataTableet les données WriteXml à partir du, utilisez la méthode.To write XML data, or both schema and data from the DataTable, use the WriteXml method. Pour écrire uniquement le schéma, utilisez la WriteXmlSchema méthode.To write just the schema, use the WriteXmlSchema 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.

Si un schéma Inline est spécifié, le schéma Inline est utilisé pour étendre la structure relationnelle existante avant de charger les données.If an in-line schema is specified, the in-line schema is used to extend the existing relational structure prior to loading the data. En cas de conflit (par exemple, la même colonne dans la même table définie avec des types de données différents), une exception est levée.If there are any conflicts (for example, the same column in the same table defined with different data types) an exception is raised.

Si aucun schéma inline n’est spécifié, la structure relationnelle est étendue à l’aide de l’inférence, si nécessaire, en fonction de la structure du document XML.If no in-line schema is specified, the relational structure is extended through inference, as necessary, according to the structure of the XML document. Si le schéma ne peut pas être étendu par le biais de l’inférence afin d’exposer toutes les données, une exception est levée.If the schema cannot be extended through inference in order to expose all data, an exception is raised.

Notes

N’associe pas un élément XML à son correspondant DataColumn ou DataTable lorsque des caractères XML légaux tels que (« _ ») sont placés dans une séquence d’échappement dans le XML sérialisé. DataSetThe DataSet does not associate an XML element with its corresponding DataColumn or DataTable when legal XML characters like ("_") are escaped in the serialized XML. Le DataSet lui-même échappe uniquement les caractères XML illégaux dans les noms d’éléments XML et peut donc uniquement consommer le même.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque des caractères légaux dans le nom d’élément XML sont placés dans une séquence d’échappement, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Voir aussi

S’applique à