Class CalculationData

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

يمثل البيانات المطلوبة عند حساب دالة واحدة، مثل اسم الدالة، المعلمات، …إلخ.

public class CalculationData

الوراثة

object ← CalculationData

الأعضاء الموروثة

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

ملاحظات

جميع الكائنات المقدمة بواسطة هذه الفئة هي للاستخدام “للقراءة” فقط. يجب على المستخدم عدم تغيير أي بيانات في مصنف العمل أثناء عملية حساب الصيغة، وإلا قد يحدث نتيجة غير متوقعة أو استثناء.

الخصائص

CalculatedValue

يحصل على أو يحدد القيمة المحسوبة لهذه الدالة.

public object CalculatedValue { get; set; }

قيمة الخاصية

object

ملاحظات

يجب على المستخدم تعيين هذه الخاصية في محرك الحساب المخصص له لتلك الدوال التي يدعمها المحرك، وستتم إرجاع القيمة المحددة عند الحصول على هذه الخاصية لاحقًا. قد تكون القيمة المحددة من الأنواع الممكنة لـ Aspose.Cells.Cell.Value، أو مصفوفة من هذا النوع من القيم، أو نطاق، أو اسم، أو منطقة مرجعية. الحصول على هذه الخاصية قبل تعيين قيمة لها سيجعل الدالة تُحسب بواسطة محرك الحساب الافتراضي لـ Aspose.Cells ثم ستُرجع القيمة المحسوبة (بشكل عام يجب أن تكون #NAME؟ للدوال المعرفة من قبل المستخدم).

Cell

يحصل على كائن الخلية حيث توجد الدالة.

public Cell Cell { get; }

قيمة الخاصية

Cell

ملاحظات

عند حساب صيغة دون تعيينها إلى خلية، مثل بواسطة Aspose.Cells.Worksheet.CalculateFormula(System.String,Aspose.Cells.CalculationOptions), سيتم حساب الصيغة كما لو كانت قد تم تعيينها إلى الخلية A1، لذا فإن كل من Aspose.Cells.CalculationData.CellRow و Aspose.Cells.CalculationData.CellColumn هما 0. ومع ذلك، قد لا تكون الخلية A1 في ورقة العمل قد تم إنشاؤها. لذا في مثل هذه الحالة ستكون هذه الخاصية null.

CellColumn

يحصل على مؤشر العمود للخلية حيث توجد الدالة.

public int CellColumn { get; }

قيمة الخاصية

int

CellRow

يحصل على مؤشر الصف للخلية حيث توجد الدالة.

public int CellRow { get; }

قيمة الخاصية

int

FunctionName

يحصل على اسم الدالة التي سيتم حسابها.

public string FunctionName { get; }

قيمة الخاصية

string

ParamCount

يحصل على عدد المعلمات

public int ParamCount { get; }

قيمة الخاصية

int

Workbook

يحصل على كائن Workbook حيث توجد الدالة.

public Workbook Workbook { get; }

قيمة الخاصية

Workbook

Worksheet

يحصل على كائن Worksheet حيث توجد الدالة.

public Worksheet Worksheet { get; }

قيمة الخاصية

Worksheet

الطرق

GetParamText(int)

يحصل على النص الحرفي للمعلمة عند الفهرس المعطى.

public string GetParamText(int index)

المعلمات

index int

فهرس المعلمة (بدءًا من 0)

العائدات

string

النص الحرفي للمعلمة

GetParamValue(int)

يحصل على كائن القيمة الممثلة للمعلمة عند الفهرس المعطى.

public object GetParamValue(int index)

المعلمات

index int

فهرس المعلمة (بدءًا من 0)

العائدات

object

القيمة المحسوبة للمعلمة.

ملاحظات

للمعلمة الواحدة:

إذا كانت قيمة عادية، فستُرجع القيمة العادية نفسها؛

إذا كانت مرجعية، فستُرجع كائن ReferredArea؛

إذا كانت تشير إلى مجموعة بيانات مع قيم متعددة، فستُرجع مصفوفة من الكائنات؛

إذا كانت نوعًا من التعبيرات التي تحتاج إلى حساب، فسيتم حسابها في وضع القيمة وعادةً ما سيتم إرجاع قيمة واحدة وفقًا لخلية القاعدة الحالية. على سبيل المثال، إذا كانت إحدى معلمات صيغة D2 هي A:A+B:B، فسيتم حساب A2+B2 وإرجاعها. ومع ذلك، إذا تم تحديد هذه المعلمة كوضع مصفوفة (عن طريق Aspose.Cells.Workbook.UpdateCustomFunctionDefinition(Aspose.Cells.CustomFunctionDefinition) أو Aspose.Cells.FormulaParseOptions.CustomFunctionDefinition)، فستُرجع مصفوفة (object[][]) تحتوي على العناصر A1+B1، A2+B2،....

GetParamValueInArrayMode(int, int, int)

يحصل على القيمة (القيم) للمعلمة عند الفهرس المعطى. إذا كانت المعلمة نوعًا من التعبيرات التي تحتاج إلى حساب، فسيتم حسابها في وضع المصفوفة.

public object[][] GetParamValueInArrayMode(int index, int maxRowCount, int maxColumnCount)

المعلمات

index int

فهرس المعلمة (بدءًا من 0)

maxRowCount int

حد عدد الصفوف للمصفوفة المرجعة. إذا كانت غير إيجابية أو أكبر من عدد الصفوف الفعلي، فسيتم استخدام عدد الصفوف الفعلي.

maxColumnCount int

حد عدد الأعمدة للمصفوفة المرجعة. إذا كانت غير إيجابية أو أكبر من عدد الأعمدة الفعلي، فسيتم استخدام عدد الأعمدة الفعلي.

العائدات

object[][]

مصفوفة تحتوي على جميع العناصر الممثلة بواسطة المعلمة المحددة.

ملاحظات

بالنسبة للتعبير الذي يحتاج إلى حساب، مع أخذ A:A+B:B كمثال: في وضع القيمة، سيتم حسابه إلى قيمة واحدة وفقًا لخلية القاعدة الحالية. لكن في وضع المصفوفة، سيتم حساب جميع قيم A1+B1، A2+B2، A3+B3،… واستخدامها لبناء المصفوفة المرجعة. وفي مثل هذه الحالة، من الأفضل تحديد الحد لعدد الصفوف/الأعمدة (مثل وفقًا لـ Aspose.Cells.Cells.MaxDataRow و Aspose.Cells.Cells.MaxDataColumn)، وإلا قد تزيد المصفوفة الكبيرة المرجعة من تكلفة الذاكرة مع كمية كبيرة من البيانات غير المفيدة.