Set függvény

A következőkre vonatkozik: vászonalapú alkalmazások Kártyák Dataverse kevés kódolást igénylő Power Platform beépülő modulok CLI

Egy globális változó értékét állítja be.

Áttekintés

A Set függvénnyel egy globális változó értéke állítható be, amely ideiglenesen tárol valamilyen információt, például egy adatművelet eredményét, vagy hogy a felhasználó hány alkalommal választott ki egy gombot.

A globális változók az alkalmazás minden képernyőjén elérhetők. Ezek a legegyszerűbb változófajták, és majdnem helyzetben kielégítenek minden igényt. Környezeti változók is vannak, amelyek egyetlen képernyőre terjednek ki, valamint gyűjtemények, amelyek a táblák sorszintű módosítását teszik lehetővé. Ezekről az egyéb lehetőségekről további tudnivalókat a Változók ismertetése című rész tartalmaz.

Power Apps megoldások olyan képleteken alapulnak, amelyek automatikusan újból elvégzik a számításokat, amikor a felhasználó használja az alkalmazást. A változótól függő képletek a módosításkor automatikusan frissülnek. A változót azonban nem frissíti a rendszer, ha a Set függvényben használt képlet értéke megváltozik. Ehhez az alkalmazás készítőjének kézzel kell frissítenie a változót, ami hibalehetőséget rejt magában, és mások számára is nehezen érthető lehet. Mielőtt változót használ, tekintse át A változókkal kapcsolatos tudnivalók témakört.

Ismertetés

A globális változók implicit módon jönnek létre a Set függvény használatakor. Explicit deklarálásra nincs szükség. Ha egy globális változó minden Set függvényét eltávolítja, akkor a globális változó megszűnik létezni. Egy változó törléséhez tegye egyenlővé az értékét Blank függvény eredményével.

A Power Apps Studio megoldás Fájl menüjéből elérhető Változók nézetben megtekintheti a változók értékét, definícióját és használatát.

Ahogy a témakörben később található példákból is látszik, a globális változók különféle információkat tartalmazhatnak, például a következőket:

• egy érték
• egy rekord
• egy tábla
• egy objektumhivatkozás
• egy képlet bármilyen eredménye

A globális változók az alkalmazás bezárásáig megtartják az értéküket. Az alkalmazás bezárásakor a globális változó értéke elvész, és az alkalmazás újbóli betöltésekor újra létre kell hozni.

A globális változók nem használhatják egy már meglévő gyűjtemény vagy vezérlő nevét. Felvehetnek azonban egy környezeti változóval megegyező nevet. A kettő megkülönböztetéséhez használja az egyértelműsítő operátort.

A Halmaznak nincs visszatérési értéke, és csak viselkedési képletben használható.

Szintaxis

Set( Változónév; Érték )

• VariableName - Kötelező. Egy létrehozandó vagy frissítendő globális változó neve.
• Érték - Kötelező. A környezeti változóhoz rendelendő érték.

Példák

Képlet	Ismertetés	Eredmény
set( számláló, 1 )	Létrehozza vagy módosítja a Counter globális változót, és 1 értékre állítja be.	A számláló értéke 1. Bármelyik képernyőn hivatkozhat erre a változóra, ha a Counter nevet használja egy képletben.
set( számláló, 2 )	Az előző példában látott Counter globális változó értékét 2-re állítja.	A számláló értéke 2.
set( számláló, számláló + 1 )	Az előző példában látott Counter globális változó értékét 3-ra növeli.	A számláló értéke 3.
set( név, "liliom" )	Létrehozza vagy módosítja a Name globális változót, és Lily értékre állítja be.	A név értéke Lily.
set( Személy,Név { : "Milton", Cím: "1 Main St" } )	Létrehozza vagy módosítja a Person globális változót, és egy rekordra állítja be az értékét. A rekord két oszlopot tartalmaz: Name és Address. A Name oszlop értéke Milton, az Address oszlop értéke pedig 1 Main St.	A személy értéke rekordnév { : "Milton", cím: "1 Main St". } A rekord egészére a Person névvel, a rekord egyes oszlopaira pedig a Person.Name vagy a Person.Address névvel hivatkozhat.
set( személy, patch( személy,cím {: "2 Main St" } ) )	A Patch függvényt használja a Person globális változó frissítésére; az Address oszlopot 2 Main St értékre állítja.	A személy most már a rekord { értéke Név: "Milton", Cím: "2 Main St". }