AuthorizationStoreRoleProvider.RoleExists Method
Assembly: System.Web (in system.web.dll)
public boolean RoleExists ( String roleName )
public override function RoleExists ( roleName : String ) : boolean
Not applicable.
Parameters
- roleName
The name of the role to search for in the authorization-manager policy store.
Return Value
true if the role name already exists in the authorization-manager policy store; otherwise, false.| Exception type | Condition |
|---|---|
|
roleName is a null reference (Nothing in Visual Basic). | |
|
roleName is an empty string. -or- roleName contains a comma. | |
|
The configured applicationName was not found. -or- The configured scopeName was not found. -or- The authorization-manager runtime is not installed on the server. | |
|
The connectionStringName attribute references a connection string to a file that does not exist. | |
|
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 RoleExists method is called by the Roles class to determine whether a role name exists in the authorization-manager data store specified in the ASP.NET application's configuration file (Web.config).
The following code example uses the RoleExists method to determine whether a role name already exists before creating the role. For an example of a Web.config file that enables role management, see AuthorizationStoreRoleProvider.