Visão geral da classe XDocument
Este tópico apresenta a classe XDocument.
Visão geral da classe XDocument
A classe XDocument contém as informações necessárias para um documento XML válido. Isso inclui uma declaração XML, instruções de processamento e comentários.
Observe que você só precisará criar objetos XDocument se precisar da funcionalidade específica fornecida pela classe XDocument. Em muitas circunstâncias, você pode trabalhar diretamente com XElement. Trabalhar diretamente com XElement é um modelo de programação mais simples.
XDocument deriva de XContainer. Portanto, pode conter nós filho. Entretanto, os objetos XDocument podem ter apenas um nó XElement filho. Isso reflete o padrão XML de que pode haver apenas um elemento raiz em um documento XML.
Componentes de XDocument
Um XDocument pode conter os seguintes elementos:
Um objeto XDeclaration. XDeclaration permite que você especifique as partes pertinentes de uma declaração XML: a versão XML, a codificação do documento e se o documento XML é autônomo.
Um objeto XElement. Esse é o nó raiz do documento XML.
Qualquer número de objetos XProcessingInstruction. Uma instrução de processamento comunica informações a um aplicativo que processa o XML.
Qualquer número de objetos XComment. Os comentários serão irmãos do elemento raiz. O objeto XComment não pode ser o primeiro argumento da lista, pois não é válido um documento XML iniciar com um comentário.
Um XDocumentType para o DTD.
Quando você serializa um XDocument, mesmo que XDocument.Declaration seja null, a saída terá uma declaração XML se o gravador tiver Writer.Settings.OmitXmlDeclaration definido como false (o padrão).
Por padrão, o LINQ to XML define a versão como “1.0 " e a codificação como “utf-8”.
Usando XElement sem XDocument
Conforme mencionado anteriormente, a classe XElement é a principal classe da interface de programação LINQ to XML. Em muitos casos, seu aplicativo não exigirá que você crie um documento. Usando a classe XElement, você poderá criar uma árvore XML, adicionar outras árvores XML a ela, modificar a árvore XML e salvá-la.
Usando XDocument
Para construir um XDocument, use a construção funcional exatamente como você faz para criar objetos XElement.
O código a seguir cria um objeto XDocument e seus objetos independentes associados.
XDocument d = new XDocument(
new XComment("This is a comment."),
new XProcessingInstruction("xml-stylesheet",
"href='mystyle.css' title='Compact' type='text/css'"),
new XElement("Pubs",
new XElement("Book",
new XElement("Title", "Artifacts of Roman Civilization"),
new XElement("Author", "Moreno, Jordao")
),
new XElement("Book",
new XElement("Title", "Midieval Tools and Implements"),
new XElement("Author", "Gazit, Inbar")
)
),
new XComment("This is another comment.")
);
d.Declaration = new XDeclaration("1.0", "utf-8", "true");
Console.WriteLine(d);
d.Save("test.xml");
Dim doc As XDocument = <?xml version="1.0" encoding="utf-8"?>
<!--This is a comment.-->
<?xml-stylesheet href='mystyle.css' title='Compact' type='text/css'?>
<Pubs>
<Book>
<Title>Artifacts of Roman Civilization</Title>
<Author>Moreno, Jordao</Author>
</Book>
<Book>
<Title>Midieval Tools and Implements</Title>
<Author>Gazit, Inbar</Author>
</Book>
</Pubs>
<!--This is another comment.-->
doc.Save("test.xml")
Quando você examina o arquivo test.xml, obtém a seguinte saída:
<?xml version="1.0" encoding="utf-8"?>
<!--This is a comment.-->
<?xml-stylesheet href='mystyle.css' title='Compact' type='text/css'?>
<Pubs>
<Book>
<Title>Artifacts of Roman Civilization</Title>
<Author>Moreno, Jordao</Author>
</Book>
<Book>
<Title>Midieval Tools and Implements</Title>
<Author>Gazit, Inbar</Author>
</Book>
</Pubs>
<!--This is another comment.-->