KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Enumerable.GroupBy — groeperen op sleutel

Enumerable.GroupBy verdeelt een reeks in groepen op basis van een geselecteerde sleutel. Elke groep biedt de sleutel via Key aan, en de elementen kunnen rechtstreeks als een reeks worden doorlopen.

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

Syntax

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

Enumerable.GroupBy uit System.Linq groepeert op basis van keySelector. Zonder elementSelector blijven de bronelementen behouden; met deze selector worden de geprojecteerde waarden opgeslagen.

Deze overloads retourneren IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementeert IEnumerable<TElement>: de groep zelf is de reeks elementen, niet een object met een aparte Values-verzameling. De eigenschap IGrouping<TKey,TElement>.Key retourneert de gedeelde sleutel. Zonder projectie is TElement het type van het bronelement.

De uitvoering wordt uitgesteld tot het enumereren. De groepen volgen de volgorde waarin sleutels voor het eerst voorkomen, en elementen behouden de volgorde van de bron; sleutels worden niet gesorteerd. Standaard wordt EqualityComparer<TKey>.Default gebruikt; geef IEqualityComparer<TKey> op voor een andere vergelijking.

Het .NET 10-voorbeeld groepeert woorden op lengte. group.Key is de lengte, en elements verwijst naar de groep zelf.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen