Задаване на функция

  • Статия

Отнася се за: Canvas apps Карти Dataverse low-code plug-ins Power Platform CLI

Задава стойността на глобална променлива.

Преглед

Използвайте Set функция за задаване на стойност на глобална променлива, която временно съдържа информация, например колко пъти потребителят е избрал бутон или резултат от операция с данни.

Глобалните променливи са достъпни във вашето приложение на всички екрани. Това са най-простият вид променливи и запълват нуждите на повечето ситуации. Съществуват и променливи на контекста, които са обхванати до един екран и колекции, които позволяват модификации на нивото на редовете в таблиците. За повече информация относно тези други опции, прегледайте Разберете променливите.

Power Apps се основават на формули, които автоматично преизчисляват, докато потребителят взаимодейства с приложение. Всички формули, които зависят от променлива, автоматично ще се актуализират при промяна. Променливата обаче няма да бъде актуализирана автоматично, ако стойността на формулата, използвана в Set функцията се промени. Това изисква производителят на приложения да актуализира ръчно променливата, което може да бъде склонно към грешки и по-трудно за другите. Преди да използвате променлива, прегледайте Разбиране на променливите.

Описание

Глобалните променливи са имплицитно създадени с помощта на Set функция. Не е необходима изрична декларация. Ако премахнете всички Set функции за глобална променлива, тази глобална променлива ще престане да съществува. За изчистване на променлива задайте нейната стойност на резултата от функцията Blank.

Можете да видите стойностите, дефинициите и употребите на променливите си с изгледа Променливи под менюто Файл в Power Apps Studio.

Както показват примерите по-късно в тази тема, глобалните променливи на контекста могат да съдържат няколко вида информация, включително тази:

  • една единствена стойност
  • запис
  • таблица
  • препратка към обект
  • всеки резултат от формула

Глобалната променлива държи стойността си, докато приложението не се затвори. След като се затвори, стойността на глобалната променлива ще бъде загубена и трябва да бъде пресъздадена, когато приложението се зареди отново.

Глобалните променливи не могат да използват същото име като съществуваща колекция или контрол. Той може да използва същото име като контекстна променлива. За да разграничите двете, използвайте оператор за разграничаване.

Set няма възвратна стойност и можете да го използвате само в рамките на формула на поведение.

Синтаксис

Set( VariableName, Value )

  • VariableName - Задължително. Името на глобалната променлива за създаване или актуализиране.
  • Value – Задължително. Стойността, която се присвоява на контекстната променлива.

Примери

Формула Описание Резултат
Set( Counter, 1 ) Създава или променя глобална променливата Counter, задавайки стойността й на 1. Counter има стойността 1. Можете да се позовавате на тази променлива, като използвате името Counter във формула на всеки екран.
Set( Counter, 2 ) Задава стойността на Counter глобална променлива от предишния пример до 2. Counter има стойността 2.
Set( Counter, Counter + 1 ) Увеличава стойността на Counter глобална променлива от предишния пример до 3. Counter има стойността 3.
Set( Name, "Lily" ) Създава или променя глобална променливата Име, задавайки стойността й на Лили. Име има стойността Лили.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) Създава или променя глобалната променлива Person, задавайки стойността си на запис. Записът съдържа две колони, наречени име и адрес. Стойността на име колоната е Милтън, и стойността на адрес колоната е 1 Main St. Person има стойност на запис { Name: "Milton", Address: "1 Main St" }.

Посочете този запис като цяло с името Person или се позовавайте на отделна колона от този запис Person.Name или Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Работи с Patch функция за актуализиране на Person глобална променлива чрез задаване на стойността на адрес колона на 2 Main St. Person вече има стойност на запис { Name: "Milton", Address: "2 Main St" }.