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は、RemoveUsersFromRoles RemoveUsersFromRole RemoveUserFromRoles 指定したユーザーをデータ ソースのRoles指定されたロールから削除するために、クラスのメソッドによってRemoveUserFromRole呼び出されます。 構成された ApplicationName ロールのみが変更されます。

指定したロール名のいずれかが構成済 applicationNameみで見つからない場合は、プロバイダー ProviderExceptionが .

指定したユーザー名のいずれかが、構成済applicationNameみの指定されたロール名に関連付けられていない場合は、プロバイダーが .ProviderException

指定したユーザー名 null のいずれかが空の文字列または空の文字列である場合は、プロバイダーが例外をスローすることをお勧めします。

指定したロール名 null のいずれかが空の文字列または空の文字列である場合は、プロバイダーが例外をスローすることをお勧めします。

データ ソースでトランザクションがサポートされている場合は、各削除操作をトランザクションに含め、削除操作が失敗した場合はトランザクションをロールバックして例外をスローすることをお勧めします。

こちらもご覧ください

• ロール プロバイダの実装