Funció de conjunt

S'aplica a: Aplicacions de llenç Targetes Dataverse connectors Power Platform de codi baix CLI

Defineix el valor d'una variable global.

Informació general

Utilitzeu la funció Set per definir el valor d'una variable global, que temporalment conté una informació, com ara el nombre de vegades que l'usuari ha seleccionat un botó o el resultat d'una operació de dades.

Les variables globals estan disponibles a totes les pantalles de l'aplicació. Aquests són el tipus de variables més simples i compleixen les necessitats de la majoria de situacions. També hi ha variables de context que estan delimitades a una única pantalla i col·leccions que permeten modificar el nivell de fila de les taules. Per obtenir més informació sobre aquestes altres opcions, consulteu Informació sobre les variables.

Les aplicacions del Power Apps es basen en fórmules que es tornen a calcular automàticament a mesura que l'usuari interactua amb una aplicació. Qualsevol fórmula que depengui d'una variable s'actualitzarà automàticament quan canviï. No obstant això, la variable no s'actualitzarà automàticament si el valor de la fórmula que s'utilitza a la funció Set canvia. Això requereix que el creador de l'aplicació actualitzi manualment la variable, que pot causar errors i ser més difícil d'entendre per a altres persones. Abans d'utilitzar una variable, reviseu Informació sobre les variables.

Descripció

Les variables globals es creen implícitament mitjançant la funció Set. No cal cap declaració explícita. Si suprimiu totes les funcions Set d'una variable global, aquesta variable global deixarà d'existir. Per esborrar una variable, definiu-ne el valor al resultat de la funció Blank.

Podeu veure els valors, les definicions i els usos de les variables amb la Visualització de variables al menú Fitxer del Power Apps Studio.

Tal com mostren els exemples més endavant en aquest tema, les variables globals poden contenir diversos tipus d'informació, com ara:

• un únic valor
• un registre
• una taula
• una referència a un objecte
• qualsevol resultat d'una fórmula

Una variable global conserva el valor fins al tancament de l'aplicació. Un cop es tanca, el valor de la variable global es perdrà i s'ha de tornar a crear quan l'aplicació es torni a carregar.

Les variables globals no poden utilitzar el mateix nom que una col·lecció o un control existent. Pot utilitzar el mateix nom que una variable de context. Per desambiguar entre totes dues, utilitzeu l'operador de desambiguació.

Set no té valor de retorn i només es pot utilitzar dins d'una fórmula de comportament.

Sintaxi

Set(VariableName, Valor)

• VariableName: obligatori. El nom de la variable global que voleu crear o actualitzar.
• Valor: obligatori. El valor que voleu assignar a la variable de context.

Exemples