para cada um, em

Use a declaração de for each para iterar através de uma matriz ou coleção.

Qualquer tempo de execução

Sintaxe

for each (type identifier in expression) {
   statements
}

Parâmetros

• type
  O tipo de identifier.

• identifier
  A variável de iteração que representa o elemento da coleção.Quando identifier é uma referência de rastreamento, você pode modificar o elemento.

• expression
  Uma expressão ou uma coleção de matriz.O compilador deve ser capaz converter o elemento da coleção para o tipo de identifier .

• statements
  Uma ou mais instruções para ser executado.

Comentários

A declaração de for each é usada para fazer iterações por uma coleção.É possível alterar os elementos em uma coleção, mas você não pode adicionar ou excluir elementos.

instruções é executado para cada elemento na matriz ou na coleção.Após a iteração foi concluída para todos os elementos na coleção, o controle será transferido da instrução a seguir após o bloco de for each .

for each e in são palavras-chave contextuais; consulte Palavras-chave Contextuais (Extensões de Componentes C++) para mais informações.

No ambiente de desenvolvimento, você pode obter F1 ajuda sobre para realçar a palavra-chave,for each() e pressionar F1.

Para obter mais informações, consulte,

• Iterando coleção STL usando-se para cada

• Como: iterar Arrays com para cada

• Como: iterar sobre uma coleção genérica com para cada

• Como: iterar sobre uma coleção definida pelo usuário com para cada

Tempo de Execução do Windows

(Não há nenhum comentário Tempo de execução específico do Windows para este recurso de linguagem.)

Requisitos

Opção de compilador: /ZW

Exemplos

Exemplo

Este exemplo mostra como fazer iterações por uma cadeia de caracteres com for each.

// for_each_string1.cpp
// compile with: /ZW
#include <stdio.h>
using namespace Platform;

ref struct MyClass {
   property String^ MyStringProperty;
};

int main() {
   String^ MyString = ref new String("abcd");

   for each ( char c in MyString )
      wprintf("%c", c);

   wprintf("/n");

   MyClass^ x = ref new MyClass();
   x->MyStringProperty = "Testing";

   for each( char c in x->MyStringProperty )
      wprintf("%c", c);
}

Saída

Common Language Runtime

As seguintes diferenças de listas da tabela de sintaxe mostrada em Qualquer tempo de execução seccionam que são específicas para C++/CLI.

Parâmetros

• expression
  Uma expressão ou uma coleção gerenciado de matriz.O compilador deve ser capaz converter o elemento da coleção de Object para o tipo de identificador .

  expressão avaliada como um tipo que implementa IEnumerable, IEnumerable<T>, ou um tipo que define um método GetEnumerator.Nesse caso, último GetEnumerator se um ou outro retornar um tipo que implementa IEnumerator ou declara quaisquer métodos definidos em IEnumerator.

Requisitos

Opção de compilador: /clr

Exemplos

Exemplo

Este exemplo mostra como fazer iterações por uma cadeia de caracteres com for each.

// for_each_string2.cpp
// compile with: /clr
using namespace System;

ref struct MyClass {
   property String ^ MyStringProperty;
};

int main() {
   String ^ MyString = gcnew String("abcd");

   for each ( Char c in MyString )
      Console::Write(c);

   Console::WriteLine();

   MyClass ^ x = gcnew MyClass();
   x->MyStringProperty = "Testing";

   for each( Char c in x->MyStringProperty )
      Console::Write(c);
}

Saída

Consulte também

Conceitos

Extensões de componente para plataformas de tempo de execução