Funkcja Set

  • Artykuł

Ma zastosowanie do: Aplikacje kanwy Karty Dataverse wtyczki niskokodowe Power Platform CLI

Ustawia wartość zmiennej globalnej.

Omówienie

Za pomocą funkcji Set można ustawić wartość zmiennej globalnej tymczasowo przechowującej informację, taką jak liczba wybrań przycisku przez użytkownika lub wynik operacji danych.

Zmienne globalne są dostępne w całej aplikacji na wszystkich ekranach. To najprostszy rodzaj zmiennych, który sprawdza się w większości sytuacji. Istnieją także zmienne kontekstowe o zakresie ograniczonym do jednego ekranu oraz kolekcje pozwalające na wprowadzanie w tabelach modyfikacji na poziomie wiersza. Aby uzyskać więcej informacji na temat tych innych opcji, przejrzyj Opis zmiennych.

Power Apps są oparte na formułach, które automatycznie dokonują ponownych obliczeń w miarę interakcji użytkownika z aplikacją. Wszystkie formuły zależne od zmiennej będą automatycznie aktualizowane podczas zmiany. Jednak zmienna nie zostanie automatycznie zaktualizowana, jeśli zostanie zmieniona wartość formuły użytej w funkcji Set. Twórca aplikacji musi ręcznie zaktualizować zmienną, co może powodować błędy i utrudnić innym zrozumienie. Przed użyciem zmiennej zapoznaj się z informacjami o Opis zmiennych.

Opis

Zmienne globalne są tworzone niejawnie za pomocą funkcji Set. Nie jest wymagana żadna jawna deklaracja. Po usunięciu wszystkich funkcji Set dla zmiennej globalnej ta zmienna przestanie istnieć. Aby wyczyścić zmienną, ustaw jej wartość na wynik funkcji Blank.

Wartości zmiennych, ich definicje i zastosowania można sprawdzić w widoku Zmienne, który jest dostępny z poziomu menu Plik w Power Apps Studio.

Jak przedstawiono w przykładach w dalszej części tego tematu, zmienne globalne mogą zawierać kilka rodzajów informacji, w tym następujące:

  • pojedyncza wartość
  • rekord
  • tabela
  • odwołanie do obiektu
  • wynik dowolnej formuły

Zmienna globalna przechowuje wartość do momentu zamknięcia aplikacji. Po zamknięciu aplikacji wartość zmiennej globalnej zostanie utracona i musi zostać ponownie utworzona po ponownym załadowaniu aplikacji.

Zmienne globalne nie mogą mieć takiej samej nazwy, jak istniejąca kolekcja lub kontrolka. Mogą natomiast mieć taką samą nazwę, jak zmienna kontekstowa. Aby rozróżnić te zmienne, zastosuj operator uściślania.

Funkcja Set nie zwraca żadnej wartości i można jej używać wyłącznie w formułach zachowań.

Składnia

Set( VariableName, Value )

  • VariableName - wymagane. Nazwa zmiennej globalnej do utworzenia lub zaktualizowania.
  • Wartość – wymagane. Wartość do przypisania zmiennej kontekstowej.

Przykłady

Wzór Opis Wynik
Set( Counter, 1 ) Tworzy lub modyfikuje zmienną globalną Licznik, ustawiając jej wartość na 1. Licznik ma wartość 1. Do tej zmiennej można odwoływać się w formule na dowolnym ekranie przy użyciu nazwy Licznik.
Set( Counter, 2 ) Ustawia wartość zmiennej globalnej Licznik z poprzedniego przykładu na 2. Licznik ma wartość 2.
Set( Counter, Counter + 1 ) Zwiększa wartość zmiennej globalnej Licznik z poprzedniego przykładu na 3. Licznik ma wartość 3.
Set( Name, "Lily" ) Tworzy lub modyfikuje zmienną globalną Imię, ustawiając jej wartość na Lily. Imię ma wartość Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) Tworzy lub modyfikuje zmienną globalną Osoba, ustawiając jej wartość na rekord. Rekord zawiera dwie kolumny o nazwach Imię i Adres. Wartość kolumny Imię to Milton, a wartość kolumny Adres to 1 Main St. Person ma wartośc rekordu { Name: "Milton", Address: "1 Main St" }.

Odwołania można wykonywać względem całego rekordu za pomocą nazwy Osoba lub względem pojedynczej kolumny tego rekordu za pomocą nazwy Person.Name lub Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Współdziała z funkcją Patch, aby zaktualizować zmienną globalną Osoba, ustawiając wartość kolumny Adres na 2 Main St. Person ma teraz wartość rekordu { Name: "Milton", Address: "2 Main St" }.