CKTIS / C#
IEnumerator – negeneričko sučelje enumeratora
System.Collections.IEnumerator opisuje pokazivač za sekvencijalno čitanje elemenata. Izlaže MoveNext(), Current tipa object i Reset(); nije kolekcija i ne jamči podršku za IDisposable.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator opisuje stanje jednog prolaska kroz kolekciju. Nasuprot tome, System.Collections.IEnumerable izlaže GetEnumerator(), koji vraća takav pokazivač. U uobičajenom kodu prednost dajte izrazu foreach, koji skriva ručno upravljanje enumeratorom. Sučelje je dostupno u .NET 10 i ne zahtijeva jezične značajke u pretpreglednoj verziji.
Na početku se pokazivač nalazi prije prvog elementa. Pozovite MoveNext() i čitajte Current samo ako je rezultat true. Rezultat false znači kraj; i sljedeći pozivi vraćaju false, osim ako se enumerator ne resetira. Current nije definiran prije prvog uspješnog pomaka ni nakon završetka — nemojte pretpostavljati određenu vrijednost ili iznimku.
Current je svojstvo samo za čitanje tipa object: za dobivanje određenog tipa možda će biti potrebno pretvaranje, a vrijednosti vrijednosnih tipova se pakiraju. Generički tip System.Collections.Generic.IEnumerator<T> izlaže Current tipa T i nasljeđuje i IEnumerator i IDisposable. Negenerički IEnumerator sam ne nasljeđuje IDisposable; pri ručnoj iteraciji oslobodite enumerator ako njegov objekt implementira to sučelje.
Reset() treba vratiti položaj prije prvog elementa, ali može izazvati NotSupportedException; služi uglavnom za interoperabilnost s COM-om. Za ponavljanje prolaska obično dohvatite novi enumerator. Nemojte pretpostaviti da su promjene kolekcije tijekom iteracije podržane: mogu poništiti valjanost enumeratora. Sučelje ne pruža sigurnost za dretve ni operacije za izmjenu kolekcije.
Primjeri
using System;
using System.Collections;
internal static class Program
{
private static void Main()
{
IEnumerable values = new string[] { "Ada", "Lin" };
IEnumerator cursor = values.GetEnumerator();
try
{
while (cursor.MoveNext())
{
string value = (string)cursor.Current;
Console.WriteLine(value);
}
}
finally
{
(cursor as IDisposable)?.Dispose();
}
}
}Rezultat
Ada Lin
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.