Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

IEnumerator – negeneričko sučelje enumeratora

System.Collections.IEnumerator opisuje pokazivač za sekvencijalno čitanje elemenata. Izlaže MoveNext(), Current tipa object i Reset(); nije kolekcija i ne jamči podršku za IDisposable.

Verzija: .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 jednog prolaska kroz kolekciju. Nasuprot tome, System.Collections.IEnumerable izlaže GetEnumerator(), koji vraća takav pokazivač. U uobičajenom kodu prednost dajte izrazu foreach, koji skriva ručno upravljanje enumeratorom. Sučelje je dostupno u .NET 10 i ne zahtijeva jezične značajke u pretpreglednoj verziji.

Na početku se pokazivač nalazi prije prvog elementa. Pozovite MoveNext() i čitajte Current samo ako je rezultat true. Rezultat false znači kraj; i sljedeći pozivi vraćaju false, osim ako se enumerator ne resetira. Current nije definiran prije prvog uspješnog pomaka ni nakon završetka — nemojte pretpostavljati određenu vrijednost ili iznimku.

Current je svojstvo samo za čitanje tipa object: za dobivanje određenog tipa možda će biti potrebno pretvaranje, a vrijednosti vrijednosnih tipova se pakiraju. Generički tip System.Collections.Generic.IEnumerator<T> izlaže Current tipa T i nasljeđuje i IEnumerator i IDisposable. Negenerički IEnumerator sam ne nasljeđuje IDisposable; pri ručnoj iteraciji oslobodite enumerator ako njegov objekt implementira to sučelje.

Reset() treba vratiti položaj prije prvog elementa, ali može izazvati NotSupportedException; služi uglavnom za interoperabilnost s COM-om. Za ponavljanje prolaska obično dohvatite novi enumerator. Nemojte pretpostaviti da su promjene kolekcije tijekom iteracije podržane: mogu poništiti valjanost enumeratora. Sučelje ne pruža sigurnost za dretve ni operacije za izmjenu kolekcije.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori