CKTIS / C#
IEnumerator — niegeneryczny interfejs enumeratora
System.Collections.IEnumerator opisuje kursor do sekwencyjnego odczytu elementów. Udostępnia MoveNext(), Current typu object oraz Reset(); nie jest kolekcją ani nie gwarantuje obsługi IDisposable.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator opisuje stan pojedynczego przejścia po kolekcji. Natomiast System.Collections.IEnumerable udostępnia GetEnumerator(), które zwraca taki kursor. W zwykłym kodzie preferuj foreach, które ukrywa ręczne sterowanie enumeratorem. Interfejs jest dostępny w .NET 10 i nie wymaga funkcji języka w wersji preview.
Początkowo kursor znajduje się przed pierwszym elementem. Wywołaj MoveNext() i odczytaj Current tylko wtedy, gdy wynik to true. Wynik false oznacza koniec; kolejne wywołania również zwracają false, dopóki enumerator nie zostanie zresetowany. Wartość Current przed pierwszym udanym przesunięciem i po zakończeniu jest niezdefiniowana — nie zakładaj konkretnej wartości ani wyjątku.
Current jest właściwością tylko do odczytu typu object: odzyskanie konkretnego typu może wymagać rzutowania, a wartości typów wartościowych są pakowane. Generyczny System.Collections.Generic.IEnumerator<T> udostępnia Current typu T i dziedziczy po IEnumerator oraz IDisposable. Sam niegeneryczny IEnumerator nie dziedziczy po IDisposable; przy ręcznej iteracji zwolnij enumerator, jeśli jego obiekt implementuje ten interfejs.
Reset() ma przywracać pozycję przed pierwszym elementem, ale może zgłaszać NotSupportedException; służy głównie współpracy z COM. Aby powtórzyć przejście, zwykle pobierz nowy enumerator. Nie zakładaj, że zmiany kolekcji podczas iteracji są obsługiwane: mogą unieważnić enumerator. Interfejs nie zapewnia bezpieczeństwa wątkowego ani operacji modyfikowania kolekcji.
Przykłady
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();
}
}
}Wynik
Ada Lin
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.