DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml DataSet.ReadXml Method

Définition

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

Surcharges

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des XmlReader et XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide du fichier et du XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

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

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

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

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

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

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

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

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

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

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

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

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des XmlReader et XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

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

Paramètres

reader
XmlReader XmlReader XmlReader XmlReader

XmlReader dans lequel effectuer la lecture.The XmlReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

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

Retours

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

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut un targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide du fichier et du XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

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

Paramètres

fileName
String String String String

Nom du fichier (chemin d'accès inclus) à partir duquel effectuer la lecture.The filename (including the path) from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

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

Retours

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

Exceptions

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut un targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Sécurité

FileIOPermission
pour lire et écrire des fichiers.for reading and writing files. Énumération associée : FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Voir aussi

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

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

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

Paramètres

stream
Stream Stream Stream Stream

Stream dans lequel effectuer la lecture.The Stream from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

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

Retours

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

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Vaut également pour le WriteXml et WriteXmlSchema méthodes, respectivement.The same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Lorsque vous utilisez ReadXml et que vous définissez XmlReadMode à Diffgram, le contenu de la cible DataSet et la version d’origine DataSet peuvent différer en raison de la façon dont le diffgram est généré et traité.When you use ReadXml and you set XmlReadMode to Diffgram, the content of the target DataSet and the original DataSet may differ because of how the diffgram is generated and processed. Pour plus d’informations sur diffgrams, voir DiffGrams.For more information on diffgrams, see DiffGrams.

Notes

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

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

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

Paramètres

reader
TextReader TextReader TextReader TextReader

TextReader dans lequel effectuer la lecture.The TextReader from which to read.

mode
XmlReadMode XmlReadMode XmlReadMode XmlReadMode

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

Retours

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

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

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

Lit le schéma et les données XML dans le DataSet à l'aide du fichier spécifié.Reads XML schema and data into the DataSet using 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 (chemin d'accès inclus) à partir duquel effectuer la lecture.The filename (including the path) from which to read.

Retours

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

Exceptions

Exemples

L’exemple suivant crée d’abord une simple DataSet avec un DataTable, deux colonnes et dix lignes.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Le DataSet schéma et les données sont écrites sur le disque en appelant le WriteXml (méthode).The DataSet schema and data are written to disk by invoking the WriteXml method. Une seconde DataSet est créé et le ReadXml méthode sert à remplir avec le schéma et données.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithStreamReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

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

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the schema and data to an XML file.
    string xmlFilename = "XmlDocument.xml";

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename);

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the schema and data to an XML file.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename)

    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename)

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        Dim row As DataRow
        For Each row In  table.Rows
            Dim column As DataColumn
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                    row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut un targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Sécurité

FileIOPermission
pour lire et écrire des fichiers.for reading and writing files. Énumération associée : FileIOPermissionAccessAssociated enumeration: FileIOPermissionAccess

Voir aussi

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

Lit le schéma et les données XML dans le DataSet à l'aide du TextReader spécifié.Reads XML schema and data into the DataSet 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 à partir duquel lire le schéma et les données.The TextReader from which to read the schema and data.

Retours

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

Exemples

L’exemple suivant crée d’abord une simple DataSet avec un DataTable, deux colonnes et dix lignes.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Le DataSet schéma et les données sont écrites sur le disque en appelant le WriteXml (méthode).The DataSet schema and data are written to disk by invoking the WriteXml method. Une seconde DataSet est créé et le ReadXml méthode sert à remplir avec le schéma et données.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet  
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();
   
    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Les classes qui héritent de la TextReader classe incluent le StreamReader et StringReader classes.Classes that inherit from the TextReader class include the StreamReader and StringReader classes.

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

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

Lit le schéma et les données XML dans le DataSet à l'aide du Stream spécifié.Reads XML schema and data into the DataSet 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 d’abord une simple DataSet avec un DataTable, deux colonnes et dix lignes.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Le DataSet schéma et les données sont écrites sur le disque en appelant le WriteXml (méthode).The DataSet schema and data are written to disk by invoking the WriteXml method. Une seconde DataSet est créé et le ReadXml méthode sert à remplir avec le schéma et données.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet  
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();
   
    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML, comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema, as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

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

Lit le schéma et les données XML dans le DataSet à l'aide du XmlReader spécifié.Reads XML schema and data into the DataSet 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 dans lequel effectuer la lecture.The XmlReader from which to read.

Retours

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

Exemples

L’exemple suivant crée d’abord une simple DataSet avec un DataTable, deux colonnes et dix lignes.The following example first creates a simple DataSet with one DataTable, two columns, and ten rows. Le DataSet schéma et les données sont écrites sur le disque en appelant le WriteXml (méthode).The DataSet schema and data are written to disk by invoking the WriteXml method. Une seconde DataSet est créé et le ReadXml méthode sert à remplir avec le schéma et données.A second DataSet is created and the ReadXml method is used to fill it with schema and data.

private void DemonstrateReadWriteXMLDocumentWithXMLReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id", 
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

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

    // Print out values of each table in the DataSet 
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the XML schema and data to file with FileStream.
    string xmlFilename = "XmlDocument.xml";

    // Create FileStream    
    System.IO.FileStream fsWriteXml = 
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Create an XmlTextWriter to write the file.
    System.Xml.XmlTextWriter xmlWriter = 
        new System.Xml.XmlTextWriter
        (fsWriteXml, System.Text.Encoding.Unicode);

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema); 

    // Close the FileStream.
    fsWriteXml.Close();
   
    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");
   
    // Read the XML document back in. 
    // Create new FileStream to read schema with.
    System.IO.FileStream fsReadXml = 
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Open);

    // Create an XmlTextReader to read the file.
    System.Xml.XmlTextReader xmlReader = 
        new System.Xml.XmlTextReader(fsReadXml);

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);

    // Close the XmlTextReader
    xmlReader.Close();

    // Print out values of each table in the DataSet 
    // fusing the unction defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
            }
            Console.WriteLine();
        }
    }
}
Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

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

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the XML schema and data to file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Create FileStream    
    Dim fsWriteXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter to write the file.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
        (fsWriteXml, System.Text.Encoding.Unicode)

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)

    ' Close the FileStream.
    fsWriteXml.Close()
        
    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
        
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim fsReadXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Open)

    ' Create an XmlTextReader to read the file.
    Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)

    ' Close the XmlTextReader
    xmlReader.Close()
        
    ' Print out values of each table in the DataSet using the 
    ' function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
    
 Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName)
         For Each row In  table.Rows
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())

             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub

Remarques

Le ReadXml méthode fournit un moyen de lire seulement les données, ou schéma et les données dans un DataSet à partir d’un document XML, tandis que le ReadXmlSchema 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 DataSet from an XML document, whereas the ReadXmlSchema method reads only the schema. Pour lire les données et le schéma, utilisez une de la ReadXML surcharges qui inclut le mode paramètre et définissez sa valeur sur ReadSchema.To read both data and schema, use one of the ReadXML overloads that includes the mode parameter, and set its value to ReadSchema.

Notez que cela vaut pour la WriteXml et WriteXmlSchema méthodes, respectivement.Note that the same is true for the WriteXml and WriteXmlSchema methods, respectively. Pour écrire des données XML, ou le schéma et les données à partir de la DataSet, utilisez le WriteXml (méthode).To write XML data, or both schema and data from the DataSet, 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

Un InvalidOperationException sera levée si un type de colonne dans la DataRow qui est lu ou écrit à implémente IDynamicMetaObjectProvider et n’implémente pas IXmlSerializable.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 en ligne 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. S’il existe des conflits (par exemple, la même colonne dans la même table définie avec différents types de données), 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 est spécifié, la structure relationnelle est étendue par inférence, en fonction des besoins, 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 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

Le DataSet n’associe pas un élément XML avec ses correspondant DataColumn ou DataTable lorsque les caractères XML légaux comme (« ») sont ignorés dans le code XML sérialisé.The 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 ignore uniquement les caractères XML non conformes dans les noms d’élément XML et peut donc uniquement utiliser les mêmes.The DataSet itself only escapes illegal XML characters in XML element names and hence can only consume the same. Lorsque les caractères valides dans le nom d’élément XML sont ignorés, l’élément est ignoré lors du traitement.When legal characters in XML element name are escaped, the element is ignored while processing.

Si le schéma XML pour un DataSet inclut un targetNamespace, les données ne peuvent pas être lues et vous pouvez rencontrer des exceptions lors de l’appel ReadXml pour charger le DataSet avec XML qui contient des éléments sans espace de noms qualifiant.If the XML Schema for a DataSet includes a targetNamespace, data may not be read, and you may encounter exceptions when calling ReadXml to load the DataSet with XML that contains elements with no qualifying namespace. Pour lire des éléments non qualifiés, définissez elementFormDefault égale à « qualified » dans votre schéma XML comme le montre l’exemple suivant.To read unqualified elements, set elementFormDefault equal to "qualified" in your XML Schema as the following example demonstrates.

<xsd:schema id="MyDataSet"   
   elementFormDefault="qualified"   
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns="http://www.tempuri.org/MyDataSet.xsd"   
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
</xsd:schema>  

System.Xml.XmlTextReader hérite de XmlReader.System.Xml.XmlTextReader inherits from XmlReader.

Notes

Si le schéma pour votre DataSet contient les éléments du même nom, mais un type différent, dans le même espace de noms, une exception est levée lorsque vous tentez de lire le schéma dans le DataSet avec ReadXml en spécifiant XmlReadMode.ReadSchema.If the schema for your DataSet contains elements of the same name, but different type, in the same namespace, an exception is thrown when you attempt to read the schema into the DataSet with ReadXml by specifying XmlReadMode.ReadSchema. Cette exception ne se produit pas si vous utilisez .NET Framework version 1.0.This exception does not occur if you are using .NET Framework version 1.0.

Voir aussi

S’applique à