XML-Dokumentliteral
Aktualisiert: November 2007
Ein Literal, das ein XDocument-Objekt darstellt.
<?xml version="1.0" [encoding="encoding"] [standalone="standalone"] ?>
[ piCommentList ]
rootElement
[ piCommentList ]
Bestandteile
encoding
Optional. Literaltext, der deklariert, welche Codierung das Dokument verwendet.standalone
Optional. Literaltext. Muss "ja" oder "nein" sein.piCommentList
Optional. Liste von XML-Verarbeitungsanweisungen und XML-Kommentaren. Die Anweisungen sind im folgenden Format:piComment [ piComment ... ]
Für jeden piComment gibt es folgende Möglichkeiten:
rootElement
Erforderlich. Stammelement des Dokuments. Das Format ist eins der folgenden:Eingebetteter Ausdruck der Form <%= elementExp %>. elementExp gibt Folgendes zurück:
Ein XElement-Objekt.
Eine Auflistung, die ein XElement-Objekt und eine Anzahl von XProcessingInstruction-Objekten und XComment-Objekten enthält.
Weitere Informationen finden Sie unter Eingebettete Ausdrücke in XML.
Rückgabewert
Ein XDocument-Objekt.
Hinweise
Ein XML-Dokumentliteral wird von der XML-Deklaration am Anfang des Literals identifiziert. Auch wenn jedes XML-Dokumentliteral genau ein XML-Stammelement haben muss, kann es über beliebig viele XML-Verarbeitungsanweisungen und XML-Kommentare verfügen.
Ein XML-Dokumentliteral kann nicht in einem XML-Element enthalten sein.
.gif "Hinweis") Hinweis: |
|---|
Ein XML-Literal kann mehrere Zeilen umfassen, ohne Zeilenfortsetzungszeichen zu verwenden. So kann Inhalt aus einem XML-Dokument kopiert und direkt in ein Visual Basic-Programm eingefügt werden. |
Der Visual Basic-Compiler konvertiert das XML-Dokumentliteral in Aufrufe an den XDocument-Konstruktor und den XDeclaration-Konstruktor.
Beispiel
Mit dem folgenden Beispiel wird ein XML-Dokument mit einer XML-Deklaration, einer Verarbeitungsanweisung, einem Kommentar und einem Element, das ein anderes Element enthält, erstellt.
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)
Siehe auch
Konzepte
Referenz
XML-Verarbeitungsanweisungsliteral