Share via

foreach, in (C# Reference) 

  • Article

The foreach statement repeats a group of embedded statements for each element in an array or an object collection. The foreach statement is used to iterate through the collection to get the desired information, but should not be used to change the contents of the collection to avoid unpredictable side effects.

Remarks

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.

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)

Example

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

C# Language Specification

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

  • 5.3.3.16 Foreach statements

  • 8.8.4 The foreach statement

See Also

Reference

C# Keywords
Iteration Statements (C# Reference)

Concepts

C# Programming Guide

Other Resources

C# Reference