Wie man ein Spreadsheet in Rust lädt

Aspose.Cells FOSS für Rust lädt Excel XLSX-Arbeitsmappen direkt aus dem Paketformat — kein Microsoft Office erforderlich. Diese Anleitung installiert das aspose-cells-foss-rust Crate über Cargo, lädt eine Arbeitsmappe mit Workbook::load_xlsx und verarbeitet unvollständige Dateien mit LoadOptions Reparatur-Flags und LoadDiagnostics.

Schritt-für-Schritt-Anleitung

Schritt 1: Paket installieren

Fügen Sie das Crate zu Ihrem Cargo.toml als Cargo-Git-Abhängigkeit hinzu:

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

Dann das Projekt bauen:

cargo build

Schritt 2: Erforderliche Klassen importieren

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

Schritt 3: Beispieldatei zum Laden erstellen

Falls Sie noch keine Arbeitsmappe auf der Festplatte haben, schreiben Sie zunächst eine:

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

Schritt 4: Arbeitsmappe laden

Workbook::load_xlsx öffnet eine gut formatierte XLSX-Datei:

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

Schritt 5: Defensiv mit Reparaturoptionen laden

Für Dateien von Dritten aktivieren Sie die Reparatur-Flags und prüfen Sie die vom Loader gesammelten Diagnosedaten:

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

Häufige Probleme und Lösungen

Der Ladevorgang gibt einen Fehler zurück für eine Datei, die sich in Excel öffnen lässt. Enable try_repair_package and try_repair_xml in LoadOptions und laden über Workbook::load_xlsx_with_options — Excel toleriert einige Paketirregularitäten, die beim strengen Laden abgelehnt werden.

worksheet("Sheet1") schlägt nach dem Laden fehl. Das Blatt kann einen anderen Namen haben. Auflisten über get_worksheets oder stattdessen per Index über die Arbeitsblatt-Sammlung abrufen.

Werte werden als leere Zeichenketten zurückgelesen. Verwenden Sie display_string_value auf die Zelle für ihren Anzeigetext und prüfen value_type um zu sehen, was tatsächlich gespeichert ist.

Formeln zeigen veraltete Ergebnisse. Der Loader bewahrt die im File gespeicherten zwischengespeicherten Werte; die Neuberechnung ist die Verantwortung des Verbrauchers. Beim Schreiben stets einen korrekten zwischengespeicherten Wert übergeben an put_formula_with_cached_value.

Häufig gestellte Fragen

Welche Formate können geladen werden?

Nur XLSX in der aktuellen Version. Das LoadFormat-Enum deckt Auto und Xlsx ab.

Muss ich Microsoft Office installiert haben?

Nein. Das Crate analysiert das XLSX-Paket direkt; weder Office, COM noch ein externes Laufzeit-Framework sind beteiligt.

Wie erkenne ich, ob der Loader etwas repariert hat?

Lese get_load_diagnostics im geladenen Arbeitsbuch — LoadDiagnostics listet die beim Laden aufgetretenen Probleme auf.