AuthorizationStoreRoleProvider.CreateRole Method (String)

 

Adds a new role to the role authorization-manager policy store.

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

override CreateRole : 
        roleName:string -> unit

Parameters

roleName
Type: System.String

The name of the role to create.

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 CreateRole method is called by the Roles class to create a role in the authorization-manager data store specified in the ASP.NET application's configuration file (Web.config).

Role names are not case sensitive.

The following code example creates a new role in the authorization-manager policy store. 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: