对于Feature,了解sharepoint的人应该都很熟悉了,不但控制着sharepoint上大部分功能的运用,还可以做功能的扩展,好处就在于管理非常的方便。虽然对于Feature的开发有很多,如用Feature定制功能菜单,用户控件方式的webpart等等,但用Feature的激活与停止功能,来执行后台代码还是挺有用的,下面就简单的介绍这个例子。
第一步:
打开VS,创建一个类库的项目,命名为“FeatureToRunCode”,
将Class1.cs命名为MyCode.cs。添加引用Microsoft.sharepoint.dll。添加引用using Microsoft.SharePoint;并在MyCode类继承SPFeatureReceiver。
整个MyCode.cs代码如下
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
namespace FeatureToRunCode
{
public class MyCode:SPFeatureReceiver
{
public override void FeatureActivated(SPFeatureReceiverProperties properties)//当激活时修改网站的标题为My Feature is working
{
SPWeb web = (SPWeb)properties.Feature.Parent;
web.AllowUnsafeUpdates = true;
web.Title = "My Feature is working ";
web.Update();
web.Close();
}
public override void FeatureDeactivating(SPFeatureReceiverProperties properties)//当激活时修改网站的标题为首页
{
SPWeb web = (SPWeb)properties.Feature.Parent;
web.AllowUnsafeUpdates = true;
web.Title = "首页";
web.Update();
web.Close();
}
public override void FeatureInstalled(SPFeatureReceiverProperties properties)//当Feature被安装时,
{
//当Feature被安装时,执行代码
}
public override void FeatureUninstalling(SPFeatureReceiverProperties properties)
{
//当Feature被卸载时,执行代码
}
}
}
记得加入强名称,编译生成FeatureToRunCode.dll。并用Reflector.exe获取
程序集名:FeatureToRunCode, Version=1.0.0.0, Culture=neutral, PublicKeyToken=146ae474b0fd2221
类名:FeatureToRunCode.MyCode
将在后面的feature.xml文件中被用到。
第二步:
开始创建Feature文件。在FeatureToRunCode项目中,创建文件夹Features,在文件夹Features目录下创建文件夹FeatureToRunCode,在FeatureToRunCode文件夹下创建feature.xml.
feature.xml的代码如下:
Id="E46240B7-8050-47e7-8A12-586C291B346C"
Title="FeatureToRunCode"
Description="用feature管理运行后台代码"
Hidden="FALSE"
Scope="Web"
ReceiverClass="FeatureToRunCode.MyCode"
ReceiverAssembly="FeatureToRunCode, Version=1.0.0.0, Culture=neutral, PublicKeyToken=146ae474b0fd2221"
>
说明:
在这个XML文件中,以下关于Featrue的metadata 包含在Featrue 元素中。(更详细的信息请参阅Feature.xml Files)
ID: 一个GUID,用于唯一标识这个Feature,可以通过VS生成
Title:Feature 的名字,可以在网站内关于Site Featrues的页面中看到。
Description:对description的描述。
Version:Feature的版本;
Scope:其值可以是Web或Site,它指明了这个Feature是应用于整个的Site Collection还是仅仅用于单独的一个子站点。
Hidden:值可以是True或False.该设置指定了这个Feature是否在Site Feature页面上显示。
DefaultResourceFile: 资源文件名字,Feature依赖它提供其它附加的配置信息。
ReceiverClass:为程序集接收类。
ReceiverAssembly:为接收程序集.
保存。这样我们的代码跟Feature文件就已经创建好了,接下来就是布署了。
第三步:
布署Feature。先将FeatureToRunCode.dll拖入到GAC里,即c:/WINDOWS/assembly目录下。
再到项目目录下的Features目录下,将FeatureToRunCode文件夹复制到C:/Program Files/Common Files/Microsoft Shared/web server extensions/12/TEMPLATE/FEATURES目录下。
在SharePoint服务器上打开命令行
输入命令切换目录:cd C:/Program Files/Common Files/Microsoft Shared/web server extensions/12/BIN
安装Feature输入命令:stsadm -o installfeature -filename FeatureToRunCode/feature.xml。
不要忘了要iisreset一下服务器。
OK,Feature的部署与开发已经完成。
第四步:
查看成果。打开网站,进入网站设置,进入网站管理---->网站功能,可以看到增加了一个FeatureToRunCode的Feature功能,如下图:
嗯,是不错,赶紧点击一下激活按钮,有点激动,好在,代码发挥作用了,网站的标题发生了变化了,变成My Feature is Working了,如下图:
至此,Feature管理后台代码已经完成了,还不错吧,那就赶快试试看,同时发挥一下想像力,在这里可以实现很多的功能......