UserPermissionCollection.Add メソッド (String, DateTime)
現在のフォームに、有効期限と共に新しいユーザーを追加します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function Add ( _
userId As String, _
expirationDate As DateTime _
) As UserPermission
'使用
Dim instance As UserPermissionCollection
Dim userId As String
Dim expirationDate As DateTime
Dim returnValue As UserPermission
returnValue = instance.Add(userId, expirationDate)
public abstract UserPermission Add(
string userId,
DateTime expirationDate
)
パラメーター
- userId
型: System.String
現在のフォームのアクセス許可を付与するユーザーの電子メール アドレス (user@domain.com 形式)。
- expirationDate
型: System.DateTime
System.DateTime 値として付与されるアクセス許可の有効期限日。
戻り値
型: Microsoft.Office.InfoPath.UserPermission
指定したユーザーを表す UserPermission オブジェクト。
例外
例外 | 条件 |
---|---|
ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
SecurityException | フォーム テンプレートが、[フォームのオプション] ダイアログ ボックスの [セキュリティと信頼] カテゴリを使用して [完全信頼] として構成されていません。 |
解説
このメンバーには、[フォームのオプション] ダイアログ ボックスの [セキュリティ] または [信頼] カテゴリを使用して、完全な信頼を与えられて実行するように構成されたフォーム テンプレートから開かれたフォームのみがアクセスできます。このメンバーは、直接の呼び出し側の完全な信頼が必要であり、部分的に信頼されたコードでは使用できません。詳細については、MSDN の「部分信頼コードからのライブラリの使用」を参照してください。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、[ボタン] コントロールをクリックすると、現在のフォームの 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",
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", _
dtExpirationDate)
End Sub