RoleCollection.Insert Method

Definition

Namespace:

Microsoft.AnalysisServices.Tabular

Assembly:

Microsoft.AnalysisServices.Tabular.dll

Package:

Microsoft.AnalysisServices v19.86.2.1

Overloads

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

Insert(Int32, String, String)

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

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

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

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

Parameters

index

Int32

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

name

String

The Name for the new Role object.

id

String

The identifier for the new Role object.

Returns

Role

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

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

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

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

Parameters

index

Int32

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

name

String

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

Returns

Role

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

Insert(Int32, Role)

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

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

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

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

Parameters

index

Int32

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

item

Role

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

Insert(Int32)

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

public Microsoft.AnalysisServices.Tabular.Role Insert (int index);

override this.Insert : int -> Microsoft.AnalysisServices.Tabular.Role

Public Function Insert (index As Integer) As Role

Parameters

index

Int32

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

Returns

Role

The newly created Role object.

Exceptions

ArgumentOutOfRangeException

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