XNode.Ancestors Método

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)

Retornos

IEnumerable<XElement>

Um IEnumerable<T> de XElement dos elementos ancestrais deste nó.

Exemplos

O exemplo a seguir usa esse método para enumerar os ancestrais de um nó.

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  

Esse exemplo gera a saída a seguir:

Child  
Root  

Comentários

Esse método não retorna a si mesmo nos resultados.

Os nós na coleção retornada estão na ordem de documento inversa.

Este método utiliza execução adiada.

Confira também

• Visão geral do LINQ to XML

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);

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

Retornos

IEnumerable<XElement>

Um IEnumerable<T> de XElement dos elementos ancestrais deste nó. Somente os elementos que têm um XName correspondente são incluídos na coleção.

Os nós na coleção retornada estão na ordem de documento inversa.

Este método utiliza execução adiada.

Exemplos

O exemplo a seguir usa esse método.

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  

Esse exemplo gera a saída a seguir:

Child  

Comentários

Esse método não retornará a si mesmo nos resultados.

Confira também

• Visão geral do LINQ to XML