Função Set no PowerAppsSet function in PowerApps

Define o valor de uma variável global.Sets the value of a global variable.

Visão geralOverview

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.Use the Set function to set the value of a global variable, which temporarily holds a piece of information, such as the number of times the user has selected a button or the result of a data operation.

Variáveis globais estão disponíveis em todo o seu aplicativo, em todas as telas.Global variables are available throughout your app on all screens. Esses são o tipo mais simples de variáveis e satisfazem as necessidades da maioria das situações.These are the simplest kind of variables and fill the needs of most situations. 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.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. Para obter mais informações sobre essas outras opções, consulte trabalhar com variáveis.For more information on these other options see working with variables.

Os PowerApps são baseados em fórmulas que se recalculam automaticamente conforme a interação do usuário com o aplicativo.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. As variáveis globais não oferecem esse benefício e podem fazer com que seja mais difícil criar e entender seu aplicativo.Global variables don't offer this benefit and can make your app harder to create and understand. Antes de usar uma variável, examine trabalhando com variáveis.Before you use a variable, review working with variables.

DescriçãoDescription

Variáveis globais são criadas implicitamente, usando a função Set.Global variables are implicitly created by using the Set function. Não há nenhuma declaração explícita necessária.There is no explicit declaration required. Se você remover todas as funções Definir para uma variável global, essa variável global deixará de existir.If you remove all the Set functions for a global variable, then that global variable will cease to exist. Para limpar uma variável, defina seu valor como o resultado da função Em branco.To clear a variable set its value to the result of the Blank function.

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.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

Como mostram os exemplos neste tópico, variáveis globais podem conter vários tipos de informações, incluindo:As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • um único valora single value
  • um registroa record
  • uma tabelaa table
  • uma referência de objetoan object reference
  • qualquer resultado de uma fórmulaany result from a formula

Uma variável global mantém seu valor até o aplicativo ser fechado.A global variable holds its value until the app is closed. Depois que o aplicativo for fechado, o valor da variável global será perdido e deverá ser recriado quando esse aplicativo for carregado novamente.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

Variáveis globais não podem usar o mesmo nome de uma coleção ou controle existente.Global variables cannot use the same name as an existing collection or control. Ela pode usar o mesmo nome de uma variável de contexto.It can use the same name as a context variable. Para desfazer a ambiguidade entre os dois, use o operador de desambiguidade.To disambiguate between the two, use the disambiguation operator.

Definir não tem nenhum valor retornado e você pode usá-lo somente em uma fórmula de comportamento.Set has no return value, and you can use it only within a behavior formula.

SintaxeSyntax

Set( VariableName, Valor )Set( VariableName, Value )

  • VariableName – obrigatório.VariableName - Required. O nome de uma variável global para criar ou atualizar.The name of a global variable to create or update.
  • Valor – Obrigatório.Value - Required. O valor a ser atribuído à variável de contexto.The value to assign to the context variable.

ExemplosExamples

FórmulaFormula DescriçãoDescription ResultadoResult
Set( Counter, 1 )Set( Counter, 1 ) Cria ou modifica a variável global Counter, definindo seu valor como 1.Creates or modifies the global variable Counter, setting its value to 1. Counter tem o valor 1.Counter has the value 1. Você pode referenciar essa variável usando o nome Counter em uma fórmula em qualquer tela.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) Define o valor da variável global Counter do exemplo anterior para 2.Sets the value of the Counter global variable from the previous example to 2. Counter tem o valor 2.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) Aumenta o valor da variável global Counter do exemplo anterior para 3.Increments the value of the Counter global variable from the previous example to 3. Counter tem o valor 3.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) Cria ou modifica a variável global Name, definindo seu valor como Lily.Creates or modifies the global variable Name setting its value to Lily. Name tem o valor Lily.Name has the value Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )Set( Person, { Name: "Milton", Address: "1 Main St" } ) Cria ou modifica a variável global Person, definindo seu valor como um registro.Creates or modifies the global variable Person, setting its value to a record. O registro contém duas colunas, chamadas Name e Address.The record contains two columns, named Name and Address. O valor da coluna Name é Miltone o valor da coluna Address é 1 Main St.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person tem o valor do registro { Name: "Milton", Address: "1 Main St" }.Person has the value of record { 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.Reference this record as a whole with the name Person, or reference an individual column of this record with Person.Name or Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )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.Works with the Patch function to update the Person global variable by setting the value of the Address column to 2 Main St. Person agora tem o valor de registro { Name: "Milton", Address: "2 Main St" }.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.