استخدام الصيغ أو الوظائف لمعالجة البيانات
استخدام الصيغ والوظائف
توفر Aspose.Cells فئةً، Workbook، التي تمثل ملف Microsoft Excel. تحتوي الفئة Workbook على مجموعة Worksheets التي تسمح بالوصول إلى كل ورقة عمل في ملف Excel. يُمثل ورقة عمل كائن الفئة Worksheet. يوفر الفئة Worksheet مجموعة Cells. كل عنصر في مجموعة Cells يمثل كائنًا من الفئة Cell.
من الممكن تطبيق الصيغ على الخلايا باستخدام الخصائص والأساليب التي تقدمها الفئة Cell، كما سيتم مناقشته بالتفصيل أدناه.
استخدام الوظائف المضمّنة
تُوفّر الوظائف المضمّنة أو الصيغ كوظائف جاهزة لتقليل جهود ووقت المطوّرين. انظر قائمة بالوظائف المضمّنة. تُسرد الوظائف بترتيب أبجدي. ستُدعم المزيد من الوظائف في المستقبل.
تدعم Aspose.Cells معظم الصيغ أو الوظائف التي توفّرها Microsoft Excel. يمكن للمطوّرين استخدام هذه الصيغ من خلال واجهة البرمجة التطبيقية أو جدول البيانات التصميمي. تدعم Aspose.Cells مجموعة هائلة من الصيغ الرياضية والنصية والبولية والتاريخ والوقت، الإحصائية، قواعد البيانات، البحث، والمراجع.
استخدم خاصية Formula للفئة Cell لإضافة صيغة إلى خلية. الصيغ المعقدة، على سبيل المثال
= H7*(1+IF(P7 = $L$3,$M$3, (IF(P7=$L$4,$M$4,0)))), مدعومة أيضًا في Aspose.Cells. عند تطبيق صيغة على خلية، يجب دائمًا بدء السلسلة بعلامة يساوي (=) كما تفعل عند إنشاء صيغة في Microsoft Excel واستخدام فاصلة (,) لفصل معلمات الوظيفة.
في المثال أدناه، يتم تطبيق صيغة معقدة على الخلية الأولى في مجموعة Cells لورقة العمل. تستخدم الصيغة وظيفة IF المضمّنة المقدّمة بواسطة Aspose.Cells.
استخدام الوظائف الإضافية
يمكن أن يحتوي على بعض الصيغ التي يعرفها المستخدم ونريد تضمينها كإضافة إكسل. عند ضبط Cell.Formula تعمل الوظائف المضمنة بشكل جيد ومع ذلك يوجد حاجة لضبط الوظائف أو الصيغ المخصصة باستخدام وظائف الإضافة.
توفر Aspose.Cells ميزات لتسجيل وظائف الوظيفة الإضافية باستخدام Worksheets.RegisterAddInFunction(). بعد ذلك عندما نقوم بتعيين Cell.Formula = anyFunctionFromAddIn ، يحتوي ملف Excel الناتج على القيمة المحسوبة من وظيفة الإضافة.
سيتم تنزيل ملف XLAM لتسجيل وظيفة الإضافة في رمز العينة أدناه. بالمثل، يمكن تنزيل ملف الإخراج “test_udf.xlsx” للتحقق من الإخراج.
استخدام الصيغة الصفيفية
الصيغ الصفية هي صيغ تعمل مع المصفوفات بدلاً من الأرقام الفردية كمدخلات للوظائف التي تشكل الصيغة. عند عرض صيغة صفية، يتم لفها بقوسين مموجين ({}) كما هو موضح أدناه.
ضبط صيغة صفية على الخلية G2
تعيد بعض وظائف Microsoft Excel مصفوفات القيم. لحساب نتائج متعددة باستخدام صيغة مصفوفة، أدخل المصفوفة في نطاق الخلايا بعدد الصفوف والأعمدة نفس معدلات الوسائط المصفوفات.
من الممكن تطبيق صيغة مصفوفة على خلية عن طريق استدعاء طريقة Cell لفئة setArrayFormula. تأخذ الطريقة setArrayFormula المعلمات التالية:
- صيغة مصفوفة, صيغة المصفوفة.
- عدد الصفوف, عدد الصفوف لملء نتيجة صيغة المصفوفة.
- عدد الأعمدة, عدد الأعمدة لملء نتيجة الصيغة الصفية.
استخدام صيغة R1C1
تطبيق صيغة نمط المرجع R1C1 على خلية مع Cell الفئة الرئيسية' setR1C1Formula الخاصية.