情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

Enumerable.GroupBy<TSource, TKey, TElement, TResult> メソッド (IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, Func<TKey, IEnumerable<TElement>, TResult>)

2013/12/12

指定されたキー セレクター関数に従ってシーケンスの要素をグループ化し、各グループとそのキーから結果の値を作成します。各グループの要素は、指定された関数を使用して射影されます。

Namespace:  System.Linq
アセンブリ:  System.Core (System.Core.dll 内)

public static IEnumerable<TResult> GroupBy<TSource, TKey, TElement, TResult>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	Func<TSource, TElement> elementSelector,
	Func<TKey, IEnumerable<TElement>, TResult> resultSelector
)

型パラメーター

TSource

source の要素の型。

TKey

keySelector によって返されるキーの型。

TElement

IGrouping<TKey, TElement> の要素の型。

TResult

resultSelector によって返される結果値の型。

パラメーター

source
型: System.Collections.Generic.IEnumerable<TSource>
グループ化する要素が含まれている IEnumerable<T>
keySelector
型: System.Func<TSource, TKey>
各要素についてキーを抽出する関数。
elementSelector
型: System.Func<TSource, TElement>
ソースの各要素を IGrouping<TKey, TElement> の要素に割り当てる関数。
resultSelector
型: System.Func<TKey, IEnumerable<TElement>, TResult>
各グループから結果の値を作成する関数。

戻り値

型: System.Collections.Generic.IEnumerable<TResult>
TResult 型の要素のコレクション。各要素は、グループとそのキーの投影を表します。

使用上の注意

Visual Basic および C# では、このメソッドを、IEnumerable<TSource> 型の任意のオブジェクトのインスタンス メソッドとして呼び出すことができます。インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。

クエリ式の構文では、group by (Visual C#) または Group By Into (Visual Basic) 句が、Enumerable.GroupByの呼び出しに変換されます。

GroupBy<TSource, TKey, TElement, TResult>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, Func<TKey, IEnumerable<TElement>, TResult>) を使用し、シーケンスの射影された要素をグループ化して TResult 型の結果のシーケンスを射影する方法を次のコード例に示します。


      class Pet
      {
         public string Name { get; set; }
         public double Age { get; set; }
      }

      public static void GroupByEx4()
      {
         // Create a list of pets.
         List<Pet> petsList =
             new List<Pet>{ new Pet { Name="Barley", Age=8.3 },
                                new Pet { Name="Boots", Age=4.9 },
                                new Pet { Name="Whiskers", Age=1.5 },
                                new Pet { Name="Daisy", Age=4.3 } };

         // Group Pet.Age values by the Math.Floor of the age.
         // Then project an anonymous type from each group
         // that consists of the key, the count of the group's
         // elements, and the minimum and maximum age in the group.
         var query = petsList.GroupBy(
             pet => Math.Floor(pet.Age),
             pet => pet.Age,
             (baseAge, ages) => new
             {
                Key = baseAge,
                Count = ages.Count(),
                Min = ages.Min(),
                Max = ages.Max()
             });

         // Iterate over each anonymous type.
         foreach (var result in query)
         {
            outputBlock.Text += "\nAge group: " + result.Key + "\n";
            outputBlock.Text += "Number of pets in this age group: " + result.Count + "\n";
            outputBlock.Text += "Minimum age: " + result.Min + "\n";
            outputBlock.Text += "Maximum age: " + result.Max + "\n";
         }

         /*  This code produces the following output:

             Age group: 8
             Number of pets in this age group: 1
             Minimum age: 8.3
             Maximum age: 8.3

             Age group: 4
             Number of pets in this age group: 2
             Minimum age: 4.3
             Maximum age: 4.9

             Age group: 1
             Number of pets in this age group: 1
             Minimum age: 1.5
             Maximum age: 1.5
         */
      }



Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: