Deletes a role specified by its name from the repository.
Namespace: Novalys.VisualGuard.Security.MembershipAssembly: Novalys.VisualGuard.Security (in Novalys.VisualGuard.Security.dll) Version: 2017.0.101.17 (2017.0.101.17)
Syntax
C# |
---|
[ObsoleteAttribute("This method does not work", true)] public static bool DeleteRole( string roleName, bool throwOnPopulatedRole ) |
Visual Basic |
---|
<ObsoleteAttribute("This method does not work", true)> Public Shared Function DeleteRole ( roleName As String, throwOnPopulatedRole As Boolean ) As Boolean |
Parameters
- roleName
- Type: System..::..String
the name of role to delete.
- throwOnPopulatedRole
- Type: System..::..Boolean
If true, throws an exception if roleName has one or more members.
Return Value
Type: Booleantrue if the role was deleted from the repository; otherwise; false.
Exceptions
Exception | Condition |
---|---|
System..::..ArgumentNullException | roleName is null (Nothing in VB.Net). |
System..::..ArgumentException | roleName is an empty string or contains invalid chars ('\', '/', '?', '*', '%', ';', ''', '"', ':', '|', '[', ']', '+', '=', ',') or is longer than 64 characters. |
System..::..InvalidOperationException | the role is marked as a built-in role or is a shared role.
-or- the role has one or more members and throwOnPopulatedRole is true. |
System.Security..::..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. |