Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła