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

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.ApplicationServices.dll

Quita los nombres de usuario especificados de los roles especificados para el applicationName configurado.

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

Parámetros

usernames

String[]

Matriz de cadenas de nombres de usuario que se quitará de los roles especificados.

roleNames

String[]

Matriz de cadenas de nombres de rol de los que se quitan los nombres de usuario especificados.

Ejemplos

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

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

Comentarios

RemoveUsersFromRoles llama a los RemoveUserFromRole métodos , RemoveUsersFromRole , RemoveUserFromRoles y RemoveUsersFromRoles de la Roles clase para quitar los usuarios especificados de los roles especificados en el origen de datos. Solo se modifican los roles para el configurado ApplicationName .

Si no se encuentra alguno de los nombres de rol especificados para el configurado applicationName, se recomienda que el proveedor inicie una ProviderExceptionexcepción .

Si alguno de los nombres de usuario especificados no está asociado a ninguno de los nombres de rol especificados para el configurado applicationName, se recomienda que el proveedor inicie una ProviderExceptionexcepción .

Si alguno de los nombres de usuario especificados es null o es una cadena vacía, se recomienda que el proveedor produzca una excepción.

Si alguno de los nombres de rol especificados es null o es una cadena vacía, se recomienda que el proveedor inicie una excepción.

Si el origen de datos admite transacciones, se recomienda incluir cada operación de eliminación en una transacción y revertir la transacción e iniciar una excepción si se produce un error en alguna operación de eliminación.

Consulte también

• Implementar un proveedor de roles