UserPermissionCollection.Add 方法

定义

重载

Add(String)

向当前表单添加新用户。

Add(String, PermissionType)

添加具有指定权限的新用户。

Add(String, DateTime)

向当前表单添加新用户并设定到期日期。

Add(String, PermissionType, DateTime)

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

Add(String)

向当前表单添加新用户。

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId);
abstract member Add : string -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String) As UserPermission

参数

userId
String

要向其授予当前表单权限的用户格式 user@domain.com 的电子邮件地址。

返回

一个 UserPermission 表示指定用户的 对象。

例外

传递给此方法的参数是一个 null 引用, (Visual Basic) 中无任何内容。

传递给此方法的参数无效。 例如,它的类型或格式有误。

没有使用“表单选项”对话框的“安全和信任”类别将表单模板配置为“完全信任”。

示例

在下面的示例中,单击“按钮”控件将获得当前表单的 UserPermissionsCollection,然后添加新用户。

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com");
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com")
End Sub

注解

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

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

适用于

Add(String, PermissionType)

添加具有指定权限的新用户。

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType) As UserPermission

参数

userId
String

要向其授予当前表单权限的用户格式 user@domain.com 的电子邮件地址。

permission
PermissionType

当前窗体上作为一个或多个 PermissionType 值的组合授予指定用户的权限。

返回

表示 UserPermission指定用户的 .object。

例外

传递给此方法的参数是一个 null 引用, (Visual Basic) 中无任何内容。

传递给此方法的参数无效。 例如,它的类型或格式有误。

没有使用“表单选项”对话框的“安全和信任”类别将表单模板配置为“完全信任”。

示例

在下面的示例中,单击“按钮”控件将获得当前表单的 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

注解

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

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

适用于

Add(String, DateTime)

向当前表单添加新用户并设定到期日期。

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, DateTime expirationDate);
abstract member Add : string * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, expirationDate As DateTime) As UserPermission

参数

userId
String

要向其授予当前表单权限的用户格式 user@domain.com 的电子邮件地址。

expirationDate
DateTime

要授予的权限的到期日期,System.DateTime 值。

返回

一个 UserPermission 表示指定用户的 对象。

例外

传递给此方法的参数是一个 null 引用, (Visual Basic) 中无任何内容。

传递给此方法的参数无效。 例如,它的类型或格式有误。

没有使用“表单选项”对话框的“安全和信任”类别将表单模板配置为“完全信任”。

示例

在下面的示例中,单击“按钮”控件将获得当前表单的 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",
      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

注解

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

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

适用于

Add(String, PermissionType, DateTime)

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

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission, DateTime expirationDate);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType, expirationDate As DateTime) As UserPermission

参数

userId
String

要向其授予当前表单权限的用户格式 user@domain.com 的电子邮件地址。

permission
PermissionType

当前窗体上作为一个或多个 PermissionType 值的组合授予指定用户的权限。

expirationDate
DateTime

要授予的权限的到期日期,System.DateTime 值。

返回

一个 UserPermission 表示指定用户的 。

例外

提供的 DateTime 值无效。

传递给此方法的参数是 null 引用, (Visual Basic) 中没有。

传递给此方法的参数无效。 例如,它们的类型或格式有误。

没有使用“表单选项”对话框的“安全和信任”类别将表单模板配置为“完全信任”。

示例

在下面的示例中,单击“按钮”控件将获得当前表单的 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

注解

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

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

适用于