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

Элемент записывает данные в диапазон ячеек ODF-таблицы. Путь до файла указывается в контейнере «Таблица ODF».

Если в файле требуется сохранить изменения, то дополнительно используйте элемент «Сохранить документ».

Элемент «Запись диапазона»

Свойства

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

1. Диапазон* [String] — диапазон записи ячеек.

2. Всю строку [Boolean] — определяет, нужно ли добавлять строку целиком. По умолчанию не используется. Настройку следует применять, если на странице настроен фильтр.

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

4. Страница [String] — наименование страницы с указанным диапазоном.

5. Индекс страницы [Int32] — порядковый номер страницы. Нумерация начинается с 0. Если заполнен индекс, лист в целевом файле может быть переименован.

6. Создавать лист [Boolean] — создавать лист в случае, если его не существует.

7. Как текст [Boolean] — определяет, следует ли вставлять значение как текст. По умолчанию не используется. Если чекбокс установлен, то свойство «Строгая типизация» нужно выключить.

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

9. Перезаписать [Boolean] — определяет, следует ли перезаписывать данные. По умолчанию не используется.

10. Направление — направление сдвига ячеек. Возможные значения:

    • Down — вниз. Значение по умолчанию.

    • Right — вправо.

11. Расширять диапазон [Boolean] — определяет, следует ли автоматически расширять диапазон до размеров данных. По умолчанию не используется.

12. Переменная (текст) [List<List<string>>] — переменная для хранения данных текстовых значений.

13. Переменная (информация) [List<List<LTools.Office.Model.ExcelCellInfo>>] — переменная для хранения данных, содержащих информацию о ячейках.

14. Переменная (таблица) [System.Data.DataTable] — переменная для хранения данных в виде таблицы.

Только код

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

C#

`Primo.Office.OdfOxml.ExcelApp app = Primo.Office.OdfOxml.ExcelApp.Init(wf, [file]);
app.AppendRange(data, range, [overwrite], [sheet], [sheetIdx], [numFormat], [entireRow]);
app.AppendRange(data_info, range, [overwrite], [sheet], [sheetIdx], [numFormat], [entireRow]);
app.AppendRange(dataTable, range, [overwrite], [sheet], [sheetIdx], [numFormat], [entireRow]);

🔸 Примечание. В языках Python и JavaScript использование элемента на данный момент не реализовано.