Nastaviť funkciu

  • Článok

Platí pre: aplikácie Canvas karty Dataverse doplnky s nízkym kódom 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.

Funkcia Set nemá žiadnu návratovú hodnotu a môžete ju použiť iba vo vzorci správania.

Syntax

Set( VariableName, Value )

  • VariableName – 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
Set( Počítadlo, 1 ) Vytvorí alebo upraví globálnu premennú Počítadlo a nastaví jej hodnotu na 1. Premenná 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.
Set( Počítadlo, 2 ) Nastaví hodnotu globálnej premennej Počítadlo z predchádzajúceho príkladu na 2. Premenná Počítadlo má hodnotu 2.
Set( Počítadlo, Počítadlo + 1 ) Nastaví hodnotu globálnej premennej Počítadlo z predchádzajúceho príkladu na 3. Premenná Počítadlo má hodnotu 3.
Set( Meno, "Lily" ) Vytvorí alebo upraví globálnu premennú Názov a nastaví jej hodnotu na Lily. Premenná 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: "1MainSt" }.

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. Premenná Osoba má teraz hodnotu záznamu {Meno: "Milton", Adresa: "2 Main St" }.