IMetabaseObject.FlushInstance

Syntax

FlushInstance(Value: IMetabaseObjectParamValues): Boolean;

Parameters

Value. Values of parameters of an object.

Description

The FlushInstance method flushes cached data of an object by specified parameter values.

Comments

FlushInstance returns True if cache flushing is successful.

This method use increases productivity while working with objects that have parameters, for example: cube that controls parameters of its dimensions. If the FlushInstance method is used, cache flushing is possible by chosen dimension and not by all during cube opening. Use the IMetabaseObject.FlushInstances method to flush cached data of an object by all dimensions.

Example

Executing the example requires that the repository contains a parametric table dictionary with the OBJ_TBL_DICT identifier. The first parameter of this dictionary must be of real type.

Add a link to the Metabase system assembly.

Sub UserSub;
   Var
       Mb: IMetabase;
       Obj: IMetabaseObject;
       ParamVals: IMetabaseObjectParamValues;
   Begin
       Mb := MetabaseClass.Active;
       Obj := Mb.ItemById("OBJ_TBL_DICT").Bind;
       ParamVals := Obj.Params.CreateEmptyValues;
       ParamVals.Item(0).Value := 66;
       Obj.FlushInstance(ParamVals);
End Sub UserSub;

After executing the example the table dictionary cache is flushed only by the first parameter.