Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Niegenericzny interfejs IEnumerable

System.Collections.IEnumerable udostępnia przechodzenie po elementach bez określania ich typu w parametrze generycznym. Jego metoda GetEnumerator() zwraca IEnumerator, a foreach odczytuje elementy przez ten kontrakt.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

public interface IEnumerable
{
    System.Collections.IEnumerator GetEnumerator();
}

System.Collections.IEnumerable to niegeneryczny kontrakt umożliwiający przechodzenie po elementach. Deklaruje jedną metodę: GetEnumerator(), zwracającą System.Collections.IEnumerator. Nie udostępnia licznika elementów ani indeksatora.

Odróżniaj sekwencję od jej enumeratora: IEnumerable udostępnia enumerator, natomiast IEnumerator przechowuje pozycję iteracji. MoveNext() przesuwa go do następnego elementu i zwraca informację o powodzeniu; dopiero wtedy można odczytać Current typu object. Przed pierwszym udanym przesunięciem i po zakończeniu iteracji odczyt Current nie jest poprawny. Reset() nie musi być obsługiwane.

System.Collections.Generic.IEnumerable<T> określa typ elementu i dziedziczy po niegenerycznym IEnumerable. Gdy typ jest znany, zwykle wybieraj wersję generyczną; wersja niegeneryczna przydaje się przy współpracy z API wymagającym tego kontraktu. Jawny typ zmiennej w foreach, na przykład string, wymaga poprawnej konwersji każdego elementu; niezgodny element może spowodować InvalidCastException.

W przykładzie tablica jest dostępna przez IEnumerable, dlatego value ma typ object, choć elementy są napisami. foreach obsługuje przesuwanie enumeratora. Samo użycie foreach nie dowodzi jednak implementacji tego interfejsu: C# obsługuje również odpowiedni wzorzec GetEnumerator() z MoveNext() i Current.

Przykłady

using System;
using System.Collections;

internal static class Program
{
    private static void Main()
    {
        IEnumerable values = new string[] { "Ada", "Lin" };

        foreach (object value in values)
        {
            Console.WriteLine(value);
        }
    }
}

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