Enumerable.SelectMany メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化します。

オーバーロード

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化して、その各要素に対して結果のセレクター関数を呼び出します。
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)	シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化して、その各要素に対して結果のセレクター関数を呼び出します。 各ソース要素のインデックスは、その要素の中間の射影されたフォームで使用されます。
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)	シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化します。
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)	シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化します。 各ソース要素のインデックスは、その要素の射影されたフォームで使用されます。

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

ソース:

SelectMany.cs

シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化して、その各要素に対して結果のセレクター関数を呼び出します。

C#

public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,System.Collections.Generic.IEnumerable<TCollection>> collectionSelector, Func<TSource,TCollection,TResult> resultSelector);

型パラメーター

TSource

source の要素の型。

TCollection

collectionSelector によって収集される中間要素の型。

TResult

結果のシーケンスの要素の型。

パラメーター

source

IEnumerable<TSource>

射影する値のシーケンス。

collectionSelector

Func<TSource,IEnumerable<TCollection>>

入力シーケンスの各要素に適用する変換関数。

resultSelector

Func<TSource,TCollection,TResult>

中間シーケンスの各要素に適用する変換関数。

戻り値

IEnumerable<TResult>

collectionSelector の各要素で一対多の変換関数 source を呼び出し、こうしたシーケンスの各要素とそれに対応するソース要素を結果の要素に割り当てた結果として得られる要素を含む IEnumerable<T>。

例外

ArgumentNullException

source、collectionSelector、または resultSelector は、null です。

例

次のコード例では、 を使用 SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) して配列に対して 1 対多のプロジェクションを実行し、結果セレクター関数を使用して、ソース シーケンスの対応する各要素を への最後の呼び出しのスコープに保持する Select方法を示します。

C#

class PetOwner
{
    public string Name { get; set; }
    public List<string> Pets { get; set; }
}

public static void SelectManyEx3()
{
    PetOwner[] petOwners =
        { new PetOwner { Name="Higa",
              Pets = new List<string>{ "Scruffy", "Sam" } },
          new PetOwner { Name="Ashkenazi",
              Pets = new List<string>{ "Walker", "Sugar" } },
          new PetOwner { Name="Price",
              Pets = new List<string>{ "Scratches", "Diesel" } },
          new PetOwner { Name="Hines",
              Pets = new List<string>{ "Dusty" } } };

    // Project the pet owner's name and the pet's name.
    var query =
        petOwners
        .SelectMany(petOwner => petOwner.Pets, (petOwner, petName) => new { petOwner, petName })
        .Where(ownerAndPet => ownerAndPet.petName.StartsWith("S"))
        .Select(ownerAndPet =>
                new
                {
                    Owner = ownerAndPet.petOwner.Name,
                    Pet = ownerAndPet.petName
                }
        );

    // Print the results.
    foreach (var obj in query)
    {
        Console.WriteLine(obj);
    }
}

// This code produces the following output:
//
// {Owner=Higa, Pet=Scruffy}
// {Owner=Higa, Pet=Sam}
// {Owner=Ashkenazi, Pet=Sugar}
// {Owner=Price, Pet=Scratches}

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) 、 の呼び出し後に発生するクエリ ロジックのスコープ内の 要素 source を保持する必要がある場合に SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)便利です。 コード例については、「使用例」のセクションを参照してください。 型のオブジェクトと 型TSourceのオブジェクトの間に双方向の関係がある場合、つまり、型TCollectionTCollectionのオブジェクトが、それを生成したオブジェクトを取得TSourceするプロパティを提供する場合、この のオーバーロードSelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)は必要ありません。 代わりに、 を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) して、 オブジェクトを TSource 介してオブジェクトに TCollection 戻ることができます。

クエリ式の構文では、最初の句の後の各 from 句 (C#) または From 句 (Visual Basic) は の SelectMany呼び出しに変換されます。

こちらもご覧ください

• from 句 (C# リファレンス)
• From 句 (Visual Basic)

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

ソース:

SelectMany.cs

シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化して、その各要素に対して結果のセレクター関数を呼び出します。 各ソース要素のインデックスは、その要素の中間の射影されたフォームで使用されます。

C#

public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,System.Collections.Generic.IEnumerable<TCollection>> collectionSelector, Func<TSource,TCollection,TResult> resultSelector);

型パラメーター

TSource

source の要素の型。

TCollection

collectionSelector によって収集される中間要素の型。

TResult

結果のシーケンスの要素の型。

パラメーター

source

IEnumerable<TSource>

射影する値のシーケンス。

collectionSelector

Func<TSource,Int32,IEnumerable<TCollection>>

各ソース要素に適用する変換関数。この関数の 2 つ目のパラメーターは、ソース要素のインデックスを表します。

resultSelector

Func<TSource,TCollection,TResult>

中間シーケンスの各要素に適用する変換関数。

戻り値

IEnumerable<TResult>

collectionSelector の各要素で一対多の変換関数 source を呼び出し、こうしたシーケンスの各要素とそれに対応するソース要素を結果の要素に割り当てた結果として得られる要素を含む IEnumerable<T>。

例外

ArgumentNullException

source、collectionSelector、または resultSelector は、null です。

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) 、 の呼び出し後に発生するクエリ ロジックのスコープ内の 要素 source を保持する必要がある場合に SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)便利です。 コード例については、「使用例」のセクションを参照してください。 型のオブジェクトと 型TSourceのオブジェクトの間に双方向の関係がある場合、つまり、型TCollectionTCollectionのオブジェクトが、それを生成したオブジェクトを取得TSourceするプロパティを提供する場合、この のオーバーロードSelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)は必要ありません。 代わりに、 を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) して、 オブジェクトを TSource 介してオブジェクトに TCollection 戻ることができます。

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)

ソース:

SelectMany.cs

シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化します。

C#

public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,System.Collections.Generic.IEnumerable<TResult>> selector);

型パラメーター

TSource

source の要素の型。

TResult

selector によって返されるシーケンスの要素の型。

パラメーター

source

IEnumerable<TSource>

射影する値のシーケンス。

selector

Func<TSource,IEnumerable<TResult>>

各要素に適用する変換関数。

戻り値

IEnumerable<TResult>

入力シーケンスの各要素に対して一対多の変換関数を呼び出した結果として得られる要素を含む IEnumerable<T>。

例外

ArgumentNullException

source または selector が null です。

例

次のコード例では、 を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) して配列に対して一対多のプロジェクションを実行する方法を示します。

C#

class PetOwner
{
    public string Name { get; set; }
    public List<String> Pets { get; set; }
}

public static void SelectManyEx1()
{
    PetOwner[] petOwners =
        { new PetOwner { Name="Higa, Sidney",
              Pets = new List<string>{ "Scruffy", "Sam" } },
          new PetOwner { Name="Ashkenazi, Ronen",
              Pets = new List<string>{ "Walker", "Sugar" } },
          new PetOwner { Name="Price, Vernette",
              Pets = new List<string>{ "Scratches", "Diesel" } } };

    // Query using SelectMany().
    IEnumerable<string> query1 = petOwners.SelectMany(petOwner => petOwner.Pets);

    Console.WriteLine("Using SelectMany():");

    // Only one foreach loop is required to iterate
    // through the results since it is a
    // one-dimensional collection.
    foreach (string pet in query1)
    {
        Console.WriteLine(pet);
    }

    // This code shows how to use Select()
    // instead of SelectMany().
    IEnumerable<List<String>> query2 =
        petOwners.Select(petOwner => petOwner.Pets);

    Console.WriteLine("\nUsing Select():");

    // Notice that two foreach loops are required to
    // iterate through the results
    // because the query returns a collection of arrays.
    foreach (List<String> petList in query2)
    {
        foreach (string pet in petList)
        {
            Console.WriteLine(pet);
        }
        Console.WriteLine();
    }
}

/*
 This code produces the following output:

 Using SelectMany():
 Scruffy
 Sam
 Walker
 Sugar
 Scratches
 Diesel

 Using Select():
 Scruffy
 Sam

 Walker
 Sugar

 Scratches
 Diesel
*/

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) 入力シーケンスを列挙し、変換関数を使用して各要素を に IEnumerable<T>マップし、そのような IEnumerable<T> 各オブジェクトの要素を列挙して生成します。 つまり、 の各要素にsourceselector対して が呼び出され、値のシーケンスが返されます。 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) 次に、コレクションのこの 2 次元コレクションを 1 次元 IEnumerable<T> にフラット化し、それを返します。 たとえば、クエリで を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) してデータベース内の各顧客の注文 (型 Order) を取得した場合、結果の型 IEnumerable<Order> は C# または IEnumerable(Of Order) Visual Basic になります。 代わりに クエリが を使用Selectして注文を取得する場合、注文のコレクションは結合されず、結果は C# または IEnumerable(Of List(Of Order)) Visual Basic の型IEnumerable<List<Order>>になります。

クエリ式の構文では、最初の句の後の各 from 句 (C#) または From 句 (Visual Basic) は の SelectMany呼び出しに変換されます。

こちらもご覧ください

• from 句 (C# リファレンス)
• From 句 (Visual Basic)

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)

ソース:

SelectMany.cs

シーケンスの各要素を IEnumerable<T> に射影し、結果のシーケンスを 1 つのシーケンスに平坦化します。 各ソース要素のインデックスは、その要素の射影されたフォームで使用されます。

C#

public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,System.Collections.Generic.IEnumerable<TResult>> selector);

型パラメーター

TSource

source の要素の型。

TResult

selector によって返されるシーケンスの要素の型。

パラメーター

source

IEnumerable<TSource>

射影する値のシーケンス。

selector

Func<TSource,Int32,IEnumerable<TResult>>

各ソース要素に適用する変換関数。この関数の 2 つ目のパラメーターは、ソース要素のインデックスを表します。

戻り値

IEnumerable<TResult>

入力シーケンスの各要素に対して一対多の変換関数を呼び出した結果として得られる要素を含む IEnumerable<T>。

例外

ArgumentNullException

source または selector が null です。

例

次のコード例では、 を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) して配列に対して一対多のプロジェクションを実行し、各外部要素のインデックスを使用する方法を示します。

C#

class PetOwner
{
    public string Name { get; set; }
    public List<string> Pets { get; set; }
}

public static void SelectManyEx2()
{
    PetOwner[] petOwners =
        { new PetOwner { Name="Higa, Sidney",
              Pets = new List<string>{ "Scruffy", "Sam" } },
          new PetOwner { Name="Ashkenazi, Ronen",
              Pets = new List<string>{ "Walker", "Sugar" } },
          new PetOwner { Name="Price, Vernette",
              Pets = new List<string>{ "Scratches", "Diesel" } },
          new PetOwner { Name="Hines, Patrick",
              Pets = new List<string>{ "Dusty" } } };

    // Project the items in the array by appending the index
    // of each PetOwner to each pet's name in that petOwner's
    // array of pets.
    IEnumerable<string> query =
        petOwners.SelectMany((petOwner, index) =>
                                 petOwner.Pets.Select(pet => index + pet));

    foreach (string pet in query)
    {
        Console.WriteLine(pet);
    }
}

// This code produces the following output:
//
// 0Scruffy
// 0Sam
// 1Walker
// 1Sugar
// 2Scratches
// 2Diesel
// 3Dusty

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) 入力シーケンスを列挙し、変換関数を使用して各要素を に IEnumerable<T>マップし、そのような IEnumerable<T> 各オブジェクトの要素を列挙して生成します。 つまり、 の各要素にsourceselector対して が呼び出され、値のシーケンスが返されます。 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) 次に、コレクションのこの 2 次元コレクションを 1 次元 IEnumerable<T> にフラット化し、それを返します。 たとえば、クエリで を使用 SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) してデータベース内の各顧客の注文 (型 Order) を取得した場合、結果の型 IEnumerable<Order> は C# または IEnumerable(Of Order) Visual Basic になります。 代わりに クエリが を使用Selectして注文を取得する場合、注文のコレクションは結合されず、結果は C# または IEnumerable(Of List(Of Order)) Visual Basic の型IEnumerable<List<Order>>になります。

処理する要素を selector 表す最初の引数。 の 2 番目の引数 selector は、ソース シーケンス内の要素の 0 から始まるインデックスを表します。 これは、要素が既知の順序にあり、たとえば、特定のインデックスにある要素を使用して何かを行う場合に便利です。 また、1 つ以上の要素のインデックスを取得する場合にも便利です。