Cria e limpa coleções e adiciona registros a qualquer fonte de dados.

Descrição

Collect

A função Collect adiciona registros em uma fonte de dados. Os itens a serem adicionados podem ser:

  • Um valor único: o valor é colocado no campo Valor de um novo registro. Todas as outras propriedades são deixadas em branco.

  • Um registro: cada propriedade nomeada é colocada na propriedade correspondente de um novo registro. Todas as outras propriedades são deixadas em branco.

  • Uma tabela: cada registro da tabela é adicionado como um registro separado da fonte de dados, conforme descrito acima. A tabela não é adicionada como uma tabela aninhada em um registro. Para fazer isso, primeiro, encapsule a tabela em um registro.

Quando usado com uma coleção, as colunas adicionais são criadas conforme o necessário. As colunas para outras fontes de dados são fixas pela fonte de dados e não é possível adicionar colunas novas.

Se a fonte de dados ainda não existir, uma coleção será criada.

Às vezes, as coleções são usadas para armazenar variáveis globais ou fazer uma cópia temporária de uma fonte de dados. Os PowerApps são baseados em fórmulas que se recalculam automaticamente conforme a interação do usuário com o aplicativo. As coleções não têm esse benefício e usá-las pode dificultar a criação e compreensão do seu aplicativo. Antes de usar uma coleção dessa maneira, revise o artigo Como trabalhar com variáveis.

Você também pode usar a função Patch para criar registros em uma fonte de dados.

Collect retorna a fonte de dados modificados como uma tabela. Collect só pode ser usado em uma fórmula de comportamento.

Clear

A função Clear exclui todos os registros de uma coleção. As colunas da coleção serão mantidas.

Observe que Clear funciona apenas em coleções e não em outras fontes de dados. Você pode usar RemoveIf( DataSource, true ) para essa finalidade. Tenha cuidado, pois essa função removerá todos os registros do armazenamento da fonte de dados e pode afetar outros usuários.

Você pode usar a função Remover para selecionar quais registros você removerá.

Clear não tem valor de retorno. Ela só pode ser usada em uma fórmula de comportamento.

ClearCollect

A função ClearCollect exclui todos os registros de uma coleção e, em seguida, adiciona um conjunto diferente de registros na mesma coleção. Com uma única função, o ClearCollect oferece a combinação de Clear e Collect.

ClearCollect retorna a coleção modificada como uma tabela. ClearCollect só pode ser usado em uma fórmula de comportamento.

Sintaxe

Collect( DataSource, Item, ... )

  • DataSource – obrigatório. A fonte de dados na qual deseja adicionar dados. Se ela ainda não existir, uma nova coleção será criada.
  • Itens - obrigatório. Um ou mais registros ou tabelas a serem adicionados à fonte de dados.

Clear( Coleção )

  • Coleção – obrigatório. A coleção que você deseja apagar.

ClearCollect( Coleção, Item.)

  • Coleção – obrigatório. A coleção que você deseja apagar e, em seguida, adicionar dados.
  • Itens - obrigatório. Um ou mais registros ou tabelas a serem adicionados à fonte de dados.

Exemplos

Como apagar e adicionar registros a uma fonte de dados

Nesses exemplos, você apagará e adicionará a uma coleção chamada Sorvete. A fonte de dados começa com esses conteúdos:

Fórmula Descrição Resultado
ClearCollect( Sorvete, { Sabor: "Morango", Quantidade: 300 } ) Apaga todos os dados da coleçãoSorvete e, em seguida, adiciona um registro que inclui a quantidade de sorvetes de morango.

A fonte de dados Sorvete também foi modificada.
Collect( Sorvete, { Sabor: "Pistache", Quantidade: 40 }, { Sabor: "Laranja", Quantidade: 200 } ) Adiciona dois registros na coleção Sorvete, que inclui a quantidade de sorvetes de pistache e de laranja.

A fonte de dados Sorvete também foi modificada.
Clear( Sorvete ) Remove todos os registros da coleção Sorvete.

A fonte de dados Sorvete também foi modificada.

Passo a passo

  1. Adicione um botão e defina a propriedade OnSelect para esta função:
    Collect(Produtos, "Europa", "Ganímedes", "Calisto")

    Esta função cria uma coleção denominada Produtos, que contém uma linha para cada um dos três nomes de produto.

  2. Pressione F5, clique o botão e, em seguida, pressione a tecla Esc para retornar ao espaço de trabalho de design.

  3. (opcional) Para exibir uma visualização de coleção que você criou, clique em Coleções na guia Conteúdo.