UserPermissionCollection.Add メソッド (String, PermissionType, DateTime)

指定したユーザー用の現在のフォームで、指定したアクセス許可と有効期限日を使用し、新しいアクセス許可のセットを作成します。

名前空間: 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
  現在のフォームのアクセス許可を付与するユーザーの電子メール アドレス (user@domain.com 形式)。

• permission
  現在のフォームで、1 つ以上の PermissionType 値の組み合わせとして、指定したユーザーに付与するアクセス許可。

• expirationDate
  System.DateTime 値として付与されるアクセス許可の有効期限日。

戻り値

指定したユーザーを表す UserPermission。

例外処理

例外の種類	条件
FormatException	指定した DateTime 値は無効です。
ArgumentNullException	このメソッドに渡されたパラメータは null です。
ArgumentException	このメソッドに渡されたパラメータは有効ではありません。たとえば、型または形式が正しくありません。
SecurityException	フォーム テンプレートが、[フォームのオプション] ダイアログ ボックスの [セキュリティと信頼] カテゴリを使用して [完全信頼] として構成されていません。

コメント

このメンバは、[フォームのオプション] ダイアログ ボックスの [セキュリティと信頼] カテゴリを使用して完全信頼で実行するように構成されているフォーム テンプレートから開かれたフォームだけがアクセスできます。このメンバは、直接呼出し元に対する完全な信頼が必要であり、部分的に信頼されたコードで使用することはできません。詳細については、MSDN の「部分的に信頼されたコードからライブラリを使用する」を参照してください。

この型またはメンバは、Microsoft Office InfoPath 2007 で開いているフォームで実行されているコードからのみアクセスできます。

例

次の例では、[ボタン] コントロールをクリックすると、現在のフォームの 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

関連項目

参照

UserPermissionCollection クラス
UserPermissionCollection のメンバ
Microsoft.Office.InfoPath 名前空間