XNode.Ancestors Méthode

Définition

Retourne une collection des éléments ancêtres de ce nœud.Returns a collection of the ancestor elements of this node.

Surcharges

Ancestors()

Retourne une collection des éléments ancêtres de ce nœud.Returns a collection of the ancestor elements of this node.

Ancestors(XName)

Retourne une collection filtrée des éléments ancêtres de ce nœud.Returns a filtered collection of the ancestor elements of this node. Seuls les éléments avec un XName correspondant sont inclus dans la collection.Only elements that have a matching XName are included in the collection.

Remarques

Vous pouvez éventuellement spécifier un nom de nœud pour filtrer les éléments ancêtres portant un nom spécifique.Optionally a node name can be specified to filter for ancestor elements with a specific name.

Les nœuds de la collection retournée sont dans l’ordre inverse du document.The nodes in the returned collection are in reverse document order.

Cette méthode utilise l'exécution différée.This method uses deferred execution.

Ancestors()

Retourne une collection des éléments ancêtres de ce nœud.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)

Retours

IEnumerable<XElement>

IEnumerable<T> de XElement des éléments ancêtres de ce nœud.An IEnumerable<T> of XElement of the ancestor elements of this node.

Exemples

L’exemple suivant utilise cette méthode pour énumérer les ancêtres d’un nœud.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  

Cet exemple produit la sortie suivante :This example produces the following output:

Child  
Root  

Remarques

Cette méthode ne retourne pas elle-même dans les résultats.This method does not return itself in the results.

Les nœuds de la collection retournée sont dans l’ordre inverse du document.The nodes in the returned collection are in reverse document order.

Cette méthode utilise l'exécution différée.This method uses deferred execution.

S’applique à

Ancestors(XName)

Retourne une collection filtrée des éléments ancêtres de ce nœud.Returns a filtered collection of the ancestor elements of this node. Seuls les éléments avec un XName correspondant sont inclus dans la collection.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);
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)

Paramètres

name
XName

XName à mettre en correspondance.The XName to match.

Retours

IEnumerable<XElement>

IEnumerable<T> de XElement des éléments ancêtres de ce nœud.An IEnumerable<T> of XElement of the ancestor elements of this node. Seuls les éléments avec un XName correspondant sont inclus dans la collection.Only elements that have a matching XName are included in the collection.

Les nœuds de la collection retournée sont dans l’ordre inverse du document.The nodes in the returned collection are in reverse document order.

Cette méthode utilise l'exécution différée.This method uses deferred execution.

Exemples

L’exemple suivant utilise cette méthode.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  

Cet exemple produit la sortie suivante :This example produces the following output:

Child  

Remarques

Cette méthode ne sera pas retournée dans les résultats.This method will not return itself in the results.

S’applique à