Partilhar via


XElement Classe

Definição

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
Implementações

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. Consulte 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 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.

Aplica-se a

Confira também