[Best Practice]WSPBuilder和QuickPart合作进行Web Partk可视化开发与部署的好方法

转帖:[Best Practice]WSPBuilder和QuickPart合作进行Web Partk可视化开发与部署的好方法

QuickPart

QuickPart大家都知道是我们大名鼎鼎的Kaneboy同学的大作,是用户控件包装器的杰出代表,是进行可视化Web部件开发的重要工具。

使用QuickPart的一般过程是:

1)先创建一个Web工程,新建用户控件,然后编译发布网站,得到我们需要的ASCX和dll文件;

2)部署QuickPart,并在网站上激活QuickPart Feature;

3)把Web应用程序的Trust Level该成可以使用Web部件;

4)把ASCX拷贝到Web应用程序的wpresources文件夹下,把dll拷贝到相应的bin目录下;

5)在网站上添加QuickPart,编辑属性,选择相应的ASCX文件;

6)现在,你可以使用包装好的用户控件了。

我想QuickPart再方便点

如果,我们想自动把开发的用户控件和dll部署好,然后能直接在网站上拖入一个包装了用户空控件的QuickPart就能使用了,添加Web部件的时候,丝毫感觉不出来是使用了QuickPart,那我们该怎么办呢?

我们首先需要了解一下Web Part的dll和.webpart文件的关系:

image

同样的一个QuickPart.dll,使用不同的.webpart描述文件可以把其描述成不同的Web Part。在.webpart文件里面指定WrappedUserControlPath就可以设置默认加载的用户控件了,再在.webpart文件里设置一个有意义的Title,这样同样一个QuickPart.dll在你的Web Part选择页面中就会对应出现多个更有意义的可用Web Part了。

利用.webpart文件我们解决了在网站上添加QuickPart,再选择加载哪个User Control的麻烦。

我们还没有解决怎样自动把ASCX文件和dll拷贝到相应目录下的问题。

Solution里面的Assembly Element有一个子Element叫做ClassResources,用来部署程序集的资源,所以我们可以把ASCX文件作为dll的资源,使得WSP可以帮我们完成这个部署,比如我们要部署IparkDebugPartUC.dll这个用户控件的程序集,它对应的资源会在bin\wpresources\IparkDebugPartUC\路径下(注意路径最后的文件夹就是程序集的名称),所以,我们在WSPBuilder下创建如下的文件夹结构:

image

把dll拷贝到80\bin目录下,ascx文件拷贝到80\bin\wpresources\IparkDebugPartUC\路径下

利用Solution的Assembly以及ClassResource我们解决了自动拷贝部署ASCX和dll的问题。

WSPBuilder生成WSP文件的时候manifest文件里面会自动为程序集添加CodeAccess相关的设置,所以修改Web应用程序的TrustLevel也就不需要了。

---------------------------------解决方案开始了------------------------------

所以我们的解决方案就是:

1)首先根据“[Best Practice]如何在SharePoint团队开发中利用WSPBuilder”中介绍的,创建好一个WSPBuilder项目来做Web Part的打包部署调试;创建好需要的文件夹结构,添加一个WSPBuilder Blank Feature,形成如下类似的样子:

image

注意,wpresources下面的文件夹必须和你要生成的用户控件所在的dll的名称一致。

2)创建一个Web Application项目,在项目里面创建一个.webpart文件,注意type这个metadata用来表示对应的dll是哪个,这里当然就是我们的QuickPart里面的包装器类型了。

<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="http://schemas.microsoft.com/WebPart/v3%22>
    <metaData>
      <!--
      The following Guid is used as a reference to the web part class,
      and it will be automatically replaced with actual type name at deployment time.
      -->
      <type name="Microsoft.PRC.SharePoint.ConsumerQuickPart, QuickPart, Version=1.0.0.0, Culture=neutral, PublicKeyToken=2d0bb71b2dd16f9e" />
      <importErrorMessage>Cannot import Web Part.</importErrorMessage>
    </metaData>
    <data>
      <properties>
        <property name="Title" type="string">Ipark Debug Demo Web Part</property>
        <property name="Description" type="string">Ipark Debug Demo Description</property>
        <property name="WrappedUserControlPath" type="string">~\wpresources\IparkDebugPartUC\IparkDebugPartUC.ascx</property>
      </properties>
    </data>
  </webPart>
</webParts>

这样,这个Web Application项目就形如:

image

把IparkDebugPartUC.ascx和IparkDebugPart.webpart文件设置为Copy Always:

image

在项目属性的Build Events中添加Post-build命令:

copy "$(TargetDir)IparkDebugPartUC.dll" "$(SolutionDir)IparkSolution\80\bin\";
copy "$(TargetDir)IparkDebugPartUC.ascx" "$(SolutionDir)IparkSolution\80\wpresources\IparkDebugPartUC\";
copy "$(TargetDir)IparkDebugPart.webpart"  "$(SolutionDir)IparkSolution\12\Template\Features\IparkDebugPartFeature\";

3)修改WSPBuilder项目中IparkDebugPartFeature的elements.xml,在Elements节中添加

<Module Name="WebParts" List="113" Url="_catalogs/wp">
  <File Path="IparkDebugPart.webpart" Url="IparkDebugPart.webpart" Type="GhostableInLibrary" />
</Module>

4)好了,你的解决方案样子就变成了:

image

首先build一下IparkDebugPartUC项目,然后在“IparkSolution”上右键菜单中,点击“Build WSP”,生成WSP文件,然后在右键菜单中可以看到Deploy和Upgrade都变成可用了,然后你就可以deploy这个解决方案了。转到你的网站集,激活IparkDebugPartFeature,你就可以在网站的Web Part列表中找到这个Web部件了:

image

你可以在你的Web Application项目上右键菜单的WSPBuilder菜单中点击“Attach to IIS Worker Processes”,开始调试你的用户控件了。

image

当你刷新用户控件所在页面,你的Visual Studio就会开始Debug了:

image

---------------------------------解决方案结束了------------------------------

补充:使用这种方法,你不需要提前部署QuickPart,你需要做的只是把QuickPart.dll拷贝到WSPBuilder的80\bin目录下,WSP包会自动部署它的:

image

posted @ 2009-04-01 22:00  cdboy  阅读(543)  评论(0编辑  收藏  举报