Skip to Content
Элементы в StudioДополнительные для Windows (NuGet)Primo.Office.OdfOxmlODF — ТаблицыЗапись диапазона

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

Элемент записывает данные в диапазон ячеек 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 использование элемента на данный момент не реализовано.

Переименовать страницуТаблица ODF