foreach, (C# Reference)

O foreach repete um grupo de instruções incorporadas para cada elemento em uma matriz ou uma coleção de objeto que implementa o System.Collections.IEnumerable ou System.Collections.Generic.IEnumerable<T> interface. O foreach declaração é usada para iterar na coleção para obter as informações que você deseja, mas não pode ser usado para adicionar ou remover itens da coleção de origem para evitar efeitos colaterais imprevisíveis. Se você precisar adicionar ou remover itens da coleção de origem, use um para loop.

As instruções incorporadas continuam a ser executado para cada elemento na matriz ou coleção. Depois de concluída a iteração de todos os elementos na coleção, o controle é transferido para a seguinte instrução próximo a foreach bloco.

Em qualquer momento dentro do foreach bloco, você pode interromper o loop usando o quebra palavra-chave ou etapa para a próxima iteração do loop usando o continuar palavra-chave.

A foreach loop também pode ser encerrado pela goto, retornar, ou lança instruções.

Para obter mais informações sobre o foreach palavra-chave e exemplos de códigos, consulte os seguintes tópicos:

O uso de foreach com matrizes (guia de programação C#)

How to: Acessar uma classe de coleção com foreach (guia de programação C#)

Exemplo

Neste exemplo, foreach é usado para exibir o conteúdo de uma matriz de inteiros.

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

Especificação da linguagem C#

Para obter mais informações, consulte C# Language Specification A especificação de linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Consulte também

Referência

C# Keywords

Iteration Statements (C# Reference)

Conceitos

C# Programming Guide

Outros recursos

C# Reference