XML-Kommentarliteral (Visual Basic)
Ein Literal, das ein XComment Objekt darstellt.
Syntax
<!-- content -->
Bestandteile
Begriff | Definition |
---|---|
<!-- |
Erforderlich. Gibt den Anfang des XML-Kommentars an. |
content |
Erforderlich. Text, der im XML-Kommentar angezeigt werden soll. Darf keine Folge von zwei Bindestrichen (--) enthalten oder mit einem Bindestrich neben dem schließenden Tag enden. |
--> |
Erforderlich. Gibt das Ende des XML-Kommentars an. |
Rückgabewert
Ein XComment-Objekt.
Bemerkungen
XML-Kommentarliterale enthalten keinen Dokumentinhalt. Sie enthalten Informationen zum Dokument. Der XML-Kommentarabschnitt endet mit der Sequenz „-->“. Dies impliziert Folgendes:
Sie können keinen eingebetteten Ausdruck in einem XML-Kommentarliteral verwenden, da die eingebetteten Ausdruckstrennzeichen gültige XML-Kommentarinhalte sind.
XML-Kommentarabschnitte können nicht geschachtelt werden, weil
content
nicht den Wert „-->“ enthalten darf.
Sie können einer Variablen ein XML-Kommentarliteral zuweisen oder es in ein XML-Elementliteral einschließen.
Hinweis
Ein XML-Literal kann mehrere Zeilen umfassen, ohne Zeilenfortsetzungszeichen zu verwenden. Durch dieses Feature können Sie Inhalte aus einem XML-Dokument kopieren und direkt in ein Visual Basic-Programm einfügen.
Der Visual Basic-Compiler konvertiert das XML-Kommentarliteral in einen Aufruf des XComment-Konstruktors.
Beispiel
Im folgenden Beispiel wird ein XML-Kommentar erstellt, der den Text „This is a comment“ enthält.
Dim com As XComment = <!-- This is a comment -->