CKTIS / C#
Negeneričko sučelje IEnumerable
System.Collections.IEnumerable omogućuje iteriranje kroz elemente bez navođenja njihova tipa generičkim parametrom. Njegova metoda GetEnumerator() vraća IEnumerator, a foreach čita elemente putem tog ugovora.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public interface IEnumerable
{
System.Collections.IEnumerator GetEnumerator();
}System.Collections.IEnumerable negenerički je ugovor za iteriranje kroz elemente. Deklarira jednu metodu: GetEnumerator(), koja vraća System.Collections.IEnumerator. Ne izlaže broj elemenata ni indeksator.
Razlikujte niz od njegova enumeratora: IEnumerable pruža enumerator, dok IEnumerator održava položaj iteracije. MoveNext() prelazi na sljedeći element i javlja je li uspio; tek se tada može čitati Current tipa object. Čitanje Current prije prvog uspješnog pomaka ili nakon završetka iteracije nije valjano. Reset() ne mora biti podržan.
System.Collections.Generic.IEnumerable<T> određuje tip elemenata i nasljeđuje negenerički IEnumerable. Kad je tip poznat, uglavnom odaberite generičku verziju; negenerička je korisna pri suradnji s API-jima koji zahtijevaju taj ugovor. Izričiti tip varijable u foreach, primjerice string, zahtijeva valjanu pretvorbu svakog elementa; nekompatibilan element može uzrokovati InvalidCastException.
U primjeru se polju pristupa putem IEnumerable, pa je value tipa object, iako su elementi nizovi znakova. foreach upravlja pomicanjem enumeratora. Međutim, samo korištenje foreach ne dokazuje da je ovo sučelje implementirano: C# podržava i odgovarajući obrazac GetEnumerator() s MoveNext() i Current.
Primjeri
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);
}
}
}Rezultat
Ada Lin
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.