XElement Classe

Definição

Espaço de Nomes:
System.Xml.Linq
Assemblagens:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblagens:
netstandard.dll, System.Xml.XDocument.dll
Assemblagem:
System.Xml.XDocument.dll
Assemblagem:
System.Xml.Linq.dll
Assemblagem:
netstandard.dll
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs
Origem:
XElement.cs

Representa um elemento XML. Consulte a Visão Geral da Classe XElement e a secção de Observações nesta página para informações de utilização 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 seguinte cria uma árvore XML. O conteúdo do novo elemento provém 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 seguinte é o mesmo, mas neste caso o XML está num namespace. Para 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>

Observações

Esta classe representa um elemento XML, o construto fundamental de XML. Consulte a Visão Geral da Classe XElement para outras informações de utilização.

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

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

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

XElement deriva de XContainer, que deriva de XNode.

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

Construtores

Name Description
XElement(XElement)

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

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

Inicializa uma nova instância da XElement classe com o nome e 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 XElement classe a partir de um XStreamingElement objeto.

Propriedades

Name Description
BaseUri

Obtém o URI base para isto XObject.

(Herdado de XObject)
Document

Recebe o XDocument por isto XObject.

(Herdado de XObject)
EmptySequence

Obtém uma coleção vazia de elementos.
FirstAttribute

Recebe o primeiro atributo deste elemento.
FirstNode

Obtém o primeiro nó filho deste nó.

(Herdado de XContainer)
HasAttributes

Recebe um valor que indica se este elemento tem pelo menos um atributo.
HasElements

Obtém um valor que indica se este elemento tem pelo menos um elemento filho.
IsEmpty

Recebe um valor que indica se este elemento não contém conteúdo.
LastAttribute

Recebe o último atributo deste elemento.
LastNode

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

(Herdado de XContainer)
Name

Recebe ou define o nome deste elemento.
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)
Value

Obtém ou define o conteúdo textual concatenado deste elemento.

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)
AncestorsAndSelf()

Devolve uma coleção de elementos que contêm este elemento, e os antepassados deste elemento.
AncestorsAndSelf(XName)

Devolve uma coleção filtrada de elementos que contêm este elemento, e os antepassados deste elemento. Apenas os elementos que têm correspondência XName são incluídos na coleção.
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)
Attribute(XName)

Devolve o XAttribute de isto XElement que tem o especificado XName.
Attributes()

Devolve uma coleção de atributos deste elemento.
Attributes(XName)

Devolve uma coleção filtrada de atributos deste elemento. Apenas os atributos que têm 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()

Devolve uma coleção dos nós descendentes deste documento ou elemento, por ordem do documento.

(Herdado de XContainer)
DescendantNodesAndSelf()

Devolve uma coleção de nós que contêm este elemento, e todos os nós descendentes deste elemento, por ordem de documento.
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)
DescendantsAndSelf()

Devolve uma coleção de elementos que contêm este elemento, e todos os elementos descendentes deste elemento, por ordem de documento.
DescendantsAndSelf(XName)

Devolve uma coleção filtrada de elementos que contêm este elemento, e todos os elementos descendentes deste elemento, por ordem do documento. Apenas os elementos que têm correspondência XName são incluídos na coleção.
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)
GetDefaultNamespace()

Obtém o padrão XNamespace deste XElement.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetNamespaceOfPrefix(String)

Obtém o namespace associado a um prefixo particular para este XElement.
GetPrefixOfNamespace(XNamespace)

Recebe 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 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 XElement 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 XElement instância usando o fluxo especificado.
Load(String, LoadOptions)

Carrega um XElement 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)

Carrega um XElement ficheiro a partir de um ficheiro.
Load(TextReader, LoadOptions)

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

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

Carrega um XElement a partir de um XmlReader, opcionalmente preservando o espaço em branco, definindo o URI base e mantendo a informação da linha.
Load(XmlReader)

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

De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o fluxo especificado, preservando opcionalmente o espaço em branco.
LoadAsync(TextReader, LoadOptions, CancellationToken)

De forma assíncrona, cria uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor de texto especificado, preservando opcionalmente o espaço em branco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Cria assíncronamente uma nova XElement árvore XML e inicializa a sua árvore XML subjacente usando o leitor XML especificado, preservando opcionalmente o espaço em branco.
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)

Carregar an XElement de uma string que contenha XML, preservando opcionalmente o espaço em branco e mantendo a informação da linha.
Parse(String)

Carregue um XElement a partir de uma string que contenha XML.
Remove()

Remove este nó do 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 filhos deste documento ou elemento.

(Herdado de XContainer)
ReplaceAll(Object)

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

Substitui os nós filhos e os atributos deste elemento pelo conteúdo especificado.
ReplaceAttributes(Object)

Substitui os atributos deste elemento pelo conteúdo especificado.
ReplaceAttributes(Object[])

Substitui os atributos deste 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 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 XElement para o especificado Stream, opcionalmente especificando o comportamento de formatação.
Save(Stream)

Envia isto XElement para o especificado Stream.
Save(String, SaveOptions)

Serialize este elemento para um ficheiro, desativando opcionalmente a formatação.
Save(String)

Serialize este elemento para um ficheiro.
Save(TextWriter, SaveOptions)

Serialize este elemento para um TextWriter, desativando opcionalmente a formatação.
Save(TextWriter)

Serialize este elemento para um TextWriter.
Save(XmlWriter)

Serialize este elemento para um XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

De forma assíncrona, isto XElement é enviado para um Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

De forma assíncrona, isto XElement é enviado para um TextWriter.
SaveAsync(XmlWriter, CancellationToken)

De forma assíncrona, isto XElement é enviado 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 deste elemento.
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 elemento num XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Escreve XElement isto de forma assíncrona para o escritor especificado.

Operadores

Name Description
Explicit(XElement to Boolean)

Atribui o valor disto XElement a um Boolean.
Explicit(XElement to DateTime)

Atribui o valor disto XElement a um DateTime.
Explicit(XElement to DateTimeOffset)

Atribui o valor disto XAttribute a um DateTimeOffset.
Explicit(XElement to Decimal)

Atribui o valor disto XElement a um Decimal.
Explicit(XElement to Double)

Atribui o valor disto XElement a um Double.
Explicit(XElement to Guid)

Atribui o valor disto XElement a um Guid.
Explicit(XElement to Int32)

Atribui o valor disto XElement a um Int32.
Explicit(XElement to Int64)

Atribui o valor disto XElement a um Int64.
Explicit(XElement to Nullable<Boolean>)

Atribui o valor disto XElement a Nullable<T> um de Boolean.
Explicit(XElement to Nullable<DateTime>)

Atribui o valor disto XElement a Nullable<T> um de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)

Atribui o valor disto XElement a Nullable<T> um de DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)

Atribui o valor disto XElement a Nullable<T> um de Decimal.
Explicit(XElement to Nullable<Double>)

Atribui o valor disto XElement a Nullable<T> um de Double.
Explicit(XElement to Nullable<Guid>)

Atribui o valor disto XElement a Nullable<T> um de Guid.
Explicit(XElement to Nullable<Int32>)

Atribui o valor disto XElement a Nullable<T> um de Int32.
Explicit(XElement to Nullable<Int64>)

Atribui o valor disto XElement a Nullable<T> um de Int64.
Explicit(XElement to Nullable<Single>)

Atribui o valor disto XElement a Nullable<T> um de Single.
Explicit(XElement to Nullable<TimeSpan>)

Atribui o valor disto XElement a Nullable<T> um de TimeSpan.
Explicit(XElement to Nullable<UInt32>)

Atribui o valor disto XElement a Nullable<T> um de UInt32.
Explicit(XElement to Nullable<UInt64>)

Atribui o valor disto XElement a Nullable<T> um de UInt64.
Explicit(XElement to Single)

Atribui o valor disto XElement a um Single.
Explicit(XElement to String)

Atribui o valor disto XElement a um String.
Explicit(XElement to TimeSpan)

Atribui o valor disto XElement a um TimeSpan.
Explicit(XElement to UInt32)

Atribui o valor disto XElement a um UInt32.
Explicit(XElement to UInt64)

Atribui o valor disto XElement a um UInt64.

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

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

Gera um objeto a partir da sua representação XML.
IXmlSerializable.WriteXml(XmlWriter)

Converte um objeto na sua representação XML.

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

Obtém o conjunto de infos pós-validação do esquema (PSVI) de um elemento validado.
ToXPathNavigable(XNode)

Devolve um acessório que permite navegar e editar o arquivo especificado XNode.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que uma XElement subárvore cumpre um especificado XmlSchemaObject e um XmlSchemaSet, preenchendo opcionalmente a árvore XML com o conjunto de infos pós-validação de esquema (PSVI).
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Este método valida que uma XElement subárvore se conforma a um especificado XmlSchemaObject e a um 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