XDocument Classe

Definição

Espaço de Nomes:: System.Xml.Linq

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

Assemblagem:: System.Xml.Linq.dll

Assemblagem:: System.Xml.XDocument.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um documento XML. Para os componentes e a utilização de um XDocument objeto, veja 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 seguinte cria um documento e depois acrescenta um comentário e um elemento a ele. Depois, 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>

Observações

Para detalhes sobre o conteúdo válido de um XDocument, veja Conteúdo Válido dos Objetos XElement e XDocument.

Construtores

Name	Description
XDocument()	Inicializa uma nova instância da XDocument classe.
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 especificado XDeclaration e conteúdo.
XDocument(XDocument)	Inicializa uma nova instância da XDocument classe a partir de um objeto existente XDocument .

Propriedades

Name	Description
BaseUri	Obtém o URI base para isto XObject. (Herdado de XObject)
Declaration	Recebe ou define a declaração XML para este documento.
Document	Recebe o XDocument por isto XObject. (Herdado de XObject)
DocumentType	Obtém a Definição do Tipo de Documento (DTD) para este documento.
FirstNode	Obtém o primeiro nó filho deste nó. (Herdado de XContainer)
LastNode	Obtém o último nó filho deste nó. (Herdado de XContainer)
NextNode	Recebe o próximo nó irmão desse nó. (Herdado de XNode)
NodeType	Obtém o tipo de nó para este nó.
Parent	Percebe o progenitor XElement disto 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 para este documento.

Métodos

Name	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 este nó. (Herdado de XNode)
AddAfterSelf(Object[])	Adiciona o conteúdo especificado imediatamente após este 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 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 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()	Devolve uma coleção dos elementos ancestrais deste nó. (Herdado de XNode)
Ancestors(XName)	Devolve uma coleção filtrada dos elementos ancestrais deste nó. Apenas os elementos que têm correspondência XName são incluídos na coleção. (Herdado de XNode)
Annotation(Type)	Obtém o primeiro objeto de anotação do tipo especificado a partir deste XObject. (Herdado de XObject)
Annotation<T>()	Obtém o primeiro objeto de anotação do tipo especificado a partir 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()	Devolve uma coleção dos nós descendentes deste documento ou elemento, por ordem do documento. (Herdado de XContainer)
Descendants()	Devolve uma coleção dos elementos descendentes deste documento ou elemento, por ordem do documento. (Herdado de XContainer)
Descendants(XName)	Devolve uma coleção filtrada dos elementos descendentes deste documento ou elemento, por ordem do documento. Apenas os elementos que têm correspondência XName são incluídos na coleção. (Herdado de XContainer)
Element(XName)	Obtém o primeiro elemento filho (na ordem do documento) com o elemento especificado XName. (Herdado de XContainer)
Elements()	Devolve uma coleção dos elementos filhos deste elemento ou documento, por ordem de documento. (Herdado de XContainer)
Elements(XName)	Devolve uma coleção filtrada dos elementos filhos deste elemento ou documento, por ordem do documento. Apenas os elementos que têm correspondência XName são incluídos na coleção. (Herdado de XContainer)
ElementsAfterSelf()	Devolve uma coleção dos elementos irmãos após este nó, por ordem de documento. (Herdado de XNode)
ElementsAfterSelf(XName)	Devolve uma coleção filtrada dos elementos irmãos após este nó, por ordem do documento. Apenas os elementos que têm correspondência XName são incluídos na coleção. (Herdado de XNode)
ElementsBeforeSelf()	Retorna uma coleção dos elementos irmãos antes deste nó, por ordem de documento. (Herdado de XNode)
ElementsBeforeSelf(XName)	Devolve uma coleção filtrada dos elementos irmãos antes deste nó, por ordem de documento. Apenas os elementos que têm correspondência XName 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 função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsAfter(XNode)	Determina se o nó atual aparece após um nó especificado em termos da ordem do documento. (Herdado de XNode)
IsBefore(XNode)	Determina se o nó atual aparece antes de um nó especificado em termos da 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 mantendo a informação da linha.
Load(Stream)	Cria uma nova XDocument instância usando o fluxo especificado.
Load(String, LoadOptions)	Cria um novo XDocument a partir de um ficheiro, preservando opcionalmente o espaço em branco, definindo o URI base e mantendo a informação da linha.
Load(String)	Cria um novo XDocument a partir de um ficheiro.
Load(TextReader, LoadOptions)	Cria um novo XDocument a partir de um TextReader, preservando opcionalmente o espaço em branco, definindo o URI base e mantendo a informação da linha.
Load(TextReader)	Cria um novo XDocument a partir de um TextReader.
Load(XmlReader, LoadOptions)	Carrega um XDocument a partir de um XmlReader, opcionalmente define o URI base e mantém a informação da linha.
Load(XmlReader)	Cria um novo XDocument a partir de um XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Cria assíncronamente uma nova XDocument árvore XML e inicializa a sua árvore XML subjacente a partir do fluxo especificado, preservando opcionalmente o espaço em branco.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Cria uma nova XDocument árvore XML e inicializa a 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 atual Object. (Herdado de Object)
Nodes()	Devolve uma coleção dos nós filhos deste elemento ou documento, por ordem do documento. (Herdado de XContainer)
NodesAfterSelf()	Devolve uma coleção dos nós irmãos após este nó, por ordem de documento. (Herdado de XNode)
NodesBeforeSelf()	Retorna uma coleção dos nós irmãos antes deste nó, por ordem de documento. (Herdado de XNode)
Parse(String, LoadOptions)	Cria um novo XDocument a partir de uma cadeia, preservando opcionalmente o espaço em branco, definindo o URI base e mantendo a informação da linha.
Parse(String)	Cria um novo XDocument a partir de uma corda.
Remove()	Remove este nó do 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 filhos 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 este nó pelo conteúdo especificado. (Herdado de XNode)
ReplaceWith(Object[])	Substitui este nó pelo conteúdo especificado. (Herdado de XNode)
Save(Stream, SaveOptions)	Exporta isto XDocument para o especificado Stream, opcionalmente especificando o comportamento de formatação.
Save(Stream)	Envia isto XDocument para o especificado Stream.
Save(String, SaveOptions)	Serialize isto XDocument para um ficheiro, desativando opcionalmente a formatação.
Save(String)	Serialize isto XDocument para um ficheiro, sobrescrevendo um ficheiro existente, se este existir.
Save(TextWriter, SaveOptions)	Serialize isto XDocument para um TextWriter, desativando opcionalmente a formatação.
Save(TextWriter)	Serialize isto XDocument para um TextWriter.
Save(XmlWriter)	Serialize isto XDocument para um XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Envie isto XDocument para um Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Escreve isto XDocument para um TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Escreve isto XDocument para um XmlWriter.
ToString()	Retorna o XML indentado para este nó. (Herdado de XNode)
ToString(SaveOptions)	Devolve o XML deste nó, desativando opcionalmente a formatação. (Herdado de XNode)
WriteTo(XmlWriter)	Escreva este documento para um XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Escreve a árvore XML subjacente deste XDocument para o especificado XmlWriter.

evento

Name	Description
Changed	Ergueu-se quando este XObject ou qualquer um dos seus descendentes mudou. (Herdado de XObject)
Changing	Erguidos quando este XObject ou qualquer um dos seus descendentes está prestes a mudar. (Herdado de XObject)

Implementações de Interface Explícita

Name	Description
IXmlLineInfo.HasLineInfo()	Recebe um valor que indica se tem XObject ou não informação de linha. (Herdado de XObject)
IXmlLineInfo.LineNumber	Obtém o número de linha que o subjacente XmlReader reportou para isto XObject. (Herdado de XObject)
IXmlLineInfo.LinePosition	Obtém a posição de linha que o subjacente XmlReader reportou para este XObject. (Herdado de XObject)

Métodos da Extensão

Name	Description
CreateNavigator(XNode, XmlNameTable)	Cria um XPathNavigator para um XNode. Isto XmlNameTable permite um processamento de expressões XPath mais eficiente.
CreateNavigator(XNode)	Cria um XPathNavigator para um XNode.
ToXPathNavigable(XNode)	Devolve um acessório que permite navegar e editar o arquivo especificado XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Valida que um XDocument conforma um XSD num XmlSchemaSet, preenchendo opcionalmente a árvore XML com o conjunto de infos pós-validação de esquema (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Este método valida que um XDocument se conforma a um XSD num XmlSchemaSet.
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 e XElement usando uma expressão XPath, resolvendo prefixos de namespace usando o especificado IXmlNamespaceResolver.
XPathSelectElement(XNode, String)	Seleciona e XElement usando 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

Ver também

Comentários

Esta página foi útil?