IsDisabled (Level Interface)
Note
This feature will be removed in the next version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible.
The IsDisabled property of the Level interface indicates whether the level is disabled.
Applies To:clsAggregationLevel, clsCubeLevel, clsPartitionLevel
Data Type
Boolean
Access
Access depends on the value of the ClassType property of the object. This property does not apply to levels whose SubClassType is sbclsParentChild or sbclsMining.
Class type |
Access |
|---|---|
clsCubeLevel |
R/W* |
clsPartitionLevel |
R |
clsAggregationLevel |
R |
* Read-only for virtual cube levels.
Remarks
If a level is disabled, it does not show up in a processed cube. That is, you cannot see the level when querying the cube using Multidimensional Expressions (MDX).
This property is useful in certain cases involving shared dimensions and multiple cubes. For example, if a parent dimension is shared between two different cubes and a child level has corresponding values in only one of the cubes, you can set the IsDisabled property of the level object in the other cube to True to prevent queries against nonexistent level members.
Note
When a level is disabled, all subordinate levels must already be disabled. When a level is enabled, all higher levels must already be enabled. At least one level must be enabled.
Example
Use the following code to disable a level object:
' Assume an object (dsoCubeLevel) of ClassType clsCubeLevel exists
dsoCubeLevel.IsDisabled = True