XDocument.Declaration Proprietà

Definizione

Ottiene o imposta la dichiarazione XML del documento.

public System.Xml.Linq.XDeclaration Declaration { get; set; }
public System.Xml.Linq.XDeclaration? Declaration { get; set; }

Valore della proprietà

XDeclaration

XDeclaration contenente la dichiarazione XML del documento.

Esempio

Nell'esempio seguente viene usata 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);  

Nell'esempio viene prodotto l'output seguente:

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

Commenti

A volte è necessario creare una dichiarazione XML per un documento. Se si vuole indicare che un documento è autonomo, è necessario usare 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 XmlWriter oggetto passato a LINQ to XML per la scrittura.

Si applica a

Prodotto Versioni
.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

Vedi anche