XElement Clase

Definición

Espacio de nombres:
System.Xml.Linq
Ensamblados:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Ensamblados:
netstandard.dll, System.Xml.XDocument.dll
Ensamblado:
System.Xml.XDocument.dll
Ensamblado:
System.Xml.Linq.dll
Ensamblado:
netstandard.dll
Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Representa un elemento XML. Vea Información general de la clase XElement y la sección Comentarios de esta página para obtener información y ejemplos de uso.

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
Herencia
Object
XObject
XNode
XContainer
XElement
Implementaciones
IXmlSerializable

Ejemplos

En el ejemplo siguiente se crea un árbol XML. El contenido del nuevo elemento procede de una 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 ejemplo produce el siguiente resultado:

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

A continuación se muestra el mismo ejemplo, pero en este caso el XML está en un espacio de nombres. Para obtener más información, vea Trabajar con espacios de nombres 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 ejemplo produce el siguiente resultado:

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

Comentarios

Esta clase representa un elemento XML, la construcción XML fundamental. Consulte Información general sobre la clase XElement para obtener otra información de uso.

Un elemento tiene , XNameopcionalmente uno o varios atributos, y opcionalmente puede contener contenido (para obtener más información, vea Nodes).

Un XElement puede contener los siguientes tipos de contenido:

Para obtener más información sobre el contenido válido de un XElement, vea Contenido válido de XElement y objetos XDocument.

XElement deriva de XContainer, que deriva de XNode.

Algunos XElement métodos se pueden usar desde XAML. Para obtener más información, vea LINQ to XML Dynamic Properties(Propiedades dinámicas de LINQ to XML).

Constructores

Nombre Description
XElement(XElement)

Inicializa una nueva instancia de la XElement clase desde otro XElement objeto.
XElement(XName, Object)

Inicializa una nueva instancia de la XElement clase con el nombre y el contenido especificados.
XElement(XName, Object[])

Inicializa una nueva instancia de la XElement clase con el nombre y el contenido especificados.
XElement(XName)

Inicializa una nueva instancia de la XElement clase con el nombre especificado.
XElement(XStreamingElement)

Inicializa una nueva instancia de la XElement clase a partir de un XStreamingElement objeto .

Propiedades

Nombre Description
BaseUri

Obtiene el URI base de este XObjectobjeto .

(Heredado de XObject)
Document

Obtiene para XDocument este XObjectobjeto .

(Heredado de XObject)
EmptySequence

Obtiene una colección vacía de elementos.
FirstAttribute

Obtiene el primer atributo de este elemento.
FirstNode

Obtiene el primer nodo secundario de este nodo.

(Heredado de XContainer)
HasAttributes

Obtiene un valor que indica si este elemento tiene al menos un atributo.
HasElements

Obtiene un valor que indica si este elemento tiene al menos un elemento secundario.
IsEmpty

Obtiene un valor que indica si este elemento no contiene contenido.
LastAttribute

Obtiene el último atributo de este elemento.
LastNode

Obtiene el último nodo secundario de este nodo.

(Heredado de XContainer)
Name

Obtiene o establece el nombre de este elemento.
NextNode

Obtiene el siguiente nodo relacionado de este nodo.

(Heredado de XNode)
NodeType

Obtiene el tipo de nodo para este nodo.
Parent

Obtiene el elemento primario XElement de este XObjectobjeto .

(Heredado de XObject)
PreviousNode

Obtiene el nodo relacionado anterior de este nodo.

(Heredado de XNode)
Value

Obtiene o establece el contenido de texto concatenado de este elemento.

Métodos

Nombre Description
Add(Object)

Agrega el contenido especificado como elementos secundarios de este XContainerobjeto .

(Heredado de XContainer)
Add(Object[])

Agrega el contenido especificado como elementos secundarios de este XContainerobjeto .

(Heredado de XContainer)
AddAfterSelf(Object)

Agrega el contenido especificado inmediatamente después de este nodo.

(Heredado de XNode)
AddAfterSelf(Object[])

Agrega el contenido especificado inmediatamente después de este nodo.

(Heredado de XNode)
AddAnnotation(Object)

Agrega un objeto a la lista de anotaciones de este XObject.

(Heredado de XObject)
AddBeforeSelf(Object)

Agrega el contenido especificado inmediatamente antes de este nodo.

(Heredado de XNode)
AddBeforeSelf(Object[])

Agrega el contenido especificado inmediatamente antes de este nodo.

(Heredado de XNode)
AddFirst(Object)

Agrega el contenido especificado como los primeros elementos secundarios de este documento o elemento.

(Heredado de XContainer)
AddFirst(Object[])

Agrega el contenido especificado como los primeros elementos secundarios de este documento o elemento.

(Heredado de XContainer)
Ancestors()

Devuelve una colección de los elementos antecesores de este nodo.

(Heredado de XNode)
Ancestors(XName)

Devuelve una colección filtrada de los elementos antecesores de este nodo. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
AncestorsAndSelf()

Devuelve una colección de elementos que contienen este elemento y los antecesores de este elemento.
AncestorsAndSelf(XName)

Devuelve una colección filtrada de elementos que contienen este elemento y los antecesores de este elemento. En la colección solo se incluyen los elementos que tienen una XName coincidente.
Annotation(Type)

Obtiene el primer objeto de anotación del tipo especificado de este XObjectobjeto .

(Heredado de XObject)
Annotation<T>()

Obtiene el primer objeto de anotación del tipo especificado de este XObjectobjeto .

(Heredado de XObject)
Annotations(Type)

Obtiene una colección de anotaciones del tipo especificado para este XObjectobjeto .

(Heredado de XObject)
Annotations<T>()

Obtiene una colección de anotaciones del tipo especificado para este XObjectobjeto .

(Heredado de XObject)
Attribute(XName)

Devuelve el XAttribute de este XElement objeto que tiene el objeto especificado XName.
Attributes()

Devuelve una colección de atributos de este elemento.
Attributes(XName)

Devuelve una colección filtrada de atributos de este elemento. En la colección solo se incluyen los atributos que tienen una coincidencia XName .
CreateReader()

Crea un XmlReader para este nodo.

(Heredado de XNode)
CreateReader(ReaderOptions)

Crea un XmlReader objeto con las opciones especificadas por el readerOptions parámetro .

(Heredado de XNode)
CreateWriter()

Crea un XmlWriter objeto que se puede usar para agregar nodos a .XContainer

(Heredado de XContainer)
DescendantNodes()

Devuelve una colección de los nodos descendientes de este documento o elemento, en orden de documento.

(Heredado de XContainer)
DescendantNodesAndSelf()

Devuelve una colección de nodos que contienen este elemento y todos los nodos descendientes de este elemento, en orden de documento.
Descendants()

Devuelve una colección de los elementos descendientes de este documento o elemento, en orden de documento.

(Heredado de XContainer)
Descendants(XName)

Devuelve una colección filtrada de los elementos descendientes de este documento o elemento, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XContainer)
DescendantsAndSelf()

Devuelve una colección de elementos que contienen este elemento y todos los elementos descendientes de este elemento, en orden de documento.
DescendantsAndSelf(XName)

Devuelve una colección filtrada de elementos que contienen este elemento y todos los elementos descendientes de este elemento, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.
Element(XName)

Obtiene el primer elemento secundario (en orden de documento) con el especificado XName.

(Heredado de XContainer)
Elements()

Devuelve una colección de los elementos secundarios de este elemento o documento, en orden de documento.

(Heredado de XContainer)
Elements(XName)

Devuelve una colección filtrada de los elementos secundarios de este elemento o documento, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XContainer)
ElementsAfterSelf()

Devuelve una colección de los elementos del mismo nivel después de este nodo, en orden de documento.

(Heredado de XNode)
ElementsAfterSelf(XName)

Devuelve una colección filtrada de los elementos del mismo nivel después de este nodo, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
ElementsBeforeSelf()

Devuelve una colección de los elementos del mismo nivel antes de este nodo, en orden de documento.

(Heredado de XNode)
ElementsBeforeSelf(XName)

Devuelve una colección filtrada de los elementos del mismo nivel antes de este nodo, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetDefaultNamespace()

Obtiene el valor predeterminado XNamespace de este XElementobjeto .
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetNamespaceOfPrefix(String)

Obtiene el espacio de nombres asociado a un prefijo determinado para este XElement.
GetPrefixOfNamespace(XNamespace)

Obtiene el prefijo asociado a un espacio de nombres para este XElementobjeto .
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsAfter(XNode)

Determina si el nodo actual aparece después de un nodo especificado en términos de orden de documento.

(Heredado de XNode)
IsBefore(XNode)

Determina si el nodo actual aparece antes de un nodo especificado en términos de orden de documento.

(Heredado de XNode)
Load(Stream, LoadOptions)

Crea una nueva XElement instancia mediante la secuencia especificada, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(Stream)

Crea una nueva XElement instancia mediante el flujo especificado.
Load(String, LoadOptions)

Carga un XElement desde un archivo, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(String)

Carga un XElement objeto desde un archivo.
Load(TextReader, LoadOptions)

Carga desde XElement un objeto TextReader, conservando opcionalmente el espacio en blanco y conservando la información de línea.
Load(TextReader)

Carga un XElement objeto desde un TextReaderobjeto .
Load(XmlReader, LoadOptions)

Carga un XElement objeto desde un XmlReader, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(XmlReader)

Carga un XElement objeto desde un XmlReaderobjeto .
LoadAsync(Stream, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo XElement e inicializa su árbol XML subyacente mediante la secuencia especificada, conservando opcionalmente el espacio en blanco.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo XElement e inicializa su árbol XML subyacente mediante el lector de texto especificado, conservando opcionalmente el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo XElement e inicializa su árbol XML subyacente mediante el lector XML especificado, conservando opcionalmente el espacio en blanco.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Nodes()

Devuelve una colección de los nodos secundarios de este elemento o documento, en orden de documento.

(Heredado de XContainer)
NodesAfterSelf()

Devuelve una colección de los nodos del mismo nivel después de este nodo, en orden de documento.

(Heredado de XNode)
NodesBeforeSelf()

Devuelve una colección de los nodos del mismo nivel antes de este nodo, en orden de documento.

(Heredado de XNode)
Parse(String, LoadOptions)

Cargue un XElement objeto a partir de una cadena que contenga XML, conservando opcionalmente el espacio en blanco y conservando la información de línea.
Parse(String)

Cargue un XElement objeto a partir de una cadena que contenga XML.
Remove()

Quita este nodo de su elemento primario.

(Heredado de XNode)
RemoveAll()

Quita los nodos y atributos de este XElement.
RemoveAnnotations(Type)

Quita las anotaciones del tipo especificado de este XObject.

(Heredado de XObject)
RemoveAnnotations<T>()

Quita las anotaciones del tipo especificado de este XObject.

(Heredado de XObject)
RemoveAttributes()

Quita los atributos de este XElement.
RemoveNodes()

Quita los nodos secundarios de este documento o elemento.

(Heredado de XContainer)
ReplaceAll(Object)

Reemplaza los nodos secundarios y los atributos de este elemento por el contenido especificado.
ReplaceAll(Object[])

Reemplaza los nodos secundarios y los atributos de este elemento por el contenido especificado.
ReplaceAttributes(Object)

Reemplaza los atributos de este elemento por el contenido especificado.
ReplaceAttributes(Object[])

Reemplaza los atributos de este elemento por el contenido especificado.
ReplaceNodes(Object)

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.

(Heredado de XContainer)
ReplaceNodes(Object[])

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.

(Heredado de XContainer)
ReplaceWith(Object)

Reemplaza este nodo por el contenido especificado.

(Heredado de XNode)
ReplaceWith(Object[])

Reemplaza este nodo por el contenido especificado.

(Heredado de XNode)
Save(Stream, SaveOptions)

Genera esto XElement en el especificado Streamy, opcionalmente, especifica el comportamiento de formato.
Save(Stream)

Genera esto XElement en el especificado Stream.
Save(String, SaveOptions)

Serialice este elemento en un archivo, deshabilitando opcionalmente el formato.
Save(String)

Serialice este elemento en un archivo.
Save(TextWriter, SaveOptions)

Serialice este elemento en un TextWriter, deshabilitando opcionalmente el formato.
Save(TextWriter)

Serialice este elemento en un TextWriter.
Save(XmlWriter)

Serialice este elemento en un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Genera esto XElement de forma asincrónica en un Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Genera esto XElement de forma asincrónica en un TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Genera esto XElement de forma asincrónica en un XmlWriter.
SetAttributeValue(XName, Object)

Establece el valor de un atributo, agrega un atributo o quita un atributo.
SetElementValue(XName, Object)

Establece el valor de un elemento secundario, agrega un elemento secundario o quita un elemento secundario.
SetValue(Object)

Establece el valor de este elemento.
ToString()

Devuelve el XML con sangría para este nodo.

(Heredado de XNode)
ToString(SaveOptions)

Devuelve el XML de este nodo, deshabilitando opcionalmente el formato.

(Heredado de XNode)
WriteTo(XmlWriter)

Escriba este elemento en un XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Escribe esto XElement de forma asincrónica en el escritor especificado.

Operadores

Nombre Description
Explicit(XElement to Boolean)

Convierta el valor de esto XElement en un Boolean.
Explicit(XElement to DateTime)

Convierta el valor de esto XElement en un DateTime.
Explicit(XElement to DateTimeOffset)

Convierta el valor de esto XAttribute en un DateTimeOffset.
Explicit(XElement to Decimal)

Convierta el valor de esto XElement en un Decimal.
Explicit(XElement to Double)

Convierta el valor de esto XElement en un Double.
Explicit(XElement to Guid)

Convierta el valor de esto XElement en un Guid.
Explicit(XElement to Int32)

Convierta el valor de este XElement en un Int32.
Explicit(XElement to Int64)

Convierta el valor de este XElement en un Int64.
Explicit(XElement to Nullable<Boolean>)

Convierta el valor de esto XElement en un Nullable<T> de Boolean.
Explicit(XElement to Nullable<DateTime>)

Convierta el valor de esto XElement en un Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)

Convierta el valor de esto XElement en un Nullable<T> de DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)

Convierta el valor de esto XElement en un Nullable<T> de Decimal.
Explicit(XElement to Nullable<Double>)

Convierta el valor de esto XElement en un Nullable<T> de Double.
Explicit(XElement to Nullable<Guid>)

Convierta el valor de esto XElement en un Nullable<T> de Guid.
Explicit(XElement to Nullable<Int32>)

Convierta el valor de esto XElement en un Nullable<T> de Int32.
Explicit(XElement to Nullable<Int64>)

Convierta el valor de esto XElement en un Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)

Convierta el valor de esto XElement en un Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)

Convierta el valor de esto XElement en un Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)

Convierta el valor de esto XElement en un Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)

Convierta el valor de esto XElement en un Nullable<T> de UInt64.
Explicit(XElement to Single)

Convierta el valor de esto XElement en un Single.
Explicit(XElement to String)

Convierta el valor de esto XElement en un String.
Explicit(XElement to TimeSpan)

Convierta el valor de esto XElement en un TimeSpan.
Explicit(XElement to UInt32)

Convierta el valor de esto XElement en un UInt32.
Explicit(XElement to UInt64)

Convierta el valor de esto XElement en un UInt64.

Eventos

Nombre Description
Changed

Se genera cuando esto XObject o cualquiera de sus descendientes han cambiado.

(Heredado de XObject)
Changing

Se genera cuando esto XObject o cualquiera de sus descendientes están a punto de cambiar.

(Heredado de XObject)

Implementaciones de interfaz explícitas

Nombre Description
IXmlLineInfo.HasLineInfo()

Obtiene un valor que indica si tiene XObject o no información de línea.

(Heredado de XObject)
IXmlLineInfo.LineNumber

Obtiene el número de línea que indica el objeto subyacente XmlReader para este XObjectobjeto .

(Heredado de XObject)
IXmlLineInfo.LinePosition

Obtiene la posición de línea que indica el objeto subyacente XmlReader para este XObjectobjeto .

(Heredado de XObject)
IXmlSerializable.GetSchema()

Obtiene una definición de esquema XML que describe la representación XML de este objeto.
IXmlSerializable.ReadXml(XmlReader)

Genera un objeto a partir de su representación XML.
IXmlSerializable.WriteXml(XmlWriter)

Convierte un objeto en su representación XML.

Métodos de extensión

Nombre Description
CreateNavigator(XNode, XmlNameTable)

Crea un XPathNavigator para un XNodeobjeto . XmlNameTable permite un procesamiento de expresiones XPath más eficaz.
CreateNavigator(XNode)

Crea un XPathNavigator para un XNodeobjeto .
GetSchemaInfo(XElement)

Obtiene el conjunto de información posterior a la validación del esquema (PSVI) de un elemento validado.
ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el especificado XNode.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que un XElement subárbol se ajusta a un especificado XmlSchemaObject y , XmlSchemaSetrellenando opcionalmente el árbol XML con el conjunto de información posterior a la validación del esquema (PSVI).
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Este método valida que un XElement subárbol se ajusta a un especificado XmlSchemaObject y a .XmlSchemaSet
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Evalúa una expresión XPath, resolviendo prefijos de espacio de nombres mediante el especificado IXmlNamespaceResolver.
XPathEvaluate(XNode, String)

Evalúa una expresión XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Selecciona un XElement objeto mediante una expresión XPath, resolviendo prefijos de espacio de nombres mediante el especificado IXmlNamespaceResolver.
XPathSelectElement(XNode, String)

Selecciona un XElement mediante una expresión XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Selecciona una colección de elementos mediante una expresión XPath, resolviendo prefijos de espacio de nombres mediante el especificado IXmlNamespaceResolver.
XPathSelectElements(XNode, String)

Selecciona una colección de elementos mediante una expresión XPath.

Se aplica a

Consulte también