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.