CKTIS / C#
L’interface IEnumerable non générique
System.Collections.IEnumerable permet de parcourir des éléments sans préciser leur type au moyen d’un paramètre générique. Sa méthode GetEnumerator() renvoie IEnumerator, et foreach lit les éléments via ce contrat.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public interface IEnumerable
{
System.Collections.IEnumerator GetEnumerator();
}System.Collections.IEnumerable est un contrat non générique permettant de parcourir des éléments. Il déclare une méthode : GetEnumerator(), qui renvoie System.Collections.IEnumerator. Il n’expose ni le nombre d’éléments ni d’indexeur.
Il faut distinguer la séquence de son énumérateur : IEnumerable fournit un énumérateur, tandis que IEnumerator conserve la position de l’itération. MoveNext() passe à l’élément suivant et indique si l’opération a réussi ; ce n’est qu’alors que Current, de type object, peut être lu. Lire Current avant le premier déplacement réussi ou après la fin de l’itération n’est pas valide. Reset() n’a pas à être pris en charge.
System.Collections.Generic.IEnumerable<T> précise le type des éléments et hérite de IEnumerable non générique. Lorsque le type est connu, préférez généralement la version générique ; la version non générique est utile pour interagir avec des API qui exigent ce contrat. Un type de variable explicite dans foreach, tel que string, nécessite une conversion valide pour chaque élément ; un élément incompatible peut provoquer InvalidCastException.
Dans l’exemple, le tableau est accessible via IEnumerable, donc value est de type object, même si les éléments sont des chaînes. foreach gère l’avancement de l’énumérateur. Toutefois, l’utilisation de foreach ne prouve pas à elle seule que cette interface est implémentée : C# prend également en charge un modèle GetEnumerator() approprié avec MoveNext() et Current.
Exemples
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);
}
}
}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.