LightCellsDataProvider класс
LightCellsDataProvider класс
Представляет поставщика данных для сохранения больших файлов электронных таблиц в облегченном режиме.
Тип LightCellsDataProvider предоставляет следующие элементы:
Методы
Метод | Описание |
---|---|
start_sheet | Начинает сохранять лист. |
next_row | Получает следующую сохраняемую строку. |
start_row | Начинает сохранять данные одной строки. |
next_cell | Получает следующую ячейку для сохранения. |
start_cell | Начинает сохранять данные одной ячейки. |
is_gather_string | Проверяет, нужно ли собирать текущее строковое значение ячейки в глобальный пул. |
Примечания
При сохранении книги в этом режиме LightCellsDataProvider.start_sheet
будет проверяться при сохранении каждого листа в книге.
Для одного листа, если LightCellsDataProvider.start_sheet
дает true, то все данные и свойства сохраняются для строк/ячейок этого листа.
будет обеспечена реализацией этого интерфейса.
В первую очередь будет вызван LightCellsDataProvider.next_row
, чтобы получить индекс следующей строки, который нужно сохранить.
Если возвращается действительный индекс строки (индекс строки должен быть в порядке возрастания, чтобы строки могли быть сохранены),
тогда объект Row, представляющий эту строку, будет предоставлен LightCellsDataProvider.start_row
для реализации, чтобы установить его свойства.
Для одной строки в первую очередь будет проверяться LightCellsDataProvider.next_cell
.
Если возвращен действительный индекс столбца (индекс столбца должен быть в порядке возрастания для всех ячеек текущей строки),
тогда объект Cell, представляющий эту ячейку, будет предоставлен LightCellsDataProvider.start_cell
для реализации для установки ее данных и свойств.
После LightCellsDataProvider.start_cell
ячейка будет сохранена непосредственно в результирующий файл электронной таблицы.
Затем будет проверена и обработана следующая ячейка.
Обратите внимание: пользователю следует обновлять значения и свойства только для текущего объекта Row/Cell, предоставленного соответствующим методом. Поскольку данные ячеек записываются в результирующий файл в потоковом режиме, большинство других объектов могли быть записаны в результирующий файл или были собраны и записаны для них некоторые глобальные данные. Поэтому, когда пользователь обновляет другие объекты при сохранении данных ячеек эти операции могут не повлиять на сохраненные данные. Или, что еще хуже, эти операции могут привести к сохранению противоречивых данных в результирующем файле и, в конечном итоге, к повреждению файла. Итак, для всех других объектов, таких как фигуры, ширина и стили столбцов, условное форматирование и т. д., пожалуйста, не используйте их ни в каких методах этой реализации. Вместо этого управляйте ими и приведите их в окончательное состояние перед вызовом метода «Сохранить» в рабочей книге.
Смотрите также
- модуль
aspose.cells