DimensionAttributeCollection.Insert Method

Definition

Namespace:

Microsoft.AnalysisServices

Assembly:

Microsoft.AnalysisServices.dll

Package:

Microsoft.AnalysisServices v19.87.2

Overloads

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

Insert(Int32, String, String)

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

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

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

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

Parameters

index

Int32

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

name

String

The Name for the new DimensionAttribute object.

id

String

The identifier for the new DimensionAttribute object.

Returns

DimensionAttribute

The newly created DimensionAttribute 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 DimensionAttribute object using the specified name, inserts it to the collection at the specified index and returns the new DimensionAttribute created.

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

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

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

Parameters

index

Int32

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

name

String

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

Returns

DimensionAttribute

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

Insert(Int32)

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

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

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

Public Function Insert (index As Integer) As DimensionAttribute

Parameters

index

Int32

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

Returns

DimensionAttribute

The newly created DimensionAttribute object.

Exceptions

ArgumentOutOfRangeException

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

Insert(Int32, DimensionAttribute)

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

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

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

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

Parameters

index

Int32

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

item

DimensionAttribute

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