Set функція

Застосовується до: Програми canvas Desktop flows Power Platform CLI Dataverse functions

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

Зведення

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

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

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

Опис

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

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

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

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

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

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

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

Синтаксис

Set( VariableName, Value )

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

Приклади

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