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

Definition

Gibt eine Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a collection of the ancestor elements of this node.

Überlädt

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

Gibt eine Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a collection of the ancestor elements of this node.

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

Gibt eine gefilterte Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a filtered collection of the ancestor elements of this node. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

Hinweise

Optional kann ein Knoten Name angegeben werden, um nach Vorgänger Elementen mit einem bestimmten Namen zu filtern.Optionally a node name can be specified to filter for ancestor elements with a specific name.

Die Knoten in der zurückgegebenen Auflistung sind in der umgekehrten Dokumentreihenfolge angeordnet.The nodes in the returned collection are in reverse document order.

Diese Methode verwendet verzögerte Ausführung.This method uses deferred execution.

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

Gibt eine Auflistung der übergeordneten Elemente dieses Knotens zurück.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)

Gibt zurück

Ein IEnumerable<T> vom Typ XElement der übergeordneten Elemente dieses Knotens.An IEnumerable<T> of XElement of the ancestor elements of this node.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um die Vorgänger eines Knotens aufzulisten.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  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

Child  
Root  

Hinweise

Diese Methode gibt nicht selbst in den Ergebnissen zurück.This method does not return itself in the results.

Die Knoten in der zurückgegebenen Auflistung sind in der umgekehrten Dokumentreihenfolge angeordnet.The nodes in the returned collection are in reverse document order.

Diese Methode verwendet verzögerte Ausführung.This method uses deferred execution.

Siehe auch

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

Gibt eine gefilterte Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a filtered collection of the ancestor elements of this node. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.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)

Parameter

name
XName XName XName XName

Der XName, mit dem eine Übereinstimmung gefunden werden soll.The XName to match.

Gibt zurück

Ein IEnumerable<T> vom Typ XElement der übergeordneten Elemente dieses Knotens.An IEnumerable<T> of XElement of the ancestor elements of this node. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

Die Knoten in der zurückgegebenen Auflistung sind in der umgekehrten Dokumentreihenfolge angeordnet.The nodes in the returned collection are in reverse document order.

Diese Methode verwendet verzögerte Ausführung.This method uses deferred execution.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet.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  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

Child  

Hinweise

Diese Methode wird in den Ergebnissen nicht selbst zurückgegeben.This method will not return itself in the results.

Siehe auch

Gilt für: