استخدام ميزة ICustomFunction
تقدم هذه المقالة فهمًا تفصيليًا لكيفية استخدام ميزة ICustomFunction لتنفيذ وظائف مخصصة مع واجهات برمجة تطبيقات Aspose.Cells.
تسمح واجهة ICustomFunction بإضافة وظائف حساب الصيغة المخصصة لتوسيع محرك الحساب الأساسي Aspose.Cells من أجل تلبية متطلبات معينة. هذه الميزة مفيدة لتعريف الوظائف المخصصة (المعرفة من قبل المستخدم) في ملف قالب أو في التعليمات البرمجية حيث يمكن تنفيذ الوظيفة المخصصة وتقييمها باستخدام واجهات برمجة تطبيقات Aspose.Cells مثل أي وظيفة إكسل Microsoft افتراضية أخرى.
إنشاء وتقييم وظيفة محددة من قبل المستخدم
توضح هذه المقالة تنفيذ واجهة ICustomFunction لكتابة وظيفة مخصصة واستخدامها في جدول البيانات للحصول على النتائج. سنحدد وظيفة مخصصة بالاسمMyFunc والتي ستقبل معاملين مع التفاصيل التالية.
- تشير المعلمة الأولى إلى خلية واحدة
- تشير المعلمة الثانية إلى نطاق من الخلايا
ستضيف الوظيفة المخصصة جميع القيم من نطاق الخلايا المحدد كمعلمة ثانية وتقسيم النتيجة بالقيمة في المعلمة الأولى.
إليك كيفية تنفيذنا لطريقة CalculateCustomFunction.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| public class CustomFunction : ICustomFunction | |
| { | |
| public object CalculateCustomFunction(string functionName, System.Collections.ArrayList paramsList, System.Collections.ArrayList contextObjects) | |
| { | |
| decimal total = 0M; | |
| try | |
| { | |
| // Get value of first parameter | |
| decimal firstParamB1 = System.Convert.ToDecimal(paramsList[0]); | |
| // Get value of second parameter | |
| Array secondParamC1C5 = (Array)(paramsList[1]); | |
| // get every item value of second parameter | |
| foreach (object[] value in secondParamC1C5) | |
| { | |
| total += System.Convert.ToDecimal(value[0]); | |
| } | |
| total = total / firstParamB1; | |
| } | |
| catch | |
| { | |
| } | |
| // Return result of the function | |
| return total; | |
| } | |
| } |
فيما يلي كيفية استخدام الوظيفة المحددة حديثًا في جدول بيانات
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Open the workbook | |
| Workbook workbook = new Workbook(); | |
| // Obtaining the reference of the first worksheet | |
| Worksheet worksheet = workbook.Worksheets[0]; | |
| // Adding sample values to cells | |
| worksheet.Cells["B1"].PutValue(5); | |
| worksheet.Cells["C1"].PutValue(100); | |
| worksheet.Cells["C2"].PutValue(150); | |
| worksheet.Cells["C3"].PutValue(60); | |
| worksheet.Cells["C4"].PutValue(32); | |
| worksheet.Cells["C5"].PutValue(62); | |
| // Adding custom formula to Cell A1 | |
| workbook.Worksheets[0].Cells["A1"].Formula = "=MyFunc(B1,C1:C5)"; | |
| // Calcualting Formulas | |
| workbook.CalculateFormula(false, new CustomFunction()); | |
| // Assign resultant value to Cell A1 | |
| workbook.Worksheets[0].Cells["A1"].PutValue(workbook.Worksheets[0].Cells["A1"].Value); | |
| // Save the file | |
| workbook.Save(dataDir + "UsingICustomFunction_out.xls"); |
ملخص
قامت واجهات برمجة التطبيقات Aspose.Cells بوضع الكائن RefifiedArea في “قائمة paramsList” عندما تكون المعلمة المقابلة مرجعًا أو تكون النتيجة المحسوبة مرجعًا. إذا كنت بحاجة إلى المرجع نفسه ، فيمكنك استخدام RefifiedArea مباشرة. إذا كنت بحاجة إلى الحصول على قيمة خلية واحدة من المرجع المقابل لموضع الصيغة ، فيمكنك استخدام أسلوب RefifiedArea.GetValue (rowOffset ، int colOffset). إذا كنت بحاجة إلى مصفوفة قيم الخلية للمنطقة بأكملها ، فيمكنك استخدام طريقة RefifiedArea.GetValues.
نظرًا لأن واجهات برمجة التطبيقات Aspose.Cells تعطي RefifiedArea في “paramsList” ، فلن تكون هناك حاجة إلى مجموعة RefifiedAreaCollection في “ContextObjects” بعد الآن (في الإصدارات القديمة ، لم تكن قادرة على إعطاء مخطط واحد لواحد لمعلمات الوظيفة المخصصة دائمًا) تمت إزالته من “ContextObjects”.
public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)
{
...
object o = paramsList[i];
if(o is ReferredArea) //fetch data from reference
{
ReferredArea ra = (ReferredArea)o;
if(ra.IsArea)
{
o = ra.GetValues();
}
else
{
o = ra.GetValue(0, 0);
}
}
if (o is Array)
{
...
}
else if...
...
}