XElement Classe

Definição

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Representa um elemento XML. Consulte Visão geral da classe XElement e a seção Comentários nesta página para ver informações de uso e exemplos.

public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable

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

public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable

public class XElement : System.Xml.Linq.XContainer

type XElement = class
    inherit XContainer
    interface IXmlSerializable

type XElement = class
    inherit XContainer

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

Public Class XElement
Inherits XContainer

Herança

Object

XObject

XNode

XContainer

XElement

Implementações

IXmlSerializable

Exemplos

O exemplo a seguir cria uma árvore XML. O conteúdo do novo elemento vem de uma consulta LINQ.

XElement xmlTree1 = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5),  
    new XElement("Child6", 6)  
);  

XElement xmlTree2 = new XElement("Root",  
    from el in xmlTree1.Elements()  
    where((int)el >= 3 && (int)el <= 5)  
    select el  
);  
Console.WriteLine(xmlTree2);  

Dim xmlTree1 As XElement = _  
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
            <Child6>6</Child6>  
        </Root>  

Dim xmlTree2 As XElement = _   
    <Root>  
        <%= From el In xmlTree1.Elements() _  
            Where el.Value >= 3 And el.Value <= 5 _  
            Select el %>  
    </Root>  

Console.WriteLine(xmlTree2)  

Esse exemplo gera a saída a seguir:

<Root>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

O exemplo a seguir é o mesmo, mas nesse caso o XML está em um namespace. Para obter mais informações, consulte Trabalhar com namespaces XML.

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree1 = new XElement(aw + "Root",  
    new XElement(aw + "Child1", 1),  
    new XElement(aw + "Child2", 2),  
    new XElement(aw + "Child3", 3),  
    new XElement(aw + "Child4", 4),  
    new XElement(aw + "Child5", 5),  
    new XElement(aw + "Child6", 6)  
);  

XElement xmlTree2 = new XElement(aw + "Root",  
    from el in xmlTree1.Elements()  
    where((int)el >= 3 && (int)el <= 5)  
    select el  
);  
Console.WriteLine(xmlTree2);  

Imports <xmlns="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim xmlTree1 As XElement = _  
            <Root>  
                <Child1>1</Child1>  
                <Child2>2</Child2>  
                <Child3>3</Child3>  
                <Child4>4</Child4>  
                <Child5>5</Child5>  
                <Child6>6</Child6>  
            </Root>  

        Dim xmlTree2 As XElement = _   
            <Root>  
                <%= From el In xmlTree1.Elements() _  
                    Where el.Value >= 3 And el.Value <= 5 _  
                    Select el %>  
            </Root>  

        Console.WriteLine(xmlTree2)  
    End SUb  
End Module  

Esse exemplo gera a saída a seguir:

<Root xmlns="http://www.adventure-works.com">  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

Comentários

Essa classe representa um elemento XML, o constructo XML fundamental. Confira a visão geral da classe XElement para obter outras informações de uso.

Um elemento tem um XName, opcionalmente, um ou mais atributos e pode, opcionalmente, conter conteúdo (para obter mais informações, consulte Nodes).

Uma XElement pode conter os seguintes tipos de conteúdo:

• XElement

• XComment

• XProcessingInstruction

• XText

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

XElement deriva de XContainer, que deriva de XNode.

Alguns XElement métodos podem ser usados do XAML. Para obter mais informações, consulte Propriedades dinâmicas LINQ to XML.

Construtores

XElement(XElement)	Inicializa uma nova instância da classe XElement de outro objeto XElement.
XElement(XName)	Inicializa uma nova instância da classe XElement com o nome especificado.
XElement(XName, Object)	Inicializa uma nova instância da classe XElement com o nome e conteúdo especificados.
XElement(XName, Object[])	Inicializa uma nova instância da classe XElement com o nome e conteúdo especificados.
XElement(XStreamingElement)	Inicializa uma nova instância da classe XElement de um objeto XStreamingElement.

Propriedades

BaseUri	Obtém o URI de base para este XObject. (Herdado de XObject)
Document	Obtém o XDocument para este XObject. (Herdado de XObject)
EmptySequence	Obtém uma coleção vazia de elementos.
FirstAttribute	Obtém o primeiro atributo desse elemento.
FirstNode	Obtém o primeiro nó filho desse nó. (Herdado de XContainer)
HasAttributes	Obtém um valor que indica se esse elemento tem pelo menos um atributo.
HasElements	Obtém um valor que indica se esse elemento tem pelo menos um elemento filho.
IsEmpty	Obtém um valor que indica se esse elemento não contém nenhum conteúdo.
LastAttribute	Obtém o último atributo desse elemento.
LastNode	Obtém o primeiro nó filho desse nó. (Herdado de XContainer)
Name	Obtém ou define o nome deste elemento.
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)
Value	Obtém ou define os conteúdos de texto concatenados desse elemento.

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)
AncestorsAndSelf()	Retorna uma coleção de elementos que contêm esse elemento e os ancestrais desse elemento.
AncestorsAndSelf(XName)	Retorna uma coleção filtrada de elementos que contêm esse elemento e os ancestrais dele. Somente os elementos que têm um XName correspondente são incluídos na coleção.
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)
Attribute(XName)	Retorna o XAttribute desse XElement que tem o XName especificado.
Attributes()	Retorna uma coleção de atributos desse elemento.
Attributes(XName)	Retorna uma coleção filtrada de atributos desse elemento. Somente atributos que têm um XName correspondente são incluídos na coleção.
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)
DescendantNodesAndSelf()	Retorna uma coleção de nós que contêm esse elemento e todos os nós descendentes desse elemento, na ordem do documento.
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)
DescendantsAndSelf()	Retorna uma coleção de elementos que contêm esse elemento e todos os elementos descendentes desse elemento, na ordem do documento.
DescendantsAndSelf(XName)	Retorna uma coleção filtrada de elementos que contêm esse elemento e todos os elementos descendentes dele, na ordem do documento. Somente os elementos que têm um XName correspondente são incluídos na coleção.
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)
GetDefaultNamespace()	Obtém o XNamespace padrão deste XElement.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetNamespaceOfPrefix(String)	Obtém o namespace associado a um prefixo específico para este XElement.
GetPrefixOfNamespace(XNamespace)	Obtém o prefixo associado a um namespace para este XElement.
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 XElement usando o fluxo especificado.
Load(Stream, LoadOptions)	Cria uma nova instância de XElement 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)	Carrega um XElement de um arquivo.
Load(String, LoadOptions)	Carrega um XElement de um arquivo, opcionalmente preservando espaço em branco, definindo o URI de base e retendo informações de linha.
Load(TextReader)	Carrega um XElement de um TextReader.
Load(TextReader, LoadOptions)	Carrega um XElement de um TextReader, opcionalmente, preservando os espaços em branco e retendo as informações de linha.
Load(XmlReader)	Carrega um XElement de um XmlReader.
Load(XmlReader, LoadOptions)	Carrega um XElement de um XmlReader, opcionalmente preservando o espaço em branco, definindo o URI de base e retendo informações de linha.
LoadAsync(Stream, LoadOptions, CancellationToken)	Cria de forma assíncrona um novo XElement e inicializa sua árvore XML subjacente usando o fluxo especificado, preservando opcionalmente o espaço em branco.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Cria de forma assíncrona um novo XElement e inicializa sua árvore XML subjacente usando o leitor de texto especificado, preservando opcionalmente o espaço em branco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Cria de forma assíncrona um novo XElement e inicializa sua árvore XML subjacente usando o leitor XML especificado, preservando opcionalmente o espaço em branco.
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)	Carrega um XElement de uma cadeia de caracteres que contém XML.
Parse(String, LoadOptions)	Carrega um XElement de uma cadeia de caracteres que contém XML, opcionalmente preservando espaço em branco e retendo informações de linha.
Remove()	Remove este nó de seu pai. (Herdado de XNode)
RemoveAll()	Remove nós e atributos deste XElement.
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)
RemoveAttributes()	Remove os atributos deste XElement.
RemoveNodes()	Remove os nós filho desse documento ou elemento. (Herdado de XContainer)
ReplaceAll(Object)	Substitui os nós filho e os atributos desse elemento com o conteúdo especificado.
ReplaceAll(Object[])	Substitui os nós filho e os atributos desse elemento com o conteúdo especificado.
ReplaceAttributes(Object)	Substitui os atributos desse elemento pelo conteúdo especificado.
ReplaceAttributes(Object[])	Substitui os atributos desse elemento pelo conteúdo especificado.
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 XElement para o Stream especificado.
Save(Stream, SaveOptions)	Gera esse XElement para o Stream especificado, com a opção de especificar o comportamento de formatação.
Save(String)	Serialize esse elemento em um arquivo.
Save(String, SaveOptions)	Serialize esse elemento em um arquivo, opcionalmente, desabilitando a formatação.
Save(TextWriter)	Serialize esse elemento para um TextWriter.
Save(TextWriter, SaveOptions)	Serializa esse elemento para um TextWriter, opcionalmente desabilitando a formatação.
Save(XmlWriter)	Serialize esse elemento em um XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Gera saída de forma assíncrona do XElement para um Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Gera saída de forma assíncrona do XElement para um TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Gera saída de forma assíncrona do XElement para um XmlWriter.
SetAttributeValue(XName, Object)	Define o valor de um atributo, adiciona um atributo ou remove um atributo.
SetElementValue(XName, Object)	Define o valor de um elemento filho e adiciona ou remove um elemento filho.
SetValue(Object)	Define o valor desse elemento.
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)	Grava esse elemento em um XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Grava assincronamente este XElement no gravador especificado.
WriteToAsync(XmlWriter, CancellationToken)	Grava o nó atual em um XmlWriter. (Herdado de XNode)

Operadores

Explicit(XElement to Boolean)	Converta o valor deste XElement em um Boolean.
Explicit(XElement to DateTime)	Converta o valor deste XElement em um DateTime.
Explicit(XElement to DateTimeOffset)	Converta o valor deste XAttribute em um DateTimeOffset.
Explicit(XElement to Decimal)	Converta o valor deste XElement em um Decimal.
Explicit(XElement to Double)	Converta o valor deste XElement em um Double.
Explicit(XElement to Guid)	Converta o valor deste XElement em um Guid.
Explicit(XElement to Int32)	Converta o valor deste XElement em um Int32.
Explicit(XElement to Int64)	Converta o valor deste XElement em um Int64.
Explicit(XElement to Nullable<Boolean>)	Converte o valor deste XElement em um Nullable<T> de Boolean.
Explicit(XElement to Nullable<DateTime>)	Converte o valor deste XElement em um Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Converte o valor deste XElement em um Nullable<T> de DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)	Converte o valor deste XElement em um Nullable<T> de Decimal.
Explicit(XElement to Nullable<Double>)	Converte o valor deste XElement em um Nullable<T> de Double.
Explicit(XElement to Nullable<Guid>)	Converte o valor deste XElement em um Nullable<T> de Guid.
Explicit(XElement to Nullable<Int32>)	Converte o valor deste XElement em um Nullable<T> de Int32.
Explicit(XElement to Nullable<Int64>)	Converte o valor deste XElement em um Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)	Converte o valor deste XElement em um Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)	Converte o valor deste XElement em um Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Converte o valor deste XElement em um Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)	Converte o valor deste XElement em um Nullable<T> de UInt64.
Explicit(XElement to Single)	Converta o valor deste XElement em um Single.
Explicit(XElement to String)	Converta o valor deste XElement em um String.
Explicit(XElement to TimeSpan)	Converta o valor deste XElement em um TimeSpan.
Explicit(XElement to UInt32)	Converta o valor deste XElement em um UInt32.
Explicit(XElement to UInt64)	Converta o valor deste XElement em um UInt64.

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)
IXmlSerializable.GetSchema()	Obtém uma definição de esquema XML que descreve a representação XML deste objeto.
IXmlSerializable.ReadXml(XmlReader)	Gera um objeto com base em sua representação XML.
IXmlSerializable.WriteXml(XmlWriter)	Converte um objeto em sua representação XML.

Métodos de Extensão

GetSchemaInfo(XElement)	Obtém o PSVI (post-schema-validation infoset) de um elemento validado.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	Esse método valida que uma subárvore XElement está em conformidade com um XmlSchemaObject e um XmlSchemaSet especificados.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	Valida se uma subárvore XElement está em conformidade com um XmlSchemaObject e XmlSchemaSet especificados, opcionalmente, populando a árvore XML com o PSVI (infoset de validação pós-esquema).
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.

Confira também

• Visão geral do LINQ to XML
• Propriedades dinâmicas LINQ to XML