Огляд функцій
Огляд можливостей
Ця сторінка відображає функціональну поверхню 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 |