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

XNode に制限された、source 内のオブジェクトの型。

パラメーター

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

XNode に制限された、source 内のオブジェクトの型。

パラメーター

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 の概要