User.IsUserMemberOf 메서드
현재 사용자가 지정된 그룹의 구성원인지 여부를 가져옵니다.
네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)
구문
‘선언
Public MustOverride Function IsUserMemberOf ( _
groupName As String _
) As Boolean
‘사용 방법
Dim instance As User
Dim groupName As String
Dim returnValue As Boolean
returnValue = instance.IsUserMemberOf(groupName)
public abstract bool IsUserMemberOf(
string groupName
)
매개 변수
- groupName
형식: System.String
도메인\그룹 이름형식의 그룹 이름입니다.
반환 값
형식: System.Boolean
현재 사용자가 지정된 그룹의 구성원이면 true이고 그렇지 않으면 false입니다.
예외
| 예외 | 조건 |
|---|---|
| ArgumentNullException | 이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다. |
| ArgumentException | 이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다. |
주의
IsUserMemberOf(String) 메서드가 보안 수준 2으로 표시되어 있어도 항상 액세스할 수 있는 것은 아닙니다. IsUserMemberOf(String) 메서드로 호출이 발생한 경우 InfoPath에서는 먼저 보안 검사를 수행하여 이 메서드에 대한 액세스가 허용되는지 확인합니다. 보안 검사는 호출 코드를 신뢰할 수 있는지 확인하고 이 코드의 위치를 확인합니다.
호출하는 코드를 신뢰할 수 있는 경우, 예를 들어 설치되었거나 서명된 InfoPath 양식 서식 파일 또는 로컬 컴퓨터의 실행 파일과 같이 신뢰할 수 있는 외부 코드에서 IsUserMemberOf(String) 메서드를 호출한 경우, InfoPath는 IsUserMemberOf(String) 메서드에 대한 전체 액세스를 허용합니다.
호출하는 코드를 신뢰할 수 없는 경우, 예를 들어 도메인 기반 InfoPath 양식 서식 파일에서 호출이 발생하는 경우, InfoPath는 먼저 호출이 어디서 발생되는지 확인합니다. 호출이 "https://www.contoso.com/example.xsn"과 같은 URL에 있는 InfoPath 양식 서식 파일의 신뢰할 수 없는 코드에서 발생하면 이 호출은 인터넷 영역에서 발생한 것입니다. InfoPath에서는 인터넷 영역에서 오는 신뢰할 수 없는 모든 호출에 대해 IsUserMemberOf(String) 메서드 액세스를 거부합니다. 호출이 "http://contoso/example.xsn"과 같은 URL에서 발생하면 이 호출은 인트라넷 영역에서 발생한 것입니다. 인트라넷 영역에서 오는 신뢰할 수 없는 호출의 경우 Internet Explorer 사용자 인증 설정이 자동 로그온(인트라넷 영역에만 해당되거나 모든 로그온에 해당됨)을 허용하는지 확인합니다. Internet Explorer가 자동 로그온을 허용하도록 구성되어 있는 경우 사용자의 그룹 등록을 확인합니다. 그룹 등록이 공개되어 있으면 InfoPath에서 IsUserMemberOf(String) 메서드에 대한 전체 액세스가 허용됩니다. 그룹 등록이 완전히 공개되어 있지 않은 경우에는 결과가 표시되지 않습니다. 다시 말해 그룹 등록이 보이지 않는 것으로 취급됩니다. 이 경우에는 그룹 등록이 공개되어 있지 않기 때문에 반환 값이 항상 false입니다. 액세스가 거부되었다는 사실은 보고되지 않습니다.
.gif "참고 사항") 참고 사항 |
|---|
그룹 등록 정보는 이에 대한 액세스가 허용되고 익명이 아닌 사용자가 정보를 볼 수 있는 경우 완전하게 공개됩니다. 익명이 아닌 사용자 한 명이라도 등록 정보에 액세스할 수 없으면 그룹 등록 정보는 완전하게 공개되지 않습니다. |
이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.
이 형식 또는 멤버는 Microsoft InfoPath Filer에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.
예
다음 예제에서 단추 컨트롤을 클릭하여 현재 사용자가 지정된 그룹의 구성원인지 여부를 표시합니다.
public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
MessageBox.Show(
this.Application.User.IsUserMemberOf(
"CONTOSO\\Users").ToString());
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
MessageBox.Show( _
Me.Application.User.IsUserMemberOf("CONTOSO\\Users").ToString())
End Sub