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

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Assembly:

System.Web.ApplicationServices.dll

Entfernt die angegebenen Benutzernamen aus den angegebenen Rollen der konfigurierten applicationName.

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

Parameter

usernames

String[]

Ein Zeichenfolgenarray mit Benutzernamen, die aus den angegebenen Rollen entfernt werden sollen.

roleNames

String[]

Ein Zeichenfolgenarray mit Rollennamen, aus denen Benutzernamen entfernt werden sollen.

Beispiele

Im folgenden Codebeispiel wird eine Beispielimplementierung der RemoveUsersFromRoles Methode gezeigt.

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

Hinweise

RemoveUsersFromRoles wird von RemoveUserFromRole , , RemoveUsersFromRole RemoveUserFromRoles und RemoveUsersFromRoles Methoden der Roles Klasse aufgerufen, um die angegebenen Benutzer aus den angegebenen Rollen in der Datenquelle zu entfernen. Nur Rollen für die konfigurierte Datei ApplicationName werden geändert.

Wenn eine der angegebenen Rollennamen für die konfigurierte applicationNameRolle nicht gefunden wird, empfehlen wir, dass Ihr Anbieter einen ProviderExceptionFehler ausgelöst hat.

Wenn einer der angegebenen Benutzernamen keinem der angegebenen Rollennamen für die konfigurierte applicationNameRolle zugeordnet ist, empfehlen wir, dass Ihr Anbieter einen ProviderExceptionFehler ausgelöst hat.

Wenn eine der angegebenen Benutzernamen eine leere Zeichenfolge ist oder eine leere Zeichenfolge ist null , empfehlen wir, dass Ihr Anbieter eine Ausnahme ausgelöst hat.

Wenn eine der angegebenen Rollennamen eine leere Zeichenfolge ist oder eine leere Zeichenfolge ist null , empfehlen wir, dass Ihr Anbieter eine Ausnahme ausgelöst hat.

Wenn Ihre Datenquelle Transaktionen unterstützt, empfehlen wir Ihnen, jeden Entfernenvorgang in eine Transaktion aufzunehmen und die Transaktion zurückzurollen und eine Ausnahme zu auslösen, wenn ein Entfernenvorgang fehlschlägt.

Siehe auch

• Implementieren eines Rollenanbieters