Extensions.Ancestors 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

傳回包含來源集合中每個節點祖系的項目集合。

多載

Ancestors<T>(IEnumerable<T>)	傳回包含來源集合中每個節點祖系的項目集合。
Ancestors<T>(IEnumerable<T>, XName)	傳回包含來源集合中每個節點祖系的已篩選項目集合。 集合中只會包含具有相符之 XName 的項目。

備註

如果來源集合中的多個節點具有相同的上階，則上階將會在結果集合中包含多次。 若要避免這種情況，請使用 Distinct 方法。

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

Ancestors<T>(IEnumerable<T>)

來源:

Extensions.cs

傳回包含來源集合中每個節點祖系的項目集合。

C#

public static System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors<T> (this System.Collections.Generic.IEnumerable<T?> source) where T : System.Xml.Linq.XNode;

類型參數

T

source 中物件的型別，限制為 XNode。

參數

source

IEnumerable<T>

IEnumerable<T> 的 XNode，其中包含來源集合。

傳回

IEnumerable<XElement>

IEnumerable<T> 的 XElement，其中包含來源集合中每個節點的祖系。

範例

下列範例會擷取大子系專案的集合。 然後，它會使用此軸方法來擷取集合中所有元素的所有祖系。

C#

XElement xmlTree = new XElement("Root",  
    new XElement("Child1",  
        new XElement("GrandChild1",  
            new XElement("GreatGrandChild1", "content")  
        )  
    ),  
    new XElement("Child2",  
        new XElement("GrandChild2",  
            new XElement("GreatGrandChild2", "content")  
        )  
    )  
);  
IEnumerable<XElement> greatGrandChildren =  
    from el in xmlTree.Descendants()  
    where el.Name.LocalName.StartsWith("Great")  
    select el;  

Console.WriteLine("Great Grand Children Elements");  
Console.WriteLine("----");  
foreach (XElement de in greatGrandChildren)  
    Console.WriteLine(de.Name);  

IEnumerable<XElement> allAncestors =  
    from el in greatGrandChildren.Ancestors().Distinct()  
    select el;  

Console.WriteLine("");  
Console.WriteLine("Ancestors");  
Console.WriteLine("----");  
foreach (XElement de in allAncestors)  
    Console.WriteLine(de.Name);  

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

Great Grand Children Elements  
----  
GreatGrandChild1  
GreatGrandChild2  

Ancestors  
----  
GrandChild1  
Child1  
Root  
GrandChild2  
Child2  

以下是相同的範例，但在此情況下，XML 位於命名空間中。 如需詳細資訊，請參閱 使用 XML 命名空間。

C#

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XElement(aw + "Child1",  
        new XElement(aw + "GrandChild1",  
            new XElement(aw + "GreatGrandChild1", "content")  
        )  
    ),  
    new XElement(aw + "Child2",  
        new XElement(aw + "GrandChild2",  
            new XElement(aw + "GreatGrandChild2", "content")  
        )  
    )  
);  
IEnumerable<XElement> greatGrandChildren =  
    from el in xmlTree.Descendants()  
    where el.Name.LocalName.StartsWith("Great")  
    select el;  

Console.WriteLine("Great Grand Children Elements");  
Console.WriteLine("----");  
foreach (XElement de in greatGrandChildren)  
    Console.WriteLine(de.Name);  

IEnumerable<XElement> allAncestors =  
    from el in greatGrandChildren.Ancestors().Distinct()  
    select el;  

Console.WriteLine("");  
Console.WriteLine("Ancestors");  
Console.WriteLine("----");  
foreach (XElement de in allAncestors)  
    Console.WriteLine(de.Name);  

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

Great Grand Children Elements  
----  
{http://www.adventure-works.com}GreatGrandChild1  
{http://www.adventure-works.com}GreatGrandChild2  

Ancestors  
----  
{http://www.adventure-works.com}GrandChild1  
{http://www.adventure-works.com}Child1  
{http://www.adventure-works.com}Root  
{http://www.adventure-works.com}GrandChild2  
{http://www.adventure-works.com}Child2  

備註

如果來源集合中的多個節點具有相同的上階，則上階將會在結果集合中包含多次。 若要避免這種情況，請使用 Distinct 方法。

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

另請參閱

• Ancestors()
• AncestorsAndSelf()
• AncestorsAndSelf
• Descendants
• Nodes<T>(IEnumerable<T>)
• LINQ to XML 概觀

Ancestors<T>(IEnumerable<T>, XName)

來源:

Extensions.cs

傳回包含來源集合中每個節點祖系的已篩選項目集合。 集合中只會包含具有相符之 XName 的項目。

C#

public static System.Collections.Generic.IEnumerable<System.Xml.Linq.XElement> Ancestors<T> (this System.Collections.Generic.IEnumerable<T?> source, System.Xml.Linq.XName? name) where T : System.Xml.Linq.XNode;

類型參數

T

source 中物件的型別，限制為 XNode。

參數

source

IEnumerable<T>

IEnumerable<T> 的 XNode，其中包含來源集合。

name

XName

要比對的 XName。

傳回

IEnumerable<XElement>

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

範例

下列範例會擷取大子系專案的集合。 然後，它會使用這個座標軸方法來擷取集合中所有符合指定 XName 之 專案的所有祖系。

C#

XElement xmlTree = new XElement("Root",  
    new XElement("Child1",  
        new XElement("GrandChild1",  
            new XElement("GreatGrandChild1", "content")  
        )  
    ),  
    new XElement("Child2",  
        new XElement("GrandChild2",  
            new XElement("GreatGrandChild2", "content")  
        )  
    )  
);  
IEnumerable<XElement> greatGrandChildren =  
    from el in xmlTree.Descendants()  
    where el.Name.LocalName.StartsWith("Great")  
    select el;  

Console.WriteLine("Great Grand Children Elements");  
Console.WriteLine("----");  
foreach (XElement de in greatGrandChildren)  
    Console.WriteLine(de.Name);  

IEnumerable<XElement> allAncestors =  
    from el in greatGrandChildren.Ancestors("Child1")  
    select el;  

Console.WriteLine("");  
Console.WriteLine("Ancestors");  
Console.WriteLine("----");  
foreach (XElement de in allAncestors)  
    Console.WriteLine(de.Name);  

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

Great Grand Children Elements  
----  
GreatGrandChild1  
GreatGrandChild2  

Ancestors  
----  
Child1  

以下是相同的範例，但在此情況下，XML 位於命名空間中。 如需詳細資訊，請參閱 使用 XML 命名空間。

C#

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XElement(aw + "Child1",  
        new XElement(aw + "GrandChild1",  
            new XElement(aw + "GreatGrandChild1", "content")  
        )  
    ),  
    new XElement(aw + "Child2",  
        new XElement(aw + "GrandChild2",  
            new XElement(aw + "GreatGrandChild2", "content")  
        )  
    )  
);  
IEnumerable<XElement> greatGrandChildren =  
    from el in xmlTree.Descendants()  
    where el.Name.LocalName.StartsWith("Great")  
    select el;  

Console.WriteLine("Great Grand Children Elements");  
Console.WriteLine("----");  
foreach (XElement de in greatGrandChildren)  
    Console.WriteLine(de.Name);  

IEnumerable<XElement> allAncestors =  
    from el in greatGrandChildren.Ancestors(aw + "Child1")  
    select el;  

Console.WriteLine("");  
Console.WriteLine("Ancestors");  
Console.WriteLine("----");  
foreach (XElement de in allAncestors)  
    Console.WriteLine(de.Name);  

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

Great Grand Children Elements  
----  
{http://www.adventure-works.com}GreatGrandChild1  
{http://www.adventure-works.com}GreatGrandChild2  

Ancestors  
----  
{http://www.adventure-works.com}Child1  

備註

如果來源集合中的多個節點具有相同的上階與相符 XName 的 ，則上階將會在結果集合中包含多次。

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

另請參閱

• Ancestors()
• AncestorsAndSelf()
• AncestorsAndSelf
• Descendants
• Nodes<T>(IEnumerable<T>)
• LINQ to XML 概觀