UserPermissionCollection.Add 메서드 (String, PermissionType, DateTime)

아티클
09/24/2014

지정된 권한과 만료 날짜를 사용하여 지정된 사용자의 현재 양식에 대한 새 권한 집합을 만듭니다.

네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)

구문

‘선언
Public MustOverride Function Add ( _
    userId As String, _
    permission As PermissionType, _
    expirationDate As DateTime _
) As UserPermission
‘사용 방법
Dim instance As UserPermissionCollection
Dim userId As String
Dim permission As PermissionType
Dim expirationDate As DateTime
Dim returnValue As UserPermission

returnValue = instance.Add(userId, permission, _
    expirationDate)

public abstract UserPermission Add(
    string userId,
    PermissionType permission,
    DateTime expirationDate
)

매개 변수

userId
형식: System.String
현재 양식에 대한 권한이 부여되는 사용자의 전자 메일 주소이며 user@domain.com 형식입니다.

permission
형식: Microsoft.Office.InfoPath.PermissionType
현재 양식에 대해 지정된 사용자에게 하나 이상의 PermissionType 값 조합으로 부여되는 사용 권한입니다.

expirationDate
형식: System.DateTime
System.DateTime 값으로 부여되는 사용 권한의 만료 날짜입니다.

반환 값

형식: Microsoft.Office.InfoPath.UserPermission
지정된 사용자를 나타내는 UserPermission입니다.

예외

예외	조건
FormatException	제공된 DateTime 값이 올바르지 않습니다.
ArgumentNullException	이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다.
ArgumentException	이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다.
SecurityException	양식 옵션 대화 상자의 보안 및 신뢰 범주를 사용하여 양식 서식 파일이 전체 신뢰로 구성되어 있지 않습니다.

주의

이 멤버는 양식 옵션 대화 상자의 보안 및 신뢰 범주에서 완전히 신뢰할 수 있는 상태로 실행되도록 구성된 양식 서식 파일에서 연 양식에서만 액세스할 수 있습니다. 이 멤버를 사용하려면 직접 실행 호출자에 대한 전체 신뢰가 필요하며 부분적으로 신뢰할 수 있는 코드에서는 사용할 수 없습니다. 자세한 내용은 MSDN의 "부분적으로 신뢰할 수 있는 코드에서 라이브러리 사용"을 참조하십시오.

이 형식 또는 멤버는 Microsoft InfoPath Filer에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.

예

다음 예제에서는 단추 컨트롤을 클릭하여 현재 양식에 대한 UserPermissionsCollection을 가져오고, 모든 권한 액세스 수준에 사용자를 추가 및 할당하고, 만료 날짜를 현재 날짜로부터 2일로 설정합니다.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl, dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl, dtExpirationDate)
End Sub