سوالات متداول
مجوزدهی و منبع باز
مجوز Aspose.Cells FOSS برای Rust چیست؟
این crate تحت مجوز MIT منتشر شده است. متن کامل آن در مخزن به عنوان LICENSE.txt موجود است.
آیا میتوانم از آن در محصولات تجاری استفاده کنم؟
بله. مجوز MIT اجازه استفاده تجاری، تغییر و توزیع مجدد را میدهد. تنها شرط این است که اطلاعیه حق کپیرایت و مجوز را در نسخهها یا بخشهای قابل توجه نرمافزار حفظ کنید.
نصب و پیش‌نیازها
چگونه میتوانم crate را نصب کنم؟
aspose-cells-foss-rust را به Cargo.toml خود به عنوان یک وابستگی گیت اضافه کنید:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }مشاهده کنید راهنمای نصب برای یک راهنمای گامبهگام.
کدام نسخههای Rust پشتیبانی میشوند؟
این crate برای نسخهٔ Rust edition 2021 هدفگذاری شده است.
آیا به Microsoft Office یا کتابخانههای بومی نیاز دارد؟
خیر. این کتابخانه مستقیماً فرمت بستهٔ XLSX را میخواند و مینویسد — بدون نصب Microsoft Office، خودکارسازی COM یا زماناجرای خارجی.
پشتیبانی از فرمتها
کدام فرمتها میتوانند خوانده و نوشته شوند؟
XLSX فرمت پشتیبانیشده در نسخهٔ فعلی است: خواندن و نوشتن کامل دوری. بارگذاری از طریق Workbook::load_xlsx انجام میشود (enum LoadFormat شامل Auto و Xlsx است) و ذخیرهسازی از طریق save، save_xlsx یا save_with_format با enum SaveFormat انجام میشود.
آیا میتواند فایلهای XLSX آسیبدیده را تعمیر کند؟
LoadOptions پرچمهای try_repair_package و try_repair_xml را افشا میکند، و LoadDiagnostics مشکلاتی را که در حین بارگذاری رخ داده است گزارش میدهد:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
الگوی معمول برای ایجاد یک کتابکار چیست؟
یک Workbook ایجاد کنید، حوزهٔ وامهای قابل تغییر را مشخص کنید، مقادیر را بنویسید، سپس ذخیره کنید:
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("Hello")?;
}
workbook.save("hello.xlsx")?;چگونه میتوان انواع مختلف مقدار را در سلولها نوشت؟
از تنظیمکنندههای تایپشده بر روی یک سلول قابل تغییر استفاده کنید: put_value_string, put_value_i32, put_value_bool, put_value_decimal, و put_value_date_time.
چگونه میتوانم فرمولی بنویسم؟
از put_formula_with_cached_value استفاده کنید و مقداری که اکسل باید پیش از اولین بازمحاسبهاش نمایش دهد، تأمین کنید:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;چگونه میتوانم مقادیر را از یک کتابکار بارگذاری‌شده بخوانم؟
برگه را با worksheet (یا مجموعهٔ شیت‌ها) دریافت کنید، سپس سلولها را از طریق get_cells بخوانید؛ display_string_value متن نمایش داده‌شده را برمی‌گرداند و value_type نوع ذخیره‌شده را گزارش میدهد.
محدودیت‌های شناخته‌شده
آیا این crate در crates.io موجود است؟
هنوز — آن را به‌عنوان یک وابستگی گیت Cargo از مخزن GitHub نصب کنید. Cargo کامیت دقیق را در Cargo.lock ثبت میکند، بنابراین ساخت‌ها قابل تکرار می‌مانند.
آیا فرمت‌های دیگری به‌جز XLSX پشتیبانی میشوند؟
خیر. نسخه فعلی بر پردازش دوطرفه XLSX متمرکز است؛ سایر فرمت‌های صفحه‌گسترده خوانده یا نوشته نمی‌شوند.
