Permission 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

提供对可应用于窗体的 UserPermissionCollection 和 权限设置的访问权限。

public ref class Permission abstract

public abstract class Permission

type Permission = class

Public MustInherit Class Permission

继承

Object

Permission

注解

使用 Permission 类及其成员可以限制对活动表单的权限，以及获取或设置特定的权限设置。

与表单模板关联的 Permission 类的实例由 Microsoft.Office.InfoPath.Xmlform.Permission 类的 XmlForm 属性返回。 返回的 Permission 对象提供对与表单模板关联的对象的集合 UserPermission 以及使用该模板创建的每个表单实例的访问权限。 每个 UserPermission 对象都用于为单个用户定义一组特定的权限。 虽然通过用户界面授予的某些权限适用于所有用户，但可以使用 UserPermission 对象为各个用户单独指定权限及到期日期。

不论权限是否仅限于活动的表单模板， Permission 对象及其属性和成员都可用。 Enabled使用 属性可确定窗体是否具有受限权限。

如果用户计算机上未安装 Windows 权限管理客户端，则使用 Permission 类将引发异常。

通过使用 Permission 类的属性和方法，可通过以下方式之一启用对窗体的权限：

将 Enabled 属性设置为 true。

属性 DocumentAuthor 已设置。

属性 RequestPermissionUrl 已设置。

属性 StoreLicenses 设置为 true 或 false。

调用 ApplyPolicy(String) 方法。

还可以通过使用 UserPermissionCollection 类的方法之Add(String)一将用户添加到表单的用户权限集合来启用对窗体的权限。

注意：当窗体处于预览模式时，无法应用权限。 因此，在预览表单时， Permission 类的所有属性都是只读的。 在预览模式下， Enabled 属性将始终返回 false，如果代码尝试更改此设置，则会引发 System.Runtime.InteropServices.COMException，并返回"该属性/方法在预览模式下不可用"错误。 同样，当在预览模式下使用时，与 UserPermission 和 UserPermissionCollection 类关联的属性和方法也将返回此错误消息。

构造函数

Permission()

提供对可应用于窗体的 UserPermissionCollection 和 权限设置的访问权限。

属性

DocumentAuthor	获取或设置当前表单作者的电子邮件地址。
Enabled	获取或设置一个值，指示是否对当前表单启用了 Permission 对象所代表的权限设置。
PermissionFromPolicy	获取一个值，指示是否对当前表单应用了权限策略。
PolicyDescription	获取应用于当前表单的策略的说明。
PolicyName	获取应用于当前表单的策略的名称。
RequestPermissionUrl	获取或设置供需要当前表单的额外权限的用户联系之用的文件、URL 或电子邮件地址。
StoreLicenses	获取或设置一个值，指示是否缓存用户查看当前表单的许可，以允许在用户无法连接到权限管理服务器时脱机查看。
UserPermissions	UserPermissionCollection获取当前窗体的 。

方法

ApplyPolicy(String)

使用策略模板文件将策略应用于表单。