Partager via


foreach, in (référence C#)

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 à itérer au sein de 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écification du langage C#

Pour plus d'informations, consultez la Spécification du langage C#. La spécification du langage est la source de référence pour la syntaxe C# et son utilisation.

Voir aussi

Référence

Mots clés C#

Instructions d'itération (référence C#)

Concepts

Guide de programmation C#

Autres ressources

Référence C#