Windows app
摺疊目錄
展開目錄
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文
資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

 

依據指定的索引鍵選擇器函式來群組序列的項目。

命名空間:   System.Linq
組件:  System.Core (在 System.Core.dll 中)

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

參數

source

要群組其項目的 IEnumerable<T>

keySelector

用來擷取各項目之索引鍵的函式。

傳回值

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

在 C# 中為 IEnumerable<IGrouping<TKey, TSource>>,而在 Visual Basic 中則為 IEnumerable(Of IGrouping(Of TKey, TSource)),其中 IGrouping<TKey, TElement> 物件包含物件和索引鍵的序列。

類型參數

TSource

source 之項目的型別。

TKey

keySelector 所傳回之索引鍵的型別。

Exception Condition
ArgumentNullException

sourcekeySelectornull

這個方法是利用延遲執行所實作。立即傳回值是一個物件,儲存執行該動作所需的所有資訊。這個方法所代表的查詢必須等到列舉物件 (透過直接呼叫其 GetEnumerator 方法,或是使用 Visual C# 中的 foreach 或 Visual Basic 中的 For Each) 之後才會執行。

GroupBy<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>) 方法會針對找到的每個獨特索引鍵,各傳回一個 IGrouping<TKey, TElement> 物件集合。 IGrouping<TKey, TElement> 是也有與其項目相關聯之索引鍵的 IEnumerable<T>

產生 IGrouping<TKey, TElement> 物件的順序是根據產生每個 IGrouping<TKey, TElement> 的第一個索引鍵之 source 中的項目順序。群組中的項目會依照它們在 source 中的出現順序產生。

使用預設的相等比較子 Default 來比較索引鍵。

在查詢運算式語法中,group by (Visual C#) 或 Group By Into (Visual Basic) 子句會轉譯為 GroupBy 的引動過程。如需詳細資訊與使用方式範例,請參閱 group 子句 (C# 參考)Group By 子句 (Visual Basic)

Universal Windows Platform
自 4.5 起可用
.NET Framework
自 3.5 起可用
Portable Class Library
支援版本:portable .NET platforms
Silverlight
自 2.0 起可用
Windows Phone Silverlight
自 7.0 起可用
Windows Phone
自 8.1 起可用
回到頁首
顯示:
© 2016 Microsoft