XDocument Classe

Definição

Namespace:: System.Xml.Linq

Assemblies:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: System.Xml.XDocument.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.

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

public ref class XDocument : System::Xml::Linq::XContainer

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

Herança: Object

XObject

XNode

XContainer
XDocument

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);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

Este exemplo produz a seguinte saída:

<!--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

Nome	Description
XDocument()	Inicializa uma nova instância da classe XDocument.
XDocument(Object[])	Inicializa uma nova instância da XDocument classe com o conteúdo especificado.
XDocument(XDeclaration, Object[])	Inicializa uma nova instância da XDocument classe com o conteúdo especificado XDeclaration .
XDocument(XDocument)	Inicializa uma nova instância da classe de XDocument um objeto existente XDocument .

Propriedades

Nome	Description
BaseUri	Obtém o URI base para isso XObject. (Herdado de XObject)
Declaration	Obtém ou define a declaração XML deste documento.
Document	Obtém o XDocument para isso XObject. (Herdado de XObject)
DocumentType	Obtém a DTD (Definição de Tipo de Documento) deste documento.
FirstNode	Obtém o primeiro nó filho desse nó. (Herdado de XContainer)
LastNode	Obtém o último nó filho deste nó. (Herdado de XContainer)
NextNode	Obtém o próximo nó irmão deste nó. (Herdado de XNode)
NodeType	Obtém o tipo de nó para este nó.
Parent	Obtém o pai XElement deste XObject. (Herdado de XObject)
PreviousNode	Obtém o nó irmão anterior deste nó. (Herdado de XNode)
Root	Obtém o elemento raiz da árvore XML deste documento.

Métodos

Nome	Description
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ções deste XObject. (Herdado de XObject)
AddBeforeSelf(Object)	Adiciona o conteúdo especificado imediatamente antes desse nó. (Herdado de XNode)
AddBeforeSelf(Object[])	Adiciona o conteúdo especificado imediatamente antes desse nó. (Herdado de XNode)
AddFirst(Object)	Adiciona o conteúdo especificado como os primeiros filhos deste documento ou elemento. (Herdado de XContainer)
AddFirst(Object[])	Adiciona o conteúdo especificado como os primeiros filhos deste 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 uma 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 deste XObject. (Herdado de XObject)
Annotation<T>()	Obtém o primeiro objeto de anotação do tipo especificado deste 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 `readerOptions` parâmetro. (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 de nós descendentes para este documento ou elemento, na ordem do documento. (Herdado de XContainer)
Descendants()	Retorna uma coleção dos elementos descendentes deste documento ou elemento, na ordem do documento. (Herdado de XContainer)
Descendants(XName)	Retorna uma coleção filtrada dos elementos descendentes deste documento ou elemento, na ordem do documento. Somente os elementos que têm uma XName correspondente são incluídos na coleção. (Herdado de XContainer)
Element(XName)	Obtém o primeiro elemento filho (em ordem de documento) com o especificado XName. (Herdado de XContainer)
Elements()	Retorna uma coleção dos elementos filho deste 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 uma XName correspondente são incluídos na coleção. (Herdado de XContainer)
ElementsAfterSelf()	Retorna uma coleção dos elementos irmãos 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 uma 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 uma 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 hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsAfter(XNode)	Determina se o nó atual é exibido após um nó especificado em termos de ordem do documento. (Herdado de XNode)
IsBefore(XNode)	Determina se o nó atual aparece antes de um nó especificado em termos de ordem do documento. (Herdado de XNode)
Load(Stream, LoadOptions)	Cria uma nova XDocument instância usando o fluxo especificado, preservando opcionalmente o espaço em branco, definindo o URI base e retendo informações de linha.
Load(Stream)	Cria uma nova XDocument instância usando o fluxo especificado.
Load(String, LoadOptions)	Cria um novo XDocument de um arquivo, preservando opcionalmente o espaço em branco, definindo o URI base e retendo informações de linha.
Load(String)	Cria um novo XDocument de um arquivo.
Load(TextReader, LoadOptions)	Cria um novo XDocument de um TextReader, opcionalmente preservando o espaço em branco, definindo o URI base e retendo informações de linha.
Load(TextReader)	Cria um novo XDocument de um TextReader.
Load(XmlReader, LoadOptions)	Carrega um XDocument de um XmlReader, opcionalmente, definindo o URI base e retendo informações de linha.
Load(XmlReader)	Cria um novo XDocument de um XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Cria de forma assíncrona uma nova XDocument e inicializa sua árvore XML subjacente do fluxo especificado, preservando opcionalmente o espaço em branco.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Cria uma nova XDocument e inicializa sua árvore XML subjacente usando o parâmetro especificado TextReader , preservando opcionalmente o espaço em branco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Cria um novo XDocument contendo o conteúdo do especificado XmlReader.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Nodes()	Retorna uma coleção dos nós filho desse 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 desse nó, na ordem do documento. (Herdado de XNode)
Parse(String, LoadOptions)	Cria um novo XDocument de uma cadeia de caracteres, preservando opcionalmente o espaço em branco, definindo o URI base e retendo informações de linha.
Parse(String)	Cria um novo XDocument de uma cadeia de caracteres.
Remove()	Remove esse 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 deste documento ou elemento. (Herdado de XContainer)
ReplaceNodes(Object)	Substitui os nós filhos deste documento ou elemento pelo conteúdo especificado. (Herdado de XContainer)
ReplaceNodes(Object[])	Substitui os nós filhos deste 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, SaveOptions)	Gera isso XDocument para o comportamento de formatação especificado Stream, opcionalmente.
Save(Stream)	Gera isso XDocument para o especificado Stream.
Save(String, SaveOptions)	Serialize isso XDocument em um arquivo, opcionalmente desabilitando a formatação.
Save(String)	Serialize isso XDocument em um arquivo, substituindo um arquivo existente, se ele existir.
Save(TextWriter, SaveOptions)	Serialize isso XDocument em uma TextWriterformatação opcionalmente desabilitando.
Save(TextWriter)	Serialize isso XDocument em um TextWriter.
Save(XmlWriter)	Serialize isso XDocument em um XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Gere isso XDocument para um Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Grava isso XDocument em um TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Grava isso XDocument em um XmlWriter.
ToString()	Retorna o XML recuado para este nó. (Herdado de XNode)
ToString(SaveOptions)	Retorna o XML para esse nó, opcionalmente desabilitando a formatação. (Herdado de XNode)
WriteTo(XmlWriter)	Escreva este documento em um XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Grava a árvore XML subjacente deste XDocument no especificado XmlWriter.

Eventos

Nome	Description
Changed	Gerado quando este XObject ou qualquer um de seus descendentes mudou. (Herdado de XObject)
Changing	Gerado quando este XObject ou qualquer um de seus descendentes estão prestes a mudar. (Herdado de XObject)

Implantações explícitas de interface

Nome	Description
IXmlLineInfo.HasLineInfo()	Obtém um valor que indica se isso XObject tem ou não informações de linha. (Herdado de XObject)
IXmlLineInfo.LineNumber	Obtém o número de linha que o subjacente XmlReader relatou para isso XObject. (Herdado de XObject)
IXmlLineInfo.LinePosition	Obtém a posição de linha que o subjacente XmlReader relatou para isso XObject. (Herdado de XObject)

Métodos de Extensão

Nome	Description
CreateNavigator(XNode, XmlNameTable)	Cria um XPathNavigator para um XNode. O XmlNameTable habilita o processamento de expressão XPath mais eficiente.
CreateNavigator(XNode)	Cria um XPathNavigator para um XNode.
ToXPathNavigable(XNode)	Retorna um acessador que permite navegar e editar o especificado XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Valida se um XDocument XSD está em conformidade com um XSD em uma XmlSchemaSetárvore XML, opcionalmente populando a árvore XML com o conjunto de informações pós-validação de esquema (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Esse método valida que um XDocument XSD está em XmlSchemaSetconformidade com um .
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Avalia uma expressão XPath, resolvendo prefixos de namespace usando o especificado IXmlNamespaceResolver.
XPathEvaluate(XNode, String)	Avalia uma expressão XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Seleciona um XElement uso de uma expressão XPath, resolvendo prefixos de namespace usando o especificado IXmlNamespaceResolver.
XPathSelectElement(XNode, String)	Seleciona um XElement uso de uma expressão XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Seleciona uma coleção de elementos usando uma expressão XPath, resolvendo prefixos de namespace usando o especificado IXmlNamespaceResolver.
XPathSelectElements(XNode, String)	Seleciona uma coleção de elementos usando uma expressão XPath.

Aplica-se a

Confira também

Comentários

Esta página foi útil?