PermissionObject 接口

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public interface class PermissionObject : Microsoft::Office::Interop::InfoPath::SemiTrust::Permission

[System.Runtime.InteropServices.Guid("096cd6cc-0786-11d1-95fa-0080c78ee3bb")]
public interface PermissionObject : Microsoft.Office.Interop.InfoPath.SemiTrust.Permission

type PermissionObject = interface
    interface Permission

Public Interface PermissionObject
Implements Permission

属性

GuidAttribute

实现

Permission

注解

此类型是用于 Coclass（托管代码需要此 Coclass 来实现 COM 互操作性）的包装。 使用此类型来访问由此 Coclass 实现的 COM 接口。 有关 COM 接口的信息（包括指向其成员说明的链接），请参阅Permission。

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

与表单模板关联的 Permission 类的实例由 Permission 类的 _XDocument3 属性返回。

注意：由于 PermissionObject 及其成员已添加到 Microsoft InfoPath 中的 Microsoft.Office.Interop.InfoPath.SemiTrust 对象模型，因此必须先将 thisXDocument 变量返回的对象强制转换为 _XDocument3 类型，然后才能访问 PermissionObject 及其成员。 有关详细信息，请参阅如何：使用与 InfoPath 2003 不兼容的对象模型成员。

通过返回的 PermissionObject 对象可以访问与表单模板以及通过该模板创建的每个表单实例关联的 UserPermissionObject 对象。 每个 UserPermissionObject 对象都用于为单个用户定义一组特定的权限。 虽然通过用户界面授予的某些权限适用于所有用户，但可以使用 UserPermissionObject 对象为各个用户单独指定权限及到期日期。

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

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

通过使用 PermissionObject 对象的属性和方法按以下方式之一来启用表单的权限：

将 Enabled 属性设置为 true。

属性 DocumentAuthor 已设置。

属性 RequestPermissionURL 已设置。

属性 StoreLicenses 设置为 true 或 false。

调用 ApplyPolicy(String) 方法。

还可以通过使用 Add(String, Object, Object) 对象的 方法 Permission 将用户添加到窗体中来启用对窗体的权限。

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

属性

Count	获取与窗体关联的对象数 UserPermissionObject 。 (继承自 Permission)
DocumentAuthor	获取或设置当前表单作者的电子邮件地址。 (继承自 Permission)
Enabled	获取或设置一个值，指示是否对当前表单启用了 Permission 对象所代表的权限设置。 (继承自 Permission)
Item[Object]	获取指定 UserPermission 索引处的对象。 (继承自 Permission)
PermissionFromPolicy	获取一个值，指示是否对当前表单应用了权限策略。 (继承自 Permission)
PolicyDescription	获取应用于当前表单的策略的说明。 (继承自 Permission)
PolicyName	获取应用于当前表单的策略的名称。 (继承自 Permission)
RequestPermissionURL	获取或设置供需要当前表单的额外权限的用户联系之用的文件、URL 或电子邮件地址。 (继承自 Permission)
StoreLicenses	获取或设置一个值，指示是否缓存用户查看当前表单的许可，以允许在用户无法连接到权限管理服务器时脱机查看。 (继承自 Permission)

方法

Add(String, Object, Object)	使用指定的权限和到期日期在当前表单上为指定用户创建一组新权限。 (继承自 Permission)
ApplyPolicy(String)	使用策略模板文件将策略应用于表单。 (继承自 Permission)
GetEnumerator()	获取一个用于对集合进行迭代的 IEnumerator。 (继承自 Permission)
RemoveAll()	删除与窗体关联的所有 UserPermission 对象。 (继承自 Permission)