Set függvény

A következőkre vonatkozik: Vászonalapú alkalmazások Asztali folyamatok Power Platform CLI Dataverse-függvények

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

Áttekintés

Set A függvény használatával beállíthatja egy globális változó értékét, amely ideiglenesen tartalmaz egy információt, például azt, hogy a felhasználó hányszor jelölt ki gombot vagy egy adatművelet eredményét.

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ó azonban nem frissül automatikusan, ha a függvényben Set 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álatával. Explicit deklarálásra nincs szükség. Ha eltávolítja egy Set globális változó összes függvényét, az a globális változó megszűnik. 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.

Set nincs visszatérési értéke, és csak egy viselkedési képleten belül használhatja.

Szintaxis

Set( VariableName, Value )

• 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, "Lily" )	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( Person, { Name: "Milton", Address: "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( Person, Patch( Person, {Address: "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". }