نظرة عامة على الميزات

نظرة عامة على الميزات

هذه الصفحة تُظهر سطح الميزات لـ Aspose.Cells FOSS للـ Rust. كل منطقة تربط أنواع نقطة الدخول التي ستقابلها في الـ API Reference.

دورة حياة دفتر العمل

Workbook هو الكائن الجذر: Workbook::new ينشئ دفتر عمل فارغ، Workbook::load_xlsx يفتح ملفًا موجودًا، وsave أو save_xlsx أو save_with_format يكتبون مخرجات XLSX تحت سيطرة تعداد SaveFormat.

let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;

الخلايا، القيم، والصيغ

تأتي مجموعات الخلايا من get_cells / get_cells_mut في ورقة العمل. تجنب الضوابط ذات النوع (put_value_string، put_value_i32، put_value_bool، put_value_decimal، put_value_date_time) تحويل السلاسل، وput_formula_with_cached_value يخزن الصيغ مع نتائجها المخزنة مؤقتًا:

cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
    .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;

الرسوم البيانية

الرسوم البيانية تثبت إلى نطاقات الخلايا عبر مجموعة رسوم الورقة مع متغيّرات ChartType مثل Column وLine؛ يمكن قراءة التثبيتات والأنواع من المصنفات المحملة عبر Chart وChartCollection.

التنسيق والتخطيط

CellStyle يجمع بين Font وFill وBorders؛ StyleFlag يحدّد أي الجوانب تُطبّق. NumberFormat يعرض القيم، PageSetup يتحكم في PaperSizeType وPageOrientationType، وFreezePane يثبّت صفوف العناوين.

جودة البيانات والبنية

Validation (مع OperatorType)، FormatCondition تنسيق شرطي، AutoFilter تصفية، ListObject جداول مُنظمة مع TableStyleType، DefinedName نطاقات مسماة، وWorkbookProtection / WorksheetProtection.

التحميل الوقائي

LoadOptions يكشف عن أعلام try_repair_package وtry_repair_xml؛ LoadDiagnostics يرفع تقارير عن المشكلات التي تم العثور عليها أثناء التحميل. الأخطاء عبر سطح API تستخدم Result مع CellsError.

نصائح وأفضل الممارسات

• النطاق get_worksheets_mut / get_cells_mut يستعير في كتلة حتى يمكن حفظ دفتر العمل لاحقًا.
• يفضَّل استخدام الضوابط المكتوبة بنوع محدد بدلاً من تنسيق القيم إلى سلاسل نصية.
• قم دائمًا بتوفير قيمة مخزنة مؤقتًا مع الصيغ حتى تُفتح الملفات بالنتائج الصحيحة قبل إعادة الحساب.
• استخدم أعلام الإصلاح LoadOptions عند استيراد ملفات الطرف الثالث.

API Reference ملخص

انظر أيضاً

• Aspose.Cells — Enterprise Documentation