Udostępnij za pośrednictwem


XDocument.Declaration Właściwość

Definicja

Pobiera lub ustawia deklarację XML dla tego dokumentu.

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

Wartość właściwości

XDeclaration

Element XDeclaration zawierający deklarację XML dla tego dokumentu.

Przykłady

W poniższym przykładzie użyto tej właściwości do pobrania deklaracji XML dokumentu.

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)  

Ten przykład generuje następujące wyniki:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  

Uwagi

Czasami trzeba utworzyć deklarację XML dla dokumentu. Jeśli chcesz wskazać, że dokument jest autonomiczny, musisz użyć tej właściwości. Jeśli chcesz zakodować dokument za pomocą kodowania innego niż utf-8, możesz określić kodowanie za pomocą polecenia XDeclaration. Innym podejściem do kodowania dokumentu jest określenie kodowania XmlWriter przekazywanego do LINQ to XML na potrzeby pisania.

Dotyczy

Zobacz też