Roles.CreateRole Method
Adds a new role to the data source.
Namespace: System.Web.Security
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 a null reference (Nothing in Visual Basic). |
| 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.
.gif?cs-save-lang=1&cs-lang=fsharp "Note") 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.
.gif?cs-save-lang=1&cs-lang=fsharp "Security note") 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. |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
