ClassRadExpression
Abstract base for all spreadsheet expressions, providing lazy evaluation, change propagation, and value caching for formula calculation.
Definition
Namespace:Telerik.Windows.Documents.Spreadsheet.Expressions
Assembly:Telerik.Windows.Documents.Spreadsheet.dll
Syntax:
public abstract class RadExpressionInheritance: objectRadExpression
Derived Classes:
Constructors
RadExpression()
Initializes a new expression with an unknown evaluation state.
Declaration
protected RadExpression()Methods
FinishRegistration(Workbook)
Called only by the factory to register this expression with the workbook.
Declaration
protected void FinishRegistration(Workbook workbook)Parameters
workbook
GetValue()
Evaluates and returns the computed value, detecting cyclic references during calculation.
Declaration
public RadExpression GetValue()Returns
The value as RadExpression.
GetValueAsString()
Evaluates the expression and returns the result formatted as a string.
GetValueAsString(CultureInfo)
Evaluates the expression and returns the result formatted according to the specified culture.
Declaration
public string GetValueAsString(CultureInfo cultureInfo)Parameters
cultureInfo
The culture info.
Returns
The value as string.
GetValueOverride()
Calculates the expression result; override to define specific evaluation logic for each expression type.
Declaration
protected abstract RadExpression GetValueOverride()Returns
The value as RadExpression.
InvalidateValue()
Marks the cached value as invalid, triggering recalculation on next access and propagating invalidation to dependent expressions.
Declaration
protected void InvalidateValue()IsRegistered()
Determines whether the current instance is registered in the calculation map of the workbook.
OnValueInvalidated()
Raises the ValueInvalidated event to notify dependent expressions.
Declaration
protected virtual void OnValueInvalidated()ToString()
Converts the expression to its formula string representation using default culture.
ToString(CultureInfo)
Converts the expression to its formula string representation using the specified culture for number and list separators.
Declaration
public string ToString(CultureInfo cultureInfo)Parameters
cultureInfo
The culture info.
Returns
The expression as string.
Events
ValueInvalidated
Raised when the expression's cached value becomes invalid and requires recalculation.