RoleProvider.AddUsersToRoles(String[], String[]) 메서드

정의

네임스페이스:

System.Web.Security

어셈블리:

System.Web.dll

어셈블리:

System.Web.ApplicationServices.dll

구성된 applicationName의 지정된 역할에 지정된 사용자 이름을 추가합니다.

public:
 abstract void AddUsersToRoles(cli::array <System::String ^> ^ usernames, cli::array <System::String ^> ^ roleNames);

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

abstract member AddUsersToRoles : string[] * string[] -> unit

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

매개 변수

usernames

String[]

지정된 역할에 추가할 사용자 이름으로 이루어진 문자열 배열입니다.

roleNames

String[]

지정된 사용자 이름을 추가할 역할 이름으로 이루어진 문자열 배열입니다.

예제

다음 코드 예제에서는 메서드의 샘플 구현을 AddUsersToRoles 보여줍니다.

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.Contains(","))
      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 UsersInRoles "  +
                                    " (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();      
  }
}

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.Contains(",") 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 UsersInRoles " & _
                                           " (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

설명

AddUsersToRoles 는 지정된 사용자를 데이터 원본의 지정된 역할에 연결하기 위해 클래스에서 호출 Roles 됩니다. 역할은 구성된 ApplicationName에 추가됩니다.

구성된 applicationName역할에 대해 지정된 역할 이름을 찾을 수 없는 경우 공급자가 을 throw ProviderException하는 것이 좋습니다.

지정된 사용자 이름 중 어느 이름도 구성된 applicationName지정된 역할 이름과 연결되지 않은 경우 공급자가 을 throw ProviderException하는 것이 좋습니다.

지정된 사용자 이름이 null 빈 문자열이거나 빈 문자열인 경우 공급자가 예외를 throw하는 것이 좋습니다.

지정된 역할 이름이 null 빈 문자열이거나 비어 있는 경우 공급자가 예외를 throw하는 것이 좋습니다.

데이터 원본이 트랜잭션을 지원하는 경우 트랜잭션에 각 추가 작업을 포함하고 트랜잭션을 롤백하고 추가 작업이 실패할 경우 예외를 throw하는 것이 좋습니다.

추가 정보

• 역할 공급자 구현