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
型: System.String
現在のフォームのアクセス許可を付与するユーザーの電子メール アドレス (user@domain.com 形式)。
- permission
型: Microsoft.Office.InfoPath.PermissionType
現在のフォームで、1 つ以上の PermissionType 値の組み合わせとして、指定したユーザーに付与するアクセス許可。
- expirationDate
型: System.DateTime
System.DateTime 値として付与されるアクセス許可の有効期限日。
戻り値
型: Microsoft.Office.InfoPath.UserPermission
指定したユーザーを表す UserPermission。
例外
| 例外 | 条件 |
|---|---|
| FormatException | 指定した DateTime 値は無効です。 |
| 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",
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