XDocument.Declaration Propriedade

Definição

Espaço de Nomes:
System.Xml.Linq
Assemblagens:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblagem:
System.Xml.Linq.dll
Assemblagem:
System.Xml.XDocument.dll
Assemblagem:
netstandard.dll

Recebe ou define a declaração XML para este documento.

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; }
member this.Declaration : System.Xml.Linq.XDeclaration with get, set
Public Property Declaration As XDeclaration

Valor de Propriedade

XDeclaration

Um XDeclaration que contém a declaração XML para este documento.

Exemplos

O exemplo seguinte utiliza esta propriedade para recuperar a declaração XML de um 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)

Este exemplo produz a seguinte saída:

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

Observações

Por vezes, é preciso criar uma declaração XML para um documento. Se quiser indicar que um documento é autónomo, deve usar esta função. Se quiseres codificar o teu documento com uma codificação diferente da utf-8, podes especificar uma codificação através do XDeclaration. Outra abordagem para codificar um documento é especificar a codificação em um XmlWriter que passa para LINQ para XML para escrita.

Aplica-se a

Ver também