策略功能定义

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

适用范围: SharePoint Server 2010

本文内容
指定全局自定义设置控件
指定自定义设置控件
指定功能程序集和类
指定策略资源
向策略功能列表添加策略功能定义

策略功能定义 是 XML 中提供 Microsoft SharePoint Server 2010 执行以下操作所需的信息的部分:

  • 包括在 SharePoint 管理中心界面创建和配置策略项。

  • 调用任务(如初始化策略功能)的策略功能代码。

若要简化策略项的创建和配置,策略功能定义可以包括两个 Web 控件的 URL 地址:一个表示服务器场级策略功能设置,另一个表示策略实例级策略功能设置。这两个 Web 控件承载于 SharePoint Server 2010 中,适当的用户可使用它们设置相应级别的设置。

指定全局自定义设置控件

服务器场级 Web 控件承载在包含相应策略功能的管理页上,管理员可使用该控件为整个服务器场的策略功能指定设置。这些设置称为全局设置,管理员之外的用户无法查看或更改它们。全局设置保存在策略功能定义中。例如,条码策略功能包含允许服务器管理员选择用于策略功能的条码生成器的全局设置。

服务器场级 Web 控件必须实现 GlobalCustomSettingsControl 类。

如果不指定全局自定义设置控件,则管理员无法覆盖或编辑为策略功能指定的默认全局数据,因而也就无法在管理员级自定义该功能。这限制了管理员对是否激活策略功能的选择权。

指定自定义设置控件

策略实例级 Web 控件承载在策略项自定义页上,因为这使得用户能够指定适用于特定策略中的策略功能的自定义设置。这些自定义设置保存在该策略功能的特定策略的策略项中。例如 Bar Code 策略功能包含用户可为出现策略功能的每个策略指定的以下设置:

  • 自动提供条码。

  • 提示用户在文档中加入条码。

策略实例级 Web 控件必须实现 CustomSettingsControl 类。

如果不指定自定义设置控件,则用户无法覆盖或编辑为策略功能指定的默认数据,因而也就无法在最终用户级自定义该功能。

指定功能程序集和类

若要使 SharePoint Server 2010 能够调用策略功能代码来执行必需的任务(如初始化),则策略功能定义必须包含两个特定的指针:一个指向全局程序集缓存中的强名称策略功能程序集的位置,另一个指向该程序集中实现 IPolicyFeature 接口的类。

有关 IPolicyFeature 接口的详细信息,请参阅 IPolicyFeature 接口概述

指定策略资源

如果策略功能使用策略资源,则策略功能必须在其策略功能定义中列出所使用的资源类型。例如,Bar Code 策略功能在其策略功能定义中包括一个指示其使用"Bar Code Generator"类型的策略资源的元素。然后,该策略功能就可以使用在其资源定义中声明的为"Barcode Generator"类型的任何资源。策略资源名称必须是完全限定名称,并且必须显示在该策略功能的策略资源定义列表上。

备注

在策略功能定义中可以指定策略资源为必需或可选。如果安装了一个需要特定类型策略资源的策略功能,而场中没有安装该类型的策略资源,则无法激活该策略功能。

图 1 显示策略功能定义中包含的信息以及此类信息所引用的项。

图 1. 策略功能定义概念性结构

策略功能定义概念性结构

向策略功能列表添加策略功能定义

策略功能列表对所指定服务器场中安装的每个策略功能都包括策略功能定义。通过调用 PolicyFeatureCollection 类的 Add 方法可以添加网站策略。此方法会将传递给它的 XML 作为策略功能的策略功能定义添加到策略功能列表。

此操作通常作为将策略功能部署为 SharePoint Foundation 功能这一过程的一部分完成。有关详细信息,请参阅使用功能

将策略功能定义添加到策略功能列表之后,您可以编程方式使用该策略功能,就像对象模型中的 PolicyFeature 对象一样。

请参阅

概念

管理信息管理策略

策略功能概述

策略功能定义架构概述

策略资源概述