Функция Set

Применяется к: приложениям Canvas Карточки Dataverse малокодовый плагинам Power Platform CLI

Задает значение глобальной переменной.

Обзор

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

Глобальные переменные доступны во всем приложении и на всех экранах. Это самые простые переменные, которые подойдут для большинства ситуаций. Существуют также переменные контекста, которые применяются к одному экрану, и коллекции, которые позволяют изменять таблицы на уровне строк. Для получения дополнительной информации об этих других параметрах см. раздел Общие сведения о переменных.

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

Описание

Глобальные переменные создаются неявно с помощью функции Set. Явное объявление не требуется. Если для глобальных переменных удалить все функции Set, эти переменные исчезнут. Чтобы очистить переменную, задайте в качестве ее значения результат функции Blank.

Чтобы просмотреть значения, определения и сведения об использовании переменных, перейдите в Power Apps Studio к меню Файл, а затем откройте представление "Переменные".

Как показано далее в примерах, глобальные переменные могут содержать несколько типов данных, в том числе:

• одиночное значение;
• запись;
• таблицу;
• ссылку на объект;
• любой результат формулы.

Значение глобальной переменной хранится, пока приложение не будет закрыто. После закрытия значение глобальной переменной будет потеряно. При следующей загрузке приложения значение нужно будет создать снова.

Имена глобальных переменных не должны совпадать с именами существующей коллекции или элемента управления. Но они могут совпадать с именами переменных контекста. Чтобы устранить неоднозначность между этими переменными, используйте оператор устранения неоднозначности.

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

Синтаксис

Установить( ИмяПеременной, Значение )

• ИмяПеременной - Обязательно. Имя создаваемой или обновляемой глобальной переменной.
• Значение - Обязательно. Значение, присваиваемое переменной контекста.

Примеры

Формула	Описание	Результат
Установить(Счетчик, 1)	Создает или изменяет глобальную переменную Counter, задав для нее значение 1.	Счетчик имеет значение 1. Вы можете добавить ссылку на эту переменную, используя имя Counter в формуле на любом экране.
Набор(Счетчик, 2)	Изменяет значение глобальной переменной Counter из предыдущего примера на 2.	Счетчик имеет значение 2.
Набор(Счетчик, Счетчик + 1)	Увеличивает значение глобальной переменной Counter из предыдущего примера до 3.	Счетчик имеет значение 3.
Набор( Имя, "Лилия")	Создает или изменяет глобальную переменную Name, задав для нее значение Lily.	Имя имеет значение Лилия.
Set( Person, { Имя: "Milton", Адрес: "1 Main St" } )	Создает или изменяет глобальную переменную Person, задавая для нее запись в качестве значения. Запись содержит два столбца: Name и Address. Столбец Name имеет значение Milton, а столбец Address — 1 Main St.	Персона имеет значение записи { Имя: «Милтон», Адрес: «1 Main St» }. Добавьте ссылку на эту запись в целом по имени Person или на ее отдельный столбец с помощью параметра Person.Name или Person.Address.
Set( Person, Patch( Person, {Адрес: "2 Main St" } ) )	В сочетании с функцией Patch обновляет глобальную переменную Person, задав для столбца Address значение 2 Main St.	Персона теперь имеет значение записи { Имя: «Милтон», Адрес: «2 Main St» }.