Функция Set

  • Статья

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

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

Обзор

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

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

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

Описание

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

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

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

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

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

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

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

Синтаксис

Set( VariableName, Value )

  • VariableName — обязательный аргумент. Имя создаваемой или обновляемой глобальной переменной.
  • Value — обязательный аргумент. Значение, присваиваемое переменной контекста.

Примеры

Формула Описание Результат
Set( Counter, 1 ) Создает или изменяет глобальную переменную Counter, задав для нее значение 1. Переменная контекста Counter имеет значение 1. Вы можете добавить ссылку на эту переменную, используя имя Counter в формуле на любом экране.
Set( Counter, 2 ) Изменяет значение глобальной переменной Counter из предыдущего примера на 2. Переменная контекста Counter имеет значение 2.
Set( Counter, Counter + 1 ) Увеличивает значение глобальной переменной Counter из предыдущего примера до 3. Переменная контекста Counter имеет значение 3.
Set( Name, "Lily" ) Создает или изменяет глобальную переменную Name, задав для нее значение Lily. Глобальная переменная Name имеет значение Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) Создает или изменяет глобальную переменную Person, задавая для нее запись в качестве значения. Запись содержит два столбца: 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 обновляет глобальную переменную Person, задав для столбца Address значение 2 Main St. Переменной Person теперь присваивается значение записи { Name:"Milton", Address:"2MainSt" }.