Roles::CreateRole Method (String^)
Adds a new role to the data source.
Assembly: System.Web (in System.Web.dll)
Parameters
- roleName
-
Type:
System::String^
The name of the role to create.
| Exception | Condition |
|---|---|
| System::ArgumentNullException | roleName is null. |
| System::ArgumentException | roleName is an empty string. -or- roleName contains a comma. |
| System.Configuration.Provider::ProviderException | Role management is not enabled. |
The CreateRole method adds a role name to the data source. CreateRole calls the CreateRole method of the default role provider to add the specified role to the data source.
Note |
|---|
Role names cannot contain commas. |
The following code example creates a new role in the data source. For an example of a Web.config file that enables role management, see Roles.
Security Note
|
|---|
This example contains a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview. |
Available since 2.0
.jpeg?cs-save-lang=1&cs-lang=cpp)
.jpeg?cs-save-lang=1&cs-lang=cpp)