本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

Enumerable.GroupBy<TSource, TKey, TElement> 方法 (IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, IEqualityComparer<TKey>)

 

根据键选择器函数对序列的元素进行分组。 通过使用比较器对键进行比较,并且通过使用指定的函数对每个组的元素进行投影。

命名空间:   System.Linq
程序集:  System.Core(位于 System.Core.dll)

public static IEnumerable<IGrouping<TKey, TElement>> GroupBy<TSource, TKey, TElement>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	Func<TSource, TElement> elementSelector,
	IEqualityComparer<TKey> comparer
)

参数

source
Type: System.Collections.Generic.IEnumerable<TSource>

IEnumerable<T> 其元素进行分组。

keySelector
Type: System.Func<TSource, TKey>

用于提取每个元素的键的函数。

elementSelector
Type: System.Func<TSource, TElement>

用于将每个源元素映射到中的元素 IGrouping<TKey, TElement>

comparer
Type: System.Collections.Generic.IEqualityComparer<TKey>

IEqualityComparer<T> 对键进行比较。

返回值

Type: System.Collections.Generic.IEnumerable<IGrouping<TKey, TElement>>

IEnumerable<IGrouping<TKey, TElement>> 在 C# 或 IEnumerable(Of IGrouping(Of TKey, TElement)) 中 Visual Basic 其中每个 IGrouping<TKey, TElement> 对象包含类型的对象的集合 TElement 和密钥。

类型参数

TSource

中的元素的类型 source

TKey

返回的键的类型 keySelector

TElement

IGrouping<TKey, TElement> 中元素的类型。

Exception Condition
ArgumentNullException

sourcekeySelectorelementSelectornull

此方法实现通过使用延迟的执行。 最接近的返回值是指存储执行的操作所需的所有信息的对象。 此方法所表示的查询不执行之前调用枚举的对象及其 GetEnumerator 方法直接或通过使用 foreach 中 Visual C# 或 For Each 中 Visual Basic。

GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, IEqualityComparer<TKey>) 方法返回的集合 IGrouping<TKey, TElement> 对象,一个遇到每个非重复键。 IGrouping<TKey, TElement>IEnumerable<T> ,它也有其元素与关联的密钥。

IGrouping<TKey, TElement> 对象都基于中元素的顺序的顺序生成 source 生成的第一个键的每个 IGrouping<TKey, TElement> 分组中的元素都按顺序生成它们的元素显示在生成 source

如果 comparernull, ,默认的相等比较 Default 用来对键进行比较。

如果两个键都被视为相等根据 comparer, ,为该分组的键选择的第一个键。

在查询表达式语法 group by (Visual C#) 或 Group By Into (Visual Basic) 子句转换为的一个调用 GroupBy 有关详细信息和用法示例,请参阅 group 子句(C# 参考)Group By 子句 (Visual Basic)

通用 Windows 平台
自 8 起可用
.NET Framework
自 3.5 起可用
可移植类库
可移植 .NET 平台 中受支持
Silverlight
自 2.0 起可用
Windows Phone Silverlight
自 7.0 起可用
Windows Phone
自 8.1 起可用
返回页首
显示: