TCustomDataStore.MaxDimensions Property

Limits the number of dimensions that can be cached by the crosstabulated data store at any one time.

Pascal

property MaxDimensions: Integer;

C++

__property int MaxDimensions;

Description

Use MaxDimensions to limit the memory usage of the data store. Memory consumption increases geometrically with each dimension that is cached in the multidimensional array. MaxDimensions prevents too many dimensions to be cached at once.

When the ActiveFlag property of a dimension is diActive, the dimension is always added to the cache. When the ActiveFlag property of a dimension is diAsNeeded, it can be added only if it does not cause the number of active dimensions to exceed MaxDimensions. The data store swaps in as-needed dimensions when they are open in the decision source, making room, if necessary, by swapping out closed dimensions.

Note: Be sure to set MaxDimensions to a value big enough to accommodate all active dimensions plus the number of as-needed dimensions that can be open at one time.