Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

IEnumerator – negenerični vmesnik enumeratorja

System.Collections.IEnumerator opisuje kazalec za zaporedno branje elementov. Ponuja MoveNext(), Current tipa object in Reset(); ni zbirka in ne zagotavlja podpore za IDisposable.

Različica: .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 enega prehoda skozi zbirko. Nasprotno System.Collections.IEnumerable ponuja GetEnumerator(), ki vrne tak kazalec. V običajni kodi dajte prednost foreach, ki skrije ročno upravljanje enumeratorja. Vmesnik je na voljo v .NET 10 in ne zahteva jezikovnih funkcij v predogledni različici.

Sprva je kazalec pred prvim elementom. Pokličite MoveNext() in preberite Current le, če je rezultat true. Rezultat false pomeni konec; tudi nadaljnji klici vrnejo false, razen če enumerator ponastavite. Current pred prvim uspešnim premikom in po koncu ni definiran – ne predpostavljajte določene vrednosti ali izjeme.

Current je lastnost samo za branje tipa object: za pridobitev določenega tipa je morda potrebna pretvorba, vrednosti vrednostnih tipov pa se zapakirajo. Generični tip System.Collections.Generic.IEnumerator<T> ponuja Current tipa T in deduje tako od IEnumerator kot od IDisposable. Negenerični IEnumerator sam ne deduje od IDisposable; pri ročnem iteriranju sprostite enumerator, če njegov objekt implementira ta vmesnik.

Reset() naj bi obnovil položaj pred prvim elementom, vendar lahko sproži NotSupportedException; namenjen je predvsem interoperabilnosti s COM. Če želite prehod ponoviti, običajno pridobite nov enumerator. Ne predpostavljajte, da so spremembe zbirke med iteriranjem podprte: enumerator lahko zaradi njih postane neveljaven. Vmesnik ne zagotavlja varnosti niti in ne ponuja operacij za spreminjanje zbirke.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri