The embedded statements continue to execute for each element in the array or collection. After the iteration has been completed for all the elements in the collection, control is transferred to the next statement following the foreach block.

At any point within the foreach block, you can break out of the loop using the break keyword, or step directly to the next iteration in the loop by using the continue keyword.

A foreach loop can also be exited by the goto, return, or throwstatements.

For more information on the foreach keyword and code samples, see the following topics:

Using foreach with Arrays (C# Programming Guide)

How to: Access a Collection Class with foreach (C# Programming Guide)

In this example, foreach is used to display the contents of an array of integers.

// cs_foreach.cs
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

For more information, see the following sections in the C# Language Specification:

• 5.3.3.16 Foreach statements

• 8.8.4 The foreach statement

Reference

Concepts

Other Resources