XNode.Ancestors XNode.Ancestors XNode.Ancestors XNode.Ancestors Method

Definición

Devuelve una colección de los elementos antecesores de este nodo.Returns a collection of the ancestor elements of this node.

Sobrecargas

Ancestors() Ancestors() Ancestors() Ancestors()

Devuelve una colección de los elementos antecesores de este nodo.Returns a collection of the ancestor elements of this node.

Ancestors(XName) Ancestors(XName) Ancestors(XName) Ancestors(XName)

Devuelve una colección filtrada de los elementos antecesores de este nodo.Returns a filtered collection of the ancestor elements of this node. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

Comentarios

Opcionalmente, se puede especificar un nombre de nodo para filtrar los elementos antecesores con un nombre específico.Optionally a node name can be specified to filter for ancestor elements with a specific name.

Los nodos de la colección devuelta están en el orden del documento inverso.The nodes in the returned collection are in reverse document order.

Este método usa la ejecución diferida.This method uses deferred execution.

Ancestors() Ancestors() Ancestors() Ancestors()

Devuelve una colección de los elementos antecesores de este nodo.Returns a collection of the ancestor elements of this node.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Ancestors();
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors ();
member this.Ancestors : unit -> seq<System.Xml.Linq.XElement>
Public Function Ancestors () As IEnumerable(Of XElement)

Devoluciones

Interfaz IEnumerable<T> de XElement de los elementos antecesores de este nodo.An IEnumerable<T> of XElement of the ancestor elements of this node.

Ejemplos

En el ejemplo siguiente se usa este método para enumerar los antecesores de un nodo.The following example uses this method to enumerate the ancestors of a node.

XElement xmlTree = new XElement("Root",  
    new XElement("Child",   
        new XElement("GrandChild", "content")  
    )  
);  
IEnumerable<XElement> grandChild = xmlTree.Descendants("GrandChild");  
foreach (XElement el in grandChild.Ancestors())  
    Console.WriteLine(el.Name);  
Dim xmlTree As XElement = _   
        <Root>  
            <Child>  
                <GrandChild>content</GrandChild>  
            </Child>  
        </Root>  
  
Dim grandChild As IEnumerable(Of XElement) = xmlTree...<GrandChild>  
For Each el In grandChild.Ancestors()  
    Console.WriteLine(el.Name)  
Next  

Este ejemplo produce el siguiente resultado:This example produces the following output:

Child  
Root  

Comentarios

Este método no se devuelve en los resultados.This method does not return itself in the results.

Los nodos de la colección devuelta están en el orden del documento inverso.The nodes in the returned collection are in reverse document order.

Este método usa la ejecución diferida.This method uses deferred execution.

Consulte también:

Ancestors(XName) Ancestors(XName) Ancestors(XName) Ancestors(XName)

Devuelve una colección filtrada de los elementos antecesores de este nodo.Returns a filtered collection of the ancestor elements of this node. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

public:
 System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Ancestors(System::Xml::Linq::XName ^ name);
public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors (System.Xml.Linq.XName name);
member this.Ancestors : System.Xml.Linq.XName -> seq<System.Xml.Linq.XElement>
Public Function Ancestors (name As XName) As IEnumerable(Of XElement)

Parámetros

name
XName XName XName XName

XName que se va a comparar.The XName to match.

Devoluciones

Interfaz IEnumerable<T> de XElement de los elementos antecesores de este nodo.An IEnumerable<T> of XElement of the ancestor elements of this node. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

Los nodos de la colección devuelta están en el orden del documento inverso.The nodes in the returned collection are in reverse document order.

Este método usa la ejecución diferida.This method uses deferred execution.

Ejemplos

En el ejemplo siguiente se usa este método.The following example uses this method.

XElement xmlTree = new XElement("Root",  
    new XElement("Child",   
        new XElement("GrandChild", "content")  
    )  
);  
IEnumerable<XElement> grandChild = xmlTree.Descendants("GrandChild");  
foreach (XElement el in grandChild.Ancestors("Child"))  
    Console.WriteLine(el.Name);  
Dim xmlTree As XElement = _   
        <Root>  
            <Child>  
                <GrandChild>content</GrandChild>  
            </Child>  
        </Root>  
  
Dim grandChild As IEnumerable(Of XElement) = xmlTree...<GrandChild>  
For Each el In grandChild.Ancestors("Child")  
    Console.WriteLine(el.Name)  
Next  

Este ejemplo produce el siguiente resultado:This example produces the following output:

Child  

Comentarios

Este método no se devolverá en los resultados.This method will not return itself in the results.

Consulte también:

Se aplica a