Cara Memuat Spreadsheet di Rust

Aspose.Cells FOSS untuk Rust memuat buku kerja Excel XLSX langsung dari format paket — tidak memerlukan Microsoft Office. Panduan ini menginstal crate aspose-cells-foss-rust melalui Cargo, memuat buku kerja dengan Workbook::load_xlsx, dan menangani file yang tidak sempurna dengan flag perbaikan LoadOptions dan LoadDiagnostics.

Panduan Langkah-demi-Langkah

Langkah 1: Instal Paket

Tambahkan crate ke Cargo.toml Anda sebagai dependensi git Cargo:

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

Kemudian bangun proyek:

cargo build

Langkah 2: Impor Kelas yang Diperlukan

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

Langkah 3: Buat File Contoh untuk Dimuat

Jika Anda belum memiliki workbook di disk, buat satu terlebih dahulu:

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

Langkah 4: Muat Workbook

Workbook::load_xlsx membuka file XLSX yang terbentuk dengan baik:

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

Langkah 5: Muat Secara Defensif dengan Opsi Perbaikan

Untuk file dari pihak ketiga, aktifkan flag perbaikan dan periksa diagnostik yang dikumpulkan oleh pemuat:

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

Masalah Umum dan Solusi

Pemanggilan load mengembalikan error untuk file yang dapat dibuka di Excel. Enable try_repair_package and try_repair_xml in LoadOptions dan load via Workbook::load_xlsx_with_options — Excel mentolerir beberapa ketidakteraturan paket yang ditolak oleh pemuatan ketat.

worksheet("Sheet1") gagal setelah dimuat. Lembar mungkin memiliki nama yang berbeda. Enumerasi melalui get_worksheets atau ambil berdasarkan indeks melalui koleksi worksheet sebagai gantinya.

Nilai yang dibaca kembali sebagai string kosong. Gunakan display_string_value pada sel untuk teks tampilan dan periksa value_type untuk melihat apa yang sebenarnya disimpan.

Formula menampilkan hasil yang usang. Loader mempertahankan nilai cache yang disimpan dalam file; perhitungan ulang adalah urusan konsumen. Saat menulis, selalu berikan nilai cache yang benar kepada put_formula_with_cached_value.

Pertanyaan yang Sering Diajukan

Format apa saja yang dapat dimuat?

Hanya XLSX dalam rilis saat ini. Enum LoadFormat mencakup Auto dan Xlsx.

Apakah saya perlu menginstal Microsoft Office?

Tidak. Crate mem-parsing paket XLSX secara langsung; tidak ada Office, COM, atau runtime eksternal yang terlibat.

Bagaimana saya tahu apakah loader memperbaiki apa pun?

Baca get_load_diagnostics pada workbook yang dimuat — LoadDiagnostics mencantumkan masalah yang ditemui selama pemuatan.