IPolicyFeature 接口概述

上次修改时间: 2010年4月2日

适用范围: SharePoint Server 2010

最初将信息管理策略应用于某个项目时,策略功能一般必须执行某些操作以初始化功能对该项目采用的策略。此初始化可以包括以下操作:

  • 根据项目的列表创建列。例如,到期策略功能根据其所要应用于的项目创建名为 ExpireDate 的新列。

  • 注册有关项目列表的事件。

  • 对项目执行一些工作。例如,到期策略功能对其所要应用于的项目计算的 ExpireDate 列的初始值。

除了安装有效的策略功能定义之外,每项策略功能还必须包含实现 IPolicyFeature 接口的类。利用此接口,Microsoft SharePoint Server 2010 可调用代码来执行策略功能所需的任何启动工作。此外,在为某个内容类型添加、删除或更改与策略功能相关的策略项时,SharePoint Server 2010 可以利用此接口调用代码来执行所需的任何任务。

为某个内容类型添加、删除或更改策略项时,SharePoint Server 2010 将调用相应的方法。

IPolicyFeature 接口包含以下方法:

  • OnCustomDataChange

    用户更改与策略功能相关的特定策略项的自定义设置时 SharePoint Server 2010 调用此方法。

  • OnGlobalCustomDataChange

    用户更改策略功能的服务器场级设置时 SharePoint Server 2010 调用此方法。

  • ProcessListItem

    策略更改时 SharePoint Server 2010 调用此方法。更改包括编辑当前分配给列表的策略或向列表分配其他策略。

    备注

    如果策略功能返回 false,则 SharePoint Server 2010 不处理剩余的项目。此优化防止 SharePoint Server 2010 对与处理项目无关的策略功能在列表上的所有项目中进行迭代。

  • ProcessListItemOnRemove

    SharePoint Server 2010 对不再受指定策略支配的列表项调用此方法。利用此方法可以指定从项目中删除策略时需要执行的项目级注销。

  • Register

    用户向策略添加新策略项时 SharePoint Server 2010 调用此方法。此方法执行策略功能所需的任何初始工作(如向内容类型添加特定列或注册事件)。

  • UnRegister

    从策略中删除现有策略项时 SharePoint Server 2010 调用此方法。

向策略添加策略项时,SharePoint Server 2010 将调用关联策略功能的 Register 方法以执行任何所需的初始工作。

同样,如果从策略中删除策略项,SharePoint Server 2010 将调用关联策略功能的 UnRegister 方法以执行任何所需的清除工作。

当某个策略发生更改时,SharePoint Server 2010 将为发生更改的每项策略功能调用 ProcessListItem 方法。如果策略功能未发生更改,则 SharePoint Server 2010 不调用任何方法。

例如,假设给定内容类型的策略包含一项策略功能"条码",然后为到期策略功能添加一个策略项。SharePoint Server 2010 将调用到期策略功能的 Register 方法,初始化分配给该内容类型的每个项目的功能。但是,由于条码策略功能的策略项在策略中没有更改,因此 SharePoint Server 2010 不调用该策略功能的 ProcessListItem 方法。

请参阅

概念

管理信息管理策略

策略功能概述

策略功能定义

IPolicyFeature 接口概述

策略资源概述