XNode.Ancestors Yöntem

Tanım

Ad Alanı:

System.Xml.Linq

Bütünleştirilmiş Kod:

System.Xml.XDocument.dll

Bütünleştirilmiş Kod:

System.Xml.Linq.dll

Bütünleştirilmiş Kod:

netstandard.dll

Bu düğümün üst öğelerinden oluşan bir koleksiyon döndürür.

Aşırı Yüklemeler

Ancestors()	Bu düğümün üst öğelerinden oluşan bir koleksiyon döndürür.
Ancestors(XName)	Bu düğümün üst öğelerinin filtrelenmiş bir koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğeler koleksiyona dahil edilir.

Açıklamalar

İsteğe bağlı olarak, belirli bir ada sahip üst öğeleri filtrelemek için bir düğüm adı belirtilebilir.

Döndürülen koleksiyondaki düğümler ters belge sırasına göre sıralanır.

Bu yöntem ertelenmiş yürütmeyi kullanır.

Ancestors()

Bu düğümün üst öğelerinden oluşan bir koleksiyon döndürür.

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)

Döndürülenler

IEnumerable<XElement>

IEnumerable<T> Bu düğümün XElement üst öğelerinden biri.

Örnekler

Aşağıdaki örnek, bir düğümün atalarını listelemek için bu yöntemi kullanır.

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  

Bu örnek aşağıdaki çıkışı oluşturur:

Child  
Root  

Açıklamalar

Bu yöntem sonuçlarda kendini döndürmez.

Döndürülen koleksiyondaki düğümler ters belge sırasına göre sıralanır.

Bu yöntem ertelenmiş yürütmeyi kullanır.

Ayrıca bkz.

• LINQ to XML'e genel bakış

Ancestors(XName)

Bu düğümün üst öğelerinin filtrelenmiş bir koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğeler koleksiyona dahil edilir.

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)

Parametreler

name

XName

Eşleştirecek XName .

Döndürülenler

IEnumerable<XElement>

IEnumerable<T> Bu düğümün XElement üst öğelerinden biri. Yalnızca eşleştirmesi XName olan öğeler koleksiyona dahil edilir.

Döndürülen koleksiyondaki düğümler ters belge sırasına göre sıralanır.

Bu yöntem ertelenmiş yürütmeyi kullanır.

Örnekler

Aşağıdaki örnekte bu yöntem kullanılır.

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  

Bu örnek aşağıdaki çıkışı oluşturur:

Child  

Açıklamalar

Bu yöntem sonuçlarda kendisini döndürmez.

Ayrıca bkz.

• LINQ to XML'e genel bakış