RoleProvider.CreateRole(String) Método

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.ApplicationServices.dll

Agrega un rol nuevo al origen de datos de la aplicación applicationName configurada.

public:
 abstract void CreateRole(System::String ^ roleName);

public abstract void CreateRole (string roleName);

abstract member CreateRole : string -> unit

Public MustOverride Sub CreateRole (roleName As String)

Parámetros

roleName

String

Nombre del rol que se va a crear.

Ejemplos

En el ejemplo de código siguiente se muestra una implementación de ejemplo del CreateRole método .

public override void CreateRole(string rolename)
{ 
  if (rolename == null || rolename == "")
    throw new ProviderException("Role name cannot be empty or null.");
  if (rolename.Contains(","))
    throw new ArgumentException("Role names cannot contain commas.");
  if (RoleExists(rolename))
    throw new ProviderException("Role name already exists.");
  if (rolename.Length > 255)
    throw new ProviderException("Role name cannot exceed 255 characters.");

  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("INSERT INTO Roles "  +
                                    " (Rolename, ApplicationName) " +
                                    " Values(?, ?)", conn);

  cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename;
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;

  try
  {
    conn.Open();

    cmd.ExecuteNonQuery();
  }
  catch (OdbcException)
  {
    // Handle exception.
  }
  finally
  {
    conn.Close();      
  }
}

Public Overrides Sub CreateRole(rolename As String) 
  If rolename Is Nothing OrElse rolename = "" Then _
    Throw New ProviderException("Role name cannot be empty or null.")
  If rolename.Contains(",") Then _
    Throw New ArgumentException("Role names cannot contain commas.")
  If RoleExists(rolename) Then _
    Throw New ProviderException("Role name already exists.")
  If rolename.Length > 255 Then _
    Throw New ProviderException("Role name cannot exceed 255 characters.")

  Dim conn As OdbcConnection = New OdbcConnection(connectionString)
            Dim cmd As OdbcCommand = New OdbcCommand("INSERT INTO Roles " & _
                                                     " (Rolename, ApplicationName) " & _
                                                     " Values(?, ?)", conn)

            cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename
            cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName

            Try
                conn.Open()

                cmd.ExecuteNonQuery()
            Catch e As OdbcException
                ' Handle exception.
            Finally
                conn.Close()
            End Try
        End Sub

Comentarios

CreateRoleel método de la clase llama CreateRole a para agregar el rol especificado al origen de datos para el configuradoApplicationName.Roles

Si el nombre de rol especificado ya existe para el configurado applicationName, es nullo es una cadena vacía, se recomienda que el proveedor produzca una excepción.

Si el nombre de rol especificado contiene una coma, se recomienda que el proveedor produzca una excepción.

Si el origen de datos restringe la longitud del nombre del rol, por ejemplo, a través de una columna de longitud fija de una tabla en una base de datos, se recomienda iniciar una excepción si el nombre del rol supera la longitud máxima permitida por el origen de datos.

Consulte también

• Implementar un proveedor de roles