HierarchyCollection.Insert Method

Definition

Namespace:

Microsoft.AnalysisServices

Assembly:

Microsoft.AnalysisServices.dll

Package:

Microsoft.AnalysisServices v19.87.2

Overloads

Insert(Int32, String, String)	Creates a new Hierarchy object using the specified name and identifier, inserts it to the collection at the specified index and returns the new Hierarchy created.
Insert(Int32, String)	Creates a new Hierarchy object using the specified name, inserts it to the collection at the specified index and returns the new Hierarchy created.
Insert(Int32, Hierarchy)	Inserts the specified Hierarchy to the collection at the specified index.
Insert(Int32)	Creates a new Hierarchy object using a generated unique Name and identifier, inserts it to the collection at the specified index and returns the new Hierarchy created.

Insert(Int32, String, String)

Creates a new Hierarchy object using the specified name and identifier, inserts it to the collection at the specified index and returns the new Hierarchy created.

public Microsoft.AnalysisServices.Hierarchy Insert (int index, string name, string id);

override this.Insert : int * string * string -> Microsoft.AnalysisServices.Hierarchy

Public Function Insert (index As Integer, name As String, id As String) As Hierarchy

Parameters

index

Int32

The zero-based index at which the Hierarchy is inserted.

name

String

The Name for the new Hierarchy object.

id

String

The identifier for the new Hierarchy object.

Returns

Hierarchy

The newly created Hierarchy object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

• The specified name is not valid in the collection.
• The specified identifier is not valid in the collection.

Insert(Int32, String)

Creates a new Hierarchy object using the specified name, inserts it to the collection at the specified index and returns the new Hierarchy created.

public Microsoft.AnalysisServices.Hierarchy Insert (int index, string name);

override this.Insert : int * string -> Microsoft.AnalysisServices.Hierarchy

Public Function Insert (index As Integer, name As String) As Hierarchy

Parameters

index

Int32

The zero-based index at which the Hierarchy is inserted.

name

String

The Name for the new Hierarchy object. It must be unique within the collection.

Returns

Hierarchy

The newly created Hierarchy object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

The specified name is not valid in the collection.

Remarks

The identifier for the Hierarchy is generated based on the specified Name.

Insert(Int32, Hierarchy)

Inserts the specified Hierarchy to the collection at the specified index.

public void Insert (int index, Microsoft.AnalysisServices.Hierarchy item);

override this.Insert : int * Microsoft.AnalysisServices.Hierarchy -> unit

Public Sub Insert (index As Integer, item As Hierarchy)

Parameters

index

Int32

The zero-based index at which the Hierarchy is inserted.

item

Hierarchy

The Hierarchy to be inserted.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).

InvalidOperationException

• The specified item is a null reference (Nothing in Visual Basic).
• The specified item already esists in the collection.
• The identifier of the specified Hierarchy is not valid in the collection.
• The name of the specified Hierarchy is not valid in the collection.
• The compatibility-level of the specified Hierarchy is not valid in the collection.

Insert(Int32)

Creates a new Hierarchy object using a generated unique Name and identifier, inserts it to the collection at the specified index and returns the new Hierarchy created.

public Microsoft.AnalysisServices.Hierarchy Insert (int index);

override this.Insert : int -> Microsoft.AnalysisServices.Hierarchy

Public Function Insert (index As Integer) As Hierarchy

Parameters

index

Int32

The zero-based index at which the Hierarchy is inserted.

Returns

Hierarchy

The newly created Hierarchy object.

Exceptions

ArgumentOutOfRangeException

The specified index is not a valid value (less than zero or bigger then the total number of elements).