Queryable.GroupBy<TSource, TKey> 方法 (IQueryable<TSource>, Expression<Func<TSource, TKey>>) 转

根据指定的键选择器函数对序列中的元素进行分组。

 

命名空间：  System.Linq
程序集：  System.Core（在 System.Core.dll 中）

语法

---

C#

C++

F#

VB

 

public static IQueryable<IGrouping<TKey, TSource>> GroupBy<TSource, TKey>(
	this IQueryable<TSource> source,
	Expression<Func<TSource, TKey>> keySelector
)

类型参数

TSource

source 中的元素的类型。

TKey

由 keySelector 表示的函数返回的键类型。

参数

source

类型：System.Linq.IQueryable<TSource>
要对其元素进行分组的 IQueryable<T>。

keySelector

类型：System.Linq.Expressions.Expression<Func<TSource, TKey>>
用于提取每个元素的键的函数。

返回值

类型：System.Linq.IQueryable<IGrouping<TKey, TSource>>
在 C# 中为 IQueryable<IGrouping<TKey, TSource>>，或者在 Visual Basic 中为 IQueryable(Of IGrouping(Of TKey, TSource))，其中每个 IGrouping<TKey, TElement> 对象都包含一个对象序列和一个键。

使用说明

在 Visual Basic 和 C# 中，可以在 IQueryable<TSource> 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关更多信息，请参见扩展方法 (Visual Basic)或扩展方法（C# 编程指南）。

异常

---

异常	条件
ArgumentNullException	source 或 keySelector 为 null。

备注

---

此方法至少有一个 Expression<TDelegate> 类型的实参，其形参类型是 Func<T, TResult> 类型之一。 对于这些参数，您可以 lambda 表达式形式传递，并且该表达式将被编译为 Expression<TDelegate>。

GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) 方法生成 MethodCallExpression，表示调用 GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) 自身作为构造的泛型方法。 然后，它将 MethodCallExpression 传递给 IQueryProvider 的 CreateQuery<TElement>(Expression) 方法，由 source 参数的 Provider 属性表示。

因执行表示调用 GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) 的表达式目录树而发生的查询行为取决于 source 参数类型的实现。 预期的行为是根据键值对 source 中的元素进行分组，而键值是通过对每个元素调用 keySelector 获得的。

示例

---

下面的代码示例演示如何使用 GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) 对序列中的元素进行分组。

C#

VB

 

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

            public static void GroupByEx1()
            {
                // Create a list of Pet objects.
                List<Pet> pets =
                    new List<Pet>{ new Pet { Name="Barley", Age=8 },
                                   new Pet { Name="Boots", Age=4 },
                                   new Pet { Name="Whiskers", Age=1 },
                                   new Pet { Name="Daisy", Age=4 } };

                // Group the pets using Pet.Age as the key.
                // Use Pet.Name as the value for each entry.
                var query = pets.AsQueryable().GroupBy(pet => pet.Age);

                // Iterate over each IGrouping in the collection.
                foreach (var ageGroup in query)
                {
                    Console.WriteLine("Age group: {0}  Number of pets: {1}", ageGroup.Key, ageGroup.Count());
                }
            }

            /*
                This code produces the following output:

                Age group: 8  Number of pets: 1
                Age group: 4  Number of pets: 2
                Age group: 1  Number of pets: 1

            */

版本信息

---

.NET Framework

受以下版本支持：4.5、4、3.5

.NET Framework Client Profile

受以下版本支持：4、3.5 SP1

可移植类库

受以下版本支持：可移植类库

适用于 Windows 应用商店应用的 .NET

受以下版本支持：Windows 8

平台

---

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008（不支持服务器核心角色）, Windows Server 2008 R2（支持带 SP1 或更高版本的服务器核心角色；不支持 Itanium）

 

 

.NET Framework 并不是对每个平台的所有版本都提供支持。