Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

IEnumerator: l’interfaccia di enumeratore non generica

System.Collections.IEnumerator descrive un cursore per leggere gli elementi in sequenza. Espone MoveNext(), un Current di tipo object e Reset(); non è una raccolta e non garantisce il supporto di IDisposable.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

public interface IEnumerator
{
    object Current { get; }
    bool MoveNext();
    void Reset();
}

System.Collections.IEnumerator descrive lo stato di un singolo attraversamento di una raccolta. System.Collections.IEnumerable, invece, espone GetEnumerator(), che restituisce un cursore di questo tipo. Nel codice ordinario, preferisci foreach, che nasconde la gestione manuale dell’enumeratore. L’interfaccia è disponibile in .NET 10 e non richiede funzionalità del linguaggio in anteprima.

Inizialmente, il cursore si trova prima del primo elemento. Chiama MoveNext() e leggi Current solo se il risultato è true. Un risultato false indica la fine; anche le chiamate successive restituiscono false, a meno che l’enumeratore non venga reimpostato. Current non è definito prima del primo avanzamento riuscito né dopo il completamento: non presumere un valore o un’eccezione specifici.

Current è una proprietà di sola lettura di tipo object: per ottenere un tipo specifico può essere necessario un cast e i valori dei tipi valore vengono sottoposti a boxing. Il tipo generico System.Collections.Generic.IEnumerator<T> espone un Current di tipo T ed eredita sia da IEnumerator sia da IDisposable. IEnumerator non generico non eredita da IDisposable; durante l’iterazione manuale, rilascia l’enumeratore se il suo oggetto implementa questa interfaccia.

Reset() dovrebbe ripristinare la posizione precedente al primo elemento, ma può generare NotSupportedException; serve principalmente per l’interoperabilità COM. Per ripetere un attraversamento, normalmente ottieni un nuovo enumeratore. Non presumere che le modifiche alla raccolta durante l’iterazione siano supportate: possono invalidare l’enumeratore. L’interfaccia non offre né sicurezza dei thread né operazioni per modificare la raccolta.

Esempi

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

Risultato

Ada
Lin

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti