Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Enumerable.GroupBy — seskupování podle klíče

Enumerable.GroupBy rozdělí sekvenci do skupin podle vybraného klíče. Každá skupina zpřístupňuje svůj klíč prostřednictvím Key a její prvky lze přímo procházet jako sekvenci.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

IEnumerable<IGrouping<TKey, TSource>> groups = source.GroupBy(keySelector);
IEnumerable<IGrouping<TKey, TElement>> groups = source.GroupBy(keySelector, elementSelector);

Enumerable.GroupBy z System.Linq seskupuje podle keySelector. Bez elementSelector zachovává zdrojové prvky; s tímto selektorem ukládá jejich promítnuté hodnoty.

Tato přetížení vracejí IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementuje IEnumerable<TElement>: samotná skupina je sekvencí prvků, nikoli objektem se samostatnou kolekcí Values. Vlastnost IGrouping<TKey,TElement>.Key vrací společný klíč. Bez projekce je TElement typem zdrojového prvku.

Provedení je odloženo až do enumerace. Skupiny zachovávají pořadí prvního výskytu klíčů a prvky pořadí zdroje; klíče se netřídí. Ve výchozím nastavení se používá EqualityComparer<TKey>.Default; pro jiné porovnávání zadejte IEqualityComparer<TKey>.

Příklad pro .NET 10 seskupuje slova podle délky. group.Key je délka a elements odkazuje na samotnou skupinu.

Příklady

using System;
using System.Collections.Generic;
using System.Linq;

string[] words = { "pear", "fig", "plum", "kiwi", "tea" };
IEnumerable<IGrouping<int, string>> groups = words.GroupBy(word => word.Length);

foreach (IGrouping<int, string> group in groups)
{
    IEnumerable<string> elements = group;
    Console.WriteLine($"{group.Key}: {string.Join(", ", elements)}");
}

Výsledek

4: pear, plum, kiwi
3: fig, tea

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje