AuthorizationStoreRoleProvider.RoleExists Method (String)

 

Gets a value indicating whether the specified role name already exists in the authorization-manager policy store.

Namespace:   System.Web.Security
Assembly:  System.Web (in System.Web.dll)

override RoleExists : 
        roleName:string -> bool

Parameters

roleName
Type: System.String

The name of the role to search for in the authorization-manager policy store.

Return Value

Type: System.Boolean

true if the role name already exists in the authorization-manager policy store; otherwise, false.

Exception Condition
ArgumentNullException

roleName is null.

ArgumentException

roleName is an empty string.

-or-

roleName contains a comma.

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 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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: