Littéral de document XML

Mise à jour : novembre 2007

Littéral représentant un objet XDocument.

<?xml version="1.0" [encoding="encoding"] [standalone="standalone"] ?>
[ piCommentList ]
rootElement
[ piCommentList ]

Éléments

• encoding
  Facultatif. Texte littéral qui déclare le codage utilisé par le document.

• standalone
  Facultatif. Texte littéral. Doit être "oui" ou "non".

• piCommentList
  Facultatif. Liste d'instructions de traitement XML et de commentaires XML. Prend le format suivant :

  piComment [ piComment ... ]

  Chaque piCommentpeut être l'un des suivants :

  • Littéral d'instruction de traitement XML.

  • Littéraux de commentaires XML.

• rootElement
  Obligatoire. Élément racine du document. Le format est l'un des suivants :

  • Littéral d'élément XML.

  • Expression incorporée, sous la forme <%= elementExp %>. L'elementExp retourne l'un des éléments suivants :

    • Objet XElement.

    • Collection contenant un objet XElement et tout nombre d'objets XProcessingInstruction et XComment.

  Pour plus d'informations, consultez Expressions incorporées en XML.

Valeur de retour

Objet XDocument.

Notes

Littéral de document XML identifié par la déclaration XML au démarrage du littéral. Bien que chaque littéral de document XML doive comporter précisément un élément XML racine, il peut comporter tout nombre d'instructions de traitement XML et de commentaires XML.

Un littéral de document XML ne peut pas apparaître dans un élément XML.

Remarque :
Un littéral XML peut couvrir plusieurs lignes, sans utiliser de caractères de continuation de ligne. Cela vous permet de copier le contenu d'un document XML et de le coller directement dans un programme Visual Basic.

Le compilateur Visual Basic convertit le littéral de document XML en appels aux constructeurs XDocument et XDeclaration.

Exemple

L'exemple suivant crée un document XML qui possède une déclaration XML, une instruction de traitement, un commentaire et un élément contenant un autre élément.

Dim libraryRequest As XDocument = _
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <?xml-stylesheet type="text/xsl" href="show_book.xsl"?>
    <!-- Tests that the application works. -->
    <books>
        <book/>
    </books>
Console.WriteLine(libraryRequest)

Voir aussi

Concepts

Expressions incorporées en XML

Référence

Littéral d'instruction de traitement XML

Littéraux de commentaires XML

Littéral d'élément XML

XElement

XProcessingInstruction

XComment

XDocument

Autres ressources

Littéraux XML

Création de code XML dans Visual Basic