Funkcia Set

Vzťahuje sa na: Plátnové aplikácie Desktopové postupy funkcie Power Platform CLI Dataverse

Umožňuje nastaviť hodnotu globálnej premennej.

Prehľad

Set Funkcia sa používa na nastavenie hodnoty globálnej premennej, ktorá dočasne uchová určitú informáciu, napríklad koľkokrát vybral používateľ 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á sa však nebude automaticky aktualizovať, ak sa zmení hodnota vzorca použitá vo funkcii Set . 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 Set funkcie . Nevyžaduje sa žiadna explicitná deklarácie. Ak odstránite všetky Set funkcie globálnej premennej, 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.

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

Syntax

Set( VariableName, Value )

• 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
Set( 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.
Set( Počítadlo, 2 )	Nastaví hodnotu globálnej premennej Počítadlo z predchádzajúceho príkladu na 2.	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.	Počítadlo má hodnotu 3.
Set( Meno, "Lenka" )	Vytvorí alebo upraví globálnu premennú Názov a nastaví jej hodnotu na Lily.	Meno má hodnotu Lily.
Set( Osoba, { Meno: "Novák", 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 Hlavná ulica" } ) )	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" }.