Define o valor de uma variável global.

Visão geral

Use a função Set para definir o valor de uma variável global, que armazena temporariamente uma informação, 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 trabalhar com variáveis.

Os PowerApps são baseados em fórmulas que se recalculam automaticamente conforme a interação do usuário com o aplicativo. As variáveis globais não oferecem esse benefício e podem fazer com que seja mais difícil criar e entender seu aplicativo. Antes de usar uma variável, examine trabalhando com variáveis.

Descrição

Variáveis globais são criadas implicitamente, usando a função Set. Não há nenhuma declaração explícita necessária. Se você remover todas as funções Definir para 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 Em branco.

Você pode ver os valores, definições e usos de suas variáveis com o modo de exibição Variáveis no menu Arquivo no ambiente de criação.

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.

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

Sintaxe

Set( VariableName, Valor )

  • 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

Fórmula Descrição Resultado
Set( Counter, 1 ) Cria ou modifica a variável global Counter, definindo seu valor como 1. Counter tem o valor 1. Você pode referenciar essa variável usando o nome Counter em uma fórmula em qualquer tela.
Set( Counter, 2 ) Define o valor da variável global Counter do exemplo anterior para 2. Counter tem o valor 2.
Set( Counter, Counter + 1 ) Aumenta o valor da variável global Counter do exemplo anterior para 3. Counter tem o valor 3.
Set( Name, "Lily" ) Cria ou modifica a variável global Name, definindo seu valor como Lily. Name tem o valor Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) Cria ou modifica a variável global Person, definindo seu valor como um registro. O registro contém duas colunas, chamadas Name e Address. O valor da coluna Name é Miltone o valor da coluna Address é 1 Main St. Person tem o valor do registro { Name: "Milton", Address: "1 Main St" }.

Fazer referência a esse registro como um todo com o nome Person, ou fazer referência a uma coluna individual desse registro com Person.Name ou Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Funciona com a função Patch para atualizar a variável global Person, definindo o valor da coluna Address como 2 Main St. Person agora tem o valor de registro { Name: "Milton", Address: "2 Main St" }.