Создание и удаление коллекций и добавление записей в любом источнике данных.

Описание

Collect

Функция Collect добавляет записи в источнике данных. Возможно добавление следующих элементов:

  • Одно значение: значение помещается в поле Value новой записи. Поля всех остальных свойств остаются пустыми.

  • Запись: каждое именованное свойство помещается в соответствующее свойство новой записи. Поля всех остальных свойств остаются пустыми.

  • Таблица: каждая запись таблицы добавляется в виде отдельной записи в источнике данных, как описано выше. Таблица не добавляется в запись в виде вложенной таблицы. Для выполнения этой задачи сначала перенесите таблицу в запись.

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

Если источник данных еще не существует, создается коллекция.

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

Можно также использовать функцию Patch для создания записей в источнике данных.

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

Clear

Функция Clear удаляет все записи из коллекции. Столбцы в коллекции остаются.

Обратите внимание, что функция Clear работает только с коллекциями и не работает с источниками данных другого типа. Для этой цели можно использовать формулу RemoveIf( DataSource, true ). Будьте осторожны, так как это приведет к удалению всех записей из хранилища источника данных и может повлиять на других пользователей.

Можно использовать функцию Remove для выборочного удаления записей.

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

ClearCollect

Функция ClearCollect удаляет все записи из коллекции, а затем добавляет в эту же коллекцию другой набор записей. Функция ClearCollect сочетает в себе возможности функций Clear и Collect.

Функция ClearCollect возвращает измененную коллекцию в виде таблицы. Функцию ClearCollect можно использовать только в формуле поведения.

Синтаксис

Collect( DataSource, Item, ... )

  • *DataSource* — обязательный аргумент. Это источник данных, в который необходимо добавить данные. Если он еще не существует, создается новая коллекция.
  • *Item(s)* — обязательный аргумент. Одна или несколько записей или таблиц, которые необходимо добавить в источник данных.

Clear( Collection )

  • *Collection* — обязательный аргумент. Коллекция, которую необходимо очистить.

ClearCollect( Collection, Item, ... )

  • *Collection* — обязательный аргумент. Коллекция, которую необходимо очистить, а затем добавить в нее данные.
  • *Item(s)* — обязательный аргумент. Одна или несколько записей или таблиц, которые необходимо добавить в источник данных.

Примеры

Удаление и добавление записей в источнике данных

В этих примерах показано удаление и добавление данных в коллекции под названием IceCream. В источнике данных содержится следующее:

Формула Описание Возвращаемый результат
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Выполняется удаление всех данных из коллекции IceCream и добавляется запись, в которой указано количестве клубничного мороженого.

Источник данных IceCream также был изменен.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Выполняется добавление двух записей в коллекцию IceCream, в которой указано количество фисташкового и апельсинового мороженого.

Источник данных IceCream также был изменен.
Clear( IceCream ) Выполняется удаление всех записей из коллекции IceCream.

Источник данных IceCream также был изменен.

Шаг за шагом

  1. Добавьте кнопку и задайте свойство OnSelect для этой функции:
    Collect(Products, "Europa", "Ganymede", "Callisto")

    Эта функция создает коллекцию с именем Products, которая содержит по одной строке для каждого из трех наименований продукта.

  2. Нажмите клавишу F5, затем нажмите кнопку и после этого нажмите клавишу ESC, чтобы вернуться в рабочую область конструирования.

  3. (Необязательно.) Чтобы отобразить предварительный просмотр созданной коллекции, нажмите кнопку Коллекции на вкладке Содержимое.