RoleProvider.AddUsersToRoles メソッド

.NET Framework クラス ライブラリ リファレンス

RoleProvider.AddUsersToRoles メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたユーザー名を、構成済みの applicationName の指定されたロールに追加します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 AddUsersToRoles ( _
    usernames As String(), _
    roleNames As String() _
)

Visual Basic (使用法)

Dim instance As RoleProvider
Dim usernames As String()
Dim roleNames As String()

instance.AddUsersToRoles(usernames, roleNames)

C#

public abstract void AddUsersToRoles (
    string[] usernames,
    string[] roleNames
)

C++

public:
virtual void AddUsersToRoles (
    array<String^>^ usernames, 
    array<String^>^ roleNames
) abstract

J#

public abstract void AddUsersToRoles (
    String[] usernames, 
    String[] roleNames
)

JScript

public abstract function AddUsersToRoles (
    usernames : String[], 
    roleNames : String[]
)

パラメータ

usernames

指定されたロールに追加するユーザー名の文字列配列。

roleNames

指定されたユーザー名の割り当て先となるロール名の文字列配列。

解説

AddUsersToRoles は Roles によって呼び出され、指定されたユーザーをデータ ソースの指定されたロールに関連付けます。ロールは構成済み ApplicationName に追加されます。

構成済みの applicationName に指定された roleNames が見つからない場合、プロバイダから ProviderException をスローすることをお勧めします。

指定された usernames のいずれかが構成済みの applicationName の指定された roleNames に関連付けられない場合、プロバイダから ProviderException をスローすることをお勧めします。

指定された usernames のいずれかが null 参照 (Visual Basic では Nothing) または空の文字列である場合、プロバイダから例外をスローすることをお勧めします。

指定された roleNames のいずれかが null 参照 (Visual Basic では Nothing) または空の文字列である場合、プロバイダから例外をスローすることをお勧めします。

データ ソースがトランザクションをサポートしている場合、1 回のトランザクションに 1 回の追加操作を含め、追加操作が失敗すると、そのトランザクションをロールバックして例外をスローすることをお勧めします。

使用例

AddUsersToRoles メソッドの実装サンプルを次のコード例に示します。

Visual Basic

Public Overrides Sub AddUsersToRoles(usernames
 As String(), 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.")
    If username.IndexOf(",") >
 0 Then _
      Throw New ArgumentException("User
 names cannot contain commas.")

    For Each rolename As String
 In rolenames
      If IsUserInRole(username, rolename) Then
        Throw New ProviderException("User
 is already in role.")
      End If
    Next
  Next


  Dim conn As OdbcConnection = New
 OdbcConnection(connectionString)
  Dim cmd As OdbcCommand = New
 OdbcCommand("INSERT INTO [" & usersInRolesTable
 & "]" & _
                                           " (Username, Rolename,
 ApplicationName) " & _
                                           " Values(?, ?, ?)",
 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

C#

public override void AddUsersToRoles(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.");
    if (username.IndexOf(',') > 0)
      throw new ArgumentException("User names cannot contain
 commas.");

    foreach (string rolename in
 rolenames)
    {
      if (IsUserInRole(username, rolename))
        throw new ProviderException("User is already in
 role.");
    }
  }


  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("INSERT INTO ["
 + usersInRolesTable + "]"  +
                                    " (Username, Rolename, ApplicationName)
 " +
                                    " Values(?, ?, ?)", 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();      
  }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RoleProvider クラス
RoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロール プロバイダの実装