XElement Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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. 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:
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 |
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) | |
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) | |
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) | |
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
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. |