RoleProvider.RemoveUsersFromRoles(String[], String[]) Méthode

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Assembly:

System.Web.ApplicationServices.dll

Supprime les noms d’utilisateur spécifiés des rôles spécifiés pour le applicationName configuré.

public:
 abstract void RemoveUsersFromRoles(cli::array <System::String ^> ^ usernames, cli::array <System::String ^> ^ roleNames);

public abstract void RemoveUsersFromRoles (string[] usernames, string[] roleNames);

abstract member RemoveUsersFromRoles : string[] * string[] -> unit

Public MustOverride Sub RemoveUsersFromRoles (usernames As String(), roleNames As String())

Paramètres

usernames

String[]

Tableau de chaînes contenant les noms d’utilisateur à supprimer des rôles spécifiés.

roleNames

String[]

Tableau de chaînes contenant les noms de rôles desquels supprimer les noms d’utilisateur spécifiés.

Exemples

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

public override void RemoveUsersFromRoles(string[] usernames, string[] rolenames)
{
  foreach (string rolename in rolenames)
  {
    if (rolename == null || rolename == "")
      throw new ProviderException("Role name cannot be empty or null.");
    if (!RoleExists(rolename))
      throw new ProviderException("Role name not found.");
  }

  foreach (string username in usernames)
  {
    if (username == null || username == "")
      throw new ProviderException("User name cannot be empty or null.");

    foreach (string rolename in rolenames)
    {
      if (!IsUserInRole(username, rolename))
        throw new ProviderException("User is not in role.");
    }
  }

  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("DELETE FROM UsersInRoles "  +
                                    " WHERE Username = ? AND Rolename = ? AND ApplicationName = ?", conn);

  OdbcParameter userParm = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255);
  OdbcParameter roleParm = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255);
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;

  try
  {
    conn.Open();

    foreach (string username in usernames)
    {
      foreach (string rolename in rolenames)
      {
        userParm.Value = username;
        roleParm.Value = rolename;
        cmd.ExecuteNonQuery();
      }
    }
  }
  catch (OdbcException)
  {
    // Handle exception.
  }
  finally
  {
    conn.Close();      
  }
}

Public Overrides Sub RemoveUsersFromRoles(ByVal usernames As String(), ByVal rolenames As String())

    For Each rolename As String In rolenames
        If rolename Is Nothing OrElse rolename = "" Then _
          Throw New ProviderException("Role name cannot be empty or null.")
        If Not RoleExists(rolename) Then _
          Throw New ProviderException("Role name not found.")
    Next

    For Each username As String In usernames
        If username Is Nothing OrElse username = "" Then _
          Throw New ProviderException("User name cannot be empty or null.")

        For Each rolename As String In rolenames
            If Not IsUserInRole(username, rolename) Then
                Throw New ProviderException("User is not in role.")
            End If
        Next
    Next

    Dim conn As OdbcConnection = New OdbcConnection(connectionString)
    Dim cmd As OdbcCommand = New OdbcCommand("DELETE FROM UsersInRoles " & _
                                             " WHERE Username = ? AND Rolename = ? AND ApplicationName = ?", conn)

    Dim userParm As OdbcParameter = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255)
    Dim roleParm As OdbcParameter = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255)
    cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName

    Try
        conn.Open()

        For Each username As String In usernames
            For Each rolename As String In rolenames
                userParm.Value = username
                roleParm.Value = rolename
                cmd.ExecuteNonQuery()
            Next
        Next
    Catch e As OdbcException
        ' Handle exception.
    Finally
        conn.Close()
    End Try
End Sub

Remarques

RemoveUsersFromRoles est appelé par RemoveUserFromRole , , RemoveUsersFromRole et RemoveUserFromRoles RemoveUsersFromRoles méthodes de la Roles classe pour supprimer les utilisateurs spécifiés des rôles spécifiés à la source de données. Seuls les rôles pour la configuration ApplicationName sont modifiés.

Si l’un des noms de rôles spécifiés n’est pas trouvé pour le paramètre configuré applicationName, nous vous recommandons de lever un ProviderException.

Si l’un des noms d’utilisateur spécifiés n’est associé à aucun des noms de rôle spécifiés pour le paramètre configuré applicationName, nous vous recommandons de lever un ProviderException.

Si l’un des noms d’utilisateur spécifiés est null ou est une chaîne vide, nous vous recommandons de lever une exception.

Si l’un des noms de rôles spécifiés est null ou est une chaîne vide, nous vous recommandons de lever une exception.

Si votre source de données prend en charge les transactions, nous vous recommandons d’inclure chaque opération de suppression dans une transaction et de restaurer la transaction et de lever une exception si une opération de suppression échoue.

Voir aussi

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