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

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Remove os nomes de usuário especificados das funções especificadas para o 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[]

Uma matriz de cadeia de caracteres de nomes de usuário a serem removidos das funções especificadas.

roleNames

String[]

Uma matriz de cadeia de caracteres de nomes de função das quais remover os nomes de usuário especificados.

Exemplos

O exemplo de código a seguir mostra uma implementação de exemplo do 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

Comentários

RemoveUsersFromRoles é chamado pelos RemoveUserFromRole métodos , RemoveUsersFromRole , RemoveUserFromRoles e RemoveUsersFromRoles da Roles classe para remover os usuários especificados das funções especificadas na fonte de dados. Somente as funções para o configurado ApplicationName são modificadas.

Se qualquer um dos nomes de função especificados não for encontrado para o configurado applicationName, recomendamos que seu provedor gere um ProviderException.

Se qualquer um dos nomes de usuário especificados não estiver associado a nenhum dos nomes de função especificados para o configurado applicationName, recomendamos que seu provedor gere um ProviderException.

Se qualquer um dos nomes de usuário especificados for null ou for uma cadeia de caracteres vazia, recomendamos que seu provedor gere uma exceção.

Se qualquer um dos nomes de função especificados for null ou for uma cadeia de caracteres vazia, recomendamos que seu provedor gere uma exceção.

Se a fonte de dados der suporte a transações, recomendamos que você inclua cada operação de remoção em uma transação e reverta a transação e gere uma exceção se qualquer operação de remoção falhar.

Confira também

• Implementando um provedor de função