DimensionCollection.Insert Method

  • Reference

Definition

Namespace:
Microsoft.AnalysisServices
Assembly:
Microsoft.AnalysisServices.dll
Package:
Microsoft.AnalysisServices.retail.amd64 v19.79.0

Overloads

Insert(Int32, String, String)

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

Creates a new Dimension object using the specified name, inserts it to the collection at the specified index and returns the new Dimension created.
Insert(Int32)

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

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

Insert(Int32, String, String)

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

public Microsoft.AnalysisServices.Dimension Insert (int index, string name, string id);
override this.Insert : int * string * string -> Microsoft.AnalysisServices.Dimension
Public Function Insert (index As Integer, name As String, id As String) As Dimension

Parameters

index
Int32

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

name
String

The Name for the new Dimension object.

id
String

The identifier for the new Dimension object.

Returns

Dimension

The newly created Dimension 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.

Applies to

Insert(Int32, String)

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

public Microsoft.AnalysisServices.Dimension Insert (int index, string name);
override this.Insert : int * string -> Microsoft.AnalysisServices.Dimension
Public Function Insert (index As Integer, name As String) As Dimension

Parameters

index
Int32

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

name
String

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

Returns

Dimension

The newly created Dimension 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 Dimension is generated based on the specified Name.

Applies to

Insert(Int32)

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

public Microsoft.AnalysisServices.Dimension Insert (int index);
override this.Insert : int -> Microsoft.AnalysisServices.Dimension
Public Function Insert (index As Integer) As Dimension

Parameters

index
Int32

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

Returns

Dimension

The newly created Dimension object.

Exceptions

ArgumentOutOfRangeException

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

Applies to

Insert(Int32, Dimension)

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

public void Insert (int index, Microsoft.AnalysisServices.Dimension item);
override this.Insert : int * Microsoft.AnalysisServices.Dimension -> unit
Public Sub Insert (index As Integer, item As Dimension)

Parameters

index
Int32

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

item
Dimension

The Dimension 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 Dimension is not valid in the collection.
  • The name of the specified Dimension is not valid in the collection.
  • The compatibility-level of the specified Dimension is not valid in the collection.

Applies to