MOSS点滴(1):如何开发和部署feature

转自：http://www.cnblogs.com/carysun/archive/2008/04/16/feature.html

Features 是MOSS 2007以开箱即用的一套新功能，Features 存储在SharePoint服务器的如下路径下：C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES。每个Featrue在此路径下有自己的子目录，在每一个Feature子目录下会发现名字为Feature.xml的文件，它存储一些关于Featrue的metadata信息。

下面我就利用feature来实现一个小功能，在"网站操作"中添加自定义的菜单，首先使用VS2005建立一个HelloWorld的类库项目，然后添加文件夹Helloworld，在文件夹中添加feature.xml文件代码如下：

<FeatureId="B2CB42E2-4F0A-4380-AABA-1EF9CD526F20"Title="HelloWorldFeature"Description="这是我的第一个Feature"Scope="Web"Hidden="FALSE"ImageUrl="TPG\canteen.gif"ReceiverAssembly="HelloWorld,Version=1.0.0.0,Culture=neutral,PublicKeyToken=b38a04419cc857d9"ReceiverClass="HelloWorld.FeatureReceiver"xmlns="http://schemas.microsoft.com/sharepoint/">

<ElementManifests>
<ElementManifestLocation="elements.xml"/>
</ElementManifests>

</Feature>

下面我们来说明下包含在Featrue 元素中的metadata 信息。

ID: 一个GUID，用于唯一标识这个Feature，这个可以使用GUID的生成工具得到;

Scope:其值可以是Web或Site,它指明了这个Feature是应用于整个的Site Collection还是仅仅用于单独的一个子站点。如果Scope="Web"，则在[网站操作—网站设置—网站管理—网站功能]下激活，如果Scope="Site"则要在[网站操作—网站设置—网站管理—网站集功能]下激活。

Hidden:值可以是True或False.该设置指定了这个Feature是否在Site Feature页面上显示。

DefaultResourceFile: 资源文件名字，Feature依赖它提供其它附加的配置信息。

<ElementManifests>元素：这个元素包含了另一个XML文件的位置，而这个文件包含的<Elemnets>的内容是Feature要实现的。

然后我们在添加elements.xml文件，代码如下：

<Elementsxmlns="http://schemas.microsoft.com/sharepoint/">

<CustomActionId="SiteActionsToolbar"GroupId="SiteActions"Location="Microsoft.SharePoint.StandardMenu"Sequence="100"Title="HelloWorld"Description="使用feature方式自定义菜单"ImageUrl="_layouts/images/crtsite.gif">
<UrlActionUrl="http://msdn.microsoft.com"/>
</CustomAction>

</Elements>

这个就是我们自定义的菜单项了。

在增加一个类文件FeatureReceiver.cs，代码如下：

usingSystem;
usingMicrosoft.SharePoint;

namespaceHelloWorld
{
publicclassFeatureReceiver:SPFeatureReceiver
{
publicoverridevoidFeatureInstalled(SPFeatureReceiverPropertiesproperties){}
publicoverridevoidFeatureUninstalling(SPFeatureReceiverPropertiesproperties){}
publicoverridevoidFeatureActivated(SPFeatureReceiverPropertiesproperties)
{
SPWebsite=(SPWeb)properties.Feature.Parent;
site.Properties["OriginalTitle"]=site.Title;
site.Properties.Update();
site.Title="HelloWorldModify";
site.Update();
}

publicoverridevoidFeatureDeactivating(SPFeatureReceiverPropertiesproperties)
{
SPWebsite=(SPWeb)properties.Feature.Parent;
site.Title=site.Properties["OriginalTitle"];
site.Update();
}
}
}

SPFeatureReceiver 类中定义当安装、激活、停用或卸载 Web 部件 Feature 时，MOSS会触发这些事件，在此我们要设置feature.xml中的ReceiverAssembly 和 ReceiverClass 的属性。 这些属性指向一个功能接收器的托管类。PublicKeyToken是HelloWorld的key可以在VS2005命令行下使用"sn -t HelloWorld"来得到。

基本上我们的任务就完成了，现在我们就要开始部署了，需要通过以下步骤

1.将HelloWorl文件夹(其中包含feature.xml和elements.xml文件)拷贝到C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES文件夹下。

2.STSADM -o InstallFeature -filename HelloWorld\feature.xml -force

3.使用"gacutil -if 程序集名"将HelloWorld.dll注册到GAC中

4.重启IIS：iisreset

现在我们去网站集功能中查看，你可以激活该feature，激活的时候会执行FeatureActivated中的代码

当然这一部署过程我们可以使用一个批处理来完成，注意路径的更改：

@SETTEMPLATEDIR="c:\programfiles\commonfiles\microsoftshared\webserverextensions\12\Template"
@SETSTSADM="c:\programfiles\commonfiles\microsoftshared\webserverextensions\12\bin\stsadm"
@SETGACUTIL="d:\ProgramFiles\MicrosoftVisualStudio8\SDK\v2.0\Bin\gacutil.exe"

EchoInstallingHelloWorld.dllinGAC
%GACUTIL%-ifbin\debug\HelloWorld.dll

EchoCopyingfilestoTEMPLATEdirectory
xcopy/e/yTEMPLATE\*%TEMPLATEDIR%

EchoInstallingfeature
%STSADM%-oinstallfeature-filenameHelloWorld\feature.xml-force

IISRESET
REMcscriptc:\windows\system32\iisapp.vbs/a"SharePointDefaultAppPool"/r

下面就是我们最终要实现的效果了