Aspose.Cells FOSS for Rust هي مكتبة مفتوحة المصدر للعمل مع جداول Excel XLSX في تطبيقات Rust. توفر للمبرمجين النظاميين طريقة أصلية وآمنة للذاكرة لإنشاء دفاتر عمل من الصفر، وتحميل ملفات XLSX الموجودة، وتعديل محتوياتها، وحفظ النتيجة — دون الحاجة إلى Microsoft Office أو أتمتة COM أو أي بيئة تشغيل خارجية.
الصندوق (crate) يُنمذج شجرة كائنات جدول البيانات بالكامل: Workbook، Worksheet، ومجموعات الخلايا مع محددات قيم ذات نوعية (put_value_string، put_value_i32، put_value_bool، put_value_decimal)، الصيغ مع القيم المخزنة مؤقتًا عبر put_formula_with_cached_value، المخططات (Chart، ChartType)، التنسيق الشرطي (FormatCondition)، التحقق من صحة البيانات (Validation)، المرشحات التلقائية (AutoFilter)، تنسيق الخلايا (CellStyle، Font، Fill، Borders)، إعداد الصفحة (PageSetup)، الصور، الأشكال، التعليقات، الروابط التشعبية، الجداول (ListObject)، المخططات الصغيرة (SparklineGroup)، الأسماء المعرفة، وحماية دفتر العمل/ورقة العمل.
Aspose.Cells FOSS for Rust مرخصة بموجب رخصة MIT وتستهدف إصدار Rust 2021. يتم تثبيتها كاعتماد قياسي في Cargo من مستودع GitHub — راجع دليل التثبيت للحصول على الإدخال الدقيق في Cargo.toml. تُعرض الأخطاء عبر أنواع Result التقليدية (CellsError)، ويقدم تحميل XLSX خيارات إصلاح (LoadOptions) مع تشخيصات منظمة (LoadDiagnostics). لعائلة منتجات المؤسسة، انظر Aspose.Cells — Enterprise Product Family.
Workbook::new أو تحميل ملفات موجودة باستخدام Workbook::load_xlsxadd_worksheet و worksheet ومجموعات أوراق العمل القابلة للتعديلsave و save_xlsx أو save_with_format المحدد للصيغةput_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_timeput_formula_with_cached_valuedisplay_string_value و value_typeget, get_by_index)CellStyle مع Font و Fill و BordersStyleFlagNumberFormatPageSetup (حجم الورق، الاتجاه، الهوامش)FreezePane; التحكم في إظهار الصفوف/الأعمدةChartType في مجموعة مخططات الورقةChart, ChartCollection)Picture والأشكال الرسومية باستخدام ShapeSparklineGroupFormatConditionValidation مع OperatorTypeAutoFilter؛ الجداول المهيكلة عبر ListObjectDefinedName؛ الحماية عبر WorkbookProtection و WorksheetProtectionLoadOptions و LoadDiagnosticsإنشاء مصنف، كتابة قيم بأنواع مختلفة وصيغة مع نتيجة مخزنة مؤقتًا، حفظه كملف XLSX، ثم تحميله مرة أخرى:
use aspose_cells_foss_rust::{CellValue, Workbook};
use std::error::Error;
fn main() -> Result<(), Box<dyn Error>> {
// Create a new workbook (starts with one sheet, "Sheet1").
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")?;
cells.get("B1")?.put_value_i32(123)?;
cells.get("C1")?.put_value_bool(true)?;
cells.get("D1")?.put_value_decimal(12.5)?;
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;
}
workbook.save("hello.xlsx")?;
// Load it back.
let loaded = Workbook::load_xlsx("hello.xlsx")?;
let sheet = loaded.worksheet("Sheet1")?;
let cells = sheet.get_cells();
println!("A1 = {}", cells.get("A1")?.display_string_value());
Ok(())
}
افتح دفاتر العمل بطريقة دفاعية باستخدام أعلام إصلاح LoadOptions وتفحص تشخيصات التحميل المنظمة:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&valid_path, &options)?;
let sheet = loaded.worksheet("Sheet1")?;
let cells = sheet.get_cells();
println!("Saved: {}", valid_path.display());
println!(
"Loaded workbook with {} worksheet(s) and {} diagnostic issue(s).",
loaded.get_worksheets().count(),
loaded.get_load_diagnostics().issues().len()
);
املأ نطاق البيانات، ثم اربط مخططات العمود والخط به:
let mut charts = sheet.get_charts();
charts.add(
ChartType::Column,
"Charts!$B$1:$B$13".to_string(),
0,
4,
18,
8,
)?;
charts.add(
ChartType::Line,
"Charts!$C$1:$C$13".to_string(),
0,
9,
18,
13,
)?;
الحزمة مُصدرة تحت رخصة MIT؛ النص الكامل موجود في المستودع كملف LICENSE.txt.
نعم. تسمح رخصة MIT بالاستخدام التجاري، والتعديل، وإعادة التوزيع، شريطة الحفاظ على إشعار حقوق النشر والرخصة.
أضف aspose-cells-foss-rust إلى ملف Cargo.toml الخاص بك كاعتماد git من مستودع GitHub.
XLSX، مع قراءة وكتابة كاملة في دورة واحدة عبر Workbook::load_xlsx و save. صيغ الجداول الإلكترونية الأخرى غير مدعومة في الإصدار الحالي.
لا. تقوم المكتبة بقراءة وكتابة تنسيق حزمة XLSX مباشرةً — لا يوجد تثبيت لـ Office أو أتمتة COM أو أي بيئة تشغيل خارجية.