Aspose.Cells FOSS
功能概述

功能概述

功能概览

此页面映射了 Aspose.Cells FOSS 在 Rust 中的功能表面。每个区域链接您将在其中遇到的入口类型 API Reference.

工作簿生命周期

Workbook 是根对象：Workbook::new 创建一个空工作簿，Workbook::load_xlsx 打开已有文件，而 save、save_xlsx 或 save_with_format 根据 SaveFormat 枚举写入 XLSX 输出。

let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;

单元格、数值与公式

单元格集合来自工作表上的 get_cells / get_cells_mut。类型化的 setter（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。

技巧与最佳实践

  • Scope get_worksheets_mut / get_cells_mut 在一个块中借用，以便随后能够保存工作簿。
  • 更倾向于使用带类型的 setter，而不是将数值格式化为字符串。
  • 始终提供带公式的缓存值，以便文件在重新计算之前打开时显示正确的结果。
  • 在导入第三方文件时使用 LoadOptions 修复标志。

API Reference 摘要

类描述
Workbook根对象：创建、加载和保存 XLSX 工作簿
Worksheet单个工作表及其单元格、图表和设置
CellMut可变单元格：类型化值和公式设置器
CellStyle单元格格式设置（包括字体、填充和边框）
ChartType添加图表时的图表类型选择
Validation数据验证规则
AutoFilter范围过滤
LoadOptions加载行为和修复标志
CellsError在 API 中返回的错误类型

另请参阅

 中文