XDocument.Declaration Proprietà

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

Valore della proprietà

Oggetto XDeclaration contenente la dichiarazione XML per questo documento.

Esempio

Nell'esempio seguente viene utilizzata questa proprietà per recuperare la dichiarazione XML di un documento.

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)

In questo esempio viene generato l'output seguente:

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

Commenti

In alcuni casi è necessario creare una dichiarazione XML per un documento. Se si desidera indicare che un documento è autonomo, è necessario utilizzare questa proprietà. Se si vuole codificare il documento con una codifica diversa da utf-8, è possibile specificare una codifica tramite .XDeclaration Un altro approccio per la codifica di un documento consiste nel specificare la codifica in un oggetto XmlWriter passato a LINQ to XML per la scrittura.

Vedi anche

• XDeclaration
• Panoramica di LINQ to XML
• Come leggere e scrivere un documento codificato