Добавить диапазон
Элемент добавляет строки из переменной типа DataTable на лист книги Excel сразу под последней заполненной строкой. Для корректной работы следует поместить элемент в контейнер Microsoft 365.
Удобен для ведения журналов и реестров: не требует расчета адреса, куда записывать данные.
Свойства
Описание общих свойств элемента см. в разделе Свойства элемента .
Символ * в названии свойства указывает на обязательность его заполнения.
| Свойство | Тип | Описание |
|---|---|---|
| Параметры: | ||
| Лист* | String | Имя листа. По умолчанию "Sheet1" |
| Книга* | DriveItem | Книга Excel. См. Общие свойства элементов |
| Данные* | DataTable | Добавляемые строки |
Примечание: Строки добавляются начиная со столбца, с которого начинается заполненная область листа. Имена столбцов DataTable не записываются.
Важно: На полностью пустом листе данные будут записаны со второй строки. Чтобы журнал начинался с первой строки, заранее запишите на лист строку заголовков элементом Запись в диапазон или Запись в ячейку.
Практический пример
Добавление записи в журнал обработки
- Сформируйте
DataTablelogRowс одной строкой: дата, номер заявки, статус. - Добавить диапазон:
- Лист:
"Журнал" - Книга:
logBook - Данные:
logRow
- Лист:
Возможные ошибки
| Ошибка | Причина и решение |
|---|---|
Не указаны данные | Не заполнено свойство Данные |
Sequence contains no elements | Лист с указанным именем не найден |
InvalidArgument | DataTable не содержит строк |