foreach, in (Riferimenti per C#)

L'istruzione foreach ripete un gruppo di istruzioni incorporate per ciascun elemento di una matrice o di un insieme di oggetti che implementa l'interaccia System.Collections.IEnumerable o System.Collections.Generic.IEnumerable<T>. L'istruzione foreach viene utilizzata per scorrere l'insieme e ottenere le informazioni desiderate; non deve tuttavia essere utilizzata per aggiungere o rimuovere elementi nell'insieme di origine allo scopo di evitare effetti indesiderati. Se è necessario aggiungere o rimuovere elementi nell'insieme di origine, utilizzare un ciclo for.

L'esecuzione delle istruzioni incorporate viene ripetuta per ciascun elemento della matrice o dell'insieme. Quando l'iterazione è stata completata per tutti gli elementi dell'insieme, il controllo viene trasferito alla prima istruzione che segue il blocco foreach.

In corrispondenza di qualsiasi punto all'interno del blocco foreach è possibile uscire dal ciclo utilizzando la parola chiave break o passare direttamente all'iterazione successiva nel ciclo utilizzando la parola chiave continue.

È inoltre possibile uscire da un ciclo foreach mediante le istruzioni goto, return e throw.

Per ulteriori informazioni sulla parola chiave foreach e per esempi di codice, vedere gli argomenti riportati di seguito:

Utilizzo di foreach con matrici (Guida per programmatori C#)

Procedura: accedere a una classe di insiemi con foreach (Guida per programmatori C#)

Esempio

Nell'esempio riportato di seguito foreach viene utilizzata per visualizzare il contenuto di una matrice di interi.

    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
    */

Specifiche del linguaggio C#

Per ulteriori informazioni, vedere la Specifiche del linguaggio C#. La specifica del linguaggio è la fonte ufficiale per la sintassi e l'utilizzo di C#.

Vedere anche

Riferimenti

Parole chiave di C#

Istruzioni di iterazione (Riferimenti per C#)

Concetti

Guida per programmatori C#

Altre risorse

Riferimenti per C#