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

CKTIS / C#

La interfaz IEnumerable no genérica

System.Collections.IEnumerable permite recorrer elementos sin especificar su tipo mediante un parámetro genérico. Su método GetEnumerator() devuelve IEnumerator, y foreach lee los elementos a través de este contrato.

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

Sintaxis

public interface IEnumerable
{
    System.Collections.IEnumerator GetEnumerator();
}

System.Collections.IEnumerable es un contrato no genérico para recorrer elementos. Declara un método: GetEnumerator(), que devuelve System.Collections.IEnumerator. No proporciona ni el número de elementos ni un indizador.

Hay que distinguir la secuencia de su enumerador: IEnumerable proporciona un enumerador, mientras que IEnumerator mantiene la posición de la iteración. MoveNext() avanza al elemento siguiente e indica si lo ha conseguido; solo entonces se puede leer Current, cuyo tipo es object. No es válido leer Current antes del primer avance correcto ni después de que termine la iteración. No es obligatorio admitir Reset().

System.Collections.Generic.IEnumerable<T> especifica el tipo de elemento y hereda de IEnumerable no genérica. Cuando se conoce el tipo, normalmente es preferible la versión genérica; la no genérica resulta útil al interoperar con API que requieren ese contrato. Un tipo explícito para la variable de foreach, como string, requiere una conversión válida para cada elemento; un elemento incompatible puede causar InvalidCastException.

En el ejemplo, se accede a la matriz mediante IEnumerable, por lo que value es de tipo object, aunque los elementos sean cadenas. foreach se encarga de avanzar el enumerador. Sin embargo, usar foreach por sí solo no demuestra que se implemente esta interfaz: C# también admite un patrón adecuado de GetEnumerator() con MoveNext() y Current.

Ejemplos

using System;
using System.Collections;

internal static class Program
{
    private static void Main()
    {
        IEnumerable values = new string[] { "Ada", "Lin" };

        foreach (object value in values)
        {
            Console.WriteLine(value);
        }
    }
}

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