Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

Enumerable.GroupBy — združevanje po ključu

Enumerable.GroupBy razdeli zaporedje v skupine glede na izbrani ključ. Vsaka skupina izpostavi svoj ključ prek Key, njene elemente pa je mogoče neposredno pregledovati kot zaporedje.

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

Sintaksa

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

Enumerable.GroupBy iz System.Linq združuje glede na keySelector. Brez elementSelector ohrani izvorne elemente; z njim shrani njihove preslikane vrednosti.

Te preobremenitve vrnejo IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementira IEnumerable<TElement>: skupina sama je zaporedje elementov, ne objekt z ločeno zbirko Values. Lastnost IGrouping<TKey,TElement>.Key vrne skupni ključ. Brez preslikave je TElement tip izvornega elementa.

Izvajanje je odloženo do enumeracije. Skupine ohranijo vrstni red prve pojavitve ključev, elementi pa vrstni red izvornega zaporedja; ključi niso razvrščeni. Privzeto se uporablja EqualityComparer<TKey>.Default; za drugačno primerjavo podajte IEqualityComparer<TKey>.

Primer za .NET 10 združuje besede glede na dolžino. group.Key je dolžina, elements pa se nanaša na samo skupino.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri