Funkce Set

  • Článek

Platí pro: aplikaci plátna karty moduly plug-in Dataverse s minimem kódu rozhraní příkazového řádku Power Platform

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

Přehled

Funkce Set umožňuje nastavit hodnotu globální proměnné, ve které se dočasně uchovává určitý údaj, například počet, kolikrát uživatel vybral nějaké 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á však nebude automaticky aktualizována, pokud se hodnota vzorce použitého ve funkci Set změní. 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í funkce Set. Nevyžaduje se žádná explicitní deklarace. Pokud u globální proměnné odeberete všechny funkce Set, přestane tato globální proměnná 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.

Funkce Set nemá žádnou návratovou hodnotu a můžete ji použít jenom ve vzorcích chování.

Syntaxe

Set( NázevProměnné; Hodnota )

  • NázevPromě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( Counter, 1 ) Vytvoří nebo změní globální proměnnou Čítač a nastaví její hodnotu na 1. Proměnná Čítač má hodnotu 1. Na tuto proměnnou můžete odkázat pomocí názvu Čítač ve vzorci na libovolné obrazovce.
Set( Counter, 2 ) Nastaví hodnotu globální proměnné Čítač z předchozího příkladu na 2. Proměnná Čítač má hodnotu 2.
Set( Counter, Counter + 1 ) Inkrementuje hodnotu globální proměnné Čítač z předchozího příkladu na 3. Proměnná Čítač má hodnotu 3.
Set( Name, "Lily" ) Vytvoří nebo změní globální proměnnou Name a nastaví její hodnotu na Lily. Name má hodnotu Lily.
Set( Person, { Name: "Milton", Address: "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. Person má hodnotu záznamu { Name: "Milton", Address: "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. Person teď má hodnotu záznamu { Name: "Milton", Address: "2 Main St" }.