KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Niet-generieke IEnumerable en IEnumerator in System.Collections

IEnumerable levert een enumerator en IEnumerator houdt de positie in de reeks bij. Een expliciete implementatie voldoet aan het niet-generieke contract zonder iteratielogica te dupliceren.

Versie: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

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

sealed class Sequence<T> : IEnumerable<T>
{
    public IEnumerator<T> GetEnumerator()
    {
        yield break;
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}

System.Collections.IEnumerable vertegenwoordigt een bron van elementen. GetEnumerator() geeft een System.Collections.IEnumerator terug die de positie in de reeks bijhoudt. De enumerator begint vóór het eerste element. Lees Current alleen nadat MoveNext() true heeft teruggegeven en stop zodra het false teruggeeft. Reset() is bedoeld om de beginpositie te herstellen, maar kan NotSupportedException veroorzaken, zoals bij iterators met yield. Vraag een nieuwe enumerator op om opnieuw te beginnen.

IEnumerable<T> uit System.Collections.Generic erft van het niet-generieke IEnumerable, dus de klasse moet aan beide contracten voldoen. Bied een openbare methode aan die IEnumerator<T> teruggeeft en voeg IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); toe. Deze expliciete implementatie is bereikbaar via de niet-generieke interface. Het is geen gewone overload: C# staat geen overloads toe die alleen in het retourtype verschillen. Beide aanroepen gebruiken dezelfde iteratielogica.

IEnumerator<T> erft van IEnumerator en IDisposable. De generieke Current heeft type T; de niet-generieke Current geeft object terug. In het voorbeeld wordt bij het lezen van de niet-generieke Current een int gebokst (boxing), waarna foreach (int ...) de waarde uitpakt (unboxing). Een iterator met yield levert beide versies van Current. Schrijf je zelf een enumerator, dan kun je de niet-generieke Current expliciet implementeren.

foreach roept MoveNext() aan en leest Current zonder Reset() te gebruiken. Als de enumerator IDisposable implementeert, roept foreach ook Dispose() aan, zelfs als je de lus voortijdig verlaat. Controleer bij handmatige iteratie via IEnumerator in een finally-blok of de enumerator IDisposable implementeert en roep dan Dispose() aan: de niet-generieke interface vereist die methode niet.

Voorbeelden

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

IEnumerable<int> typed = new EvenPair();
IEnumerable untyped = typed;

foreach (int value in typed)
    Console.WriteLine(FormattableString.Invariant($"Generic: {value}"));

foreach (int value in untyped)
    Console.WriteLine(FormattableString.Invariant($"Non-generic: {value}"));

sealed class EvenPair : IEnumerable<int>
{
    public IEnumerator<int> GetEnumerator()
    {
        yield return 2;
        yield return 4;
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}

Resultaat

Generic: 2
Generic: 4
Non-generic: 2
Non-generic: 4

Beide variabelen verwijzen naar hetzelfde object. De tweede lus roept de expliciete implementatie aan via `IEnumerable` en leest opnieuw `2` en `4`.

Gerelateerde lessen

  • C# · Les 38 · Gemiddeld · Versie: 2

Bronnen