HierarchyDimensionGrouping Property

Determines the manner in which hierarchies are associated with DimensionDescriptors.

Syntax

Visual Basic

'Declaration
 
Public Property HierarchyDimensionGrouping As HierarchyDimensionGrouping

C#

public HierarchyDimensionGrouping HierarchyDimensionGrouping {get; set;}

Remarks

By default, only one dimension is created for the data source, and each hierarchy appears as a child of that dimension.

Use this property to control the way hierarchies are associated with DimensionDescriptors.

Note that when setting the Rows, Columns, or Filters properties of a FlatDataSourceInitialSettings instance, the hierarchy names must be fully qualified, using the following form:

[Dimension].[Hierarchy]

Because the HierarchyDimensionGrouping property determines the dimension name, a fully qualified hierarchy name can vary for different settings of the property. For example, assume we have a class named 'Foo', with a property name 'Bar'; also assume that the 'Bar' property is decorated with a Category attribute named 'FooBar'. The following table outlines the different forms of the fully qualified hierarchy names resulting from each HierarchyDimensionGrouping property setting:

	HierarchyDimensionGrouping	Qualified Name
AllInOne	[Foo].[Bar]
ByCategory	[FooBar].[Bar]
Separate	[Bar].[Bar]