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()

הערות

כל האובייקטים המסופקים על ידי מחלקה זו הם לשימוש “קריאה” בלבד. המשתמש לא צריך לשנות שום נתון ב-Workbook במהלך תהליך חישוב הנוסחה, אחרת עשוי להיגרם תוצאה לא צפויה או חריגה.

מאפיינים

CalculatedValue

מקבל או קובע את הערך המחושב עבור פונקציה זו.

public object CalculatedValue { get; set; }

ערך המאפיין

object

הערות

המשתמש צריך לקבוע מאפיין זה במנוע החישוב המותאם אישית שלו עבור הפונקציות שהמנוע תומך בהן, והערך שנקבע יוחזר כאשר מקבלים מאפיין זה מאוחר יותר. הערך שנקבע עשוי להיות מסוגים אפשריים של Aspose.Cells.Cell.Value, או מערך של סוג כזה של ערכים, או טווח, שם, אזור מופנה. קבלת מאפיין זה לפני קביעת ערך בו תגרום לכך שהפונקציה תחושב על ידי מנוע החישוב ברירת המחדל של Aspose.Cells ואז הערך המחושב יוחזר (באופן כללי זה אמור להיות #NAME? עבור פונקציות שהוגדרו על ידי המשתמש).

Cell

מקבל את אובייקט ה-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), אחרת המערך הגדול המוחזר עשוי להגדיל את עלות הזיכרון עם כמות גדולה של נתונים חסרי תועלת.