Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

IEnumerator: la interfaz de enumerador no genérica

System.Collections.IEnumerator describe un cursor para leer elementos secuencialmente. Expone MoveNext(), un Current de tipo object y Reset(); no es una colección ni garantiza compatibilidad con IDisposable.

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

Sintaxis

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

System.Collections.IEnumerator describe el estado de un recorrido por una colección. En cambio, System.Collections.IEnumerable expone GetEnumerator(), que devuelve un cursor de este tipo. En el código habitual, prefiere foreach, que oculta la gestión manual del enumerador. La interfaz está disponible en .NET 10 y no requiere características del lenguaje en versión preliminar.

Al principio, el cursor está antes del primer elemento. Llama a MoveNext() y lee Current solo cuando el resultado sea true. Un resultado false indica el final; las llamadas posteriores también devuelven false, a menos que se restablezca el enumerador. Current no está definido antes del primer avance correcto ni después de terminar: no des por supuesto ningún valor ni excepción concretos.

Current es una propiedad de solo lectura de tipo object: recuperar un tipo concreto puede requerir una conversión, y los valores de tipos de valor se empaquetan. El tipo genérico System.Collections.Generic.IEnumerator<T> expone un Current de tipo T y hereda tanto de IEnumerator como de IDisposable. El IEnumerator no genérico no hereda de IDisposable; al iterar manualmente, libera el enumerador si su objeto implementa esa interfaz.

Reset() está pensado para restaurar la posición anterior al primer elemento, pero puede producir NotSupportedException; se usa principalmente para la interoperabilidad con COM. Para repetir un recorrido, normalmente obtén un enumerador nuevo. No des por sentado que se admiten cambios en la colección durante la iteración: pueden invalidar el enumerador. La interfaz no proporciona seguridad para subprocesos ni operaciones para modificar la colección.

Ejemplos

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

Resultado

Ada
Lin

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes