XNode.Ancestors 方法

定義

命名空間:

System.Xml.Linq

組件:

netstandard.dll, System.Xml.XDocument.dll

傳回這個節點之上階元素的集合。

多載

Ancestors()	傳回這個節點之上階元素的集合。
Ancestors(XName)	傳回這個節點的上階元素之篩選的集合。 集合中只會包含具有相符之 XName 的項目。

備註

您可以選擇性地指定節點名稱，以篩選具有特定名稱的上階專案。

所傳回集合中之節點的順序為反向文件順序。

這個方法會使用延後的執行。

Ancestors()

來源:

XNode.cs

傳回這個節點之上階元素的集合。

C#

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors();

傳回

IEnumerable<XElement>

IEnumerable<T>，屬於這個節點之祖系項目的 XElement。

範例

下列範例會使用這個方法來列舉節點的上階。

C#

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

這個範例會產生下列輸出：

Child  
Root  

備註

這個方法不會在結果中傳回本身。

所傳回集合中之節點的順序為反向文件順序。

這個方法會使用延後的執行。

另請參閱

• LINQ to XML 概觀

Ancestors(XName)

來源:

XNode.cs

傳回這個節點的上階元素之篩選的集合。 集合中只會包含具有相符之 XName 的項目。

C#

public System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors(System.Xml.Linq.XName? name);

參數

name

XName

要比對的 XName。

傳回

IEnumerable<XElement>

IEnumerable<T>，屬於這個節點之祖系項目的 XElement。 集合中只會包含具有相符之 XName 的項目。

所傳回集合中之節點的順序為反向文件順序。

這個方法會使用延後的執行。

範例

下列範例會使用這個方法。

C#

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

這個範例會產生下列輸出：

Child  

備註

這個方法不會在結果中傳回本身。

另請參閱

• LINQ to XML 概觀