Teilen über

XDocument.Declaration Eigenschaft

  • Referenz

Definition

Namespace:
System.Xml.Linq
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll

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

Siehe auch