New to Telerik Document Processing? Start a free 30-day trial

RadExpression

Class

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 RadExpression

Inheritance: objectRadExpression

Derived Classes: CellReferenceRangeExpressionConstantExpressionFunctionExpressionOperatorExpressionSpreadsheetNameExpression

Constructors

RadExpression()

Initializes a new expression with an unknown evaluation state.

protected RadExpression()

Events

ValueInvalidated

EventHandler

Raised when the expression's cached value becomes invalid and requires recalculation.

public event EventHandler ValueInvalidated

Methods

FinishRegistration(Workbook)

Called only by the factory to register this expression with the workbook.

protected void FinishRegistration(Workbook workbook)

Parameters:workbookWorkbook

GetValue()

RadExpression

Evaluates and returns the computed value, detecting cyclic references during calculation.

public RadExpression GetValue()

Returns:

RadExpression

The value as RadExpression.

GetValueAsString()

string

Evaluates the expression and returns the result formatted as a string.

public string GetValueAsString()

Returns:

string

The value as string.

GetValueAsString(CultureInfo)

string

Evaluates the expression and returns the result formatted according to the specified culture.

public string GetValueAsString(CultureInfo cultureInfo)

Parameters:cultureInfoCultureInfo

The culture info.

Returns:

string

The value as string.

GetValueOverride()

RadExpression

Calculates the expression result; override to define specific evaluation logic for each expression type.

protected abstract RadExpression GetValueOverride()

Returns:

RadExpression

The value as RadExpression.

InvalidateValue()

Marks the cached value as invalid, triggering recalculation on next access and propagating invalidation to dependent expressions.

protected void InvalidateValue()

IsRegistered()

bool

Determines whether the current instance is registered in the calculation map of the workbook.

protected virtual bool IsRegistered()

Returns:

bool

true if the instance is registered; otherwise, false.

OnValueInvalidated()

Raises the ValueInvalidated event to notify dependent expressions.

protected virtual void OnValueInvalidated()

ToString()

string

Converts the expression to its formula string representation using default culture.

public override string ToString()

Returns:

string

A string that represents the current object.

Overrides: object.ToString()

ToString(CultureInfo)

string

Converts the expression to its formula string representation using the specified culture for number and list separators.

public string ToString(CultureInfo cultureInfo)

Parameters:cultureInfoCultureInfo

The culture info.

Returns:

string

The expression as string.

Extension Methods

ExpressionExtensions.GetValueAsConstantExpression(RadExpression)

ExpressionExtensions.IntegerValue(RadExpression)

ExpressionExtensions.NumberValue(RadExpression)