Extensions.Elements メソッド

リファレンス

定義

名前空間:: System.Xml.Linq

アセンブリ:: System.Xml.XDocument.dll

アセンブリ:: System.Xml.Linq.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ソースコレクション内のすべての要素およびドキュメントの子要素のコレクションを返します。

オーバーロード

Elements<T>(IEnumerable<T>)	ソースコレクション内のすべての要素およびドキュメントの子要素のコレクションを返します。
Elements<T>(IEnumerable<T>, XName)	ソースコレクション内のすべての要素およびドキュメントの、フィルター処理された子要素のコレクションを返します。一致する XName を持つ要素のみがコレクションに含められます。

注釈

Visual Basic には、ソースコレクション内のすべての要素に対してが指定 XName されているすべての子要素を検索できる統合要素軸が含まれています。

このメソッドは遅延実行を使用します。

Elements<T>(IEnumerable<T>)

ソース:: Extensions.cs

ソース:: Extensions.cs

ソース:: Extensions.cs

ソースコレクション内のすべての要素およびドキュメントの子要素のコレクションを返します。

public:
generic <typename T>
 where T : System::Xml::Linq::XContainer[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Elements(System::Collections::Generic::IEnumerable<T> ^ source);

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

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

static member Elements : seq<'T (requires 'T :> System.Xml.Linq.XContainer)> -> seq<System.Xml.Linq.XElement> (requires 'T :> System.Xml.Linq.XContainer)

<Extension()>
Public Function Elements(Of T As XContainer) (source As IEnumerable(Of T)) As IEnumerable(Of XElement)

型パラメーター

T

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

パラメーター

source: IEnumerable<T>

ソースコレクションが格納されている IEnumerable<T> の XElement。

戻り値

IEnumerable<XElement>

ソースコレクション内のすべての要素またはドキュメントの子要素の、IEnumerable<T> の XElement。

例

次の例では、の要素名 Childを持つ要素のコレクションを取得します。次に、この軸メソッドを使用して、コレクションのすべての子要素を取得します。

XElement xmlTree = new XElement("Root",  
    new XElement("Child",  
        new XElement("GrandChild1", 1),  
        new XElement("GrandChild2", 2)  
    ),  
    new XElement("Child",  
        new XElement("GrandChild3", 3),  
        new XElement("GrandChild4", 4)  
    ),  
    new XElement("Child",  
        new XElement("GrandChild5", 5),  
        new XElement("GrandChild6", 6)  
    )  
);  

IEnumerable<XElement> allGrandChildren =  
    from el in xmlTree.Elements("Child").Elements()  
    select el;  

foreach (XElement el in allGrandChildren)  
    Console.WriteLine(el);

Dim xmlTree As XElement = _  
     <Root>  
          <Child>  
              <GrandChild1>1</GrandChild1>  
              <GrandChild2>2</GrandChild2>  
          </Child>  

          <Child>  
              <GrandChild3>3</GrandChild3>  
              <GrandChild4>4</GrandChild4>  
          </Child>  

          <Child>  
              <GrandChild5>5</GrandChild5>  
              <GrandChild6>6</GrandChild6>  
          </Child>  
      </Root>  

Dim allGrandChildren = From el In xmlTree.<Child>.Elements _  
                       Select el  

For Each el As XElement In allGrandChildren  
    Console.WriteLine(el)  
Next

この例を実行すると、次の出力が生成されます。

<GrandChild1>1</GrandChild1>  
<GrandChild2>2</GrandChild2>  
<GrandChild3>3</GrandChild3>  
<GrandChild4>4</GrandChild4>  
<GrandChild5>5</GrandChild5>  
<GrandChild6>6</GrandChild6>

同じ例を次に示しますが、この場合、XML は名前空間内にあります。詳細については、「 XML 名前空間の操作」を参照してください。

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XElement(aw + "Child",  
        new XElement(aw + "GrandChild1", 1),  
        new XElement(aw + "GrandChild2", 2)  
    ),  
    new XElement(aw + "Child",  
        new XElement(aw + "GrandChild3", 3),  
        new XElement(aw + "GrandChild4", 4)  
    ),  
    new XElement(aw + "Child",  
        new XElement(aw + "GrandChild5", 5),  
        new XElement(aw + "GrandChild6", 6)  
    )  
);  

IEnumerable<XElement> allGrandChildren =  
    from el in xmlTree.Elements(aw + "Child").Elements()  
    select el;  

foreach (XElement el in allGrandChildren)  
    Console.WriteLine(el);

Imports <xmlns="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim xmlTree As XElement = _  
             <Root>  
                 <Child>  
                     <GrandChild1>1</GrandChild1>  
                     <GrandChild2>2</GrandChild2>  
                 </Child>  

                 <Child>  
                     <GrandChild3>3</GrandChild3>  
                     <GrandChild4>4</GrandChild4>  
                 </Child>  

                 <Child>  
                     <GrandChild5>5</GrandChild5>  
                     <GrandChild6>6</GrandChild6>  
                 </Child>  
             </Root>  

        Dim allGrandChildren = From el In xmlTree.<Child>.Elements _  
                               Select el  

        For Each el As XElement In allGrandChildren  
            Console.WriteLine(el)  
        Next  
    End Sub  
End Module

この例を実行すると、次の出力が生成されます。

<GrandChild1 xmlns="http://www.adventure-works.com">1</GrandChild1>  
<GrandChild2 xmlns="http://www.adventure-works.com">2</GrandChild2>  
<GrandChild3 xmlns="http://www.adventure-works.com">3</GrandChild3>  
<GrandChild4 xmlns="http://www.adventure-works.com">4</GrandChild4>  
<GrandChild5 xmlns="http://www.adventure-works.com">5</GrandChild5>  
<GrandChild6 xmlns="http://www.adventure-works.com">6</GrandChild6>

注釈

Visual Basic には、ソースコレクション内のすべての要素に対してが指定されたすべての XName 子要素を検索できる統合要素軸が含まれていますが、ソースコレクション内のすべての要素のすべての子要素のコレクションを取得できる統合要素軸はありません。

このメソッドは遅延実行を使用します。

こちらもご覧ください

適用対象

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

ソース:: Extensions.cs

ソース:: Extensions.cs

ソース:: Extensions.cs

ソースコレクション内のすべての要素およびドキュメントの、フィルター処理された子要素のコレクションを返します。一致する XName を持つ要素のみがコレクションに含められます。

public:
generic <typename T>
 where T : System::Xml::Linq::XContainer[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<System::Xml::Linq::XElement ^> ^ Elements(System::Collections::Generic::IEnumerable<T> ^ source, System::Xml::Linq::XName ^ name);

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

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

static member Elements : seq<'T (requires 'T :> System.Xml.Linq.XContainer)> * System.Xml.Linq.XName -> seq<System.Xml.Linq.XElement> (requires 'T :> System.Xml.Linq.XContainer)

<Extension()>
Public Function Elements(Of T As XContainer) (source As IEnumerable(Of T), name As XName) As IEnumerable(Of XElement)

型パラメーター

T

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

パラメーター

source: IEnumerable<T>

ソースコレクションが格納されている IEnumerable<T> の XElement。

name: XName

照合する XName。

戻り値

IEnumerable<XElement>

ソースコレクション内のすべての要素およびドキュメントの子要素の、IEnumerable<T> の XElement。一致する XName を持つ要素のみがコレクションに含められます。

例

この拡張メソッドは、特定の深さで指定された名前を持つすべての要素を取得する場合に便利です。これは、ドキュメントが非常に規則的な場合は簡単ですが、ドキュメントが不規則な場合は、もう少し難しい場合があります。次の例では、要素のItem子であるすべてのaaa要素を取得します。特定 Item の要素に要素が含まれている場合と含 aaa まれていない場合があります。これは、次のように、この拡張メソッドを使用して簡単に実現できます。

XElement xmlTree = new XElement("Root",  
    new XElement("Item",  
        new XElement("aaa", 1),  
        new XElement("bbb", 2)  
    ),  
    new XElement("Item",  
        new XElement("ccc", 3),  
        new XElement("aaa", 4)  
    ),  
    new XElement("Item",  
        new XElement("ddd", 5),  
        new XElement("eee", 6)  
    )  
);  

IEnumerable<XElement> allGrandChildren =  
    from el in xmlTree.Elements("Item").Elements("aaa")  
    select el;  

foreach (XElement el in allGrandChildren)  
    Console.WriteLine(el);

Dim xmlTree As XElement = _  
    <Root>  
        <Item>  
            <aaa>1</aaa>  
            <bbb>2</bbb>  
        </Item>  

        <Item>  
            <ccc>3</ccc>  
            <aaa>4</aaa>  
        </Item>  

        <Item>  
            <ddd>5</ddd>  
            <eee>6</eee>  
        </Item>  
    </Root>  

Dim allGrandChildren = From el In xmlTree.<Item>.<aaa> _  
                       Select el  

For Each el As XElement In allGrandChildren  
    Console.WriteLine(el)  
Next

この例を実行すると、次の出力が生成されます。

<aaa>1</aaa>  
<aaa>4</aaa>

同じ例を次に示しますが、この場合、XML は名前空間内にあります。詳細については、「 XML 名前空間の操作」を参照してください。

XNamespace aw = "http://www.adventure-works.com";  
XElement xmlTree = new XElement(aw + "Root",  
    new XElement(aw + "Item",  
        new XElement(aw + "aaa", 1),  
        new XElement(aw + "bbb", 2)  
    ),  
    new XElement(aw + "Item",  
        new XElement(aw + "ccc", 3),  
        new XElement(aw + "aaa", 4)  
    ),  
    new XElement(aw + "Item",  
        new XElement(aw + "ddd", 5),  
        new XElement(aw + "eee", 6)  
    )  
);  

IEnumerable<XElement> allGrandChildren =  
    from el in xmlTree.Elements(aw + "Item").Elements(aw + "aaa")  
    select el;  

foreach (XElement el in allGrandChildren)  
    Console.WriteLine(el);

Imports <xmlns="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim xmlTree As XElement = _  
            <Root>  
                <Item>  
                    <aaa>1</aaa>  
                    <bbb>2</bbb>  
                </Item>  

                <Item>  
                    <ccc>3</ccc>  
                    <aaa>4</aaa>  
                </Item>  

                <Item>  
                    <ddd>5</ddd>  
                    <eee>6</eee>  
                </Item>  
            </Root>  

        Dim allGrandChildren = From el In xmlTree.<Item>.<aaa> _  
                               Select el  

        For Each el As XElement In allGrandChildren  
            Console.WriteLine(el)  
        Next  
    End Sub  
End Module

この例を実行すると、次の出力が生成されます。

<aaa xmlns="http://www.adventure-works.com">1</aaa>  
<aaa xmlns="http://www.adventure-works.com">4</aaa>

注釈

Visual Basic ユーザーは、統合された要素軸を使用して、コレクション内のすべての要素の子要素を取得できます。

このメソッドは遅延実行を使用します。

こちらもご覧ください

適用対象

次の方法で共有

Extensions.Elements メソッド

定義

オーバーロード

注釈

Elements<T>(IEnumerable<T>)

型パラメーター

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

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

型パラメーター

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

その他のリソース