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

  • Article

Mise à jour : novembre 2007

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 :

  1. Création d'un nouveau projet.

  2. Création d'un fichier XML à lire dans le groupe de données.

  3. Création de l'interface utilisateur.

  4. Création du groupe de données, lecture du fichier XML et affichage de celui-ci dans un contrôle DataGridView.

  5. Ajout du code permettant d'afficher le schéma XML basé sur le fichier XML dans un contrôle TextBox.

Remarque :

Les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide selon vos paramètres actifs ou votre édition. 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 allez créer un projet Visual Basic, Visual C# ou Visual J# contenant cette procédure.

Pour créer le nouveau projet Windows

  1. Dans le menu Fichier, créez un nouveau projet.

  2. Nommez le projet ReadingXML.

  3. Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

    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

  1. Dans le menu Projet, cliquez sur Ajouter un nouvel élément.

  2. 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.

  3. 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>

  4. 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

  1. Ouvrez Form1 en mode Design.

  2. À partir de la boîte à outils, faites glisser les contrôles suivants jusqu'au formulaire :

  3. Définissez les propriétés suivantes :

    Contrôle

    Propriété

    Valeur

    TextBox1

    Multiline

    true

     

    ScrollBars

    Vertical

    Button1

    Name

    ReadXmlButton

     

    Text

    Lire XML

    Button2

    Name

    ShowSchemaButton

     

    Text

    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 Vue d'ensemble des groupes de données dans Visual Studio.

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

  1. 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.

  2. Dans l'Données, onglet de la boîte à outils, faites glisser un DataSet jusqu'à Form1.

  3. Sélectionnez Groupe de données non typé dans la Ajouter un DataSet, boîte de dialogue, puis cliquez sur OK.

    DataSet1 est ajouté à la barre d'état des composants.

  4. 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

  1. 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.

  2. Double-cliquez sur le bouton Lire XML.

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

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

    Private Sub ReadXmlButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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";
}

  4. 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

  1. Sélectionnez Form1 dans l'Explorateur de solutions et cliquez sur le bouton Concepteur de vues.

  2. Double-cliquez sur le bouton Afficher schéma.

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

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

    Private Sub ShowSchemaButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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

  1. Appuyez sur F5 pour exécuter l'application.

  2. Cliquez sur le bouton Lire XML.

    Le DataGridView affiche le contenu du fichier XML.

  3. 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 pouvez ensuite être amené à exécuter les tâches ci-dessous :

  • É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

Autres ressources

Procédures pas à pas relatives aux données

Accès aux données (Visual Studio)

Préparation de votre application pour recevoir des données

Outils XML dans Visual Studio