CKTIS / C#
IEnumerator — l’interface d’énumérateur non générique
System.Collections.IEnumerator décrit un curseur permettant de lire des éléments séquentiellement. Il expose MoveNext(), une propriété Current de type object et Reset() ; ce n’est pas une collection et la prise en charge d’IDisposable n’est pas garantie.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public interface IEnumerator
{
object Current { get; }
bool MoveNext();
void Reset();
}System.Collections.IEnumerator décrit l’état d’un parcours d’une collection. En revanche, System.Collections.IEnumerable expose GetEnumerator(), qui renvoie un tel curseur. Dans le code courant, privilégiez foreach, qui masque la gestion manuelle de l’énumérateur. L’interface est disponible dans .NET 10 et ne nécessite aucune fonctionnalité de langage en préversion.
Au départ, le curseur se trouve avant le premier élément. Appelez MoveNext() et lisez Current uniquement si le résultat est true. Un résultat false indique la fin ; les appels suivants renvoient également false, sauf si l’énumérateur est réinitialisé. Current n’est pas défini avant la première avancée réussie ni après la fin : ne supposez ni valeur ni exception particulière.
Current est une propriété en lecture seule de type object : retrouver un type précis peut nécessiter une conversion, et les valeurs de types valeur sont boxées. Le type générique System.Collections.Generic.IEnumerator<T> expose un Current de type T et hérite à la fois de IEnumerator et d’IDisposable. IEnumerator non générique n’hérite pas lui-même d’IDisposable ; lors d’une itération manuelle, libérez l’énumérateur si son objet implémente cette interface.
Reset() est destiné à rétablir la position avant le premier élément, mais peut lever NotSupportedException ; il sert principalement à l’interopérabilité COM. Pour répéter un parcours, récupérez normalement un nouvel énumérateur. Ne supposez pas que les modifications de la collection pendant l’itération sont prises en charge : elles peuvent invalider l’énumérateur. L’interface ne fournit ni sécurité des threads ni opérations de modification de la collection.
Exemples
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();
}
}
}Résultat
Ada Lin
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.