Array.ForEach<T> Method (T[], Action<T>)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Performs the specified action on each element of the specified array.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static void ForEach<T>(
	T[] array,
	Action<T> action


Type: T[]

The one-dimensional, zero-based Array on whose elements the action is to be performed.

Type: System.Action<T>

The Action<T> to perform on each element of array.

Type Parameters


The type of the elements of the array.

Exception Condition

array is null.


action is null.

The Action<T> is a delegate to a method that performs an action on the object passed to it. The elements of array are individually passed to the Action<T>.

This method is an O(n) operation, where n is the Length of array.

The following example shows how to use ForEach<T> to display the squares of each element in an integer array.

using System;

public class SamplesArray
    public static void Main()
        // create a three element array of integers
        int[] intArray = new int[] {2, 3, 4};

        // set a delegate for the ShowSquares method
        Action<int> action = new Action<int>(ShowSquares);

        Array.ForEach(intArray, action);

    private static void ShowSquares(int val)
        Console.WriteLine("{0:d} squared = {1:d}", val, val*val);

This code produces the following output:

2 squared = 4
3 squared = 9
4 squared = 16

.NET Framework
Available since 2.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top