XDocument Classe

Definição

Representa um documento XML. Para saber mais sobre os componentes e o uso de um objeto XDocument, consulte Visão geral da classe XDocument.

public class XDocument : System.Xml.Linq.XContainer
Herança

Exemplos

O exemplo a seguir cria um documento e adiciona um comentário e um elemento a ele. Em seguida, ele compõe outro documento usando os resultados de uma consulta.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Esse exemplo gera a saída a seguir:

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Comentários

Para obter detalhes sobre o conteúdo válido de um XDocument, consulte Conteúdo válido de objetos XElement e XDocument.

Construtores

XDocument()

Inicializa uma nova instância da classe XDocument.

XDocument(Object[])

Inicializa uma nova instância da classe XDocument com o conteúdo especificado.

XDocument(XDeclaration, Object[])

Inicializa uma nova instância da classe XDocument com o XDeclaration e conteúdo especificados.

XDocument(XDocument)

Inicializa uma nova instância da classe XDocument de um objeto XDocument existente.

Propriedades

BaseUri

Obtém o URI de base para este XObject.

(Herdado de XObject)
Declaration

Obtém ou define a declaração XML para este documento.

Document

Obtém o XDocument para este XObject.

(Herdado de XObject)
DocumentType

Obtém a DTD (Definição de Tipo de Documento) desse documento.

FirstNode

Obtém o primeiro nó filho desse nó.

(Herdado de XContainer)
LastNode

Obtém o primeiro nó filho desse nó.

(Herdado de XContainer)
NextNode

Obtém o próximo nó irmão desse nó.

(Herdado de XNode)
NodeType

Obtém o tipo de nó para este nó.

Parent

Obtém o pai XElement desse XObject.

(Herdado de XObject)
PreviousNode

Obtém o nó irmão anterior desse nó.

(Herdado de XNode)
Root

Obtém o elemento raiz da Árvore XML desse documento.

Métodos

Add(Object)

Adiciona o conteúdo especificado como filhos deste XContainer.

(Herdado de XContainer)
Add(Object[])

Adiciona o conteúdo especificado como filhos deste XContainer.

(Herdado de XContainer)
AddAfterSelf(Object)

Adiciona o conteúdo especificado imediatamente após esse nó.

(Herdado de XNode)
AddAfterSelf(Object[])

Adiciona o conteúdo especificado imediatamente após esse nó.

(Herdado de XNode)
AddAnnotation(Object)

Adiciona um objeto à lista de anotação deste XObject.

(Herdado de XObject)
AddBeforeSelf(Object)

Adiciona o conteúdo especificado imediatamente antes deste nó.

(Herdado de XNode)
AddBeforeSelf(Object[])

Adiciona o conteúdo especificado imediatamente antes deste nó.

(Herdado de XNode)
AddFirst(Object)

Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.

(Herdado de XContainer)
AddFirst(Object[])

Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.

(Herdado de XContainer)
Ancestors()

Retorna uma coleção dos elementos ancestrais deste nó.

(Herdado de XNode)
Ancestors(XName)

Retorna uma coleção filtrada dos elementos ancestrais deste nó. Somente os elementos que têm um XName correspondente são incluídos na coleção.

(Herdado de XNode)
Annotation(Type)

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.

(Herdado de XObject)
Annotation<T>()

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.

(Herdado de XObject)
Annotations(Type)

Obtém uma coleção de anotações do tipo especificado para este XObject.

(Herdado de XObject)
Annotations<T>()

Obtém uma coleção de anotações do tipo especificado para este XObject.

(Herdado de XObject)
CreateReader()

Cria um XmlReader para este nó.

(Herdado de XNode)
CreateReader(ReaderOptions)

Cria um XmlReader com as opções especificadas pelo parâmetro readerOptions.

(Herdado de XNode)
CreateWriter()

Cria um XmlWriter que pode ser usado para adicionar nós ao XContainer.

(Herdado de XContainer)
DescendantNodes()

Retorna uma coleção dos nós descendentes desse documento ou elemento, na ordem do documento.

(Herdado de XContainer)
Descendants()

Retorna uma coleção dos elementos descendentes desse documento ou elemento, na ordem do documento.

(Herdado de XContainer)
Descendants(XName)

Retorna uma coleção filtrada dos elementos descendentes desse documento ou elemento, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

(Herdado de XContainer)
Element(XName)

Obtém o primeiro elemento filho (na ordem de documentos) com o XName especificado.

(Herdado de XContainer)
Elements()

Retorna uma coleção dos elementos filho desse elemento ou documento, na ordem do documento.

(Herdado de XContainer)
Elements(XName)

Retorna uma coleção filtrada dos elementos filho desse elemento ou documento, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

(Herdado de XContainer)
ElementsAfterSelf()

Retorna uma coleção dos elementos irmão após esse nó, na ordem do documento.

(Herdado de XNode)
ElementsAfterSelf(XName)

Retorna uma coleção filtrada dos elementos irmãos após esse nó, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

(Herdado de XNode)
ElementsBeforeSelf()

Retorna uma coleção dos elementos irmãos antes desse nó, na ordem do documento.

(Herdado de XNode)
ElementsBeforeSelf(XName)

Retorna uma coleção filtrada dos elementos irmãos antes desse nó, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.

(Herdado de XNode)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsAfter(XNode)

Determina se o nó atual aparece depois de um nó especificado com relação à ordem do documento.

(Herdado de XNode)
IsBefore(XNode)

Determina se o nó atual aparece antes de um nó especificado com relação à ordem do documento.

(Herdado de XNode)
Load(Stream)

Cria uma nova instância XDocument usando o fluxo especificado.

Load(Stream, LoadOptions)

Cria uma nova instância de XDocument usando o fluxo especificado, com a opção de preservar espaços em branco, definir o URI base e reter informações de linha.

Load(String)

Cria um novo XDocument com base em um arquivo.

Load(String, LoadOptions)

Cria um novo XDocument com base em um arquivo, opcionalmente, preservando os espaços em branco, definindo o URI base e retendo as informações de linha.

Load(TextReader)

Cria um novo XDocument com base em um TextReader.

Load(TextReader, LoadOptions)

Cria um novo XDocument de um TextReader, opcionalmente preservando espaços em branco, configurando o URI base e retendo informações de linha.

Load(XmlReader)

Cria um novo XDocument com base em um XmlReader.

Load(XmlReader, LoadOptions)

Carrega um XDocument de um XmlReader, configurando opcionalmente o URI de base e retendo informações de linha.

LoadAsync(Stream, LoadOptions, CancellationToken)

Cria de forma assíncrona um novo XDocument e inicializa sua árvore XML subjacente a partir do fluxo especificado, preservando opcionalmente o espaço em branco.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Cria um novo XDocument e inicializa sua árvore XML subjacente usando o parâmetro TextReader especificado, preservando opcionalmente o espaço em branco.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Cria um novo XDocument que contém o conteúdo do XmlReader especificado.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Nodes()

Retorna uma coleção de nós filhos deste elemento ou documento, na ordem do documento.

(Herdado de XContainer)
NodesAfterSelf()

Retorna uma coleção de nós irmãos após esse nó, na ordem do documento.

(Herdado de XNode)
NodesBeforeSelf()

Retorna uma coleção de nós irmãos antes deste nó, na ordem do documento.

(Herdado de XNode)
Parse(String)

Cria um novo XDocument com base em uma cadeia de caracteres.

Parse(String, LoadOptions)

Cria um novo XDocument de uma cadeia de caracteres, com a opção de preservar espaços em branco, definir o URI base e reter as informações de linha.

Remove()

Remove este nó de seu pai.

(Herdado de XNode)
RemoveAnnotations(Type)

Remove as anotações do tipo especificado deste XObject.

(Herdado de XObject)
RemoveAnnotations<T>()

Remove as anotações do tipo especificado deste XObject.

(Herdado de XObject)
RemoveNodes()

Remove os nós filho desse documento ou elemento.

(Herdado de XContainer)
ReplaceNodes(Object)

Substitui os nós filho desse documento ou elemento pelo conteúdo especificado.

(Herdado de XContainer)
ReplaceNodes(Object[])

Substitui os nós filho desse documento ou elemento pelo conteúdo especificado.

(Herdado de XContainer)
ReplaceWith(Object)

Substitui esse nó pelo conteúdo especificado.

(Herdado de XNode)
ReplaceWith(Object[])

Substitui esse nó pelo conteúdo especificado.

(Herdado de XNode)
Save(Stream)

Gera este XDocument para o Stream especificado.

Save(Stream, SaveOptions)

Gera esse XDocument para o Stream especificado, com a opção de especificar o comportamento de formatação.

Save(String)

Serializar este XDocument em um arquivo, substituindo um arquivo existente, se ele existir.

Save(String, SaveOptions)

Serialize este XDocument em um arquivo, desabilitando a formatação de forma opcional.

Save(TextWriter)

Serialize este XDocument em um TextWriter.

Save(TextWriter, SaveOptions)

Serialize XDocument em TextWriter, desabilitando a formatação de forma opcional.

Save(XmlWriter)

Serializar esse XDocument para um XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Gere este XDocument como saída para um Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Grava este XDocument em um TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Grava este XDocument em um XmlWriter.

ToString()

Retorna o XML recuado para este nó.

(Herdado de XNode)
ToString(SaveOptions)

Retorna o XML para esse nó, com a opção de desabilitar a formatação.

(Herdado de XNode)
WriteTo(XmlWriter)

Gravar este documento em um XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Grava a árvore XML subjacente deste XDocument no XmlWriter especificado.

WriteToAsync(XmlWriter, CancellationToken)

Grava o nó atual em um XmlWriter.

(Herdado de XNode)

Eventos

Changed

Gerado quando esse XObject ou qualquer um de seus descendentes foi alterado.

(Herdado de XObject)
Changing

Acionado quando esse XObject ou um de seus descendentes está prestes a mudar.

(Herdado de XObject)

Implantações explícitas de interface

IXmlLineInfo.HasLineInfo()

Obtém um valor que indica se este XObject tem informações de linha ou não.

(Herdado de XObject)
IXmlLineInfo.LineNumber

Obtém o número de linha que o XmlReader subjacente relatou para este XObject.

(Herdado de XObject)
IXmlLineInfo.LinePosition

Obtém a posição de linha que o XmlReader subjacente relatou para este XObject.

(Herdado de XObject)

Métodos de Extensão

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Esse método valida se um XDocument está em conformidade com um XSD em um XmlSchemaSet.

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que um XDocument está em conformidade com um XSD em um XmlSchemaSet, opcionalmente, preenchendo a árvore XML com o PSVI (post-schema-validation infoset).

CreateNavigator(XNode)

Cria um XPathNavigator para um XNode.

CreateNavigator(XNode, XmlNameTable)

Cria um XPathNavigator para um XNode. O XmlNameTable habilita o processamento mais eficiente de expressão XPath.

XPathEvaluate(XNode, String)

Avalia uma expressão XPath.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Avalia uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.

XPathSelectElement(XNode, String)

Seleciona um XElement usando uma expressão XPath.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Seleciona um XElement usando uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.

XPathSelectElements(XNode, String)

Seleciona uma coleção de elementos usando uma expressão XPath.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Seleciona uma coleção de elementos usando uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.

ToXPathNavigable(XNode)

Retorna um acessador que permite que você navegue e edite o XNode especificado.

Aplica-se a

Produto Versões
.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, 8, 9
.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, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Confira também