Nastaviť funkciu
Platí pre: aplikácie Canvas Karty Dataverse nízkokódové doplnky Power Platform CLI
Umožňuje nastaviť hodnotu globálnej premennej.
Prehľad
Funkcia Set umožňuje nastaviť hodnotu globálnej premennej, ktorá dočasne uchová určitú informáciu, napríklad koľkokrát vybral používateľ určité tlačidlo alebo výsledok operácie s údajmi.
Globálne premenné sú k dispozícii vo vašej aplikácii na všetkých obrazovkách. Ide o najjednoduchší druh premenných a pokryjú vaše potreby vo väčšine situácií. K dispozícii sú aj kontextové premenné, ktoré sú sústredené na jednej obrazovke, a kolekcie, ktoré umožňujú úpravy tabuliek na úrovni riadka. Viac informácií o týchto ďalších možnostiach nájdete na stránke Vysvetlenie premenných.
Power Apps sa zakladá na vzorcoch, ktoré sa automaticky prepočítajú v priebehu interakcie používateľa s aplikáciou. Akékoľvek vzorce, ktoré závisia od premennej, sa po zmene automaticky aktualizujú. Premenná však nebude automaticky aktualizovaná, ak sa hodnota vzorca použitého vo funkcii Set zmení. Vyžaduje si to, aby tvorca aplikácie manuálne aktualizovali premennú, ktorá môže byť náchylná na chyby a pre iných zrozumiteľnejšie. Pred použitím kontextovej premennej si prečítajte časť Vysvetlenie premenných.
Popis
Globálne premenné sa implicitne vytvárajú pomocou funkcie Set. Nevyžaduje sa žiadna explicitná deklarácie. Ak odstránite všetky funkcie Set pre určitú globálnu premennú, potom táto globálna premenná prestane existovať. Premennú vymažete tak, že jej hodnotu nastavíte na výsledok funkcie Blank.
Hodnoty, definície a použitie premenných si môžete pozrieť pomocou zobrazenia Premenné v ponuke Súbor v Power Apps Studio.
Ako uvidíte na príkladoch uvedených nižšie, globálne premenné môžu uchovávať niekoľko typov informácií vrátane týchto:
- samostatná hodnota
- záznam
- tabuľka
- odkaz na objekt
- akýkoľvek výsledok vzorca.
Globálna premenná uchováva svoju hodnotu, dokým sa aplikácia nezatvorí. Po zavretí aplikácie sa hodnota globálnej premennej stratí a musí sa znovu vytvoriť pri opätovnom načítaní aplikácie.
Globálne premenné nemôžu mať rovnaký názov ako existujúca kolekcia alebo ovládací prvok. Môžete mať rovnaký názov ako kontextová premenná. Ak chcete odstrániť nejednoznačnosť medzi týmito dvoma premennými, použite rozlišovací operátor.
Množina nemá žiadnu návratovú hodnotu a môžete ju použiť iba v rámci vzorca správania.
Syntax
Nastaviť( Názov premennej, Hodnota )
- Názov premennej – povinné. Názov globálnej premennej, ktorá sa má vytvoriť alebo aktualizovať.
- Hodnota – povinné. Hodnota, ktorá sa má tejto kontextovej premennej priradiť.
Príklady
Vzorec | Popis | Výsledok |
---|---|---|
Sada (počítadlo, 1) | Vytvorí alebo upraví globálnu premennú Počítadlo a nastaví jej hodnotu na 1. | Počítadlo má hodnotu 1. Na túto premennú môžete odkázať použitím názvu Počítadlo vo vzorci na ľubovoľnej obrazovke. |
Sada (počítadlo, 2) | Nastaví hodnotu globálnej premennej Počítadlo z predchádzajúceho príkladu na 2. | Počítadlo má hodnotu 2. |
Sada (počítadlo, počítadlo + 1) | Nastaví hodnotu globálnej premennej Počítadlo z predchádzajúceho príkladu na 3. | Počítadlo má hodnotu 3. |
Set (meno, "Lily" ) | Vytvorí alebo upraví globálnu premennú Názov a nastaví jej hodnotu na Lily. | Meno má hodnotu Lily. |
Set( osoba, { meno: "Milton", adresa: "1 Main St" } ) | Vytvorí alebo upraví globálnu premennú Osoba a nastaví jej hodnotu na záznam. Tento záznam obsahuje dva stĺpce, s názvami Meno a Adresa. Hodnota stĺpca Meno je Novák, a hodnotu stĺpca Adresa je Hlavná ulica 1. | Osoba má hodnotu záznamu { Meno: "Milton", Adresa: "1 Main St" }. Na tento záznam môžete odkázať ako na celok pomocou premennej Osoba alebo môžete odkázať na individuálny stĺpec z tohto záznamu pomocou Person.Name alebo Person.Address. |
Set( Osoba, Patch( Osoba, {Adresa: "2 Main St" } ) ) | Používa funkciu Patch na aktualizáciu globálnej premennej Osoba nastavením hodnoty stĺpca Adresa na Hlavná ulica 2. | Osoba má teraz hodnotu záznamu { Meno: "Milton", Adresa: "2 Main St" }. |