XNode.Ancestors Yöntem

Tanım

Ad Alanı:

System.Xml.Linq

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.XDocument.dll

Bu düğümün üst öğelerinin bir koleksiyonunu döndürür.

Aşırı Yüklemeler

Name	Description
Ancestors()	Bu düğümün üst öğelerinin bir koleksiyonunu döndürür.
Ancestors(XName)	Bu düğümün üst öğelerinin filtrelenmiş koleksiyonunu döndürür. Yalnızca eşleşen XName öğ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 ertelenen yürütmeyi kullanır.

Ancestors()

Kaynak:

XNode.cs

Bu düğümün üst öğelerinin bir koleksiyonunu 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>

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

Örnekler

Aşağıdaki örnek, bir düğümün atalarını numaralandırmak 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 ertelenen yürütmeyi kullanır.

Ayrıca bkz.

• LINQ to XML'e genel bakış

Ancestors(XName)

Kaynak:

XNode.cs

Bu düğümün üst öğelerinin filtrelenmiş koleksiyonunu döndürür. Yalnızca eşleşen XName öğ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);

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şmesi XName için.

Döndürülenler

IEnumerable<XElement>

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

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

Bu yöntem ertelenen yürütmeyi kullanır.

Örnekler

Aşağıdaki örnek 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("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ış