Establecer función

Aplícase a: Aplicacións Canvas Cartóns Dataverse Complementos con pouco código Power Platform CLI

Establece o valor dunha variable global.

Visión xeral

Use a función Set para establecer o valor dunha variable global, que contén temporalmente unha información, como o número de veces que o usuario seleccionou un botón ou o resultado dunha operación de datos.

As variables globais están dispoñibles en toda a aplicación en todas as pantallas. Son o tipo de variables máis sinxelo e cubren as necesidades da maioría das situacións. Tamén hai variables de contexto orientadas a unha única pantalla e coleccións que permiten modificacións a nivel de fila en táboas. Para obter máis información sobre estas outras opcións, revise Comprender as variables.

Power Apps baséase en fórmulas que se recalculan automaticamente a medida que o usuario interactúa cunha aplicación. Todas as fórmulas que dependan dunha variable actualizaranse automaticamente cando cambie. Non obstante, a variable non se actualizará automaticamente se o valor da fórmula empregada na función Set cambia. Isto require que o fabricante da aplicación actualice manualmente a variable, o que pode ser máis propenso a erros e difícil de comprender. Antes de usar unha variable de contexto, revise Comprender as variables.

Descripción

As variables globais son creadas implícitamente mediante a función Set. Non é necesaria ningunha declaración explícita. Se elimina todas as funcións Set para unha variable global, esa variable global deixará de existir. Para borrar unha variable, estableza o seu valor no resultado da función Blank.

Pode ver os valores, as definicións e os usos das súas variables coa vista Variables do menú Ficheiro en Power Apps Studio.

Como mostran os exemplos posteriores neste tema, as variables globais poden ter varios tipos de información, incluídos estes:

• un único valor
• un rexistro
• unha táboa
• unha referencia do obxecto
• calquera resultado dunha fórmula

Unha variable global mantén o seu valor ata que se pecha a aplicación. Unha vez que pechada, perderase o valor da variable global e debe ser recreado cando a aplicación se volva cargar.

As variables globais non poden usar o mesmo nome que unha colección ou control existente. Pode usar o mesmo nome que unha variable de contexto. Para eliminar a ambigüidade entre as dúas, use o operador de desambiguación.

Set non ten valor de retorno e só podes usalo dentro dunha fórmula de comportamento.

Sintaxe

Establecer( VariableName, Valor )

• VariableName : é necesario. O nome dunha variable global para crear ou actualizar.
• Valor - Obrigatorio. O valor que hai que asignar á variable de contexto.

Exemplos

Fórmula	Descripción	Resultado
Establecer (contador, 1)	Crea ou modifica a variable global Counter, definindo o seu valor en 1.	O contador ten o valor 1. Pode facer referencia a esa variable usando o nome Counter nunha fórmula en calquera pantalla.
Establecer (contador, 2)	Define o valor da variable global Counter do exemplo anterior en 2.	O contador ten o valor 2.
Establecer (contador, contador + 1)	Incrementa o valor da variable global Counter do exemplo anterior en 3.	O contador ten o valor 3.
Set(Nome, "Lily")	Crea ou modifica a variable global Name, definindo o seu valor en Lily.	O nome ten o valor Lily.
Set( Persoa, { Nome: "Milton", Enderezo: "1 Main St" } )	Crea ou modifica a variable global Person, definindo o seu valor nun rexistro. O rexistro contén dúas columnas, chamadas Name e Address. O valor da columna Name é Milton, e o valor da columna Address é 1 Main St.	Persoa ten o valor de rexistro { Nome: "Milton", Enderezo: "1 Main St" }. Faga referencia a este rexistro en conxunto co nome Person, ou faga referencia a unha columna individual deste rexistro con Person.Name ou Person.Address.
Set( Persoa, Parche( Persoa, {Enderezo: "2 Main St" } ) )	Traballa coa función Patch para actualizar a variable global Person definindo o valor da columna Address en 2 Main St.	A persoa agora ten o valor de rexistro { Nome: "Milton", Enderezo: "2 Main St" }.