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
- IEnumerable Interface (System.Collections)
- IEnumerator Interface (System.Collections)
- IEnumerable<T> Interface (System.Collections.Generic)
- IEnumerator<T> Interface (System.Collections.Generic)
- Explicit Interface Implementation (C# Programming Guide)
- Iterate through collections
- Statements — C# language specification
- Basic concepts — C# language specification
- Boxing and Unboxing (C# Programming Guide)