Quickstart

Quickstart

Эта страница пошагово демонстрирует основной рабочий процесс Aspose.Cells FOSS для Rust: создать книгу, записать типизированные значения ячеек и формулу, сохранить файл и загрузить его обратно.


Требования

ТребованиеПодробности
Crate установленСм. Installation
Инструментарий RustИздание 2021

1. Создать книгу и записать значения

Новый Workbook начинается с одного листа, названного Sheet1. Изменяемый доступ осуществляется через get_worksheets_mut и get_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 после повторной загрузки.


Следующие шаги

См. также:

 Русский