Quickstart

Quickstart

Esta página apresenta o fluxo de trabalho central Aspose.Cells FOSS para Rust: criar uma pasta de trabalho, escrever valores de célula tipados e uma fórmula, salvar o arquivo e carregá-lo novamente.


Pré-requisitos

RequisitoDetalhe
Crate instaladoVer Installation
Cadeia de ferramentas RustEdição 2021

1. Criar uma Pasta de Trabalho e Escrever Valores

Um novo Workbook começa com uma planilha chamada Sheet1. O acesso mutável flui através de get_worksheets_mut e get_cells_mut; cada célula possui setters tipados:

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. Entender as Chamadas Principais

  • Workbook::new — cria uma pasta de trabalho vazia com uma planilha.
  • put_value_string / put_value_i32 / put_value_bool / put_value_decimal — definidores de célula tipados.
  • put_formula_with_cached_value — armazena a fórmula e o valor que o Excel exibe antes da recalculação.
  • Workbook::save — grava o pacote XLSX no disco.
  • Workbook::load_xlsx — carrega um arquivo XLSX existente.
  • display_string_value — o texto exibido da célula ao ler os valores de volta.

3. Execute

cargo run

O programa grava hello.xlsx e imprime A1 = Hello após recarregá-lo.


Próximas etapas

Ver também

 Português