XDocument.Declaration Eigenschaft

Referenz

Definition

Namespace:: System.Xml.Linq

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

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.

Ruft die XML-Deklaration für das Dokument ab oder legt diese fest.

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, set

Public Property Declaration As XDeclaration

Eigenschaftswert

XDeclaration

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 für die Codierung eines Dokuments besteht darin, die Codierung für eine XmlWriter LINQ to XML zum Schreiben anzugeben.

Gilt für

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Teilen über