IUserHierarchyServiceInsertLevel Method (UserHierarchy, Int32, Guid, IListString)

Inserts the level based on a native structure at the specified index.

Namespace:  Dundas.BI.Entities.UserHierarchies
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (9.0.0.1000)
Syntax
Copy
UserHierarchyLevel InsertLevel(
	UserHierarchy hierarchy,
	int levelIndex,
	Guid entityId,
	IList<string> defaultColumns
)

Parameters

hierarchy
Type: Dundas.BI.Entities.UserHierarchiesUserHierarchy
The hierarchy.
levelIndex
Type: SystemInt32
The zero-based index at which level should be inserted.
entityId
Type: SystemGuid
ID of the data source entity.
defaultColumns
Type: System.Collections.GenericIListString
The default column names. The column names serve as a "hint" on how to generate the level.

Return Value

Type: UserHierarchyLevel
The level.
Exceptions
ExceptionCondition
InvalidSessionExceptionThe caller context is not associated with a valid session.
ArgumentNullExceptionhierarchy is .
NotSupportedExceptionThe data structure with the specified ID cannot be used as a data source for the user hierarchy.
NotFoundExceptionThe data structure with the specified ID doesn't exist or cannot be discovered.
ArgumentOutOfRangeExceptionlevelIndex is not a valid level index.
InvalidOperationException

The entity has never been saved before.

-or-

The entity is not checked out to the caller.

Remarks
The table is analyzed based on relationships with other tables in existing levels.
See Also