foreach, in (Référence C#)
Mise à jour : novembre 2007
L'instruction foreach répète un groupe d'instructions incorporées pour chaque élément d'un tableau ou d'une collection d'objets qui implémente l'interface System.Collections.IEnumerable ou System.Collections.Generic.IEnumerable<T>. L'instruction foreach sert à parcourir la collection pour obtenir les informations souhaitées, mais elle ne peut pas être utilisée pour ajouter ou supprimer des éléments dans la collection source, ceci afin d'éviter des effets secondaires imprévisibles. Si vous devez ajouter ou supprimer des éléments dans la collection source, utilisez une boucle for.
Les instructions incorporées continuent à être exécutées pour chaque élément dans le tableau ou la collection. Une fois l'itération terminée pour tous les éléments de la collection, le contrôle est transféré à l'instruction suivante après le bloc foreach.
À n'importe quel point du bloc foreach, vous pouvez interrompre la boucle à l'aide du mot clé break ou passer directement à l'itération suivante de la boucle en utilisant le mot clé continue.
Une boucle foreach peut également être quittée à l'aide des instructions goto, return ou throw.
Pour plus d'informations sur le mot clé foreach et les exemples de code, consultez les rubriques suivantes :
Utilisation de foreach avec des tableaux (Guide de programmation C#)
Comment : accéder à une classe de collection à l'aide de foreach (Guide de programmation C#)
Exemple
Dans cet exemple, foreach sert à afficher le contenu d'un tableau d'entiers.
class ForEachTest
{
static void Main(string[] args)
{
int[] fibarray = new int[] { 0, 1, 2, 3, 5, 8, 13 };
foreach (int i in fibarray)
{
System.Console.WriteLine(i);
}
}
}
/*
Output:
0
1
2
3
5
8
13
*/
Spécifications du langage C#
Pour plus d'informations, consultez les sections suivantes dans Spécifications du langage C#.
5.3.3.16 Instructions foreach
8.8.4 L'instruction foreach
Voir aussi
Concepts
Référence
Instructions d'itération (Référence C#)