Setați funcția

Se aplică pentru: aplicații Canvas Carduri Dataverse pluginuri low-code Power Platform CLI

Setează valoarea unei variabile globale.

Prezentare generală

Utilizați funcția Set pentru a seta valoare unei variabile globale, care deține temporar o informație, cum ar fi de câte ori utilizatorul a selectat un buton sau rezultatul unei operațiuni de date.

Variabile globale sunt disponibile în toată aplicația pe toate ecranele. Acestea sunt cele mai simple tipuri de variabile și răspund nevoilor majorității situațiilor. Există, de asemenea, variabile de context care sunt orientate către un singur ecran și colecții care permit modificări la nivel de rând la tabele. Pentru mai multe informații despre aceste alte opțiuni, consultați Înțelegeți variabilele.

Power Apps se bazează pe formule care se recalculează automat pe măsură ce utilizatorul interacționează cu o aplicație. Orice formulă care depinde de o variabilă se vor actualiza automat atunci când se schimbă. Cu toate acestea, variabila nu va fi actualizată automat dacă valoarea formulei utilizate în funcția Set se schimbă. Acest lucru necesită ca producătorul de aplicații să actualizeze manual variabila, care poate fi predispusă la erori și mai greu de înțeles pentru alții. Înainte de a utiliza o variabilă de context, revedeți Înțelegeți variabilele.

Descriere

Variabilele globale sunt implicit create prin utilizarea funcției Set. Nu este necesară nicio declarație explicită. Dacă eliminați toate funcțiile Set pentru o variabilă globală, acea variabilă globală va înceta să existe. Pentru a șterge o variabilă, setați-i valoarea la rezultatul funcției Blank.

Puteți vizualiza valorile, definițiile și utilizările variabilelor dvs. cu vizualizarea Variabile din meniul Fișier în Power Apps Studio..

După cum arată exemplele de mai jos din acest subiect, variabilele globale pot conține mai multe tipuri de informații, inclusiv:

• o singură valoare
• o înregistrare
• un tabel
• o referință la un obiect
• orice rezultat dintr-o formulă

O variabilă globală își păstrează valoarea până la închiderea aplicației. Odată ce aplicația este închisă, valoarea variabilei globale va fi pierdută și trebuie recreată atunci când aplicația este încărcată din nou.

Variabilele globale nu pot utiliza același nume ca o colecție sau un control existent. Poate folosi același nume ca o variabilă de context. Pentru a dezambiguiza între cele două, utilizați tasta operator de dezambiguizare.

Set nu are nicio valoare returnată și puteți să o utilizați numai în cadrul unei formule comportamentale.

Sintaxă

Set( VariableName, Value )

• VariableName - Obligatoriu. Numele unei variabile globale de creat sau actualizat.
• Value - Obligatoriu. Valoare de atribuit variabilei de context.

Exemple

Formulă	Descriere	Rezultat
Set( Counter, 1 )	Creează sau modifică variabila globală Counter, setând valoarea acesteia la 1.	Counter are valoarea 1. Puteți face referire la variabila respectivă utilizând numele Counter într-o formulă de pe orice ecran.
Set( Counter, 2 )	Setează valoarea variabilei globale Counter din exemplul anterior la 2.	Counter are valoarea 2.
Set( Counter, Counter + 1 )	Mărește valoarea variabilei globale Counter din exemplul anterior la 3.	Counter are valoarea 3.
Set( Name, "Lily" )	Creează sau modifică variabila globală Nume, setând valoarea acesteia la Lili.	Nume are valoarea Lili.
Set( Person, { Name: "Milton", Address: "1 Main St" } )	Creează sau modifică variabila globală Person, setând valoarea acesteia conform unei înregistrări. Înregistrarea conține două coloane, numite Name și Address. Valoarea coloanei Name este Milton, iar valoarea coloanei Address este 1 Main St.	Person are valoarea înregistrării { Name: "Milton", Address: "1 Main St" }. Faceți referire la această înregistrare ca întreg cu numele Person sau faceți referire la o coloană individuală a acestei înregistrări cu Person.Name sau Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	Se utilizează cu funcția Patch pentru a actualiza variabila globală Person setând valoarea coloanei Address la 2 Main St.	Person are acum înregistrarea { Name: "Milton", Address: "2 Main St" }.