Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje