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

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

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

Зведення

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

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

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

Опис

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

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

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

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

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

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

Набір не має значення, що повертається, і ви можете використовувати його лише у формулі поведінки.

Синтаксис

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

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

Приклади

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