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

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.ApplicationServices.dll

Odebere zadaná uživatelská jména ze zadaných rolí pro nakonfigurovaný applicationNameobjekt .

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

Parametry

usernames

String[]

Pole řetězců uživatelských jmen, která mají být odebrána ze zadaných rolí.

roleNames

String[]

Pole řetězců s názvy rolí, ze které chcete odebrat zadaná uživatelská jména.

Příklady

Následující příklad kódu ukazuje ukázkovou implementaci RemoveUsersFromRoles metody.

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

Poznámky

RemoveUsersFromRolesje volána metodami RemoveUserFromRoleRoles , RemoveUsersFromRole , RemoveUserFromRoles a RemoveUsersFromRoles třídy k odebrání zadaných uživatelů ze zadaných rolí ve zdroji dat. Upraví se jenom role pro nakonfigurované ApplicationName .

Pokud se pro nakonfigurovaný applicationNameobjekt nenajde žádný ze zadaných názvů rolí , doporučujeme, aby váš zprostředkovatel vyvolal ProviderException.

Pokud některé ze zadaných uživatelských jmen není přidruženo k žádnému ze zadaných názvů rolí pro nakonfigurovanou applicationNameslužbu , doporučujeme, aby váš zprostředkovatel vyvolal ProviderException.

Pokud některé ze zadaných uživatelských jmen je null nebo je prázdný řetězec, doporučujeme, aby váš poskytovatel vyvolal výjimku.

Pokud některý ze zadaných názvů rolí je null nebo je prázdný řetězec, doporučujeme, aby váš zprostředkovatel vyvolal výjimku.

Pokud zdroj dat podporuje transakce, doporučujeme zahrnout každou operaci odebrání do transakce a vrátit transakci zpět a vyvolat výjimku, pokud jakákoli operace odebrání selže.

Viz také

• Implementace zprostředkovatele role