Class CalculationData
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
하나의 함수(예: 함수 이름, 매개변수 등)를 계산할 때 필요한 데이터를 나타냅니다.
public class 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; }속성 값
비고
사용자는 엔진이 지원하는 함수에 대해 이 속성을 자신의 사용자 정의 계산 엔진에서 설정해야 하며,
설정된 값은 나중에 이 속성을 가져올 때 반환됩니다.
설정된 값은 Aspose.Cells.Cell.Value의 가능한 유형일 수 있으며,
이러한 종류의 값 배열, 또는 Range, Name, ReferredArea일 수 있습니다.
값을 설정하기 전에 이 속성을 가져오면 Aspose.Cells의 기본 계산 엔진에 의해 함수가 계산되고,
계산된 값이 반환됩니다(일반적으로 사용자 정의 함수의 경우 #NAME?이어야 합니다).
Cell
함수가 위치한 Cell 객체를 가져옵니다.
public Cell Cell { get; }속성 값
비고
셀에 설정하지 않고 수식을 계산할 때,
예를 들어 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; }속성 값
CellRow
함수가 위치한 셀의 행 인덱스를 가져옵니다.
public int CellRow { get; }속성 값
FunctionName
계산할 함수 이름을 가져옵니다.
public string FunctionName { get; }속성 값
ParamCount
매개변수의 개수를 가져옵니다.
public int ParamCount { get; }속성 값
Workbook
함수가 위치한 Workbook 객체를 가져옵니다.
public Workbook Workbook { get; }속성 값
Worksheet
함수가 위치한 Worksheet 객체를 가져옵니다.
public Worksheet Worksheet { get; }속성 값
메서드
GetParamText(int)
주어진 인덱스의 매개변수의 리터럴 텍스트를 가져옵니다.
public string GetParamText(int index)매개변수
index int
매개변수의 인덱스(0 기반)
반환
매개변수의 리터럴 텍스트
GetParamValue(int)
주어진 인덱스의 매개변수의 표현된 값 객체를 가져옵니다.
public object GetParamValue(int index)매개변수
index int
매개변수의 인덱스(0 기반)
반환
매개변수의 계산된 값.
비고
하나의 매개변수에 대해:
값이 단순한 경우, 단순한 값 자체를 반환합니다;
참조인 경우, ReferredArea 객체를 반환합니다;
여러 값이 있는 데이터셋을 참조하는 경우, 객체 배열을 반환합니다;
계산이 필요한 어떤 종류의 표현식인 경우, 값 모드에서 계산되고 일반적으로 현재 셀 기반에 따라 단일 값이 반환됩니다. 예를 들어, D2의 수식의 매개변수 중 하나가 A:A+B:B인 경우 A2+B2가 계산되어 반환됩니다. 그러나 이 매개변수가 배열 모드로 지정된 경우 (Aspose.Cells.Workbook.UpdateCustomFunctionDefinition(Aspose.Cells.CustomFunctionDefinition) 또는 Aspose.Cells.FormulaParseOptions.CustomFunctionDefinition에 의해), A1+B1, A2+B2,...의 항목을 포함하는 배열(object[][])이 반환됩니다.
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에 따라),
그렇지 않으면 반환된 큰 배열이 쓸모없는 데이터로 메모리 비용을 증가시킬 수 있습니다.
