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

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

 

根据指定的键选择器函数和项目的元素的每个组通过使用指定的函数对序列的元素进行分组。

命名空间:   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
)

参数

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

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

keySelector
Type: System.Func<TSource, TKey>

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

elementSelector
Type: System.Func<TSource, TElement>

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

返回值

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>) 方法返回的集合 IGrouping<TKey, TElement> 对象,一个遇到每个非重复键。 IGrouping<TKey, TElement>IEnumerable<T> ,它也有其元素与关联的密钥。

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

默认的相等比较 Default 用来对键进行比较。

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

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

// Uses method-based query syntax.
public static void GroupByEx1()
{
    // Create a list of pets.
    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 Age as the key value 
    // and selecting only the pet's Name for each value.
    IEnumerable<IGrouping<int, string>> query =
        pets.GroupBy(pet => pet.Age, pet => pet.Name);

    // Iterate over each IGrouping in the collection.
    foreach (IGrouping<int, string> petGroup in query)
    {
        // Print the key value of the IGrouping.
        Console.WriteLine(petGroup.Key);
        // Iterate over each value in the 
        // IGrouping and print the value.
        foreach (string name in petGroup)
            Console.WriteLine("  {0}", name);
    }
}

/*
 This code produces the following output:

 8
   Barley
 4
   Boots
   Daisy
 1
   Whiskers
*/

在查询表达式语法 group by (Visual C#) 或 Group By Into (Visual Basic) 子句转换为的一个调用 GroupBy 下面的示例中的查询表达式转换等效于上述示例中的查询。

IEnumerable<IGrouping<int, string>> query =
    from pet in pets
    group pet.Name by pet.Age;
System_CAPS_note说明

在 Visual C# 或 Visual Basic 查询表达式中,元素和键选择表达式中发生相反的顺序从其在调用中的参数位置 GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>) 方法。

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