乐胖代购免代理版

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

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

C++

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

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

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