Hoe een spreadsheet te laden in Rust

Aspose.Cells FOSS for Rust laadt Excel XLSX-werkboeken rechtstreeks vanuit het pakketformaat — geen Microsoft Office nodig. Deze gids installeert de aspose-cells-foss-rust crate via Cargo, laadt een werkboek met Workbook::load_xlsx, en behandelt onvolmaakte bestanden met LoadOptions reparatie-vlaggen en LoadDiagnostics.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

Voeg de crate toe aan uw Cargo.toml als een Cargo-git-afhankelijkheid:

# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }

Bouw vervolgens het project:

cargo build

Stap 2: Vereiste klassen importeren

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

Stap 3: Maak een voorbeeldbestand om te laden

Als je nog geen werkmap op schijf hebt, maak er dan eerst één:

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("Item")?;
    cells.get("B1")?.put_value_string("Quantity")?;
    cells.get("A2")?.put_value_string("Apples")?;
    cells.get("B2")?.put_value_i32(12)?;
}
workbook.save("inventory.xlsx")?;

Stap 4: Laad de werkmap

Workbook::load_xlsx opent een goed gevormd XLSX-bestand:

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

Stap 5: Laad defensief met reparatie-opties

Voor bestanden van derden, schakel de reparatie-vlaggen in en inspecteer de diagnostiek die de lader heeft verzameld:

let options = LoadOptions {
    try_repair_package: true,
    try_repair_xml: true,
    ..LoadOptions::default()
};

let loaded = Workbook::load_xlsx_with_options("inventory.xlsx", &options)?;
println!(
    "Loaded workbook with {} worksheet(s) and {} diagnostic issue(s).",
    loaded.get_worksheets().count(),
    loaded.get_load_diagnostics().issues().len()
);

Veelvoorkomende problemen en oplossingen

De load-aanroep geeft een fout voor een bestand dat in Excel opent. Enable try_repair_package and try_repair_xml in LoadOptions en laad via Workbook::load_xlsx_with_options — Excel tolereert enkele pakket-irregulariteiten die strikte laden afwijst.

worksheet("Sheet1") faalt na het laden. Het blad kan een andere naam hebben. Enumereren via get_worksheets of haal in plaats daarvan op via index uit de werkbladen-collectie.

Waarden worden teruggelezen als lege tekenreeksen. Gebruik display_string_value op de cel voor de weergavetekst en controleer value_type om te zien wat er daadwerkelijk is opgeslagen.

Formules tonen verouderde resultaten. De loader behoudt de in het bestand opgeslagen cachewaarden; herberekening is de zorg van de consument. Bij het schrijven, geef altijd een correcte cachewaarde door aan put_formula_with_cached_value.

Veelgestelde vragen

Welke formaten kunnen worden geladen?

Alleen XLSX in de huidige release. De LoadFormat enum omvat Auto en Xlsx.

Moet ik Microsoft Office geïnstalleerd hebben?

Nee. De crate parseert het XLSX-pakket direct; er is geen Office, COM of externe runtime bij betrokken.

Hoe weet ik of de loader iets heeft hersteld?

Lees get_load_diagnostics in de geladen werkmap — LoadDiagnostics geeft de tijdens het laden tegengekomen problemen weer.