Procédure pas à pas : lecture des données XML dans un groupe de données

Article
12/14/2016

Date de publication : mars 2016

ADO.NET offre des méthodes simples pour l'utilisation des données XML. Dans le cadre de cette procédure pas à pas, vous allez créer une application Windows qui va charger des données XML dans un groupe de données. Le groupe de données sera affiché dans un DataGridView. À la fin, un schéma XML basé sur le contenu du fichier XML sera affiché dans une zone de texte.

Cette procédure pas à pas se compose de cinq étapes principales :

Création d'un nouveau projet.
Création d'un fichier XML à lire dans le groupe de données.
Création de l'interface utilisateur.
Création du groupe de données, lecture du fichier XML et affichage de celui-ci dans un contrôle DataGridView.
Ajout du code permettant d'afficher le schéma XML basé sur le fichier XML dans un contrôle TextBox.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Customizing Development Settings in Visual Studio.

Création d'un projet

Dans cette étape, vous créerez un projet Visual Basic ou Visual C# qui contiendra cette procédure pas à pas.

Pour créer le nouveau projet Windows

Dans le menu Fichier, créez un nouveau projet.
Nommez le projet ReadingXML.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Applications clientes.

Le projet ReadingXML est créé et ajouté à l'Explorateur de solutions.

Création du fichier XML qui sera lu dans le groupe de données

Cette procédure traite de la lecture de données XML dans un groupe de données. Le contenu d'un fichier XML vous est donc proposé.

Pour créer le fichier XML qui sera lu dans le groupe de données

Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Sélectionnez Fichier XML, nommez le fichier authors.xml et cliquez Ajouter.

Le fichier XML est chargé dans le concepteur et prêt pour la modification.

Collez le code suivant dans l'éditeur, sous la déclaration XML :

<Authors_Table>  
  <authors>  
    <au_id>172-32-1176</au_id>  
    <au_lname>White</au_lname>  
    <au_fname>Johnson</au_fname>  
    <phone>408 496-7223</phone>  
    <address>10932 Bigge Rd.</address>  
    <city>Menlo Park</city>  
    <state>CA</state>  
    <zip>94025</zip>  
    <contract>true</contract>  
  </authors>  
  <authors>  
    <au_id>213-46-8915</au_id>  
    <au_lname>Green</au_lname>  
    <au_fname>Margie</au_fname>  
    <phone>415 986-7020</phone>  
    <address>309 63rd St. #411</address>  
    <city>Oakland</city>  
    <state>CA</state>  
    <zip>94618</zip>  
    <contract>true</contract>  
  </authors>  
  <authors>  
    <au_id>238-95-7766</au_id>  
    <au_lname>Carson</au_lname>  
    <au_fname>Cheryl</au_fname>  
    <phone>415 548-7723</phone>  
    <address>589 Darwin Ln.</address>  
    <city>Berkeley</city>  
    <state>CA</state>  
    <zip>94705</zip>  
    <contract>true</contract>  
  </authors>  
  <authors>  
    <au_id>267-41-2394</au_id>  
    <au_lname>Hunter</au_lname>  
    <au_fname>Anne</au_fname>  
    <phone>408 286-2428</phone>  
    <address>22 Cleveland Av. #14</address>  
    <city>San Jose</city>  
    <state>CA</state>  
    <zip>95128</zip>  
    <contract>true</contract>  
  </authors>  
  <authors>  
    <au_id>274-80-9391</au_id>  
    <au_lname>Straight</au_lname>  
    <au_fname>Dean</au_fname>  
    <phone>415 834-2919</phone>  
    <address>5420 College Av.</address>  
    <city>Oakland</city>  
    <state>CA</state>  
    <zip>94609</zip>  
    <contract>true</contract>  
  </authors>  
</Authors_Table>

Dans le menu Fichier, pointez sur Enregistrer authors.xml.

Création de l'interface utilisateur

Pour cette application, l'interface utilisateur se composera des éléments suivants :

un contrôle DataGridView qui affichera le contenu du fichier XML sous la forme de données ;
un contrôle TextBox qui affichera le schéma XML du fichier XML ;
deux contrôles Button ;
- le premier bouton lit le fichier XML en le plaçant dans le groupe de données et l'affiche dans le contrôle DataGridView ;
- le deuxième bouton extrait le schéma du groupe de données et l'affiche dans le contrôle TextBox via un StringWriter.

Pour ajouter des contrôles au formulaire

Ouvrez Form1 en mode Design.
À partir de la boîte à outils, faites glisser les contrôles suivants jusqu'au formulaire :
- Un contrôle DataGridView
- Un contrôle TextBox
- Deux contrôles Button
Définissez les propriétés suivantes :

Contrôle Propriété Paramètre

TextBox1 Multiline true

ScrollBars Vertical

Button1 Nom ReadXmlButton

Texte Lire XML

Button2 Nom ShowSchemaButton

Texte Afficher schéma

Contrôle	Propriété	Paramètre
`TextBox1`	Multiline	`true`
	ScrollBars	Vertical
`Button1`	Nom	`ReadXmlButton`
	Texte	`Lire XML`
`Button2`	Nom	`ShowSchemaButton`
	Texte	`Afficher schéma`

Création du groupe de données qui recevra les données XML

Au cours de la procédure suivante, vous allez créer un nouveau groupe de données appelé authors. Pour plus d'informations sur les groupes de données, consultez Utilisation de groupes de données dans Visual Studio.

Pour créer un nouveau groupe de données qui recevra les données XML

Avec le fichier source de Form1 sélectionné dans l'Explorateur de solutions, cliquez sur le bouton Concepteur de vues de la barre d'outils de l'Explorateur de solutions.
Dans l'Boîte à outils, Onglet Données, faites glisser un DataSet jusqu'à Form1.
Sélectionnez groupe de données non typé dans la boîte de dialogue d' Ajoutez le groupe de données , puis cliquez sur OK.

DataSet1 est ajouté à la barre d'état des composants.
Dans la fenêtre Propriétés, affectez aux propriétés Name et DataSetName la valeur AuthorsDataSet.

Création du gestionnaire d'événements pour lire les données XML dans le groupe de données

Le bouton Lire XML lit le fichier XML dans le groupe de données et définit dans le contrôle DataGridView les propriétés qui le lient au groupe de données.

Pour ajouter le code au gestionnaire d'événements ReadXmlButton_Click

Sélectionnez Form1 dans l'Explorateur de solutions et cliquez sur le bouton Concepteur de vues dans la barre d'outils de l'Explorateur de solutions.
Double-cliquez sur le bouton Lire XML.

L'Éditeur de code s'ouvre au gestionnaire d'événements ReadXmlButton_Click.

Tapez le code suivant dans le gestionnaire d'événements ReadXmlButton_Click :

        private void ReadXmlButton_Click(object sender, EventArgs e)
        {
            string filePath = "Complete path where you saved the XML file";

            AuthorsDataSet.ReadXml(filePath);

            dataGridView1.DataSource = AuthorsDataSet;
            dataGridView1.DataMember = "authors";
        }

    Private Sub ReadXmlButton_Click() Handles ReadXmlButton.Click

        Dim filePath As String = "Complete path where you saved the XML file"

        AuthorsDataSet.ReadXml(filePath)

        DataGridView1.DataSource = AuthorsDataSet
        DataGridView1.DataMember = "authors"
    End Sub

Dans le code du gestionnaire d'événements ReadXMLButton_Click, remplacez l'entrée filepath = par le chemin d'accès correct.

Création du gestionnaire d'événements pour afficher le schéma dans le contrôle Textbox

Le bouton Afficher schéma crée un objet StringWriter rempli par le schéma et affiché dans TextBox.

Pour ajouter le code au gestionnaire d'événements ShowSchemaButton_Click

Sélectionnez Form1 dans l'Explorateur de solutions et cliquez sur le bouton Concepteur de vues.
Double-cliquez sur le bouton Afficher schéma.

L'Éditeur de code s'ouvre au gestionnaire d'événements ShowSchemaButton_Click.

Tapez le code suivant dans le gestionnaire d'événements ShowSchemaButton_Click.

        private void ShowSchemaButton_Click(object sender, EventArgs e)
        {
            System.IO.StringWriter swXML = new System.IO.StringWriter();
            AuthorsDataSet.WriteXmlSchema(swXML);
            textBox1.Text = swXML.ToString();
        }

    Private Sub ShowSchemaButton_Click() Handles ShowSchemaButton.Click

        Dim swXML As New System.IO.StringWriter()
        AuthorsDataSet.WriteXmlSchema(swXML)
        TextBox1.Text = swXML.ToString
    End Sub

Test

Vous pouvez à présent tester le formulaire afin de vous assurer qu'il se comporte comme prévu.

Pour tester le formulaire

Appuyez sur F5 pour exécuter l'application.
Cliquez sur le bouton Lire XML.

Le DataGridView affiche le contenu du fichier XML.
Cliquez sur le bouton Afficher schéma.

La zone de texte affiche le schéma XML pour le fichier XML.

Étapes suivantes

Cette procédure décrit les principes de base de la lecture d'un fichier XML dans un groupe de données et de la création d'un schéma basé sur le contenu du fichier XML. Vous devrez peut-être ensuite exécuter les opérations suivantes :

Éditer les données dans le groupe de données et les enregistrer à nouveau au format XML. Pour plus d'informations, consultez WriteXml.
Éditer les données dans le groupe de données et les enregistrer dans une base de données. Pour plus d'informations, consultez Enregistrement des données.

Voir aussi

Procédures pas à pas relatives aux données
Accès aux données dans Visual Studio
Préparation de votre application pour recevoir des données
Outils XML dans Visual Studio

Partager via