Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje