RoleProvider.RemoveUsersFromRoles(String[], String[]) Метод

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.dll

Сборка:

System.Web.ApplicationServices.dll

Удаляет указанные имена пользователей из указанных ролей для настроенного приложения 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())

Параметры

usernames

String[]

Строковый массив имен пользователей, которых необходимо удалить из указанных ролей.

roleNames

String[]

Строковый массив имен ролей, из которых необходимо удалить указанных пользователей.

Примеры

В следующем примере кода показан пример реализации RemoveUsersFromRoles метода.

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

Комментарии

RemoveUsersFromRoles вызывается RemoveUserFromRole , RemoveUsersFromRole RemoveUserFromRoles и RemoveUsersFromRoles методы Roles класса для удаления указанных пользователей из указанных ролей в источнике данных. Изменяются только роли для настроенных ApplicationName ролей.

Если для настроенной applicationNameроли не найдено ни одного из указанных имен ролей, рекомендуется вызвать у поставщика исключение ProviderException.

Если какое-либо из указанных имен пользователей не связано ни с какими из указанных имен ролей для настроенного applicationName, рекомендуется вызвать у поставщика исключение ProviderException.

Если любое из указанных имен пользователей является null или является пустой строкой, рекомендуется, чтобы поставщик создает исключение.

Если любое из указанных имен ролей является null или является пустой строкой, рекомендуется, чтобы поставщик создает исключение.

Если источник данных поддерживает транзакции, рекомендуется включить каждую операцию удаления в транзакцию и выполнить откат транзакции и создать исключение при сбое операции удаления.

См. также раздел

• Реализация поставщика ролей