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