You can programmatically add new roles, read role information, and delete roles from your application. In addition, you can associate users with roles as well as get users associated with a specific role. You can do all this by calling methods of the Roles class.
Most of the properties included in the Roles class just map to the settings for the <roleManager> tag described in the article How to configure roles providers for Role-Based Authorization in ASP.NET. The next table lists the additional properties and the Roles class’s methods that you can use for managing and accessing the roles API programmatically.
|Provider||Returns the provider currently used by your application.|
Returns a collection of all the available providers on the system and for your application configured in machine.config and in web.config of your application.
Accepts a user name and a role name as a string parameter and adds the specified user to the specified role.
Accepts a user name as a string parameter and role names as an array of strings and adds the specified user to all the roles specified in the role names parameter.
Accepts a string array with user names and a string parameter that specifies a role name and adds all the specified users to the role specified in the second parameter.
Accepts a string array with user names and a second one with role names and adds all the users in the user names parameter to all the roles in the role names parameter.
|CreateRole||Creates a new role.|
|DeleteRole||Deletes an existing role.|
Accepts a string representing the role name and a second string specifying a pattern for user names to match. The method returns a list of users that are associated with the role, and matches the pattern of the second parameter of the method (usernameToMatch).
Returns a string array containing all the role names of the roles available in the role store of the configured provider.
Returns a string array containing all the roles the specified user is associated with. There is also a version that doesn’t take any parameters, which gets the roles of the currently logged on user.
|GetUsersInRole||Returns a list of users who are associated with the role passed in as a parameter.|
|IsUserInRole||Returns true if the specified user is a member of the specified role.|
|RemoveUserFromRole||Removes a single user from the specified role.|
|RemoveUserFromRoles||Removes the specified user from all roles specified.|
|RemoveUsersFromRole||Removes all the specified users from a single role.|
|RemoveUsersFromRoles||Removes all the specified users from all the specified roles.|
|RoleExists||Returns true if a role exists and otherwise false.|