Огляд функцій

Огляд можливостей

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


Якість даних і структура

ValidationOperatorType), 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

Дивіться також

 Українська