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.