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.