Set függvény

  • Cikk

A következőkre vonatkozik: Vászonalapú alkalmazások Kártyák Dataverse kevés kódolást igénylő beépülő modulok Power Platform 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 Set függvényhez nem tartozik visszaadott érték, és kizárólag viselkedési képletben használható.

Szintaxis

Set( VariableName, É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( Counter, 1 ) Létrehozza vagy módosítja a Counter globális változót, és 1 értékre állítja be. A Counter az 1 értéket tartalmazza. Bármelyik képernyőn hivatkozhat erre a változóra, ha a Counter nevet használja egy képletben.
Set( Counter, 2 ) Az előző példában látott Counter globális változó értékét 2-re állítja. A Counter a 2 értéket tartalmazza.
Set( Counter, Counter + 1 ) Az előző példában látott Counter globális változó értékét 3-ra növeli. A Counter a 3 értéket tartalmazza.
Set( Name, "Tímea" ) Létrehozza vagy módosítja a Name globális változót, és Lily értékre állítja be. A Name a Tímea értéket tartalmazza.
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 Person a { Name: "Milton", Address: "1 Main St" } rekord értékét tartalmazza.

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 Person most már a { Name: "Milton", Address: "2 Main St" } rekord értékét tartalmazza.