Hur man laddar ett kalkylblad i Rust

Hur man laddar ett kalkylblad i Rust

Aspose.Cells FOSS för Rust laddar Excel XLSX-arbetsböcker direkt från paketformatet — ingen Microsoft Office krävs. Denna guide installerar aspose-cells-foss-rust-craten via Cargo, laddar en arbetsbok med Workbook::load_xlsx, och hanterar ofullständiga filer med LoadOptions reparationsflaggor och LoadDiagnostics.

Steg-för-steg guide

Steg 1: Installera paketet

Lägg till craten i din Cargo.toml som ett Cargo-git-beroende:

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

Bygg sedan projektet:

cargo build

Steg 2: Importera nödvändiga klasser

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

Steg 3: Skapa en exempelfil att läsa in

Om du ännu inte har en arbetsbok på disken, skriv en först:

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")?;

Steg 4: Ladda arbetsboken

Workbook::load_xlsx öppnar en välformad XLSX-fil:

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());

Steg 5: Ladda defensivt med reparationsalternativ

För filer från tredje part, aktivera reparationsflaggorna och inspektera diagnostiken som laddaren samlade in:

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()
);

Vanliga problem och lösningar

Laddningsanropet returnerar ett fel för en fil som öppnas i Excel. Enable try_repair_package and try_repair_xml in LoadOptions och ladda via Workbook::load_xlsx_with_options — Excel tolererar vissa paketoregelbundenheter som strikt laddning avvisar.

worksheet("Sheet1") misslyckas efter laddning. Arket kan ha ett annat namn. Enumerera via get_worksheets eller hämta efter index via arbetsbladsamlingen istället.

Värden läses tillbaka som tomma strängar. Använd display_string_value på cellen för dess visningstext och kontrollera value_type för att se vad som faktiskt är lagrat.

Formler visar föråldrade resultat. Läsaren bevarar de cachade värdena som lagras i filen; omräkning är konsumentens ansvar. Vid skrivning, skicka alltid ett korrekt cachat värde till put_formula_with_cached_value.

Vanliga frågor

Vilka format kan laddas?

Endast XLSX i den aktuella releasen. LoadFormat-enumerationen täcker Auto och Xlsx.

Behöver jag ha Microsoft Office installerat?

Nej. Craten analyserar XLSX-paketet direkt; ingen Office, COM eller extern runtime är involverad.

Hur vet jag om loadern reparerade något?

Läs get_load_diagnostics på den laddade arbetsboken — LoadDiagnostics listar problemen som påträffades under inläsning.

Se även

 Svenska