Click or drag to resize

VGRolesInstanceCreateRole Method (String, String, Guid)
Adds a new role to the repository.

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
public VGRole CreateRole(
	string roleName,
	string description,
	Guid permissionSetId
)

Parameters

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

Return Value

Type: VGRole
the role added to the repository.
Exceptions
ExceptionCondition
ArgumentNullExceptionroleName is null (Nothing in VB.Net).
ArgumentExceptionroleName 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.
SecurityExceptionThe current user does not have 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.
See Also