WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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