Rustでスプレッドシートをロードする方法

Aspose.Cells Rust向けFOSSは、Excel XLSXブックをパッケージ形式から直接読み込みます — Microsoft Officeは不要です。このガイドでは、Cargoを使ってaspose-cells-foss-rustクレートをインストールし、Workbook::load_xlsxでブックを読み込み、LoadOptions修復フラグとLoadDiagnosticsで不完全なファイルを処理します。

ステップバイステップガイド

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

cargo build

use aspose_cells_foss_rust::{LoadOptions, Workbook};
use std::error::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("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")?;

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

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

一般的な問題と対策

ロード呼び出しは、Excelで開くことができるファイルに対してエラーを返します。 Enable try_repair_package and try_repair_xml in LoadOptions そして以下でロード Workbook::load_xlsx_with_options — Excel は、厳密なロードが拒否するいくつかのパッケージの不整合を許容します。

worksheet("Sheet1") ロード後に失敗します。 シートの名前が異なる場合があります。以下で列挙してください get_worksheets または、代わりにワークシートコレクションを介してインデックスで取得します。

読み取った値が空文字列として返されます。 使用してください display_string_value セルの表示テキストに対してチェック value_type 実際に保存されているものを確認するために。

数式が古い結果を表示しています。 ローダーはファイルに保存されたキャッシュ値を保持します；再計算はコンシューマーの責任です。書き込む際は、常に正しいキャッシュ値を渡すように put_formula_with_cached_value.

よくある質問

どのフォーマットをロードできますか？

現在のリリースでは XLSX のみです。LoadFormat 列挙型は Auto と Xlsx をカバーしています。

Microsoft Office をインストールする必要がありますか？

いいえ。このクレートは XLSX パッケージを直接解析します。Office、COM、または外部ランタイムは関与しません。

ローダーが何か修復したかどうかは、どうやって確認できますか？

読み込まれたワークブック上の get_load_diagnostics を確認してください — LoadDiagnostics は読み込み中に発生した問題を一覧表示します。

参照

• Rustでワークブックモデルを作成する方法
• FAQ
• インストールガイド
• Quickstart
• API Reference
• Aspose.Cells — Enterprise Knowledge Base