Встановити функцію

Застосовується до: додатків Canvas Карток Dataverse плагінів із низьким кодом інтерфейсу Power Platform командного рядка

Установлює значення глобальної змінної.

Зведення

За допомогою функції Set можна задати значення глобальної змінної, яка тимчасово містить частину інформації, наприклад кількість разів, яку користувач натискав кнопку, або результат операції з даними.

Глобальні змінні доступні в рамках всієї програми на всіх екранах. Це найпростіший тип змінних, який відповідає потребам більшості ситуацій. Існують також змінні контексту, які розташовано на одному екрані та в колекціях, які дають змогу змінення рівня рядків в таблицях. Додаткові відомості про ці інші параметри див. в розділі Ознайомлення зі змінними.

Power Apps використовують формули, які автоматично перераховуються, коли користувач взаємодіє з програмою. Усі формули, які залежать від змінної, автоматично оновлюватимуться після її змінення. Проте змінна не оновлюватиметься автоматично, якщо значення формули, що використовується у функції Set, зміниться. Для цього потрібно, щоб розробник програми вручну оновив змінну, яка може бути використаною помилково та важчою для розуміння для інших користувачів. Перш ніж використовувати змінну, перегляньте розділ Ознайомлення зі змінними.

Опис

Глобальні змінні неявно створюються за допомогою функції Set. Явне оголошення не є обов’язковим. Якщо буде видалено всі функції Set для глобальної змінної, ця глобальна змінна перестане існувати. Щоб очистити змінну, встановіть її значенням результат функції Blank.

Значення, визначення та використання змінної можна переглянути в поданні змінних у меню Файл програми Power Apps Studio.

Як показують приклади нижче в цьому розділі, глобальні змінні можуть містити кілька типів інформації, зокрема такі:

• одне значення
• запис
• таблиця
• посилання на об’єкт
• будь-який результат формули

Глобальна змінна міститиме значення даних, доки програму не буде закрито. Після закриття значення глобальної змінної буде втрачено, і його потрібно буде створити повторно, коли програму знов буде завантажено.

Глобальні змінні не можуть використовувати ім’я, яке співпадає з іменем існуючої колекції або елемента керування. Вони можуть використовувати ім’я, що співпадає з іменем змінної контексту. Щоб усунути неоднозначність між ними, використовуйте оператор неоднозначності.

Функція Set не повертає значення, її можна використовувати лише у формулі поведінки.

Синтаксис

Set( Ім’я змінної, Значення )

• VariableName — обов’язковий аргумент. Ім’я глобальної змінної, яку потрібно створити або оновити.
• Value — обов’язковий аргумент. Це значення, яке слід призначити змінній контексту.

Приклади

Формула	Опис	Результат
Set( Counter, 1 )	Створює або змінює глобальну змінну Лічильник і встановлює його значення на 1.	Counter має значення 1. Можна посилатися на цю змінну за допомогою імені Лічильник у формулі на будь-якому екрані.
Set( Counter, 2 )	Установлює значення глобальної змінної Лічильник з попереднього прикладу на 2.	Counter має значення 2.
Set( Counter, Counter + 1 )	Збільшує значення глобальної змінної Лічильник з попереднього прикладу на 3.	Лічильник має значення 3.
Set( Name, "Lily" )	Створює або змінює глобальну змінну Ім’я і встановлює його значення на Лілія.	Ім’я матиме значення Лілія.
Set( Person, { Name: "Milton", Address: "1 Main St" } )	Створює або змінює глобальну змінну Особа і встановлює його значення на запис. Запис містить два стовпці під назвою Name й Address. Значення стовпця Name: Milton, а значення стовпця Address: 1 Main St.	Person матиме значення запису { Name: "Milton", Address: "1 Main St" }. Посилання на цей запис як ціле з іменем Person, або посилання на окремий стовпець цього запису Person.Name або Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	Працює з функцією Patch для оновлення глобальної змінної Особа, встановлюючи для стовпця Адреси значення вул. Головна, 2.	Person тепер матиме значення запису { Name: "Milton", Address: "2 Main St" }.