ClientRolePrincipal 클래스


클라이언트 애플리케이션 서비스에 대한 역할 정보를 비롯한 보안 정보를 나타냅니다.Represents security information for client application services, which includes role information.

public ref class ClientRolePrincipal : System::Security::Principal::IPrincipal
public class ClientRolePrincipal : System.Security.Principal.IPrincipal
type ClientRolePrincipal = class
    interface IPrincipal
Public Class ClientRolePrincipal
Implements IPrincipal


다음 예제 코드에서는 사용자가 "manager" 역할인 경우에 단추를 표시 하려면이 클래스를 사용 하는 방법에 설명 합니다.The following example code demonstrates how to use this class to display a button only when the user is in the "manager" role. 이 예제는 Button 라는 managerOnlyButton 초기값을 사용 하 여 Visible 속성 값 false합니다.This example requires a Button named managerOnlyButton with an initial Visible property value of false.

private void DisplayButtonForManagerRole()
        ClientRolePrincipal rolePrincipal =
            as ClientRolePrincipal;

        if (rolePrincipal != null && rolePrincipal.IsInRole("manager"))
            managerOnlyButton.Visible = true;
    catch (System.Net.WebException)
        MessageBox.Show("Unable to access the roles service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
Private Sub DisplayButtonForManagerRole()


        Dim rolePrincipal As ClientRolePrincipal = TryCast( _
            System.Threading.Thread.CurrentPrincipal, ClientRolePrincipal)

        If rolePrincipal IsNot Nothing And _
            rolePrincipal.IsInRole("manager") Then

            managerOnlyButton.Visible = True

        End If

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the role service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

End Sub


클라이언트 애플리케이션 서비스에서 사용자의 유효성을 검사할 때 합니다 ClientFormsAuthenticationMembershipProvider 또는 ClientWindowsAuthenticationMembershipProvider 설정 합니다 staticThread.CurrentPrincipal 이 클래스의 인스턴스에 대 한 속성입니다.When you validate a user in client application services, the ClientFormsAuthenticationMembershipProvider or the ClientWindowsAuthenticationMembershipProvider sets the static Thread.CurrentPrincipal property to an instance of this class. ClientFormsAuthenticationMembershipProvider 초기화를 Identity 속성의 새 인스턴스를 ClientFormsIdentity 클래스.The ClientFormsAuthenticationMembershipProvider initializes the Identity property to a new instance of the ClientFormsIdentity class. ClientWindowsAuthenticationMembershipProvider 초기화를 Identity 속성을 합니다 WindowsIdentity 에서 반환 된 개체를 static WindowsIdentity.GetCurrent() 메서드.The ClientWindowsAuthenticationMembershipProvider initializes the Identity property to the WindowsIdentity object returned by the static WindowsIdentity.GetCurrent() method.

수는 없습니다 일반적으로이 클래스에 직접 액세스 합니다.You will not typically access this class directly. 일반적으로 호출 하는 IsInRole 메서드를 IPrincipal 반환한를 static CurrentPrincipal 속성.Normally, you will call the IsInRole method of the IPrincipal returned by the static CurrentPrincipal property. 캐스팅할 수 있습니다는 CurrentPrincipal 속성 값을 ClientRolePrincipal 호출에 대 한 참조를 IsInRole 메서드 예제 단원에 설명 된 대로 명시적으로 합니다.However, you can cast the CurrentPrincipal property value to a ClientRolePrincipal reference to call the IsInRole method explicitly, as demonstrated in the Example section.



ClientRolePrincipal 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClientRolePrincipal class.



ClientRolePrincipal과 관련된 보안 ID를 가져옵니다.Gets the security identity associated with the ClientRolePrincipal.



지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)

ClientRolePrincipal로 나타낸 사용자가 지정된 역할에 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the user represented by the ClientRolePrincipal is in the specified role.


현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상

추가 정보