Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Negenerické rozhranie IEnumerable

System.Collections.IEnumerable umožňuje prechádzať prvky bez určenia ich typu pomocou generického parametra. Jeho metóda GetEnumerator() vracia IEnumerator a foreach číta prvky prostredníctvom tejto zmluvy.

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

Syntax

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

System.Collections.IEnumerable je negenerická zmluva na prechádzanie prvkov. Deklaruje jednu metódu: GetEnumerator(), ktorá vracia System.Collections.IEnumerator. Neposkytuje počet prvkov ani indexer.

Rozlišujte sekvenciu a jej enumerátor: IEnumerable poskytuje enumerátor, zatiaľ čo IEnumerator uchováva pozíciu iterácie. MoveNext() prejde na ďalší prvok a oznámi, či sa to podarilo; až potom možno čítať Current typu object. Čítanie Current pred prvým úspešným posunom alebo po skončení iterácie nie je platné. Reset() nemusí byť podporované.

System.Collections.Generic.IEnumerable<T> určuje typ prvkov a dedí z negenerického IEnumerable. Ak je typ známy, zvyčajne uprednostnite generickú verziu; negenerická verzia je užitočná pri spolupráci s rozhraniami API, ktoré túto zmluvu vyžadujú. Výslovný typ premennej vo foreach, napríklad string, vyžaduje platnú konverziu každého prvku; nekompatibilný prvok môže spôsobiť InvalidCastException.

V príklade sa k poľu pristupuje cez IEnumerable, takže value má typ object, hoci prvky sú reťazce. foreach zabezpečuje posúvanie enumerátora. Samotné použitie foreach však nedokazuje, že je toto rozhranie implementované: C# podporuje aj vhodný vzor GetEnumerator() s MoveNext() a Current.

Príklady

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);
        }
    }
}

Výsledok

Ada
Lin

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje