My.User.IsInRole 메서드

아티클
08/20/2008

업데이트: 2007년 11월

현재 사용자가 지정된 역할에 속하는지 여부를 확인합니다.

' Usage
Dim value As Boolean = My.User.IsInRole(role)
Dim value As Boolean = My.User.IsInRole(role)
' Declaration
Public Function IsInRole( _
ByVal role As String _
) As Boolean
' -or-
Public Function IsInRole( _
ByVal role As BuiltInRole _
) As Boolean

매개 변수

role
String 또는 BuiltInRole 열거형. 멤버 자격을 확인하기 위한 역할입니다.

반환 값

현재 사용자가 지정된 역할의 멤버인 경우 True를 반환하고 그렇지 않은 경우 False를 반환합니다.

설명

My.User.IsInRole 메서드를 사용하여 사용자 코드에서 현재 사용자가 지정된 역할의 멤버인지 여부를 확인할 수 있습니다.

문자열을 사용하는 My.User.IsInRole 메서드의 오버로드를 사용하면 현재 보안 주체의 IsInRole 메서드에 쉽게 액세스할 수 있습니다.

BuiltInRole 열거형을 사용하는 My.User.IsInRole 메서드의 오버로드는 현재 보안 주체에 따라 다르게 동작합니다. Windows 사용자 보안 주체(WindowsPrincipal)인 경우 이 함수는 role을 해당하는 WindowsBuiltInRole 열거형으로 변환하고 IsInRole 호출 결과를 반환합니다. 현재 보안 주체가 다른 보안 주체인 경우 이 함수는 role의 열거형 값 이름을 보안 주체의 IsInRole 메서드로 전달합니다.

참고:
My.User 개체의 정확한 동작은 응용 프로그램을 실행하는 운영 체제 및 응용 프로그램의 종류에 따라 달라집니다. 자세한 내용은 My.User 개체를 참조하십시오.

작업

작업	참조
사용자의 역할 확인	방법: 사용자가 그룹에 있는지 여부 확인

예제

이 예제에서는 리소스에 액세스하기 전에 사용자가 관리자인지 여부를 확인합니다.

If My.User.IsInRole( _
        ApplicationServices.BuiltInRole.Administrator) Then
    ' Insert code to access a resource here.
End If

요구 사항

네임스페이스:Microsoft.VisualBasic.ApplicationServices

클래스:User, WebUser

어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예