كيفية تحميل جدول بيانات في Rust

Aspose.Cells FOSS لـ Rust يحمّل دفاتر عمل Excel XLSX مباشرةً من تنسيق الحزمة — لا حاجة إلى Microsoft Office. يثبّت هذا الدليل الحزمة aspose-cells-foss-rust عبر Cargo، ويحمل دفتر عمل باستخدام 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؟

لا. الـ crate يحلل حزمة XLSX مباشرةً؛ لا يوجد Office أو COM أو أي بيئة تشغيل خارجية.

كيف أعرف ما إذا كان المُحمِّل قد أصلح شيئًا؟

اقرأ get_load_diagnostics على المصنف المحمَّل — LoadDiagnostics يسرد المشكلات التي تم مواجهتها أثناء التحميل.

انظر أيضاً

• كيفية إنشاء نموذج دفتر عمل في Rust
• FAQ
• دليل التثبيت
• Quickstart
• API Reference
• Aspose.Cells — Enterprise Knowledge Base