Inclusion de balisage XML directement dans votre code : utilisation de littéraux XML

Article
08/21/2008

Mise à jour : novembre 2007

Les applications fonctionnent avec de nombreux types de données et le langage XML (Extensible Markup Language) est devenu l'un des formats de données les plus populaires. Visual Basic vous permet désormais d'utiliser le balisage XML dans votre code Visual Basic via les littéraux XML. Dans cette leçon, vous apprendrez à utiliser directement le balisage XML dans votre code et à y incorporer des expressions.

Vous pouvez créer facilement par programme des éléments et des documents XML en utilisant des littéraux XML. Par exemple, si vous souhaitez créer un élément XML, vous pouvez déclarer une variable de type XElement, puis assigner un bloc de balisage XML à la variable.

Vous pouvez taper le balisage XML manuellement, le copier dans le Presse-papiers et le coller directement dans l'éditeur de code Visual Basic, ou lire le balisage XML d'un fichier. Pour plus d'informations, consultez Comment : charger du code XML à partir d'un fichier, d'une chaîne ou d'un flux (Visual Basic). Pour cette leçon, vous pouvez copier directement le balisage XML de cette rubrique.

Essayez !

Pour créer un élément XML

Dans le menu Fichier, cliquez sur Nouveau projet.

La boîte de dialogue Nouveau projet s'affiche.
Cliquez sur Application Windows Forms, puis sur OK.
Faites glisser un contrôle bouton depuis la Boîte à outils jusqu'au formulaire.

Double-cliquez sur le bouton pour ouvrir le gestionnaire d'événements par défaut Click dans l'éditeur de code. Ajoutez le code ci-dessous.

Dim memo As XElement = _
    <memo>
        <date>February 2, 2008</date>
        <to>Patrick Hines</to>
        <from>Roger Harui</from>
        <heading>XML Literals</heading>
        <body>Visual Basic makes XML element creation easy!</body>
    </memo>
Console.WriteLine(memo)

Dans l'IDE Visual Basic, dans le menu Affichage, pointez sur Autres fenêtres, puis cliquez sur Sortie.

La fenêtre Sortie s'ouvre.
Appuyez sur F5 pour exécuter l'application.

Cliquez sur le bouton, puis fermez l'application et vérifiez que le balisage XML suivant est affiché dans la fenêtre Sortie.

<memo>
    <date>February 2, 2008</date>
    <to>Patrick Hines</to>
    <from>Roger Harui</from>
    <heading>XML Literals</heading>
    <body>Visual Basic makes XML element creation easy!</body>
</memo>

Dans cet exemple de code, la date apparaîtra toujours sous la forme : février 2, 2008. Si vous préférez afficher la date en cours, vous pouvez incorporer une expression dans le balisage XML. Par exemple, vous pouvez créer une variable pour la date en cours, puis inclure cette variable en tant qu'expression en l'englobant dans une balise spéciale. La balise commence par le signe < (inférieur à) suivi du signe de pourcentage, du signe égal et d'un espace. La balise se termine par un espace, le signe de pourcentage et le signe > (supérieur à) : <%= variable %>.

Vous n'avez pas à déclarer les types de données pour les variables locales, car Visual Basic déduira le type de la valeur assignée. Toutefois, le code suivant répertorie les types par souci de clarté. Pour plus d'informations, consultez Inférence de type local.

Pour créer un élément XML ayant une expression incorporée

Remplacez le code dans le gestionnaire d'événements Click par défaut du bouton par le code suivant.

Dim currentDate As String = Format(Now, "MMMM d, yyyy")
Dim memo As XElement = _
    <memo>
        <date> <%=currentDate %></date>
        <to>Patrick Hines</to>
        <from>Roger Harui</from>
        <heading>XML Literals</heading>
        <body>Embedding expresions in XML is easy!</body>
        </memo>

Console.WriteLine(memo)

Appuyez sur F5, cliquez sur le bouton, puis fermez le formulaire.
Vérifiez que le balisage XML affiché dans la fenêtre Sortie affiche la date en cours.

Étapes suivantes

Dans cette leçon, vous avez appris comment utiliser des littéraux XML dans votre code et comment incorporer une expression dans un littéral XML. Dans les leçons suivantes, vous allez vous familiariser avec la lecture et l'écriture de fichiers texte.

Leçon suivante : Utilisation du système de fichiers : écriture et lecture des fichiers