Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Negenerické rozhraní IEnumerable

System.Collections.IEnumerable umožňuje procházet prvky, aniž by se jejich typ určoval generickým parametrem. Jeho metoda GetEnumerator() vrací IEnumerator a foreach čte prvky prostřednictvím této smlouvy.

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

Syntaxe

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

System.Collections.IEnumerable je negenerická smlouva pro procházení prvků. Deklaruje jednu metodu: GetEnumerator(), která vrací System.Collections.IEnumerator. Neposkytuje počet prvků ani indexer.

Rozlišujte posloupnost a její enumerátor: IEnumerable poskytuje enumerátor, zatímco IEnumerator uchovává pozici iterace. MoveNext() přejde na další prvek a oznámí, zda se to podařilo; teprve potom lze číst Current typu object. Číst Current před prvním úspěšným posunem nebo po skončení iterace není platné. Reset() nemusí být podporováno.

System.Collections.Generic.IEnumerable<T> určuje typ prvků a dědí z negenerického IEnumerable. Pokud je typ známý, obvykle upřednostněte generickou variantu; negenerická varianta se hodí při spolupráci s rozhraními API, která tuto smlouvu vyžadují. Výslovný typ proměnné ve foreach, například string, vyžaduje platnou konverzi každého prvku; nekompatibilní prvek může způsobit InvalidCastException.

V příkladu se k poli přistupuje přes IEnumerable, takže value má typ object, přestože prvky jsou řetězce. foreach zajišťuje posouvání enumerátoru. Samotné použití foreach však nedokazuje, že je toto rozhraní implementováno: C# podporuje také odpovídající vzor GetEnumerator() s MoveNext() a Current.

Pří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ýsledek

Ada
Lin

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje