XDocument.Declaration Propriedade

Referência

Definição

Namespace:: System.Xml.Linq

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém 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; }

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

member this.Declaration : System.Xml.Linq.XDeclaration with get, set

Public Property Declaration As XDeclaration

Valor da propriedade

XDeclaration

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

Exemplos

O exemplo a seguir usa essa 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)

Esse exemplo gera a saída a seguir:

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

Comentários

Às vezes, você precisa criar uma declaração XML para um documento. Se você quiser indicar que um documento é autônomo, você deve usar essa propriedade. Se você quiser codificar seu documento com uma codificação diferente de utf-8, você poderá especificar uma codificação por meio da XDeclaration. Outra abordagem para codificar um documento é especificar a codificação em um XmlWriter que você passa para LINQ to XML para gravação.

Aplica-se a

Compartilhar via