VGRoles.CreateRole Method

Adds a new role to the repository.

public static VGRole CreateRole(
   String roleName,
   String description,
   Guid permissionSetId
);

Parameters

roleName: The name of the role to create.
description: a short description of the role
permissionSetId: The repository id of the permission set assigned to the role. Empty when there is no permission set assigned to the role.

Exceptions

Exception Type	Condition
ArgumentNullException	roleName is null (Nothing in VB.Net).
ArgumentException	roleName is empty or contains invalid chars ('\', '/', '?', '', '%', ';', ''', '"', ':', '\|', '[', ']', '+', '=', ','). or roleName* is longer than 64 characters. or a role with the same name already exists in the repository. or permissionSetId does not exist in the repository fro the application.
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 Type

Condition

ArgumentNullException

roleName is null (Nothing in VB.Net).

ArgumentException

roleName is empty or contains invalid chars ('\', '/', '?', '*', '%', ';', ''', '"', ':', '|', '[', ']', '+', '=', ',').

roleName is longer than 64 characters. or a role with the same name already exists in the repository.

permissionSetId does not exist in the repository fro the application.

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.

VGRoles.CreateRole Method

Parameters

Exceptions

See Also