Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Enumerable.GroupBy — grupowanie według klucza

Enumerable.GroupBy dzieli sekwencję na grupy według wybranego klucza. Każda grupa udostępnia klucz przez Key, a jej elementy można przeglądać bezpośrednio jako sekwencję.

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

Składnia

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

Enumerable.GroupBy z System.Linq grupuje według keySelector. Bez elementSelector zachowuje elementy źródłowe; z nim przechowuje ich przekształcone wartości.

Wynik tych przeciążeń to IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementuje IEnumerable<TElement>: sama grupa jest sekwencją elementów, nie obiektem z osobną kolekcją Values. Właściwość IGrouping<TKey,TElement>.Key zwraca wspólny klucz. Bez projekcji TElement jest typem elementu źródłowego.

Wykonanie jest odroczone do enumeracji. Grupy zachowują kolejność pierwszego wystąpienia kluczy, a elementy — kolejność źródłową; klucze nie są sortowane. Domyślnie obowiązuje EqualityComparer<TKey>.Default; inne porównanie można przekazać przez IEqualityComparer<TKey>.

Przykład dla .NET 10 grupuje słowa według długości. group.Key to długość, a elements wskazuje samą grupę.

Przykłady

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)}");
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła