RoleProvider.RemoveUsersFromRoles(String[], String[]) Metodo

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Rimuove i nomi utente specificati dai ruoli indicati per l'oggetto applicationName configurato.

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())

Parametri

usernames

String[]

Matrice di stringhe di nomi utente da rimuovere dai ruoli specificati.

roleNames

String[]

Matrice di stringhe di nomi di ruoli da cui rimuovere i nomi utente specificati.

Esempio

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

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

Commenti

RemoveUsersFromRolesviene chiamato dai RemoveUserFromRole metodi , RemoveUserFromRolesRemoveUsersFromRole , e RemoveUsersFromRoles della Roles classe per rimuovere gli utenti specificati dai ruoli specificati nell'origine dati. Vengono modificati solo i ruoli per l'oggetto configurato ApplicationName .

Se uno dei nomi di ruolo specificati non viene trovato per l'oggetto configurato applicationName, è consigliabile che il provider generi un'eccezione ProviderException.

Se uno dei nomi utente specificati non è associato ad alcun nome di ruolo specificato per l'oggetto configurato applicationName, è consigliabile che il provider generi un'eccezione ProviderException.

Se uno dei nomi utente specificati è null o è una stringa vuota, è consigliabile che il provider generi un'eccezione.

Se uno dei nomi di ruolo specificati è null o è una stringa vuota, è consigliabile che il provider generi un'eccezione.

Se l'origine dati supporta le transazioni, è consigliabile includere ogni operazione di rimozione in una transazione e eseguire il rollback della transazione e generare un'eccezione se un'operazione di rimozione non riesce.

Vedi anche

• Implementazione di un provider di ruoli