Set функция

Применимо к: Функции Power Platform CLI Dataverse для классических приложений на основе холста

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

Обзор

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

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

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

Описание

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

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

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

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

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

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

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

Синтаксис

Set( VariableName, Value )

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

Примеры

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