【Feature】使用Feature导入WebPart

前些天在刚刚接触WebPart的时候，搜到了一篇《使用Feature导入WebPart》的文章，那个时候对Feature的了解还为零，所以看了是一知半解，等到今天回望时，发现文章里的内容竟然“缺斤少两”（我晕），郁闷之下，直接到Google上用英文查找，功夫不负有心人，总算被我挖到了另外一篇《Add A Web Part To Your Web Parts Gallery Using A Feature》（使用Feature添加一个WebPart到你的WebPart库？）。

 内容很简单啊，而且有前一篇文章做参考，所以很好理解。然而一试，发现问题多多，似乎作者们只是写出了具体的步骤，而忽略了告诉读者需要注意的小细节（- -），呃呃，于是只能硬着头皮试到底（这里非常感谢谷歌先生的帮忙），最后，光辉迸射的一刻终于到来！

 

【1】简单的讲，我们需要一个做好了的WebPart，比如我用：WebPartForLeadingIn.dll。

using  System;
using  System.Text;
using  System.Web.UI.WebControls.WebParts;

namespace  WebPartForLeadingIn
{
     public   class  Wp:WebPart
    {
         private   string  _Text  =   " 看，我是通过Feature导入的WebPart～ " ;

        [WebBrowsable( true ), Personalizable( true )]
         public   string  Text
        {
             get  {  return  _Text; }
             set  { _Text  =  value; }
        }
         protected   override   void  Render(System.Web.UI.HtmlTextWriter writer)
        {
            writer.Write(_Text);
        }
    }
}

做强名称这个就不用说了，然后编译。。。

 

【2】同时最好手动编写一个.webpart文件——这个文件一般在用VS编码时不会产生，在导入到SharePoint后才有，是XML格式的文件。（我命名为Wp.webpart）

<? xml version="1.0" encoding="utf-8" ?>
< webParts >
     < webPart  xmlns ="http://schemas.microsoft.com/WebPart/v3" >
         < metaData >
             < type  name ="WebPartForLeadingIn.Wp, WebPartForLeadingIn, Version=1.0.0.0, Culture=neutral, PublicKeyToken=437f6f449ff02b7a"   />
             < importErrorMessage > 无法导入此 Web 部件。 </ importErrorMessage >
         </ metaData >
         < data >
             < properties >
                 < property  name ="Title"  type ="string" > Wp </ property >
             </ properties >
         </ data >
     </ webPart >
</ webParts >

 

【3】上面两步就把WebPart搞定了，下面开始编写Feature.xml和Element.xml（后面这个文件可以随便命名， 不过记得要在Feature.xml文件里相应的关联部分输入同样的文件名）

◎Feature.xml文件：

<? xml version="1.0" encoding="utf-8"  ?>
< Feature  xmlns ="http://schemas.microsoft.com/sharepoint/"
         Id ="FC3BB8FB-EC18-4ace-9B1D-24333C2C9A6E"
         Title ="Leading in WebPart"
         Description ="通过Feature导入WebPart"
         Hidden ="FALSE"
         Scope ="Site" >
     < ElementManifests >
         < ElementManifest  Location ="Element.xml"   />
     </ ElementManifests >
</ Feature >

 ◎Element.xml文件：

<? xml version="1.0" encoding="utf-8"  ?>
< Elements  xmlns ="http://schemas.microsoft.com/sharepoint/" >
     < Module
       Name ="WebPartPopulation"
      List ="113"
      Url ="_catalogs/wp"
      RootWebOnly ="TRUE" >
         < File  Url ="Wp.webpart"  Type ="GhostableInLibrary"   />
     </ Module >
</ Elements >

 

 【4】接下来这一步很棒，编写.bat批量文件，省了在cmd敲命令的功夫，而且完全“一步到位” ：）

◎ImportWP.bat文件：

 @SET STSADM="c:\program files\common files\microsoft shared\web server extensions\12\bin\stsadm"

Echo Installing feature

%STSADM% -o InstallFeature -filename WebPartForLeadingIn\feature.xml -force

Echo Activating feature

%STSADM% -o activatefeature -filename WebPartForLeadingIn\feature.xml -url http://gl-5fc632fd62e9:8800/

Iisrest

 

以上有些地方要根据您的实际情况修改，比如stsadm.exe所在位置，WebPartForLeadingIn是一个文件夹名，http://gl-5fc632fd62e9:8800/是SharePoint网站URL。

【5】搞定这些，就万事俱备，只欠东风了。

把 WebPartForLeadingIn.dll 拷到GAC里（C:\WINDOWS\assembly），把Feature.xml、Element.xml、ImportWP.bat、Wp.webprt四个文件拷贝到WebPartForLeadingIn文件夹里，然后将其挪到C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES\下。

（*这里有两点要注意：

1)是要到相应的网站下修改web.config，添加SafeControl节点，我的是<SafeControl Assembly="WebPartForLeadingIn, Version=1.0.0.0, Culture=neutral, PublicKeyToken=437f6f449ff02b7a" Namespace="WebPartForLeadingIn" TypeName="*" />。感觉有点昏，不是说放到GAC下的WebPart文件是完全可信的吗，怎么还要设置安全节点？

2)可能在后面进行Feature激活时会出错，

我自己是通过以下手段解决的：【SharePoint 3.0管理中心】—>【应用程序管理】—>【应用程序安全性】的“Web应用程序的策略”—>选择要激活的网站，【添加用户】—>【区域】选择“所有区域”（也可以选择相应的区域，比如 默认）—>【下一步】—>在“用户”框填上网站管理员帐号，“权限”为“完全控制”—>【完成】

）

【6】运行ImportWP.bat，然后到您的网站里，看看是不是多了什么东东，我的网站上是这样：

 

好了，如果有兴趣，再到“Web部件”库里看看是不是new出了什么（Wp.webpart！新 ） 。Jesus，还等什么，直接添加到页面上吧～

 

Good luck ：）