RoleProvider.CreateRole(String) Metodo

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Aggiunge un nuovo ruolo all'origine dati per l'oggetto applicationName configurato.

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)

Parametri

roleName

String

Nome del ruolo da creare.

Esempio

Nell'esempio di codice seguente viene illustrata un'implementazione di esempio del CreateRole metodo .

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

Commenti

CreateRole viene chiamato dal CreateRole metodo della Roles classe per aggiungere il ruolo specificato all'origine dati per l'oggetto configurato ApplicationName.

Se il nome del ruolo specificato esiste già per l'oggetto configurato applicationName, è nullo è una stringa vuota, è consigliabile che il provider generi un'eccezione.

Se il nome del ruolo specificato contiene una virgola, è consigliabile che il provider generi un'eccezione.

Se l'origine dati limita la lunghezza del nome del ruolo, ad esempio tramite una colonna a lunghezza fissa di una tabella in un database, è consigliabile generare un'eccezione se il nome del ruolo supera la lunghezza massima consentita dall'origine dati.

Vedi anche

• Implementazione di un provider di ruoli