Class CalculationData
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Mewakili data yang diperlukan saat menghitung satu fungsi, seperti nama fungsi, parameter, …dll.
public class CalculationDataPewarisan
Anggota yang Dwarisi
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Catatan
Semua objek yang disediakan oleh kelas ini hanya untuk tujuan “baca”. Pengguna tidak boleh mengubah data apa pun di Workbook selama proses perhitungan rumus, Jika tidak, hasil yang tidak terduga atau Exception mungkin terjadi.
Properti
CalculatedValue
Mengambil atau mengatur nilai yang dihitung untuk fungsi ini.
public object CalculatedValue { get; set; }Nilai Properti
Catatan
Pengguna harus mengatur properti ini di mesin perhitungan kustomnya untuk fungsi-fungsi yang didukung oleh mesin tersebut, dan nilai yang diatur akan dikembalikan saat mengambil properti ini nanti. Nilai yang diatur dapat berupa jenis yang mungkin dari Aspose.Cells.Cell.Value, atau array dari jenis nilai tersebut, atau Range, Name, ReferredArea. Mengambil properti ini sebelum mengatur nilai akan membuat fungsi dihitung oleh mesin perhitungan default dari Aspose.Cells dan kemudian nilai yang dihitung akan dikembalikan (umumnya harus #NAME? untuk fungsi yang ditentukan pengguna).
Cell
Mengambil objek Cell tempat fungsi berada.
public Cell Cell { get; }Nilai Properti
Catatan
Saat menghitung rumus tanpa mengaturnya ke sel, seperti oleh Aspose.Cells.Worksheet.CalculateFormula(System.String,Aspose.Cells.CalculationOptions), rumus akan dihitung seolah-olah telah diatur ke sel A1, jadi baik Aspose.Cells.CalculationData.CellRow dan Aspose.Cells.CalculationData.CellColumn adalah 0. Namun, sel A1 di lembar kerja mungkin belum diinstansiasi. Jadi untuk situasi semacam ini, properti ini akan bernilai null.
CellColumn
Mengambil indeks kolom dari sel tempat fungsi berada.
public int CellColumn { get; }Nilai Properti
CellRow
Mengambil indeks baris dari sel tempat fungsi berada.
public int CellRow { get; }Nilai Properti
FunctionName
Mengambil nama fungsi yang akan dihitung.
public string FunctionName { get; }Nilai Properti
ParamCount
Mengambil jumlah parameter
public int ParamCount { get; }Nilai Properti
Workbook
Mengambil objek Workbook tempat fungsi berada.
public Workbook Workbook { get; }Nilai Properti
Worksheet
Mengambil objek Worksheet tempat fungsi berada.
public Worksheet Worksheet { get; }Nilai Properti
Metode
GetParamText(int)
Mengambil teks literal dari parameter pada indeks yang diberikan.
public string GetParamText(int index)Parameter
index int
indeks dari parameter (berbasis 0)
Mengembalikan
teks literal dari parameter
GetParamValue(int)
Mengambil objek nilai yang diwakili dari parameter pada indeks yang diberikan.
public object GetParamValue(int index)Parameter
index int
Indeks dari parameter (berbasis 0)
Mengembalikan
Nilai yang dihitung dari parameter.
Catatan
Untuk satu parameter:
Jika itu adalah nilai biasa, maka mengembalikan nilai biasa itu sendiri;
Jika itu adalah referensi, maka mengembalikan objek ReferredArea;
Jika itu merujuk pada dataset dengan beberapa nilai, maka mengembalikan array objek;
Jika itu adalah semacam ekspresi yang perlu dihitung, maka akan dihitung dalam mode nilai dan umumnya satu nilai akan dikembalikan sesuai dengan basis sel saat ini. Misalnya, jika salah satu parameter dari rumus D2 adalah A:A+B:B, maka A2+B2 akan dihitung dan dikembalikan. Namun, jika parameter ini telah ditentukan sebagai mode array (melalui Aspose.Cells.Workbook.UpdateCustomFunctionDefinition(Aspose.Cells.CustomFunctionDefinition) atau Aspose.Cells.FormulaParseOptions.CustomFunctionDefinition), maka array (object[][]) akan dikembalikan yang itemnya adalah A1+B1,A2+B2,....
GetParamValueInArrayMode(int, int, int)
Mengambil nilai dari parameter pada indeks yang diberikan. Jika parameter adalah semacam ekspresi yang perlu dihitung, maka akan dihitung dalam mode array.
public object[][] GetParamValueInArrayMode(int index, int maxRowCount, int maxColumnCount)Parameter
index int
Indeks dari parameter (berbasis 0)
maxRowCount int
Batas jumlah baris untuk array yang dikembalikan. Jika tidak positif atau lebih besar dari jumlah baris yang sebenarnya, maka jumlah baris yang sebenarnya akan digunakan.
maxColumnCount int
Batas jumlah kolom untuk array yang dikembalikan. Jika tidak positif atau lebih besar dari jumlah kolom yang sebenarnya, maka jumlah kolom yang sebenarnya akan digunakan.
Mengembalikan
object[][]
Sebuah array yang berisi semua item yang diwakili oleh parameter yang ditentukan.
Catatan
Untuk ekspresi yang perlu dihitung, mengambil A:A+B:B sebagai contoh: Dalam mode nilai, itu akan dihitung menjadi satu nilai sesuai dengan basis sel saat ini. Tetapi dalam mode array, semua nilai A1+B1,A2+B2,A3+B3,… akan dihitung dan digunakan untuk membangun array yang dikembalikan. Dan untuk situasi semacam ini, lebih baik untuk menentukan batas untuk jumlah baris/kolom (seperti sesuai dengan Aspose.Cells.Cells.MaxDataRow dan Aspose.Cells.Cells.MaxDataColumn), jika tidak, array besar yang dikembalikan mungkin meningkatkan biaya memori dengan jumlah data yang tidak berguna yang besar.
