CKTIS / C#
Nicht generische Schnittstellen IEnumerable und IEnumerator in System.Collections
IEnumerable liefert einen Enumerator, und IEnumerator verwaltet die Position in einer Sequenz. Eine explizite Implementierung erfüllt den nicht generischen Vertrag ohne doppelte Iterationslogik.
Version: 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 steht für eine Quelle von Elementen. GetEnumerator() gibt einen System.Collections.IEnumerator zurück, der die Position in der Sequenz verwaltet. Der Enumerator startet vor dem ersten Element. Lies Current erst, nachdem MoveNext() den Wert true geliefert hat, und beende die Iteration bei false. Reset() soll die Startposition wiederherstellen, kann aber wie bei yield-Iteratoren eine NotSupportedException auslösen. Hole zum Neustart einen neuen Enumerator.
IEnumerable<T> aus System.Collections.Generic erbt vom nicht generischen IEnumerable. Die Klasse muss also beide Verträge erfüllen. Stelle eine öffentliche Methode bereit, die IEnumerator<T> zurückgibt, und ergänze IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Diese explizite Implementierung ist über die nicht generische Schnittstelle zugänglich. Sie ist keine gewöhnliche Überladung: C# erlaubt keine Überladung allein nach Rückgabetyp. Beide Aufrufe nutzen dieselbe Iterationslogik.
IEnumerator<T> erbt von IEnumerator und IDisposable. Das generische Current hat den Typ T; das nicht generische liefert object. Im Beispiel wird beim Lesen des nicht generischen Current ein int geboxt und in foreach (int ...) wieder entboxt. Ein yield-Iterator stellt beide Varianten von Current bereit. Bei einem selbst geschriebenen Enumerator kannst du das nicht generische Current explizit implementieren.
foreach ruft MoveNext() auf und liest Current, ohne Reset() zu verwenden. Es ruft auch Dispose() auf, wenn der Enumerator IDisposable implementiert, selbst beim vorzeitigen Verlassen der Schleife. Prüfe bei manueller Iteration über IEnumerator in einem finally-Block auf IDisposable und rufe gegebenenfalls Dispose() auf: Die nicht generische Schnittstelle selbst verlangt die Methode nicht.
Beispiele
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();
}Ergebnis
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Beide Variablen verweisen auf dasselbe Objekt. Die zweite Schleife ruft die explizite Implementierung über `IEnumerable` auf und liest erneut `2` und `4`.
Zugehörige Lektionen
- C# · Lektion 38 · Mittlere Stufe · Version: 2
Quellen
- 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)