Quickstart

Quickstart

本页演示核心 Aspose.Cells FOSS for Rust 工作流:创建工作簿、写入带类型的单元格值和公式、保存文件并重新加载。


先决条件

需求详情
已安装 Crate查看 Installation
Rust 工具链2021 版

1. 创建工作簿并写入数值

一个新的 Workbook 会包含一个名为 Sheet1 的工作表。可变访问通过 get_worksheets_mutget_cells_mut 进行;每个单元格都有带类型的设置器:

use aspose_cells_foss_rust::{CellValue, Workbook};
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    let mut workbook = Workbook::new();
    {
        let mut worksheets = workbook.get_worksheets_mut();
        let sheet = worksheets.get(0)?;
        let mut cells = sheet.get_cells_mut();

        cells.get("A1")?.put_value_string("Hello")?;
        cells.get("B1")?.put_value_i32(123)?;
        cells.get("C1")?.put_value_bool(true)?;
        cells.get("D1")?.put_value_decimal(12.5)?;
        cells.get("F1")?.put_value_i32(10)?;
        cells.get("G1")?
            .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;
    }
    workbook.save("hello.xlsx")?;

    let loaded = Workbook::load_xlsx("hello.xlsx")?;
    let sheet = loaded.worksheet("Sheet1")?;
    let cells = sheet.get_cells();
    println!("A1 = {}", cells.get("A1")?.display_string_value());

    Ok(())
}

2. 理解关键调用

  • Workbook::new — 创建一个包含单个工作表的空工作簿。
  • put_value_string / put_value_i32 / put_value_bool / put_value_decimal — 类型单元格设置器。
  • put_formula_with_cached_value — 存储公式以及 Excel 在重新计算前显示的值。
  • Workbook::save — 将 XLSX 包写入磁盘。
  • Workbook::load_xlsx — 加载已有的 XLSX 文件。
  • display_string_value — 读取回值时单元格的显示文本。

3. 运行它

cargo run

程序写入 hello.xlsx,并在重新加载后打印 A1 = Hello


后续步骤

另请参阅

 中文