CKTIS / C#
IEnumerable e IEnumerator no genéricos en System.Collections
IEnumerable proporciona un enumerador e IEnumerator mantiene la posición en la secuencia. Una implementación explícita cumple el contrato no genérico sin duplicar la lógica de recorrido.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
using System.Collections;
using System.Collections.Generic;
sealed class Sequence<T> : IEnumerable<T>
{
public IEnumerator<T> GetEnumerator()
{
yield break;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}System.Collections.IEnumerable representa un origen de elementos. Su método GetEnumerator() devuelve un System.Collections.IEnumerator que mantiene la posición en la secuencia. El enumerador empieza antes del primer elemento. Lee Current solo después de que MoveNext() devuelva true y detén el recorrido cuando devuelva false. Reset() sirve para volver a la posición inicial, pero puede lanzar NotSupportedException, como sucede con los iteradores que usan yield. Para empezar de nuevo, obtén otro enumerador.
IEnumerable<T>, de System.Collections.Generic, hereda de IEnumerable no genérico, así que la clase debe cumplir ambos contratos. Expón un método público que devuelva IEnumerator<T> y añade IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Esta implementación explícita es accesible a través de la interfaz no genérica. No es una sobrecarga normal: C# no permite sobrecargar métodos que solo difieran en el tipo devuelto. Ambas llamadas usan la misma lógica de recorrido.
IEnumerator<T> hereda de IEnumerator e IDisposable. Su Current genérico es de tipo T; el Current no genérico devuelve object. En el ejemplo, leer el Current no genérico convierte un int en un objeto mediante boxing, y foreach (int ...) recupera el valor mediante unboxing. Un iterador con yield proporciona ambas versiones de Current. Si escribes tu propio enumerador, puedes implementar el Current no genérico de forma explícita.
foreach llama a MoveNext() y lee Current sin usar Reset(). También llama a Dispose() si el enumerador implementa IDisposable, aunque salgas antes de tiempo del bucle. Si recorres la secuencia manualmente con IEnumerator, comprueba en un bloque finally si el enumerador implementa IDisposable y llama a Dispose() si es así: la interfaz no genérica no exige ese método.
Ejemplos
using System;
using System.Collections;
using System.Collections.Generic;
IEnumerable<int> typed = new EvenPair();
IEnumerable untyped = typed;
foreach (int value in typed)
Console.WriteLine(FormattableString.Invariant($"Generic: {value}"));
foreach (int value in untyped)
Console.WriteLine(FormattableString.Invariant($"Non-generic: {value}"));
sealed class EvenPair : IEnumerable<int>
{
public IEnumerator<int> GetEnumerator()
{
yield return 2;
yield return 4;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}Resultado
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Ambas variables hacen referencia al mismo objeto. El segundo bucle llama a la implementación explícita a través de `IEnumerable` y vuelve a leer `2` y `4`.
Lecciones relacionadas
- C# · Lección 38 · Intermedio · Versión: 2
Fuentes
- IEnumerable Interface (System.Collections)
- IEnumerator Interface (System.Collections)
- IEnumerable<T> Interface (System.Collections.Generic)
- IEnumerator<T> Interface (System.Collections.Generic)
- Explicit Interface Implementation (C# Programming Guide)
- Iterate through collections
- Statements — C# language specification
- Basic concepts — C# language specification
- Boxing and Unboxing (C# Programming Guide)