Comparteix a través de

Funció d'establiment

  • Article

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

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é cap valor de retorn i només el podeu utilitzar dins d'una fórmula de comportament.

Sintaxi

Set(VariableName,Value )

  • 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

Fórmula Descripció Resultat
Set ( Comptador, 1 ) Crea o modifica la variable global Comptador i en defineix el valor a 1. El comptador té el valor 1. Podeu fer referència a aquesta variable amb el nom Comptador en una fórmula a qualsevol pantalla.
Set ( Comptador, 2 ) Defineix el valor de la variable global Comptador de l'exemple anterior en 2. El comptador té el valor 2.
Conjunt( Comptador, Comptador + 1 ) Augmenta el valor de la variable global Comptador de l'exemple anterior en 3. El comptador té el valor 3.
Set( Nom, "Lily" ) Crea o modifica la variable global Nom i en defineix el valor a Lily. Nom té el valor Lily.
Set( Persona, { Nom: "Milton", Adreça: "1 Main St" } ) Crea o modifica la variable global Persona i en defineix el valor a un registre. El registre conté dues columnes, anomenades Nom i Adreça. El valor de la columna Nom és Milton, mentre que el valor de la columna Adreça és 1 Main St. La persona té el valor del registre { Nom: "Milton", Adreça: "1 Main St". }

Feu referència a aquest registre com a conjunt amb el nom Persona o feu referència a una columna individual d'aquest registre amb Person.Name o Person.Address.
Set( Persona, Pegat (Persona,Adreça {: "2 Main St" } ) ) Utilitza la funció Patch per actualitzar la variable global Persona mitjançant la definició del valor de la columna Adreça a 2 Main St. La persona ara té el valor del registre { Nom: "Milton", Adreça: "2 Main St". }