Nastavite funkcijo

Velja za: Aplikacije Canvas Kartice Dataverse vtičnike z nizko kodo Power Platform CLI

Nastavi vrednost globalne spremenljivke.

Pregled

Uporabite funkcijo Set, da nastavite vrednost globalne spremenljivke, ki začasno vsebuje na primer podatek, kolikokrat je uporabnik izbral gumb ali kakšen je rezultat podatkovne operacije.

Globalne spremenljivke so na voljo v vaši aplikaciji na vseh zaslonih. To so najenostavnejše vrste spremenljivk, ki izpolnjujejo potrebe za večino primerov. Obstajajo tudi spremenljivke konteksta, ki so zajete na enem zaslonu, in zbirke, ki omogočajo spremembe v tabelah na ravni vrstic. Za več informacij o teh drugih možnostih glejte Razumevanje spremenljivk.

Aplikacije Power Apps temeljijo na formulah, ki se samodejno preračunajo, ko uporabnik uporablja aplikacijo. Vse formule, ki so odvisne od spremenljivke, se samodejno posodobijo, ko se spremenljivka spremeni. Vendar pa spremenljivka ne bo samodejno posodobljena, če se spremeni vrednost formule, uporabljene v funkciji Set. Zato mora ustvarjalec aplikacije ročno posodobiti spremenljivko, ki pa je lahko nagnjena k napakam in težje razumljiva za druge. Preden uporabite spremenljivko, glejte Razumevanje spremenljivk.

Opis

Globalne spremenljivke so implicitno ustvarjene s funkcijo Set. Izrecna izjava ni potrebna. Če odstranite vse funkcije Set za globalno spremenljivko, ta globalna spremenljivka ne bo več obstajala. Če želite izbrisati spremenljivko, nastavite njeno vrednost na rezultat funkcije Blank.

Vrednosti, definicije in uporabe spremenljivk so prikazane v pogledu »Spremenljivke« v meniju Datoteka v Power Apps Studio.

Kot kažejo primeri v nadaljevanju te teme, lahko globalne spremenljivke vsebujejo več vrst informacij, vključno s temi:

• ena vrednost
• zapis
• tabela
• sklic na predmet
• kakršenkoli rezultat iz formule

Globalna spremenljivka ohrani svojo vrednost, dokler se aplikacija ne zapre. Ko se zapre, se vrednost globalne spremenljivke izgubi in jo je treba znova ustvariti, ko se aplikacija znova naloži.

Globalne spremenljivke ne morejo uporabljati istega imena kot obstoječa zbirka ali kontrolnik. Lahko pa uporabijo isto ime kot spremenljivka konteksta. Če želite razlikovati med njima, uporabite operator za razločitev.

Funkcija Set ne vrne nobene vrednosti in jo lahko uporabite samo v formuli vedenja.

Sintaksa

Set( VariableName, Value )

• VariableName – obvezno. Ime globalne spremenljivke za ustvarjanje ali posodobitev.
• Value – obvezno. Vrednost, ki je dodeljena spremenljivki konteksta.

Primeri

Formula	Opis	Rezultat
Set( Counter, 1 )	Ustvari ali spremeni globalno spremenljivko Counter in nastavi njeno vrednost na 1.	Counter ima vrednost 1. Na to spremenljivko se lahko sklicujete z imenom Counter v formuli na katerem koli zaslonu.
Set( Counter, 2 )	Nastavi vrednost globalne spremenljivke Counter iz prejšnjega primera na 2.	Counter ima vrednost 2.
Set( Counter, Counter + 1 )	Poveča vrednost globalne spremenljivke Counter iz prejšnjega primera na 3.	Counter ima vrednost 3.
Set( Name, "Lily" )	Ustvari ali spremeni globalno spremenljivko Name in nastavi njeno vrednost na Lily.	Name ima vrednost Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )	Ustvari ali spremeni globalno spremenljivko Person in nastavi njeno vrednost na zapis. Zapis vsebuje dva stolpca, imenovana Name in Address. Vrednost stolpca Name je Milton, vrednost stolpca Address pa 1 Main St.	Person ima vrednost zapisa { Name: "Milton", Address: "1 Main St" }. Navedite celoten zapis z imenom Person ali posamezen stolpec tega zapisa s Person.Name ali Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	Deluje s funkcijo Patch in posodobi globalno spremenljivko Person tako, da nastavi vrednost stolpca Address na 2 Main St.	Person ima zdaj vrednost zapisa { Name: "Milton", Address: "2 Main St" }.