VGRolesInstanceAddUsersToRolesById Method (String, Guid, Guid)

Note: This API is now obsolete.

Adds a list of users specified by repository ids to the specified roles.

Namespace: Novalys.VisualGuard.Security.Membership
Assembly: Novalys.VisualGuard.Security (in Novalys.VisualGuard.Security.dll) Version: 2019.1.831.19 (2019.1.0831.19)

Syntax

Copy

[ObsoleteAttribute("Use AddUsersToRoles(ICollection<VGMembershipUser> users, ICollection<VGRole> roles)")]
public void AddUsersToRolesById(
	string[] userIds,
	Guid[] roleIds,
	Guid applicationId
)

<ObsoleteAttribute("Use AddUsersToRoles(ICollection<VGMembershipUser> users, ICollection<VGRole> roles)")>
Public Sub AddUsersToRolesById ( 
	userIds As String(),
	roleIds As Guid(),
	applicationId As Guid
)

Parameters

userIds: Type: SystemString
An array of repository id identifying the users to add to the specified roles.
roleIds: Type: SystemGuid
An array of repository id identifying the roles to add the specified users to.
applicationId: Type: SystemGuid
The code of the application where you can find the specified roles.

Exceptions

Exception	Condition
ArgumentNullException	roleIds is null. -or- userIds is null. -or- applicatinId is null.
ArgumentException	roleIds contains a duplicate element. -or- One of the roles was not found in the repository for the application. -or- userIds contains a duplicate element. -or- One of the users was not declared in the repository -or- The application was not found in the repository
SecurityException	The current user has not enough privileges to use Membership API. The Membership access level of the application must be sufficient to allows this action or the 'Membership Manager' role must be granted to the user by using the Visual Guard console.

Exception

Condition

ArgumentNullException

roleIds is null.

-or-

userIds is null.

-or-

applicatinId is null.

ArgumentException

roleIds contains a duplicate element.

-or-

One of the roles was not found in the repository for the application.

-or-

userIds contains a duplicate element.

-or-

One of the users was not declared in the repository

-or-

The application was not found in the repository

SecurityException

The current user has not enough privileges to use Membership API. The Membership access level of the application must be sufficient to allows this action or the 'Membership Manager' role must be granted to the user by using the Visual Guard console.

Reference

VGRolesInstance Class

AddUsersToRolesById Overload

Novalys.VisualGuard.Security.Membership Namespace

VGMembershipUserRepositoryId

VGRoleRepositoryId

VGApplicationRepositoryId