UserPermissionCollection.Add 方法 (String, PermissionType, DateTime)

项目
05/13/2015

使用指定的权限和到期日期在当前表单上为指定用户创建一组新权限。

命名空间： 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	传递给此方法的参数为空引用（无在 Visual Basic 中）。
ArgumentException	传递给此方法的参数无效。例如，它们的类型或格式有误。
SecurityException	没有使用"表单选项"对话框的"安全和信任"类别将表单模板配置为"完全信任"。

备注

只能由从表单模板打开的表单访问此成员，已使用"表单选项"对话框"安全和信任"类别将该模板配置为以完全信任状态运行。此成员要求直接调用方的完全信任并且不能由部分信任的代码使用。有关更多信息，请参阅 MSDN 上的"使用部分信任的代码中的库"。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

示例

在下面的示例中，单击"按钮"控件将获得当前表单的 UserPermissionsCollection，添加用户并为其指定"完全控制"访问级别，然后将到期日期设为从当前日期起向后推算两天的日期。

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