AuthorizationStoreRoleProvider::AddUsersToRoles Method (array<String^>^, array<String^>^)
Adds the specified user names to each of the specified roles.
Assembly: System.Web (in System.Web.dll)
public: virtual void AddUsersToRoles( array<String^>^ usernames, array<String^>^ roleNames ) override
Parameters
- usernames
-
Type:
array<System::String^>^
A string array of user names to be added to the specified roles.
- roleNames
-
Type:
array<System::String^>^
A string array of role names to add the specified user names to.
| Exception | Condition |
|---|---|
| ArgumentNullException | One of the specified user names is null. -or- One of the specified role names is null. -or- usernames is null. -or- roleNames is null. |
| ArgumentException | One of the specified user names is an empty string or contains a comma (,). -or- One of the specified role names is an empty string or contains a comma (,). -or- usernames contains a duplicate element. -or- roleNames contains a duplicate element. |
| ProviderException | The configured applicationName was not found. -or- The configured scopeName was not found. -or- The authorization-manager runtime is not installed on the server. |
| FileNotFoundException | The connectionStringName attribute references a connection string to a file that does not exist. |
| HttpException | The AuthorizationStoreRoleProvider instance is configured with a file-based policy store, and read access to the file is not allowed at the current trust level. |
The AddUsersToRoles method is called by the Roles class to associate one or more users with one or more roles in the authorization-manager data store specified in the ASP.NET application's configuration file (Web.config). This method is called by the Roles::AddUserToRole, Roles::AddUserToRoles, Roles::AddUsersToRole, and Roles::AddUsersToRoles methods of the Roles class.
The following code example adds one or more users to a role or removes a user from a role. For an example of a Web.config file that enables role management, see AuthorizationStoreRoleProvider.
Available since 2.0