CKTIS / C#
IEnumerator – negenerické rozhraní enumerátoru
System.Collections.IEnumerator popisuje kurzor pro postupné čtení prvků. Poskytuje MoveNext(), Current typu object a Reset(); není to kolekce a nezaručuje podporu IDisposable.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator popisuje stav jednoho průchodu kolekcí. Naproti tomu System.Collections.IEnumerable poskytuje GetEnumerator(), který takový kurzor vrací. V běžném kódu upřednostněte foreach, který skrývá ruční správu enumerátoru. Rozhraní je dostupné v .NET 10 a nevyžaduje funkce jazyka ve verzi preview.
Na začátku se kurzor nachází před prvním prvkem. Zavolejte MoveNext() a čtěte Current pouze tehdy, když je výsledek true. Výsledek false znamená konec; další volání také vracejí false, pokud enumerátor není resetován. Current není definováno před prvním úspěšným posunem ani po dokončení – nepředpokládejte konkrétní hodnotu ani výjimku.
Current je vlastnost pouze pro čtení typu object: získání konkrétního typu může vyžadovat přetypování a hodnoty hodnotových typů se boxují. Generický typ System.Collections.Generic.IEnumerator<T> poskytuje Current typu T a dědí z IEnumerator i IDisposable. Negenerické IEnumerator samo z IDisposable nedědí; při ruční iteraci enumerátor uvolněte, pokud jeho objekt toto rozhraní implementuje.
Reset() má obnovit pozici před prvním prvkem, ale může vyvolat NotSupportedException; slouží hlavně k interoperabilitě s COM. Chcete-li průchod zopakovat, obvykle získejte nový enumerátor. Nepředpokládejte, že jsou změny kolekce během iterace podporovány: mohou enumerátor zneplatnit. Rozhraní neposkytuje bezpečnost vláken ani operace pro úpravu kolekce.
Pří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ý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.