Set Funkce

Platí pro: Desktopové aplikace plátna toky Power Platform CLI – funkce Dataverse

Nastaví hodnotu globální proměnné.

Přehled

Set Pomocí funkce můžete nastavit hodnotu globální proměnné, která dočasně obsahuje informace, například počet, kolikrát uživatel vybral tlačítko nebo výsledek operace s daty.

Globální proměnné jsou v aplikaci dostupné na všech obrazovkách. Jedná se o nejjednodušší typ proměnné, která splňuje potřeby většiny situací. Existují rovněž kontextové proměnné, které se omezují na jednu obrazovku a kolekci a umožňují změny tabulek na úrovní řádků. Další informace o těchto dalších možnostech naleznete v Informace o proměnných.

Základem Power Apps jsou vzorce, které se automaticky přepočítávají během interakce uživatele s aplikací. Všechny vzorce, které závisí na proměnné, se automaticky aktualizují, když se změní. Proměnná se ale nebude automaticky aktualizovat, pokud se změní hodnota vzorce použitého Set ve funkci. To vyžaduje, aby tvůrce aplikace ručně aktualizoval proměnnou, která může být náchylná k chybám a pro ostatní je obtížnější porozumět. Před použitím proměnné si přečtěte téma o Informace o proměnných.

Popis

Globální proměnné se implicitně vytvářejí pomocí Set funkce. Nevyžaduje se žádná explicitní deklarace. Pokud odeberete všechny Set funkce globální proměnné, globální proměnná přestane existovat. Proměnnou vymažete tak, že její hodnotu nastavíte na výsledek funkce Blank.

Hodnoty, definice a použití proměnných si můžete prohlédnout pomocí zobrazení Proměnné v nabídce Soubor v Power Apps Studio.

Jak ukazují příklady dál v tomto tématu, mohu globální proměnné uchovávat několik druhů informací, mezi které patří:

• Jedna hodnota
• záznam
• tabulka
• Odkaz na objekt
• Jakýkoli výsledek vzorce

Globální proměnná uchovává svou hodnotu tak dlouho, dokud se aplikace nezavře. Po zavření se hodnota globální proměnné ztratí a musí se znovu vytvořit při opětovném načtení aplikace.

Globální proměnná nemůže používat stejný název jako existující kolekce nebo ovládací prvek. Může používat stejný název jako kontextová proměnná. K rozlišení těchto dvou proměnných se používá rozlišovací operátor.

Set nemá žádnou návratovou hodnotu a můžete ji použít pouze ve vzorci chování.

Syntaxe

Set( VariableName, Value )

• Název proměnné – Povinné. Název globální proměnné, která se má vytvořit nebo aktualizovat.
• Hodnota – Povinné. Hodnota, která se má této globální proměnné přiřadit.

Příklady

Vzorec	Popis	Výsledek
Set( Čítač, 1 )	Vytvoří nebo změní globální proměnnou Čítač a nastaví její hodnotu na 1.	Počítadlo má hodnotu 1. Na tuto proměnnou můžete odkázat pomocí názvu Čítač ve vzorci na libovolné obrazovce.
Set( Čítač, 2 )	Nastaví hodnotu globální proměnné Čítač z předchozího příkladu na 2.	Počítadlo má hodnotu 2.
Set( Counter, Counter + 1 )	Inkrementuje hodnotu globální proměnné Čítač z předchozího příkladu na 3.	Počítadlo má hodnotu 3.
Set( Jméno, "Lily" )	Vytvoří nebo změní globální proměnnou Name a nastaví její hodnotu na Lily.	Jméno má hodnotu Lily.
Set( Osoba, { Jméno: "Milton", Adresa: "1 Main St" } )	Vytvoří nebo změní globální proměnnou Osoba a nastaví její hodnotu na záznam. Tento záznam obsahuje dva sloupce s názvy Name a Address. Hodnota sloupce Name je Milton a hodnota sloupce Address je 1 Main St.	Osoba má hodnotu záznamu { Jméno: "Milton", Adresa: "1 Main St" }. Na tento záznam můžete odkázat jako na celek pomocí názvu Person, nebo na individuální sloupec tohoto záznamu pomocí Person.Name nebo Person.Address.
Set( Person; Patch( Person; {Address: "2 Main St" } ) )	V součinnosti s funkcí Patch aktualizuje globální proměnnou Person nastavením hodnoty sloupce Address na 2 Main St.	Osoba má nyní hodnotu záznamu { Jméno: "Milton", Adresa: "2 Main St" }.