ClientRoleProvider.GetRolesForUser(String) 메서드

정의

네임스페이스:

System.Web.ClientServices.Providers

어셈블리:

System.Web.Extensions.dll

지정된 사용자가 속한 역할의 이름을 가져옵니다.

public:
 override cli::array <System::String ^> ^ GetRolesForUser(System::String ^ username);

public override string[] GetRolesForUser (string username);

override this.GetRolesForUser : string -> string[]

Public Overrides Function GetRolesForUser (username As String) As String()

매개 변수

username

String

역할을 검색할 사용자의 이름입니다.

반환

String[]

username 속한 역할 이름 또는 사용자가 인증되지 않은 경우 빈 배열입니다.

예외

ArgumentException

username Empty 또는 null.

-또는-

username 인증된 현재 사용자의 사용자 이름이 아닙니다.

예제

다음 예제 코드는 이 메서드를 사용하여 역할 멤버 자격을 테스트하기 전에 사용자 로그인이 만료되었는지 여부를 확인하는 방법을 보여 줍니다. 이 코드는 유효한 모든 사용자가 하나 이상의 역할과 연결되어 있다고 가정합니다. 이 경우 GetRolesForUser 메서드는 로그인이 만료된 이전에 인증된 사용자에 대한 역할을 반환하지 않습니다. 사용자 로그인이 만료된 경우 이 코드는 로그인 대화 상자를 표시합니다. 그렇지 않으면 IsUserInRole 메서드를 호출하여 사용자가 "관리자" 역할에 있는지 여부를 확인합니다. 제한된 코드는 제공되지 않는 PerformManagerTask 메서드에 있습니다.

private void AttemptManagerTask()
{
    System.Security.Principal.IIdentity identity =
        System.Threading.Thread.CurrentPrincipal.Identity;

    // Return if the authentication type is not "ClientForms". 
    // This indicates that the user is logged out.
    if (!identity.AuthenticationType.Equals("ClientForms")) return;

    try
    {
        ClientRoleProvider provider =
            (ClientRoleProvider)System.Web.Security.Roles.Provider;
        String userName = identity.Name;

        // Determine whether the user login has expired by attempting
        // to retrieve roles from the service. Call the ResetCache method
        // to ensure that the roles are retrieved from the service. If no 
        // roles are returned, then the login has expired. This assumes 
        // that every valid user has been assigned to one or more roles.
        provider.ResetCache();
        String[] roles = provider.GetRolesForUser(userName);
        if (roles.Length == 0)
        {
            MessageBox.Show(
                "Your login has expired. Please log in again to access " +
                "the roles service.", "Attempting to access user roles...");

            // Call ValidateUser with empty strings in order to 
            // display the login dialog box configured as a 
            // credentials provider.
            if (!System.Web.Security.Membership.ValidateUser(
                String.Empty, String.Empty))
            {
                MessageBox.Show("Unable to authenticate. " +
                    "Cannot retrieve user roles.", "Not logged in",
                    MessageBoxButtons.OK, MessageBoxIcon.Error);
                return;
            }
        }

        if (provider.IsUserInRole(userName, "manager"))
        {
            PerformManagerTask();
        }
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show(
            "Unable to access the remote service. " +
            "Cannot retrieve user roles.", "Warning",
            MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}

Private Sub AttemptManagerTask()

    Dim identity As System.Security.Principal.IIdentity = _
        System.Threading.Thread.CurrentPrincipal.Identity

    ' Return if the authentication type is not "ClientForms". 
    ' This indicates that the user is logged out.
    If Not identity.AuthenticationType.Equals("ClientForms") Then Return

    Try

        Dim provider As ClientRoleProvider = _
            CType(System.Web.Security.Roles.Provider, ClientRoleProvider)
        Dim userName As String = identity.Name

        ' Determine whether the user login has expired by attempting
        ' to retrieve roles from the service. Call the ResetCache method
        ' to ensure that the roles are retrieved from the service. If no 
        ' roles are returned, then the login has expired. This assumes 
        ' that every valid user has been assigned to one or more roles.
        provider.ResetCache()
        Dim roles As String() = provider.GetRolesForUser(userName)
        If roles.Length = 0 Then

            MessageBox.Show( _
                "Your login has expired. Please log in again to access " & _
                "the roles service.", "Attempting to access user roles...")

            ' Call ValidateUser with empty strings in order to 
            ' display the login dialog box configured as a 
            ' credentials provider.
            If Not System.Web.Security.Membership.ValidateUser( _
                String.Empty, String.Empty) Then

                MessageBox.Show("Unable to authenticate. " & _
                    "Cannot retrieve user roles.", "Not logged in", _
                    MessageBoxButtons.OK, MessageBoxIcon.Error)
                Return

            End If

        End If

        If provider.IsUserInRole(userName, "manager") Then
            PerformManagerTask()
        End If

    Catch ex As System.Net.WebException

        MessageBox.Show( _
            "Unable to access the remote service. " & _
            "Cannot retrieve user roles.", "Warning", _
            MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

End Sub

설명

GetRolesForUser 메서드는 username 매개 변수에 지정해야 하는 현재 인증된 사용자에 대한 역할 정보를 검색합니다. 다음과 같이 staticThread.CurrentPrincipal 속성을 통해 사용자 이름을 가져올 수 Thread.CurrentPrincipal.Identity.Name.

서비스 공급자는 불필요한 서비스 호출을 방지하기 위해 로컬 파일 시스템에 대한 역할 정보를 캐시합니다. 자세한 내용은 ClientRoleProvider 클래스 개요를 참조하세요.

추가 정보

• CurrentPrincipal
• IsUserInRole(String, String)
• Client Application Services
• 방법: 클라이언트 애플리케이션 서비스 구성