Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori