Skip to main content
Row

DocumentOptions.CalculationEngineType Property

Gets or sets the parameter that specifies the computational model used in worksheet calculations.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Spreadsheet.v24.1.Core.dll

NuGet Package: DevExpress.Spreadsheet.Core

Declaration

public CalculationEngineType CalculationEngineType { get; set; }

Property Value

Type Description
CalculationEngineType

A CalculationEngineType enumeration member.

Available values:

Name Description
ChainBased

This is the default calculation engine type. It constructs the calculation chain.

Spreadsheet analyzes cell formulas to build the tree of dependencies between cells, and constructs the calculation chain. When cell content is modified, the dependency tree allows you to determine which cells should be calculated. Those cells are marked as needing recalculation.

There are also cells which are always marked as needing calculation. They are listed below:

  • containing volatile function
  • referencing another cell which always needs recalculation
  • containing a circular reference

After calling the Workbook.EndUpdate method, the Spreadsheet calculates all cells marked as needing recalculation.

Recursive

This type of calculation engine was used by default before v15.1.

When the cell content is modified, all cells are marked as needing recalculation. Calculation of a particular cell is performed when needed - in a situation when its actual value is required for rendering or when the calculation engine attempts to obtain a value of another cell which references the current cell.

Property Paths

You can access this nested property as listed below:

Object Type Path to CalculationEngineType
ISpreadsheetComponent
.Options .CalculationEngineType
See Also