RoleProvider.CreateRole(String) Méthode

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Assembly:

System.Web.ApplicationServices.dll

Ajoute un nouveau rôle à la source de données pour le applicationName configuré.

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)

Paramètres

roleName

String

Nom du rôle à créer.

Exemples

L’exemple de code suivant montre un exemple d’implémentation de la CreateRole méthode.

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

Remarques

CreateRole est appelé par la CreateRole méthode de la Roles classe pour ajouter le rôle spécifié à la source de données pour la configuration ApplicationName.

Si le nom de rôle spécifié existe déjà pour le paramètre configuré applicationName, est nullou est une chaîne vide, nous vous recommandons de lever une exception.

Si le nom de rôle spécifié contient une virgule, nous vous recommandons de lever une exception.

Si votre source de données limite la longueur du nom du rôle, par exemple, via une colonne de longueur fixe d’une table d’une base de données, nous vous recommandons de lever une exception si le nom du rôle dépasse la longueur maximale autorisée par la source de données.

Voir aussi

• Implémentation d’un fournisseur de rôles