XElement Clase

Definición

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

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
Implementaciones

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>  

El siguiente es 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 objetos XElement y XDocument.

XElement deriva de XContainer, que deriva de XNode.

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

Constructores

XElement(XElement)

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

XElement(XName)

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

XElement(XName, Object)

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

XElement(XName, Object[])

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

XElement(XStreamingElement)

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

Propiedades

BaseUri

Obtiene el URI base de este XObject.

(Heredado de XObject)
Document

Obtiene el objeto XDocument para este objeto XObject.

(Heredado de XObject)
EmptySequence

Obtiene una colección de elementos vacía.

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 incluye ningún 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 de este nodo.

Parent

Obtiene el XElement primario de XObject.

(Heredado de XObject)
PreviousNode

Obtiene el anterior nodo relacionado de este nodo.

(Heredado de XNode)
Value

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

Métodos

Add(Object)

Agrega el contenido especificado como elementos secundarios de este XContainer.

(Heredado de XContainer)
Add(Object[])

Agrega el contenido especificado como elementos secundarios de este XContainer.

(Heredado de XContainer)
AddAfterSelf(Object)

Agrega el contenido especificado inmediatamente a continuación de este nodo.

(Heredado de XNode)
AddAfterSelf(Object[])

Agrega el contenido especificado inmediatamente a continuación de este nodo.

(Heredado de XNode)
AddAnnotation(Object)

Agrega un objeto a la lista de anotaciones de 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 el primer elemento secundario de este documento o elemento.

(Heredado de XContainer)
AddFirst(Object[])

Agrega el contenido especificado como el primer elemento secundario 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 sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XNode)
AncestorsAndSelf()

Devuelve una colección de elementos que contienen este elemento y sus antecesores.

AncestorsAndSelf(XName)

Devuelve una colección filtrada de los elementos que contienen este elemento y sus antecesores. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

Annotation(Type)

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

(Heredado de XObject)
Annotation<T>()

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

(Heredado de XObject)
Annotations(Type)

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

(Heredado de XObject)
Annotations<T>()

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

(Heredado de XObject)
Attribute(XName)

Devuelve el XAttribute de XElement que tiene el XName especificado.

Attributes()

Devuelve una colección de los 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 un XName coincidente.

CreateReader()

Crea un objeto XmlReader para este nodo.

(Heredado de XNode)
CreateReader(ReaderOptions)

Crea una clase XmlReader con las opciones especificadas por el parámetro readerOptions.

(Heredado de XNode)
CreateWriter()

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

(Heredado de XContainer)
DescendantNodes()

Devuelve una colección de los nodos descendientes de este documento o elemento, clasificados por documento.

(Heredado de XContainer)
DescendantNodesAndSelf()

Devuelve una colección de nodos que contienen este elemento y todos sus nodos descendientes, en el orden del documento.

Descendants()

Devuelve una colección de los elementos descendientes de este documento o elemento, clasificados por documento.

(Heredado de XContainer)
Descendants(XName)

Devuelve una colección filtrada de los elementos descendientes de este documento o elemento, clasificados por documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XContainer)
DescendantsAndSelf()

Devuelve la colección de los elementos que contienen este elemento y todos sus elementos descendientes, en el orden del documento.

DescendantsAndSelf(XName)

Devuelve la colección filtrada de los elementos que contienen este elemento y todos sus elementos descendientes, en el orden del documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

Element(XName)

Obtiene el primer elemento secundario (clasificado por documento) con el XName especificado.

(Heredado de XContainer)
Elements()

Devuelve una colección de los elementos secundarios de este elemento o documento, clasificados por documento.

(Heredado de XContainer)
Elements(XName)

Devuelve una colección filtrada de elementos secundarios de este documento o elemento, clasificados por documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XContainer)
ElementsAfterSelf()

Devuelve una colección de los elementos relacionados situados detrás de este nodo en el orden del documento.

(Heredado de XNode)
ElementsAfterSelf(XName)

Devuelve una colección filtrada de los elementos relacionados situados detrás de este nodo en el orden del documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XNode)
ElementsBeforeSelf()

Devuelve una colección de los elementos relacionados situados antes de este nodo en el orden del documento.

(Heredado de XNode)
ElementsBeforeSelf(XName)

Devuelve una colección filtrada de los elementos relacionados situados antes de este nodo en el orden del documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XNode)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetDefaultNamespace()

Obtiene el objeto XNamespace predeterminado de este XElement.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetNamespaceOfPrefix(String)

Obtiene el espacio de nombres asociado a un prefijo en particular para XElement.

GetPrefixOfNamespace(XNamespace)

Obtiene el prefijo asociado a un espacio de nombres correspondiente a este XElement.

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 respecto al orden del documento.

(Heredado de XNode)
IsBefore(XNode)

Determina si el nodo actual aparece antes de un nodo especificado respecto al orden del documento.

(Heredado de XNode)
Load(Stream)

Crea una nueva instancia de XElement usando la secuencia especificada.

Load(Stream, LoadOptions)

Crea una nueva instancia de XElement usando la secuencia especificada y, de forma opcional, conservando el espacio en blanco, estableciendo el identificador URI base y conservando la información de línea.

Load(String)

Carga un XElement desde un archivo.

Load(String, LoadOptions)

Carga un XElement desde un archivo y, de manera opcional, conserva los espacios en blanco, establece el URI base y retiene la información de línea.

Load(TextReader)

Carga un XElement desde TextReader.

Load(TextReader, LoadOptions)

Carga un XElement desde un objeto TextReader y, de manera opcional, conserva los espacios en blanco y retiene la información de línea.

Load(XmlReader)

Carga un XElement desde XmlReader.

Load(XmlReader, LoadOptions)

Carga un XElement desde XmlReader y, de manera opcional, conserva los espacios en blanco, establece el URI base y retiene la información de línea.

LoadAsync(Stream, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el flujo especificado y, de manera opcional, conserva el espacio en blanco.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector de texto especificado y, de manera opcional, conserva el espacio en blanco.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo objeto XElement e inicializa su árbol XML subyacente mediante el lector XML especificado y, de manera opcional, conserva el espacio en blanco.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Nodes()

Devuelve una colección de los nodos secundarios de este elemento o documento, clasificados por documento.

(Heredado de XContainer)
NodesAfterSelf()

Devuelve una colección de los nodos relacionados situados detrás de este nodo en el orden del documento.

(Heredado de XNode)
NodesBeforeSelf()

Devuelve una colección de los nodos relacionados situados antes de este nodo en el orden del documento.

(Heredado de XNode)
Parse(String)

Cargue XElement a partir de una cadena que contiene el XML.

Parse(String, LoadOptions)

Carga un objeto XElement desde una cadena que contiene XML y, opcionalmente, conserva los espacios en blanco y la información de línea.

Remove()

Quita este nodo de su elemento primario.

(Heredado de XNode)
RemoveAll()

Quita nodos y atributos de este XElement.

RemoveAnnotations(Type)

Quita las anotaciones del tipo especificado de XObject.

(Heredado de XObject)
RemoveAnnotations<T>()

Quita las anotaciones del tipo especificado de 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)

Genera este XElement en el objeto Stream especificado.

Save(Stream, SaveOptions)

Genera este XElement en el objeto Stream especificado, especificando opcionalmente el comportamiento de formato.

Save(String)

Serialice este elemento en un archivo.

Save(String, SaveOptions)

Serialice este elemento en un archivo y, de manera opcional, deshabilite el formato.

Save(TextWriter)

Serialice este elemento en un objeto TextWriter.

Save(TextWriter, SaveOptions)

Serialice este elemento en un TextWriter y, de manera opcional, deshabilite el formato.

Save(XmlWriter)

Serialice este elemento en un objeto XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Genera de forma asincrónica este objeto XElement en un Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Genera de forma asincrónica este objeto XElement en un TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Genera de forma asincrónica este objeto XElement en un XmlWriter.

SetAttributeValue(XName, Object)

Establece el valor de un atributo, agrega o quita un atributo.

SetElementValue(XName, Object)

Establece el valor de un elemento secundario, agrega un elemento secundario o lo quita.

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 y, opcionalmente, deshabilita el formato.

(Heredado de XNode)
WriteTo(XmlWriter)

Escribe el elemento en un objeto XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

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

WriteToAsync(XmlWriter, CancellationToken)

Escribe el nodo actual en XmlWriter.

(Heredado de XNode)

Operadores

Explicit(XElement to Boolean)

Convierte el valor de XElement en Boolean.

Explicit(XElement to DateTime)

Convierte el valor de XElement en DateTime.

Explicit(XElement to DateTimeOffset)

Convierte el valor de XAttribute en DateTimeOffset.

Explicit(XElement to Decimal)

Convierte el valor de XElement en Decimal.

Explicit(XElement to Double)

Convierte el valor de XElement en Double.

Explicit(XElement to Guid)

Convierte el valor de XElement en Guid.

Explicit(XElement to Int32)

Convierte el valor de XElement en Int32.

Explicit(XElement to Int64)

Convierte el valor de XElement en Int64.

Explicit(XElement to Nullable<Boolean>)

El valor de XElement se convierte en un objeto Nullable<T> de Boolean.

Explicit(XElement to Nullable<DateTime>)

El valor de XElement se convierte en un objeto Nullable<T> de DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

El valor de XElement se convierte en un objeto Nullable<T> de DateTimeOffset.

Explicit(XElement to Nullable<Decimal>)

El valor de XElement se convierte en un objeto Nullable<T> de Decimal.

Explicit(XElement to Nullable<Double>)

El valor de XElement se convierte en un objeto Nullable<T> de Double.

Explicit(XElement to Nullable<Guid>)

El valor de XElement se convierte en un objeto Nullable<T> de Guid.

Explicit(XElement to Nullable<Int32>)

El valor de XElement se convierte en un objeto Nullable<T> de Int32.

Explicit(XElement to Nullable<Int64>)

El valor de XElement se convierte en un objeto Nullable<T> de Int64.

Explicit(XElement to Nullable<Single>)

El valor de XElement se convierte en un objeto Nullable<T> de Single.

Explicit(XElement to Nullable<TimeSpan>)

El valor de XElement se convierte en un objeto Nullable<T> de TimeSpan.

Explicit(XElement to Nullable<UInt32>)

El valor de XElement se convierte en un objeto Nullable<T> de UInt32.

Explicit(XElement to Nullable<UInt64>)

El valor de XElement se convierte en un objeto Nullable<T> de UInt64.

Explicit(XElement to Single)

Convierte el valor de XElement en Single.

Explicit(XElement to String)

Convierte el valor de XElement en String.

Explicit(XElement to TimeSpan)

Convierte el valor de XElement en TimeSpan.

Explicit(XElement to UInt32)

Convierte el valor de XElement en UInt32.

Explicit(XElement to UInt64)

Convierte el valor de XElement en UInt64.

Eventos

Changed

Se genera cuando este XObject o cualquiera de sus descendientes ha cambiado.

(Heredado de XObject)
Changing

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

(Heredado de XObject)

Implementaciones de interfaz explícitas

IXmlLineInfo.HasLineInfo()

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

(Heredado de XObject)
IXmlLineInfo.LineNumber

Obtiene el número de línea del que el XmlReader subyacente informó para este XObject.

(Heredado de XObject)
IXmlLineInfo.LinePosition

Obtiene la posición de línea de la que el XmlReader subyacente informó para este XObject.

(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

GetSchemaInfo(XElement)

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

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Este método valida que un subárbol XElement se ajusta a un XmlSchemaObject especificado y a un XmlSchemaSet.

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

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

CreateNavigator(XNode)

Crea un objeto XPathNavigator para XNode.

CreateNavigator(XNode, XmlNameTable)

Crea un objeto XPathNavigator para XNode. XmlNameTable permite un procesamiento más eficaz de la expresión XPath.

XPathEvaluate(XNode, String)

Evalúa una expresión XPath.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Evalúa una expresión XPath, resolviendo los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.

XPathSelectElement(XNode, String)

Selecciona un objeto XElement mediante una expresión XPath.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Selecciona un XElement utilizando una expresión XPath, que resuelve los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.

XPathSelectElements(XNode, String)

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

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Selecciona una colección de elementos utilizando una expresión XPath, que resuelve los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.

ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el elemento XNode especificado.

Se aplica a

Consulte también