KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

IEnumerator — de niet-generieke enumeratorinterface

System.Collections.IEnumerator beschrijft een cursor voor het achtereenvolgens lezen van elementen. De interface biedt MoveNext(), een Current van het type object en Reset(); het is geen collectie en garandeert geen ondersteuning voor IDisposable.

Versie: .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 beschrijft de status van één doorgang door een collectie. System.Collections.IEnumerable biedt daarentegen GetEnumerator(), dat zo’n cursor retourneert. Gebruik in gewone code bij voorkeur foreach, dat het handmatige beheer van de enumerator verbergt. De interface is beschikbaar in .NET 10 en vereist geen preview-taalfuncties.

Aanvankelijk staat de cursor vóór het eerste element. Roep MoveNext() aan en lees Current alleen als het resultaat true is. Een resultaat van false betekent dat het einde is bereikt; volgende aanroepen retourneren eveneens false, tenzij de enumerator opnieuw wordt ingesteld. Current is niet gedefinieerd vóór de eerste geslaagde verplaatsing en na afloop — ga niet uit van een bepaalde waarde of uitzondering.

Current is een alleen-lezen eigenschap van het type object: om een specifiek type terug te krijgen kan een cast nodig zijn, en waarden van waardetypen worden geboxed. Het generieke type System.Collections.Generic.IEnumerator<T> biedt een Current van het type T en erft van zowel IEnumerator als IDisposable. De niet-generieke IEnumerator erft zelf niet van IDisposable; disposeer bij handmatige iteratie de enumerator als het object die interface implementeert.

Reset() is bedoeld om de positie vóór het eerste element te herstellen, maar kan NotSupportedException veroorzaken; de methode is vooral bedoeld voor COM-interoperabiliteit. Haal normaal gesproken een nieuwe enumerator op om de doorgang te herhalen. Ga er niet van uit dat wijzigingen aan de collectie tijdens het itereren worden ondersteund: ze kunnen de enumerator ongeldig maken. De interface biedt geen threadveiligheid en geen bewerkingen om de collectie te wijzigen.

Voorbeelden

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();
        }
    }
}

Resultaat

Ada
Lin

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen