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.