Esta documentación está archivada y no tiene mantenimiento.

foreach, in (Referencia de C#)

La instrucción foreach repite un grupo de instrucciones incluidas en el bucle para cada elemento de una matriz o de un objeto collection. La instrucción foreach se utiliza para recorrer en iteración una colección de elementos y obtener la información deseada, pero no se debe utilizar para cambiar el contenido de la colección, ya que se pueden producir efectos secundarios imprevisibles.

Las instrucciones del bucle siguen ejecutándose para cada elemento de la matriz o la colección. Cuando ya se han recorrido todos los elementos de la colección, el control se transfiere a la siguiente instrucción fuera del bloque foreach.

En cualquier punto dentro del bloque foreach, puede salir del bucle utilizando la palabra clave break o pasando directamente la iteración siguiente del bucle mediante la palabra clave continue.

También se puede salir de un bucle foreach mediante las instrucciones goto, return o throw.

Para obtener más información acerca de la palabra clave foreach, incluidos ejemplos de código, vea los temas siguientes:

Utilizar foreach son matrices (Guía de programación de C#)

Cómo: Obtener acceso a una clase de colección mediante Foreach (Guía de programación de C#)

En este ejemplo, foreach se utiliza para mostrar el contenido de una matriz de enteros.

// 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);
        }
    }
}

Resultados

0
1
2
3
5
8
13

Para obtener más información, vea las secciones siguientes de Especificación del lenguaje C#.

  • 5.3.3.16 Instrucciones Foreach

  • 8.8.4 La instrucción foreach

Mostrar: