XElement Classe

Definição

Namespace:
System.Xml.Linq
Assemblies:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblies:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs

Representa um elemento XML. Confira a visão geral da classe XElement e a seção Comentários nesta página para obter 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)

Este exemplo produz a seguinte saída:

<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

Este exemplo produz a seguinte saída:

<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. Consulte 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, opcionalmente, pode conter conteúdo (para obter mais informações, consulte Nodes).

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

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 a partir de XAML. Para obter mais informações, consulte LinQ to XML Dynamic Properties.

Construtores

Nome Description
XElement(XElement)

Inicializa uma nova instância da classe de XElement outro XElement objeto.
XElement(XName, Object)

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

Inicializa uma nova instância da XElement classe com o nome e o conteúdo especificados.
XElement(XName)

Inicializa uma nova instância da XElement classe com o nome especificado.
XElement(XStreamingElement)

Inicializa uma nova instância da classe de XElement um XStreamingElement objeto.

Propriedades

Nome Description
BaseUri

Obtém o URI base para isso XObject.

(Herdado de XObject)
Document

Obtém o XDocument para isso 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 conteúdo.
LastAttribute

Obtém o último atributo desse elemento.
LastNode

Obtém o último nó filho deste nó.

(Herdado de XContainer)
Name

Obtém ou define o nome desse elemento.
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)
Value

Obtém ou define o conteúdo de texto concatenado desse elemento.

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)
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 desse elemento. Somente os elementos que têm uma XName correspondente são incluídos na coleção.
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)
Attribute(XName)

Retorna o XAttribute deste XElement que tem o especificado XName.
Attributes()

Retorna uma coleção de atributos desse elemento.
Attributes(XName)

Retorna uma coleção filtrada de atributos desse elemento. Somente os atributos que têm uma correspondência XName 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 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)
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 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)
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 desse elemento, na ordem do documento. Somente os elementos que têm uma XName correspondente são incluídos na coleção.
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)
GetDefaultNamespace()

Obtém o padrão XNamespace 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 é 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 XElement 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 XElement instância usando o fluxo especificado.
Load(String, LoadOptions)

Carrega um XElement de um arquivo, preservando opcionalmente o espaço em branco, definindo o URI base e retendo informações de linha.
Load(String)

Carrega um XElement de um arquivo.
Load(TextReader, LoadOptions)

Carrega um XElement de um TextReader, opcionalmente preservando o espaço em branco e retendo informações de linha.
Load(TextReader)

Carrega um XElement de um TextReader.
Load(XmlReader, LoadOptions)

Carrega um XElement de um XmlReader, opcionalmente preservando o espaço em branco, definindo o URI base e retendo informações de linha.
Load(XmlReader)

Carrega um XElement de um XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)

Cria de forma assíncrona uma nova 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 uma nova 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 uma nova 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 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)

Carregue um XElement de uma cadeia de caracteres que contenha XML, preservando opcionalmente o espaço em branco e retendo informações de linha.
Parse(String)

Carregue um XElement de uma cadeia de caracteres que contém XML.
Remove()

Remove esse 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 deste documento ou elemento.

(Herdado de XContainer)
ReplaceAll(Object)

Substitui os nós filho e os atributos desse elemento pelo conteúdo especificado.
ReplaceAll(Object[])

Substitui os nós filho e os atributos desse elemento pelo 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 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 XElement para o comportamento de formatação especificado Stream, opcionalmente.
Save(Stream)

Gera isso XElement para o especificado Stream.
Save(String, SaveOptions)

Serialize esse elemento em um arquivo, desabilitando opcionalmente a formatação.
Save(String)

Serialize esse elemento em um arquivo.
Save(TextWriter, SaveOptions)

Serialize esse elemento em um TextWriter, opcionalmente desabilitando a formatação.
Save(TextWriter)

Serialize esse elemento em um TextWriter.
Save(XmlWriter)

Serialize esse elemento em um XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Gera isso XElement de forma assíncrona para um Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Gera isso XElement de forma assíncrona para um TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Gera isso XElement de forma assíncrona 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, adiciona um elemento filho 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ó, opcionalmente desabilitando a formatação.

(Herdado de XNode)
WriteTo(XmlWriter)

Escreva este elemento em um XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Grava isso XElement de forma assíncrona no gravador especificado.

Operadores

Nome Description
Explicit(XElement to Boolean)

Converta o valor disso XElement em um Boolean.
Explicit(XElement to DateTime)

Converta o valor disso XElement em um DateTime.
Explicit(XElement to DateTimeOffset)

Converta o valor disso XAttribute em um DateTimeOffset.
Explicit(XElement to Decimal)

Converta o valor disso XElement em um Decimal.
Explicit(XElement to Double)

Converta o valor disso XElement em um Double.
Explicit(XElement to Guid)

Converta o valor disso XElement em um Guid.
Explicit(XElement to Int32)

Converta o valor disso XElement em um Int32.
Explicit(XElement to Int64)

Converta o valor disso XElement em um Int64.
Explicit(XElement to Nullable<Boolean>)

Converta o valor disso XElement em um Nullable<T> de Boolean.
Explicit(XElement to Nullable<DateTime>)

Converta o valor disso XElement em um Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)

Converta o valor disso XElement em um Nullable<T> de DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)

Converta o valor disso XElement em um Nullable<T> de Decimal.
Explicit(XElement to Nullable<Double>)

Converta o valor disso XElement em um Nullable<T> de Double.
Explicit(XElement to Nullable<Guid>)

Converta o valor disso XElement em um Nullable<T> de Guid.
Explicit(XElement to Nullable<Int32>)

Converta o valor disso XElement em um Nullable<T> de Int32.
Explicit(XElement to Nullable<Int64>)

Converta o valor disso XElement em um Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)

Converta o valor disso XElement em um Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)

Converta o valor disso XElement em um Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)

Converta o valor disso XElement em um Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)

Converta o valor disso XElement em um Nullable<T> de UInt64.
Explicit(XElement to Single)

Converta o valor disso XElement em um Single.
Explicit(XElement to String)

Converta o valor disso XElement em um String.
Explicit(XElement to TimeSpan)

Converta o valor disso XElement em um TimeSpan.
Explicit(XElement to UInt32)

Converta o valor disso XElement em um UInt32.
Explicit(XElement to UInt64)

Converta o valor disso XElement em um UInt64.

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)
IXmlSerializable.GetSchema()

Obtém uma definição de esquema XML que descreve a representação XML desse objeto.
IXmlSerializable.ReadXml(XmlReader)

Gera um objeto de sua representação XML.
IXmlSerializable.WriteXml(XmlWriter)

Converte um objeto em sua representação XML.

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.
GetSchemaInfo(XElement)

Obtém o CONJUNTO de informações pós-validação de esquema (PSVI) de um elemento validado.
ToXPathNavigable(XNode)

Retorna um acessador que permite navegar e editar o especificado XNode.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida se uma XElement subárvore está em conformidade com um especificado XmlSchemaObject e um XmlSchemaSet, opcionalmente, populando a árvore XML com o conjunto de informações pós-validação de esquema (PSVI).
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Esse método valida que uma XElement subárvore está em conformidade com uma especificada XmlSchemaObject e uma 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 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