Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

Negenerični vmesnik IEnumerable

System.Collections.IEnumerable omogoča iteriranje po elementih, ne da bi njihov tip določili z generičnim parametrom. Njegova metoda GetEnumerator() vrne IEnumerator, foreach pa bere elemente prek te pogodbe.

Različica: .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 je negenerična pogodba za iteriranje po elementih. Deklarira eno metodo: GetEnumerator(), ki vrne System.Collections.IEnumerator. Ne zagotavlja števila elementov ali indekserja.

Razlikujte med zaporedjem in njegovim enumeratorjem: IEnumerable zagotavlja enumerator, medtem ko IEnumerator ohranja položaj iteracije. MoveNext() se premakne na naslednji element in sporoči, ali mu je uspelo; šele nato lahko preberete Current tipa object. Branje Current pred prvim uspešnim premikom ali po koncu iteracije ni veljavno. Podpora za Reset() ni obvezna.

System.Collections.Generic.IEnumerable<T> določa tip elementov in deduje iz negeneričnega IEnumerable. Če je tip znan, običajno izberite generično različico; negenerična je uporabna pri sodelovanju z API-ji, ki zahtevajo to pogodbo. Izrecni tip spremenljivke v foreach, na primer string, zahteva veljavno pretvorbo vsakega elementa; nezdružljiv element lahko povzroči InvalidCastException.

V primeru je do polja dostopano prek IEnumerable, zato je value tipa object, čeprav so elementi nizi. foreach poskrbi za premikanje enumeratorja. Vendar sama uporaba foreach ne dokazuje, da je ta vmesnik implementiran: C# podpira tudi ustrezen vzorec GetEnumerator() z MoveNext() in Current.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri