Удаляют записи из источника данных.

Описание

Функция Remove

С помощью функции Remove можно удалить из источника данных определенную запись или набор записей.

Для коллекций должна совпадать вся запись. Удалить все копии записи можно с помощью аргумента All; в противном случае удаляется только одна копия.

Функция RemoveIf

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

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

Кроме того, удалить все записи из источника данных можно с помощью функции Clear.

Делегирование

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

Синтаксис

Remove(источник_данных, запись_1[, запись_2, ... ] [, All])

  • *источник_данных* — обязательный аргумент. Это источник данных, содержащий запись или записи, которые требуется удалить.

  • *запись(_n)* — обязательный аргумент. Запись или записи, которые требуется удалить.

  • All — необязательный аргумент. В коллекции может существовать несколько копий одной записи. С помощью аргумента All можно удалить их все.

Remove(источник_данных, таблица[, All])

  • *источник_данных* — обязательный аргумент. Это источник данных, содержащий записи, которые требуется удалить.

  • *таблица* — обязательный аргумент. Таблица с записями, которые требуется удалить.

  • All — необязательный аргумент. В коллекции может существовать несколько копий одной записи. С помощью аргумента All можно удалить их все.

RemoveIf(источник_данных, условие[, ... ])

  • *источник_данных* — обязательный аргумент. Это источник данных, содержащий запись или записи, которые требуется удалить.

  • условие(_n)* — обязательный аргумент. Формула, возвращающая значение true (истина) для записи или записей, которые требуется удалить. В формуле можно использовать названия столбцов из *источника_данных. Если указано несколько условий, для удаления соответствующей записи все они должны возвращать значение true.

Примеры

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

Формула Описание Возвращаемый результат
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ))
Удаляет из источника данных запись Chocolate.

Источник данных IceCream изменен.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ))
Удаляет из источника данных две записи.

Источник данных IceCream изменен.
RemoveIf( IceCream, Quantity > 150) Удаляет записи со значением Quantity больше 150.

Источник данных IceCream изменен.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S") Удаляет записи со значением Quantity больше 150 и значением Flavor, начинающимся с буквы S.


Источник данных IceCream изменен.
RemoveIf( IceCream, true) Удаляет из источника данных все записи.

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

Шаг за шагом

  1. Импортируйте или создайте коллекцию под названием Inventory и отобразите ее в коллекции, как описано в этой статье.

  2. В коллекции задайте для свойства OnSelect изображения следующее выражение:
    Remove(Inventory, ThisItem)

  3. Нажмите клавишу F5 и выберите изображение в коллекции.
    Элемент будет удален из галереи и из коллекции.