Permission.Add(String, Object, Object) 方法

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::UserPermissionObject ^ Add(System::String ^ bstrUserId, System::Object ^ varPermission, System::Object ^ varExpirationDate);

public Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject Add (string bstrUserId, object varPermission, object varExpirationDate);

abstract member Add : string * obj * obj -> Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject

Public Function Add (bstrUserId As String, varPermission As Object, varExpirationDate As Object) As UserPermissionObject

参数

bstrUserId

String

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

varPermission

Object

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

varExpirationDate

Object

要授予的权限的到期日期，System.DateTime 值。 可选。

返回

UserPermissionObject

一个 UserPermissionObject 表示指定用户的 。

示例

在以下示例中，将使用 Add 方法将新用户添加到表单中，为该用户指定“完全控制”访问级别，并将到期日期设置为自当前日期起向后推算两天的日期。

此示例要求在表单模块的声明节中对 Microsoft.Office.Core 命名空间使用 using 或 Imports 指令。

_XDocument3 thisDoc = (_XDocument3)thisXDocument;

string strExpirationDate = DateTime.Today.AddDays(2).ToString();
DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

thisDoc.Permission.Add("someone@example.com",
   msoPermission.msoPermissionFullControl, dtExpirationDate);

Dim thisDoc As _XDocument3 = DirectCast(thisXDocument, _XDocument3)

Dim strExpirationDate As String = _
   DateTime.Today.AddDays(2).ToString()
dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

thisDoc.Permission.UserPermissions.Add("someone@example.com", _
   msoPermission.msoPermissionFullControl, dtExpirationDate)

注解

若要访问 MsoPermission 用于设置参数的 varPermission 枚举值，必须使用 Visual Studio 2012 或 Visual Studio 中“添加引用”对话框 的 COM 选项卡 设置对 Microsoft Office 14.0 对象库的引用。 这将建立对 Microsoft.Office.Core 命名空间成员的引用。

由于 Permission 对象及其成员对 Microsoft InfoPath 不熟悉，因此必须将 thisXDocument 变量返回的对象强制转换为 _XDocument3 类型才能访问此对象及其成员。 有关详细信息，请参阅如何：使用与 InfoPath 2003 不兼容的对象模型成员。

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