Aspose.Cells FOSS
Jak načíst tabulku v Rustu

Jak načíst tabulku v Rustu

Aspose.Cells FOSS pro Rust načítá Excel XLSX sešity přímo z formátu balíčku — není potřeba Microsoft Office. Tento návod nainstaluje crate aspose-cells-foss-rust pomocí Cargo, načte sešit pomocí Workbook::load_xlsx a zachází s neúplnými soubory pomocí opravárenských příznaků LoadOptions a LoadDiagnostics.

Průvodce krok za krokem

Krok 1: Nainstalujte balíček

Přidejte crate do svého Cargo.toml jako Cargo git závislost:

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

Pak sestavte projekt:

cargo build

Krok 2: Naimportujte požadované třídy 

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

Krok 3: Vytvořte ukázkový soubor k načtení

Pokud ještě nemáte sešit na disku, nejprve jej vytvořte:

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

Krok 4: Načtěte sešit

Workbook::load_xlsx otevře korektní soubor XLSX:

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

Krok 5: Načtěte obezřetně s možnostmi opravy

U souborů od třetích stran povolte příznaky opravy a prohlédněte si diagnostiku, kterou načítač shromáždil:

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

Běžné problémy a opravy

Volání load vrací chybu pro soubor, který se otevře v Excelu. Enable try_repair_package and try_repair_xml in LoadOptions a načíst pomocí Workbook::load_xlsx_with_options — Excel toleruje některé nepravidelnosti balíčku, které přísné načítání odmítá.

worksheet("Sheet1") selže po načtení. List může mít jiný název. Vyjmenujte pomocí get_worksheets nebo místo toho získat podle indexu přes kolekci listů.

Hodnoty jsou načteny jako prázdné řetězce. Použijte display_string_value v buňce pro její zobrazovaný text a zkontrolujte value_type abyste viděli, co je ve skutečnosti uloženo.

Vzorce zobrazují zastaralé výsledky. Načítací modul zachovává kešované hodnoty uložené v souboru; přepočítání je záležitostí spotřebitele. Při zápisu vždy předávejte správnou kešovanou hodnotu do put_formula_with_cached_value.

Často kladené otázky

Jaké formáty lze načíst?

Pouze XLSX v aktuálním vydání. Výčtový typ LoadFormat zahrnuje Auto a Xlsx.

Potřebuji mít nainstalovaný Microsoft Office?

Ne. Crate přímo parsuje balíček XLSX; není zapotřebí Office, COM ani externí runtime.

Jak zjistím, zda loader něco opravil?

Přečtěte get_load_diagnostics v načteném sešitu — LoadDiagnostics uvádí problémy, které se během načítání vyskytly.

Viz také:

 Čeština