Set Função

Aplica-se a: Aplicativos de tela A área de trabalho flui funções do Dataverse da CLI do Power Platform

Define o valor de uma variável global.

Visão geral

Use a Set função para definir o valor de uma variável global, que contém temporariamente uma parte das informações, como o número de vezes que o usuário selecionou um botão ou o resultado de uma operação de dados.

Variáveis globais estão disponíveis em todo o seu aplicativo, em todas as telas. Esses são o tipo mais simples de variáveis e satisfazem as necessidades da maioria das situações. Também há variáveis de contexto que têm o escopo para uma única tela e coleções que permitem realizar modificações em nível de linha a tabelas. Para obter mais informações sobre essas outras opções, consulte Entender as variáveis.

O Power Apps é baseado em fórmulas que se recalculam automaticamente conforme a interação do usuário com o aplicativo. Todas as fórmulas que dependem de uma variável serão atualizadas automaticamente quando forem alteradas. No entanto, a variável não será atualizada automaticamente se o valor da fórmula usada na Set função for alterado. Isso requer que o criador de aplicativos atualize manualmente a variável, o que pode ser propenso a erros e mais difícil para que outras pessoas entendam. Antes de usar uma variável, examine Entender as variáveis.

Descrição

As variáveis globais são criadas implicitamente usando a Set função. Nenhuma declaração explícita é necessária. Se você remover todas as Set funções de uma variável global, essa variável global deixará de existir. Para limpar uma variável, defina seu valor como o resultado da função Blank.

Você pode ver os valores, as definições e os usos das variáveis com o modo de exibição de variáveis no menu Arquivo no Power Apps Studio.

Como mostram os exemplos neste tópico, variáveis globais podem conter vários tipos de informações, incluindo:

• um único valor
• um registro
• uma tabela
• uma referência de objeto
• qualquer resultado de uma fórmula

Uma variável global mantém seu valor até o aplicativo ser fechado. Depois que o aplicativo for fechado, o valor da variável global será perdido e deverá ser recriado quando esse aplicativo for carregado novamente.

Variáveis globais não podem usar o mesmo nome de uma coleção ou controle existente. Ela pode usar o mesmo nome de uma variável de contexto. Para desfazer a ambiguidade entre os dois, use o operador de desambiguidade.

Set não tem nenhum valor retornado e você pode usá-lo somente dentro de uma fórmula de comportamento.

Sintaxe

Set( VariableName, Value )

• VariableName - Obrigatório. O nome de uma variável global para criar ou atualizar.
• Valor - Obrigatório. O valor a ser atribuído à variável de contexto.

Exemplos