RoleCollection.Insert Method

Definition

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.Role Insert (int index, string name, string id);
override this.Insert : int * string * string -> Microsoft.AnalysisServices.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

The newly created Role object.

Exceptions

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

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

public Microsoft.AnalysisServices.Role Insert (int index, string name);
override this.Insert : int * string -> Microsoft.AnalysisServices.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

The newly created Role object.

Exceptions

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

The specified name is not valid in the collection.

Remarks

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

Applies to

Insert(Int32, Role)

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

public void Insert (int index, Microsoft.AnalysisServices.Role item);
override this.Insert : int * Microsoft.AnalysisServices.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

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

  • 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.

Applies to

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.Role Insert (int index);
override this.Insert : int -> Microsoft.AnalysisServices.Role
Public Function Insert (index As Integer) As Role

Parameters

index
Int32

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

Returns

The newly created Role object.

Exceptions

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

Applies to