Feature使得添加操作到Windows SharePoint Services用户界面的菜单变得更容易。下面的例子展示了如何通过Feature在各种菜单中添加操作,并实际的部署和激活它。
Location和Group ID
在为特定的菜单定义自定义操作前,您必须通过设置其区域信息为适当的WSS命名空间,并使用WSS用于标识特定区域的ID来标识该菜单。。
举个例子,如果要添加一个自定义操作到网站设置页面,需要设置CustoMaction的 Location 属性为Microsoft.SharePoint.SiteSettings。然后,通过GroupId 属性指定该页面的特定区域。
不同的操作可能需要使用不同的CustomAction属性来标识放置自定义操作的菜单。但是您可能还需要为该操作指定其他参数,比如,指定一个版本号,执行该操作的用户权限要求,或者与已有操作在菜单中的前后关系等。下面的自定义操作例子展示了各种的属性。
URL Tokens
WSS支持下列可用于相对URL地址前的记号:
~site - 网站(SPWeb)相对链接。
~sitecollection - 网站集(SPSite)相对链接。
同时,您还可以在URL中使用下列记号:
{ItemId} - 整数 ID 代表了列表中的列表项。
{ItemUrl} - 受控列表项的URL 。仅用于库中的文档。 [在Beta 2中无效]
{ListId} - 代表该列表的GUID。
{SiteUrl} - 网站URL (SPWeb).
{RecurrenceId} - 重复项ID。该记号不可以用于列表项的上下文菜单。
步骤
在 C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES下创建一个 UserInterfaceLightUp 文件夹.
在新建的UserInterfaceLightUp文件夹中创建一个 Feature.xml 文件来提供该Feature的元素清单,如下所示:
<?xml version="1.0" encoding="utf-8" ?>
<Feature Id="GUID"
Title="Light Up"
Description="This example shows how you can light up various areas inside Windows SharePoint Services."
Version="1.0.0.0"
Scope="Site"
xmlns="http://schemas.microsoft.com/sharepoint/">
<ElementManifests>
<ElementManifest Location="Lightup.xml" />
</ElementManifests>
</Feature>