XDocument Classe

Definição

Representa um documento XML.Represents an XML document. Para saber mais sobre os componentes e o uso de um objeto XDocument, consulte Visão geral da classe XDocument.For the components and usage of an XDocument object, see XDocument Class Overview.

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

Exemplos

O exemplo a seguir cria um documento e, em seguida, adiciona um comentário e um elemento a ele.The following example creates a document, and then adds a comment and an element to it. Em seguida, ele compõe outro documento usando os resultados de uma consulta.It then composes another document using the results of a query.

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)  

Esse exemplo gera a saída a seguir:This example produces the following output:

<!--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.For details about the valid content of an XDocument, see Valid Content of XElement and XDocument Objects.

Construtores

XDocument()

Inicia uma nova instância da classe XDocument.Initializes a new instance of the XDocument class.

XDocument(Object[])

Inicializa uma nova instância da classe XDocument com o conteúdo especificado.Initializes a new instance of the XDocument class with the specified content.

XDocument(XDeclaration, Object[])

Inicializa uma nova instância da classe XDocument com o XDeclaration e conteúdo especificados.Initializes a new instance of the XDocument class with the specified XDeclaration and content.

XDocument(XDocument)

Inicializa uma nova instância da classe XDocument de um objeto XDocument existente.Initializes a new instance of the XDocument class from an existing XDocument object.

Propriedades

BaseUri

Obtém o URI de base para este XObject.Gets the base URI for this XObject.

(Herdado de XObject)
Declaration

Obtém ou define a declaração XML para este documento.Gets or sets the XML declaration for this document.

Document

Obtém o XDocument para este XObject.Gets the XDocument for this XObject.

(Herdado de XObject)
DocumentType

Obtém a DTD (Definição de Tipo de Documento) desse documento.Gets the Document Type Definition (DTD) for this document.

FirstNode

Obtém o primeiro nó filho desse nó.Gets the first child node of this node.

(Herdado de XContainer)
LastNode

Obtém o primeiro nó filho desse nó.Gets the last child node of this node.

(Herdado de XContainer)
NextNode

Obtém o próximo nó irmão desse nó.Gets the next sibling node of this node.

(Herdado de XNode)
NodeType

Obtém o tipo de nó para este nó.Gets the node type for this node.

Parent

Obtém o pai XElement desse XObject.Gets the parent XElement of this XObject.

(Herdado de XObject)
PreviousNode

Obtém o nó irmão anterior desse nó.Gets the previous sibling node of this node.

(Herdado de XNode)
Root

Obtém o elemento raiz da Árvore XML desse documento.Gets the root element of the XML Tree for this document.

Métodos

Add(Object)

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

(Herdado de XContainer)
Add(Object[])

Adiciona o conteúdo especificado como filhos deste XContainer.Adds the specified content as children of this XContainer.

(Herdado de XContainer)
AddAfterSelf(Object)

Adiciona o conteúdo especificado imediatamente após esse nó.Adds the specified content immediately after this node.

(Herdado de XNode)
AddAfterSelf(Object[])

Adiciona o conteúdo especificado imediatamente após esse nó.Adds the specified content immediately after this node.

(Herdado de XNode)
AddAnnotation(Object)

Adiciona um objeto à lista de anotação deste XObject.Adds an object to the annotation list of this XObject.

(Herdado de XObject)
AddBeforeSelf(Object)

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

(Herdado de XNode)
AddBeforeSelf(Object[])

Adiciona o conteúdo especificado imediatamente antes deste nó.Adds the specified content immediately before this node.

(Herdado de XNode)
AddFirst(Object)

Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.Adds the specified content as the first children of this document or element.

(Herdado de XContainer)
AddFirst(Object[])

Adiciona o conteúdo especificado como os primeiros filhos desse documento ou elemento.Adds the specified content as the first children of this document or element.

(Herdado de XContainer)
Ancestors()

Retorna uma coleção dos elementos ancestrais deste nó.Returns a collection of the ancestor elements of this node.

(Herdado de XNode)
Ancestors(XName)

Retorna uma coleção filtrada dos elementos ancestrais deste nó.Returns a filtered collection of the ancestor elements of this node. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

(Herdado de XNode)
Annotation(Type)

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.Gets the first annotation object of the specified type from this XObject.

(Herdado de XObject)
Annotation<T>()

Obtém o primeiro objeto de anotação do tipo especificado desse XObject.Gets the first annotation object of the specified type from this XObject.

(Herdado de XObject)
Annotations(Type)

Obtém uma coleção de anotações do tipo especificado para este XObject.Gets a collection of annotations of the specified type for this XObject.

(Herdado de XObject)
Annotations<T>()

Obtém uma coleção de anotações do tipo especificado para este XObject.Gets a collection of annotations of the specified type for this XObject.

(Herdado de XObject)
CreateReader()

Cria um XmlReader para este nó.Creates an XmlReader for this node.

(Herdado de XNode)
CreateReader(ReaderOptions)

Cria um XmlReader com as opções especificadas pelo parâmetro readerOptions.Creates an XmlReader with the options specified by the readerOptions parameter.

(Herdado de XNode)
CreateWriter()

Cria um XmlWriter que pode ser usado para adicionar nós ao XContainer.Creates an XmlWriter that can be used to add nodes to the XContainer.

(Herdado de XContainer)
DescendantNodes()

Retorna uma coleção dos nós descendentes desse documento ou elemento, na ordem do documento.Returns a collection of the descendant nodes for this document or element, in document order.

(Herdado de XContainer)
Descendants()

Retorna uma coleção dos elementos descendentes desse documento ou elemento, na ordem do documento.Returns a collection of the descendant elements for this document or element, in document order.

(Herdado de XContainer)
Descendants(XName)

Retorna uma coleção filtrada dos elementos descendentes desse documento ou elemento, na ordem do documento.Returns a filtered collection of the descendant elements for this document or element, in document order. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

(Herdado de XContainer)
Element(XName)

Obtém o primeiro elemento filho (na ordem de documentos) com o XName especificado.Gets the first (in document order) child element with the specified XName.

(Herdado de XContainer)
Elements()

Retorna uma coleção dos elementos filho desse elemento ou documento, na ordem do documento.Returns a collection of the child elements of this element or document, in document order.

(Herdado de XContainer)
Elements(XName)

Retorna uma coleção filtrada dos elementos filho desse elemento ou documento, na ordem do documento.Returns a filtered collection of the child elements of this element or document, in document order. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

(Herdado de XContainer)
ElementsAfterSelf()

Retorna uma coleção dos elementos irmão após esse nó, na ordem do documento.Returns a collection of the sibling elements after this node, in document order.

(Herdado de XNode)
ElementsAfterSelf(XName)

Retorna uma coleção filtrada dos elementos irmãos após esse nó, na ordem do documento.Returns a filtered collection of the sibling elements after this node, in document order. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

(Herdado de XNode)
ElementsBeforeSelf()

Retorna uma coleção dos elementos irmãos antes desse nó, na ordem do documento.Returns a collection of the sibling elements before this node, in document order.

(Herdado de XNode)
ElementsBeforeSelf(XName)

Retorna uma coleção filtrada dos elementos irmãos antes desse nó, na ordem do documento.Returns a filtered collection of the sibling elements before this node, in document order. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

(Herdado de XNode)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IsAfter(XNode)

Determina se o nó atual aparece depois de um nó especificado com relação à ordem do documento.Determines if the current node appears after a specified node in terms of document order.

(Herdado de XNode)
IsBefore(XNode)

Determina se o nó atual aparece antes de um nó especificado com relação à ordem do documento.Determines if the current node appears before a specified node in terms of document order.

(Herdado de XNode)
Load(Stream)

Cria uma nova instância XDocument usando o fluxo especificado.Creates a new XDocument instance by using the specified stream.

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.Creates a new XDocument instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(String)

Cria um novo XDocument com base em um arquivo.Creates a new XDocument from a file.

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.Creates a new XDocument from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader)

Cria um novo XDocument com base em um TextReader.Creates a new XDocument from a 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.Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(XmlReader)

Cria um novo XDocument com base em um XmlReader.Creates a new XDocument from an XmlReader.

Load(XmlReader, LoadOptions)

Carrega um XDocument de um XmlReader, configurando opcionalmente o URI de base e retendo informações de linha.Loads an XDocument from an XmlReader, optionally setting the base URI, and retaining line information.

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.Asynchronously creates a new XDocument and initializes its underlying XML tree from the specified stream, optionally preserving white space.

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.Creates a new XDocument and initializes its underlying XML tree using the specified TextReader parameter, optionally preserving white space.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Cria um novo XDocument que contém o conteúdo do XmlReader especificado.Creates a new XDocument containing the contents of the specified XmlReader.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Nodes()

Retorna uma coleção de nós filhos deste elemento ou documento, na ordem do documento.Returns a collection of the child nodes of this element or document, in document order.

(Herdado de XContainer)
NodesAfterSelf()

Retorna uma coleção de nós irmãos após esse nó, na ordem do documento.Returns a collection of the sibling nodes after this node, in document order.

(Herdado de XNode)
NodesBeforeSelf()

Retorna uma coleção de nós irmãos antes deste nó, na ordem do documento.Returns a collection of the sibling nodes before this node, in document order.

(Herdado de XNode)
Parse(String)

Cria um novo XDocument com base em uma cadeia de caracteres.Creates a new XDocument from a string.

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.Creates a new XDocument from a string, optionally preserving white space, setting the base URI, and retaining line information.

Remove()

Remove este nó de seu pai.Removes this node from its parent.

(Herdado de XNode)
RemoveAnnotations(Type)

Remove as anotações do tipo especificado deste XObject.Removes the annotations of the specified type from this XObject.

(Herdado de XObject)
RemoveAnnotations<T>()

Remove as anotações do tipo especificado deste XObject.Removes the annotations of the specified type from this XObject.

(Herdado de XObject)
RemoveNodes()

Remove os nós filho desse documento ou elemento.Removes the child nodes from this document or element.

(Herdado de XContainer)
ReplaceNodes(Object)

Substitui os nós filho desse documento ou elemento pelo conteúdo especificado.Replaces the children nodes of this document or element with the specified content.

(Herdado de XContainer)
ReplaceNodes(Object[])

Substitui os nós filho desse documento ou elemento pelo conteúdo especificado.Replaces the children nodes of this document or element with the specified content.

(Herdado de XContainer)
ReplaceWith(Object)

Substitui esse nó pelo conteúdo especificado.Replaces this node with the specified content.

(Herdado de XNode)
ReplaceWith(Object[])

Substitui esse nó pelo conteúdo especificado.Replaces this node with the specified content.

(Herdado de XNode)
Save(Stream)

Gera este XDocument para o Stream especificado.Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Gera esse XDocument para o Stream especificado, com a opção de especificar o comportamento de formatação.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(String)

Serializar este XDocument em um arquivo, substituindo um arquivo existente, se ele existir.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(String, SaveOptions)

Serialize este XDocument em um arquivo, desabilitando a formatação de forma opcional.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

Serialize este XDocument em um TextWriter.Serialize this XDocument to a TextWriter.

Save(TextWriter, SaveOptions)

Serialize XDocument em TextWriter, desabilitando a formatação de forma opcional.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(XmlWriter)

Serializar esse XDocument para um XmlWriter.Serialize this XDocument to an XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Gere este XDocument como saída para um Stream.Output this XDocument to a Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Grava este XDocument em um TextWriter.Writes this XDocument to a TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Grava este XDocument em um XmlWriter.Writes this XDocument to an XmlWriter.

ToString()

Retorna o XML recuado para este nó.Returns the indented XML for this node.

(Herdado de XNode)
ToString(SaveOptions)

Retorna o XML para esse nó, com a opção de desabilitar a formatação.Returns the XML for this node, optionally disabling formatting.

(Herdado de XNode)
WriteTo(XmlWriter)

Gravar este documento em um XmlWriter.Write this document to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Grava a árvore XML subjacente deste XDocument no XmlWriter especificado.Writes this XDocument's underlying XML tree to the specified XmlWriter.

Eventos

Changed

Gerado quando esse XObject ou qualquer um de seus descendentes foi alterado.Raised when this XObject or any of its descendants have changed.

(Herdado de XObject)
Changing

Acionado quando esse XObject ou um de seus descendentes está prestes a mudar.Raised when this XObject or any of its descendants are about to change.

(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.Gets a value indicating whether or not this XObject has line information.

(Herdado de XObject)
IXmlLineInfo.LineNumber

Obtém o número de linha que o XmlReader subjacente relatou para este XObject.Gets the line number that the underlying XmlReader reported for this XObject.

(Herdado de XObject)
IXmlLineInfo.LinePosition

Obtém a posição de linha que o XmlReader subjacente relatou para este XObject.Gets the line position that the underlying XmlReader reported for this 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.This method validates that an XDocument conforms to an XSD in an 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).Validates that an XDocument conforms to an XSD in an XmlSchemaSet, optionally populating the XML tree with the post-schema-validation infoset (PSVI).

CreateNavigator(XNode)

Cria um XPathNavigator para um XNode.Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Cria um XPathNavigator para um XNode.Creates an XPathNavigator for an XNode. O XmlNameTable habilita o processamento mais eficiente de expressão XPath.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Avalia uma expressão XPath.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Avalia uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

Seleciona um XElement usando uma expressão XPath.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Seleciona um XElement usando uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Seleciona uma coleção de elementos usando uma expressão XPath.Selects a collection of elements using an XPath expression.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Seleciona uma coleção de elementos usando uma expressão XPath, resolvendo os prefixos de namespace usando o IXmlNamespaceResolver especificado.Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Retorna um acessador que permite que você navegue e edite o XNode especificado.Returns an accessor that allows you to navigate and edit the specified XNode.

Aplica-se a

Veja também