CKTIS / C#
IEnumerator – negenerični vmesnik enumeratorja
System.Collections.IEnumerator opisuje kazalec za zaporedno branje elementov. Ponuja MoveNext(), Current tipa object in Reset(); ni zbirka in ne zagotavlja podpore za IDisposable.
Različica: .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 enega prehoda skozi zbirko. Nasprotno System.Collections.IEnumerable ponuja GetEnumerator(), ki vrne tak kazalec. V običajni kodi dajte prednost foreach, ki skrije ročno upravljanje enumeratorja. Vmesnik je na voljo v .NET 10 in ne zahteva jezikovnih funkcij v predogledni različici.
Sprva je kazalec pred prvim elementom. Pokličite MoveNext() in preberite Current le, če je rezultat true. Rezultat false pomeni konec; tudi nadaljnji klici vrnejo false, razen če enumerator ponastavite. Current pred prvim uspešnim premikom in po koncu ni definiran – ne predpostavljajte določene vrednosti ali izjeme.
Current je lastnost samo za branje tipa object: za pridobitev določenega tipa je morda potrebna pretvorba, vrednosti vrednostnih tipov pa se zapakirajo. Generični tip System.Collections.Generic.IEnumerator<T> ponuja Current tipa T in deduje tako od IEnumerator kot od IDisposable. Negenerični IEnumerator sam ne deduje od IDisposable; pri ročnem iteriranju sprostite enumerator, če njegov objekt implementira ta vmesnik.
Reset() naj bi obnovil položaj pred prvim elementom, vendar lahko sproži NotSupportedException; namenjen je predvsem interoperabilnosti s COM. Če želite prehod ponoviti, običajno pridobite nov enumerator. Ne predpostavljajte, da so spremembe zbirke med iteriranjem podprte: enumerator lahko zaradi njih postane neveljaven. Vmesnik ne zagotavlja varnosti niti in ne ponuja operacij za spreminjanje zbirke.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.