XDocument.Declaration Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der XML-Deklaration für dieses Dokument.
public:
property System::Xml::Linq::XDeclaration ^ Declaration { System::Xml::Linq::XDeclaration ^ get(); void set(System::Xml::Linq::XDeclaration ^ value); };public System.Xml.Linq.XDeclaration Declaration { get; set; }public System.Xml.Linq.XDeclaration? Declaration { get; set; }member this.Declaration : System.Xml.Linq.XDeclaration with get, setPublic Property Declaration As XDeclarationEigenschaftswert
Eine XDeclaration , die die XML-Deklaration für dieses Dokument enthält.
Beispiele
Im folgenden Beispiel wird diese Eigenschaft verwendet, um die XML-Deklaration eines Dokuments abzurufen.
XDocument doc = new XDocument(
new XDeclaration("1.0", "utf-8", "yes"),
new XComment("This is a comment"),
new XElement("Root", "content")
);
Console.WriteLine(doc.Declaration);
Dim doc As XDocument = _
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!--This is a comment-->
<Root>content</Root>
Console.WriteLine(doc.Declaration)
Dieses Beispiel erzeugt die folgende Ausgabe:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
Hinweise
Manchmal müssen Sie eine XML-Deklaration für ein Dokument erstellen. Wenn Sie angeben möchten, dass ein Dokument eigenständig ist, müssen Sie diese Eigenschaft verwenden. Wenn Sie Ihr Dokument mit einer anderen Codierung als utf-8 codieren möchten, können Sie eine Codierung über die XDeclaration. Ein weiterer Ansatz zum Codieren eines Dokuments besteht darin, die Codierung für ein XmlWriter Dokument anzugeben, das Sie zum Schreiben an LINQ to XML übergeben.
