CKTIS / C#
IEnumerator – die nicht generische Enumerator-Schnittstelle
System.Collections.IEnumerator beschreibt einen Cursor zum sequenziellen Lesen von Elementen. Er stellt MoveNext(), ein Current vom Typ object und Reset() bereit; er ist keine Sammlung und garantiert keine Unterstützung für IDisposable.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator beschreibt den Zustand eines einzelnen Durchlaufs durch eine Sammlung. Im Gegensatz dazu stellt System.Collections.IEnumerable GetEnumerator() bereit, das einen solchen Cursor zurückgibt. Bevorzuge in gewöhnlichem Code foreach, da es die manuelle Verwaltung des Enumerators verbirgt. Die Schnittstelle ist in .NET 10 verfügbar und benötigt keine Preview-Sprachfunktionen.
Anfangs befindet sich der Cursor vor dem ersten Element. Rufe MoveNext() auf und lies Current nur, wenn das Ergebnis true ist. Das Ergebnis false bedeutet das Ende; weitere Aufrufe geben ebenfalls false zurück, sofern der Enumerator nicht zurückgesetzt wird. Current ist vor dem ersten erfolgreichen Weiterschalten und nach Abschluss nicht definiert – gehe weder von einem bestimmten Wert noch von einer bestimmten Ausnahme aus.
Current ist eine schreibgeschützte Eigenschaft vom Typ object: Um einen bestimmten Typ zu erhalten, kann eine Typumwandlung erforderlich sein, und Werte von Werttypen werden geboxt. Der generische Typ System.Collections.Generic.IEnumerator<T> stellt ein Current vom Typ T bereit und erbt sowohl von IEnumerator als auch von IDisposable. Der nicht generische IEnumerator selbst erbt nicht von IDisposable; gib den Enumerator bei manueller Iteration frei, wenn sein Objekt diese Schnittstelle implementiert.
Reset() soll die Position vor dem ersten Element wiederherstellen, kann aber NotSupportedException auslösen; die Methode dient hauptsächlich der COM-Interoperabilität. Um einen Durchlauf zu wiederholen, hole normalerweise einen neuen Enumerator. Gehe nicht davon aus, dass Änderungen an der Sammlung während der Iteration unterstützt werden: Sie können den Enumerator ungültig machen. Die Schnittstelle bietet weder Thread-Sicherheit noch Operationen zum Ändern der Sammlung.
Beispiele
using System;
using System.Collections;
internal static class Program
{
private static void Main()
{
IEnumerable values = new string[] { "Ada", "Lin" };
IEnumerator cursor = values.GetEnumerator();
try
{
while (cursor.MoveNext())
{
string value = (string)cursor.Current;
Console.WriteLine(value);
}
}
finally
{
(cursor as IDisposable)?.Dispose();
}
}
}Ergebnis
Ada Lin
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.