Удалить диапазон

Элемент удаляет ячейки диапазона листа книги Excel со сдвигом соседних ячеек вверх или влево — так же, как команда «Удалить ячейки» в Excel. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Чтобы очистить ячейки без сдвига, используйте Очистить диапазон.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

Свойство	Тип	Описание
Параметры:
Лист*	String	Имя листа. По умолчанию `"Sheet1"`
Книга*	DriveItem	Книга Excel. См. Общие свойства элементов
Диапазон*	String	Адрес удаляемого диапазона, например `"A5:F5"` или `"5:5"` для целой строки
Сдвиг	-	Направление сдвига соседних ячеек. Доступные значения: `Up` — вверх, `Left` — влево, `No` — не указывать. По умолчанию `No`

Важно: Явно выбирайте направление сдвига — Up для удаления строк, Left для удаления столбцов.

Практические примеры

Пример 1: удаление строки таблицы

Лист: "Реестр"
Книга: book
Диапазон: rowNumber + ":" + rowNumber
Сдвиг: Up

Пример 2: удаление столбца

Диапазон: "C:C"
Сдвиг: Left

Примечание: При удалении нескольких строк в цикле удаляйте их снизу вверх — иначе после каждого удаления номера оставшихся строк смещаются.

Возможные ошибки

Ошибка	Причина и решение
`Не указана книга` / `Не указан лист`	Не заполнены обязательные свойства
`Sequence contains no elements`	Лист с указанным именем не найден
`InvalidArgument`	Не указан Диапазон, неверный адрес или не задано направление Сдвига