CKTIS / C#
IEnumerator – negenerické rozhranie enumerátora
System.Collections.IEnumerator opisuje kurzor na postupné čítanie prvkov. Poskytuje MoveNext(), Current typu object a Reset(); nie je to kolekcia a nezaručuje podporu IDisposable.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator opisuje stav jedného prechodu kolekciou. Naproti tomu System.Collections.IEnumerable poskytuje GetEnumerator(), ktorý vracia takýto kurzor. V bežnom kóde uprednostnite foreach, ktorý skrýva ručnú správu enumerátora. Rozhranie je dostupné v .NET 10 a nevyžaduje jazykové funkcie vo verzii preview.
Na začiatku sa kurzor nachádza pred prvým prvkom. Zavolajte MoveNext() a čítajte Current iba vtedy, keď je výsledok true. Výsledok false znamená koniec; ďalšie volania tiež vracajú false, pokiaľ sa enumerátor neresetuje. Current nie je definované pred prvým úspešným posunom ani po dokončení – nepredpokladajte konkrétnu hodnotu ani výnimku.
Current je vlastnosť iba na čítanie typu object: získanie konkrétneho typu môže vyžadovať pretypovanie a hodnoty hodnotových typov sa boxujú. Generický typ System.Collections.Generic.IEnumerator<T> poskytuje Current typu T a dedí z IEnumerator aj IDisposable. Negenerické IEnumerator samo nededí z IDisposable; pri ručnej iterácii uvoľnite enumerátor, ak jeho objekt implementuje toto rozhranie.
Reset() má obnoviť pozíciu pred prvým prvkom, ale môže vyvolať NotSupportedException; slúži hlavne na interoperabilitu s COM. Ak chcete prechod zopakovať, zvyčajne získajte nový enumerátor. Nepredpokladajte, že sa podporujú zmeny kolekcie počas iterácie: môžu enumerátor zneplatniť. Rozhranie neposkytuje bezpečnosť vlákien ani operácie na úpravu kolekcie.
Príklady
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();
}
}
}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.