System.Web.Security.RoleProvider.CreateRole Method

Adds a new role to the data source for the configured applicationName.

Syntax

public abstract void CreateRole (string rolename)

Parameters

rolename
Documentation for this section has not yet been entered.

Remarks

RoleProvider.CreateRole(string) is called by the Roles.CreateRole(string) method of the System.Web.Security.Roles class to add the specified role to the data source for the configured RoleProvider.ApplicationName.

If the specified role name already exists for the configured applicationName, is null, or is an empty string, we recommend that your provider throw an exception.

If the specified role name contains a comma, we recommend that your provider throw an exception.

If your data source restricts the length of the role name, for example, through a fixed-length column of a table in a database, we recommend that you throw an exception if the role name exceeds the maximum length allowed by the data source.

Requirements

Namespace: System.Web.Security
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0