Запись диапазона

Append range

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

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

Свойства

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

СвойствоТипОписаниеПример

Excel:

Диапазон*

String

Диапазон ячеек для записи данных

"A1:D12"

Страница

String

Наименование страницы Excel. Если указан индекс страницы, то название можно не заполнять

"List1"

Индекс страницы

Int32

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

0

Создавать лист

Boolean

Определяет, нужно ли создавать лист в случае, если его не существует. По умолчанию отключено — лист не создается

Всю строку

Boolean

Определяет, нужно ли добавлять строку целиком. По умолчанию отключено. Свойство рекомендуется применять, если на странице Excel настроен фильтр

Добавлять заголовки

Boolean

Определяет, нужно ли добавлять заголовки колонок. По умолчанию отлючено — заголовки не записываются в таблицу

Строгая типизация

Boolean

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

Как текст

Boolean

Определяет, нужно ли вставлять значение как текст. По умолчанию отключено.

Перезаписать

Boolean

Определяет, нужно ли перезаписывать данные. По умолчанию свойство отключено — перезапись не разрешается

Направление

Направление сдвига ячеек. Возможные значения: 1) Down — по умолчанию; 2) Right

Down

Расширять диапазон

Boolean

Определяет, нужно ли автоматически расширять диапазон до размеров данных. По умолчанию отключено — диапазон не расширяется

Числовой формат

String

Формат вводимого числа

#,#

Переменная (таблица)

Название переменной для записи табличных данных

Переменная (текст)

List<List<string>>

Название переменной для записи текстовых данных

Переменная (информация)

Название переменной для записи данных, содержащих информацию о ячейках

Пример использования

RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning.

  1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.

  2. Распакуйте архив и откройте в Студии проект WorkWithExcelExamples.

Только код

Ниже приведен пример использования элемента в процессе с типом Только код (Pure code):

LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX);
app.AppendRange(new List<List<string>>(), "A1:B2", true, "Лист1", 0);
app.AppendRange(new List<List<LTools.Office.Model.ExcelCellInfo>>(), "A1:B2", true, null, 0);
app.AppendRange(new System.Data.DataTable(), "A1:B2", true, "Лист1");

Last updated