For Each

UiPath.Core.Activities.ForEach

Description

Executa uma atividade ou série de atividades especificadas na seção Corpo, em cada elemento de uma coleção. Os elementos podem ser referenciados nas atividades na seção Corpo usando a variável iteradora item.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Lista de Itens — a variável cujos valores você deseja iterar. Este campo é compatível apenas com variáveis IEnumerable.

• Item — o nome que deve ser usado para fazer referência ao item atual na iteração. Usar um nome que descreve o item facilita a identificação.

  Observação: o valor do campo Lista de itens deve ser uma coleção de objetos homogêneos.

Corpo

• As atividades colocadas dentro são executadas se a condição for verdadeira.

Opções avançadas

• Índice — um índice com base zero que especifica qual elemento da coleção atual está sendo iterado, armazenado em uma variável Int32.

Windows - Legada, Configuração do Windows

Painel do Designer

• ParaCada — o nome que deve ser usado para fazer referência ao item atual na iteração. Usar um nome que descreve o item facilita a identificação.
• Em — especifica a lista a ser iterada.

Corpo

• As atividades colocadas dentro são executadas se a condição for verdadeira.

Painel de Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.

Entrada

• Condição — se a condição for verdadeira, o Corpo da atividade será executado.
• IteraçõesMáx — número de vezes máximo que a atividade é executada.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
• ArgumentoDeTipo — uma lista suspensa que permite escolher qual o tipo de variável que você deseja usar com a atividade.
• Lista de Itens — a variável cujos valores você deseja iterar. Este campo é compatível apenas com variáveis IEnumerable.
  Observação:

  • Ao alterar o tipo de argumento, o conteúdo desta atividade é excluído.
  • O valor do campo Lista de itens deve ser uma coleção de objetos homogêneos.

Saída

• Índice — um índice com base zero que especifica qual elemento da coleção atual está sendo iterado, armazenado em uma variável Int32.

Exemplo de uso de uma atividade For Each

Para este exemplo, usamos uma variável IEnumerable simples composta por três elementos, que exibe cada um deles em uma Caixa de Mensagem:

1. Crie um novo Processo e arraste a atividade For Each para dentro do designer de fluxo de trabalho.
2. A partir do painel Variáveis, crie uma variável IEnumerable chamada List com o seguinte valor:

   {"one", "two", "three"}

3. Insira a variável List na propriedade Valores da atividade For Each.
4. Arraste uma atividade Message Box para dentro da seção Corpo da atividade For Each.
5. Insira a variável iteradora item no campo da propriedade Texto da atividade Message Box.
6. Execute o arquivo. A atividade For Each itera através de cada um dos valores especificados na variável List e exibe ela em uma caixa de mensagem separada.