Обзор функций
Обзор функций
Эта страница отображает набор возможностей Aspose.Cells FOSS для Rust. Каждая область связывает типы входных точек, с которыми вы встретитесь в API Reference.
Жизненный цикл рабочей книги
Workbook является корневым объектом: Workbook::new создает пустую рабочую книгу, Workbook::load_xlsx открывает существующий файл, а save, save_xlsx или save_with_format записывают вывод XLSX, управляемый перечислением SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;Ячейки, значения и формулы
Коллекции ячеек получаются из get_cells / get_cells_mut на листе. Типизированные сеттеры (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) избегают преобразования строк, а put_formula_with_cached_value хранит формулы вместе с их кэшированными результатами:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Диаграммы
Диаграммы привязываются к диапазонам ячеек через коллекцию диаграмм листа с вариантами ChartType, такими как Column и Line; привязки и типы можно считать обратно из загруженных книг с помощью Chart и ChartCollection.
Оформление и макет
CellStyle объединяет Font, Fill и Borders; StyleFlag выбирает, какие аспекты применяются. NumberFormat отображает значения, PageSetup управляет PaperSizeType и PageOrientationType, а FreezePane фиксирует строки заголовков.
Качество данных и структура
Validation (с OperatorType), FormatCondition условное форматирование, AutoFilter фильтрацию, ListObject структурированные таблицы с TableStyleType, DefinedName именованными диапазонами и WorkbookProtection / WorksheetProtection.
Защищённая загрузка
LoadOptions раскрывает флаги try_repair_package и try_repair_xml; LoadDiagnostics сообщает о проблемах, найденных при загрузке. Ошибки по всему API используют Result с CellsError.
Советы и лучшие практики
- Объём
get_worksheets_mut/get_cells_mutзаимствуется в блоке, чтобы после этого можно было сохранить книгу. - Предпочитайте типизированные сеттеры, а не форматирование значений в строки.
- Всегда предоставляйте кэшированное значение вместе с формулами, чтобы файлы открывались с корректными результатами до пересчёта.
- Используйте флаги восстановления
LoadOptionsпри загрузке сторонних файлов.
API Reference Сводка
| Класс | Описание: |
|---|---|
Workbook | Корневой объект: создание, загрузка и сохранение XLSX-рабочих книг |
Worksheet | Один лист и его ячейки, диаграммы и настройки |
CellMut | Изменяемая ячейка: сеттеры типизированных значений и формул |
CellStyle | Форматирование ячеек с шрифтом, заливкой и границами |
ChartType | Выбор типа диаграммы при добавлении диаграмм |
Validation | Правила проверки данных |
AutoFilter | Фильтрация диапазона |
LoadOptions | Поведение загрузки и флаги восстановления |
CellsError | Тип ошибки, возвращаемый в API |