Partager via

Littéraux de commentaires XML (Visual Basic)

  • Article

Littéral représentant un objet XComment.

Syntaxe

<!-- content -->

Éléments

Terme Définition
<!-- Obligatoire. Indique le début du commentaire XML.
content Obligatoire. Texte à afficher dans le commentaire XML. Ne peut pas contenir une série de deux traits d’union (--) ou se terminer par un trait d’union adjacent à la balise fermante.
--> Obligatoire. Indique la fin du commentaire XML.

Valeur renvoyée

Objet XComment.

Notes

Les littéraux de commentaire XML ne contiennent pas de contenu de document ; ils contiennent des informations sur le document. La section de commentaire XML se termine par la séquence « --> ». Cela implique ce qui suit :

  • Vous ne pouvez pas utiliser une expression incorporée dans un littéral de commentaire XML, car les délimiteurs d’expression incorporées sont du contenu de commentaire XML valide.

  • Les sections de commentaires XML ne peuvent pas être imbriquées, car content ne peut pas contenir la valeur « -->».

Vous pouvez affecter un littéral de commentaire XML à une variable, ou vous pouvez l’inclure dans un littéral d’élément XML.

Notes

Un littéral XML peut s’étendre sur plusieurs lignes sans utiliser de caractères de continuation de ligne. Cette fonctionnalité vous permet de copier du contenu à partir d’un document XML et de le coller directement dans un programme Visual Basic.

Le compilateur Visual Basic convertit le littéral de commentaire XML en un appel au constructeur XComment.

Exemple

L’exemple suivant crée un commentaire XML qui contient le texte « Il s’agit d’un commentaire ».

Dim com As XComment = <!-- This is a comment -->

Voir aussi