Procédure pas à pas : lecture des données XML dans un groupe de données
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 Paramètres 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 Développement d'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
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 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
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"; }
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 Sub ShowSchemaButton_Click() Handles ShowSchemaButton.Click Dim swXML As New System.IO.StringWriter() AuthorsDataSet.WriteXmlSchema(swXML) TextBox1.Text = swXML.ToString End Sub
private void ShowSchemaButton_Click(object sender, EventArgs e) { System.IO.StringWriter swXML = new System.IO.StringWriter(); AuthorsDataSet.WriteXmlSchema(swXML); textBox1.Text = swXML.ToString(); }
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
Concepts
Préparation de votre application pour recevoir des données
Autres ressources
Procédures pas à pas relatives aux données