CKTIS / C#
IEnumerable et IEnumerator non génériques dans System.Collections
IEnumerable fournit un énumérateur, et IEnumerator suit la position dans une séquence. Une implémentation explicite respecte le contrat non générique sans dupliquer la logique de parcours.
Version : C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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 représente une source d’éléments. Sa méthode GetEnumerator() renvoie un System.Collections.IEnumerator qui suit la position dans la séquence. L’énumérateur commence avant le premier élément. Ne lisez Current qu’après un appel à MoveNext() qui renvoie true, et arrêtez le parcours dès que la méthode renvoie false. Reset() est censée rétablir la position initiale, mais peut lever NotSupportedException, notamment avec les itérateurs utilisant yield. Pour recommencer, obtenez un nouvel énumérateur.
IEnumerable<T>, dans System.Collections.Generic, hérite de l’interface non générique IEnumerable. La classe doit donc respecter les deux contrats. Exposez une méthode publique qui renvoie IEnumerator<T> et ajoutez IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Cette implémentation explicite est accessible via l’interface non générique. Ce n’est pas une surcharge ordinaire : en C#, le seul type de retour ne suffit pas à distinguer deux surcharges. Les deux appels utilisent la même logique de parcours.
IEnumerator<T> hérite de IEnumerator et de IDisposable. Son Current générique est de type T, tandis que le Current non générique renvoie object. Dans l’exemple, lire le Current non générique encapsule un int dans un objet (boxing), puis foreach (int ...) extrait la valeur (unboxing). Un itérateur utilisant yield fournit les deux versions de Current. Si vous écrivez votre propre énumérateur, vous pouvez implémenter explicitement le Current non générique.
foreach appelle MoveNext() et lit Current sans utiliser Reset(). Si l’énumérateur implémente IDisposable, foreach appelle aussi Dispose(), même en cas de sortie anticipée. Lors d’un parcours manuel avec IEnumerator, vérifiez dans un bloc finally si l’énumérateur implémente IDisposable et appelez Dispose() le cas échéant : l’interface non générique n’exige pas cette méthode.
Exemples
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();
}Résultat
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Les deux variables référencent le même objet. La seconde boucle appelle l’implémentation explicite via `IEnumerable` et lit de nouveau `2` et `4`.
Leçons associées
- C# · Leçon 38 · Intermédiaire · Version : 2
Sources
- 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)