Sdílet prostřednictvím

Funkce Set

  • Článek

Platí pro: aplikace Canvas Karty Dataverse s minimálním psaním kódu plug-iny Power Platform CLI

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.

Sada nemá žádnou návratovou hodnotu a můžete ji použít pouze v rámci vzorce chování.

Syntaxe

Nastavit( Název proměnné, Hodnota )

  • 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
Sada (počítadlo, 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.
Sada (počítadlo, 2) Nastaví hodnotu globální proměnné Čítač z předchozího příkladu na 2. Počítadlo má hodnotu 2.
Sada (počítadlo, počítadlo + 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( Osoba, Patch( Osoba, {Adresa: "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" }.