Set функция

Отнася се за: Приложенията за платно настолни потоци CLI функции на Платформата CLI Dataverse

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

Преглед

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

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

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

Описание

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

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

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

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

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

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

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

Синтаксис

Set( VariableName, Value )

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

Примери

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