WalkThrough SharePoint WebPart 入门指南 四

Presentation on theme: "WalkThrough SharePoint WebPart 入门指南 四"— Presentation transcript:

1 WalkThrough SharePoint WebPart 入门指南 四
blog.joycode.com Kaneboy [MS MVP] 转载声明：此WalkThrough系列被转载和引用时，请保持博客堂链接。 Thanks.

2 此WalkThrough将演示 通过(.CAB)方式将WebPart部署到SPS服务器上
通过(.MSI)方式将WebPart部署到SPS服务器上

3 背景知识 请通过此WalkThrough系列的第一辑了解在VS.NET中创建WebPart、加入User Control、简单部署WebPart等基础知识。

4 一、下载、安装Cabinet Manager 2003
通过此链接下载Cabinet Manager 2003 汉化版，并安装在开发WebPart的计算机上。 此WalkThrough中将通过这个软件来方便的生成(.CAB)压缩文件。 Cabinet Manager的使用方法很简单。安装后，在资源管理器中选择一个或多个文件，然后点击鼠标右键呼出上下文菜单，选择其中的“添加到Cabinet(A)”选项，就可以根据提示，将选中的文件压缩到一个cab文件中。

5 二、创建一个WebPart 在VS.NET中建立一个类型为“Web Part Library”，名称为“SampleWebPart”的项目。
在“WebPart1.cs”文件的“RenderWebPart()”方法中将一个事先准备好的名字为“boketang.jpg”的图片输出。代码如下： protected override void RenderWebPart(HtmlTextWriter output) { System.Web.UI.WebControls.Image image = new Image(); image.ImageUrl = "/wpresources/samplewebpart/boketang.jpg"; image.RenderControl(output); }

6 三、编辑WebPart的部署文件 VS.NET会给我们的WebPart项目自动生成一个用于部署的文件，“Manifest.xml”，将其打开进行必要的修改： 由于在第二步中，我们使用了一个名为“boketang.jpg”的图片文件，所以，我们需要告诉这个部署文件。 在已有的“<Assembly FileName=”SampleWebPart.dll“>”标签下，增加一个新的标签“<ClassResources>”，用来描述这个WebPart所用到的所有其他的资源文件。 <ClassResources> <ClassResource FileName="boketang.jpg"/> </ClassResources> 如上，我们增加的这三行标签告诉部署文件，我们需要一个名为“boketang.jpg”的资源文件。

7 四、生成(.CAB)文件 将我们这个WebPart所需要所有四个文件：
SampleWebPart.dll （VS.NET编译生成的Assembly文件） WebPart1.dwp （WebPart描述文件） Manifest.xml （WebPart部署文件） boketang.jpg （WebPart中用到的图片资源文件） 拷贝到一处，然后用Cabinet Manager 2003将他们压缩成一个名称为“SampleWebPart.cab”的压缩包。 将“SampleWebPart.cab”文件拷贝到SPS服务器的“C:/”位置。

8 五、将(.CAB)中的WebPart部署到SPS服务器上
部署(.CAB)方式压缩的WebPart需要SPS中的“stsadm.exe”这个命令行工具，它通常位于“C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\BIN”目录中，请将这个目录加入到SPS服务器的系统“Path”环境变量中，以使我们可以直接调用到“stsadm.exe”。 打开命令提示符窗口，将当前路径指定为“SampleWebPart.cab”所在的“C:/”，执行下面的指令： stsadm –o addwppack –filename SampleWebPart.cab 如果成功，它会提示我们类似下面的信息： samplewebpart.cab: 部署到 操作成功完成。 至此，这个WebPart已经成功部署到了SPS服务器上的所有虚拟站点中。

9 六、将WebPart放入页面中 点击页面右上角的“修改我的网页”链接，在打开的菜单中选择“添加Web部件 － 浏览”，就可以在打开的Panel中浏览到。 选择“虚拟服务器库”，就可以在下方的“Web部件列表”中看到我们在第五步中加入到虚拟服务器中的那个WebPart。 通过Panel下方的“添加”按钮，将这个WebPart加入到当前页面中。效果如左图，它将指定的“boketang.jpg”图片输出来了。

10 七、升级已部署的WebPart 现在我们回到VS.NET开发界面，重新打开“WebPart1.cs”文件，修改RenderWebPart()方法，增加一行代码，给Image控件增加一个Tooltip效果，如下： protected override void RenderWebPart(HtmlTextWriter output) { System.Web.UI.WebControls.Image image = new Image(); image.ImageUrl = "/wpresources/samplewebpart/boketang.jpg"; image.ToolTip = "博客堂，.NET技术站点！"; image.RenderControl(output); } 重新编译、压缩生成(.CAB)文件、拷贝到SPS服务器上，然后在服务器的命令提示行输入命令（与第四、五步骤相同）： stsadm –o addwppack –filename SampleWebPart.cab –force “-force”参数可以将已部署的WebPart升级成为最新的版本。再次浏览已加入此WebPart的页面，可以发现Tooltip效果已经加上去了。

11 八、删除已部署的WebPart 首先打开已加入WebPart的页面，通过此WebPart的下拉按钮，选择“删除”选项，将这个WebPart从页面上删除。 在SPS服务器的命令提示行下输入下面的指令： stsadm –o deletewppack –name SampleWebPart.cab 就可以将SPS服务器上所有虚拟站点中的“SampleWebPart”删除。

12 九、用(.MSI)方式部署WebPart 下面开始介绍如何将WebPart制作成(.MSI)安装包，在SPS上以安装程序的形式部署WebPart。 在此链接中下载WebPart Packager。将下载的压缩包展开（一共7个文件）到“C:/WPPackager”目录。 将第四步中提到的WebPart所需要的4个文件拷贝到“C:/WPPackager”目录。 SampleWebPart.dll （VS.NET编译生成的Assembly文件） WebPart1.dwp （WebPart描述文件） Manifest.xml （WebPart部署文件） boketang.jpg （WebPart中用到的图片资源文件）

13 十、编辑WebPart Packager的打包配置文件
打开WebPart Packager自带的“wppackager.xml”文件，根据各自的打包需要，编辑它。此例中打包配置文件的完整格式如下： <?xml version="1.0" ?> <Wppackager xmlns=" <Manifest FileName="Manifest.xml" /> <MSI Name="SampleWebPart" Version=" " Manufacturer="kaneboy" /> </Wppackager> Manifest标签 “FileName”属性的值为WebPart的部署文件之所在，在这个例子中，WebPart的部署文件就是“manifest.xml”。 MSI标签 “Name”属性的值为打包生成的(.MSI)文件的名称。“Version”属性为(.MSI)安装包的版本（可用于升级更新的WebPart）。“Manufacturer”为WebPart的开发商信息。

14 十一、生成(.MSI)安装包 打开命令提示符窗口，将当前目录设置为“C:/WPPackager”，执行指令：
wppackager wppackager.xml WebPart Packager将为你生成一个“SampleWebPart.msi”的安装文件。

15 十二、安装、删除(.MSI)安装包 将第十步生成的(.MSI)文件拷贝到SPS服务器中，双击执行它，就会启动WebPart的安装过程。
在安装过程中，安装程序会询问是否将WebPart安装到SPS服务器所在的所有虚拟站点中，还是只安装到指定的虚拟站点中。如左图所示，我们只安装到“ 要删除这个WebPart，只需要进入“控制面板 － 添加或删除程序”，就可以看到我们安装的WebPart被列在了程序列表中。点击“删除”按钮就可以将这个WebPart从SPS服务器上删除。

16 十三、 To Be Continued… 注意：
此WalkThrough只讲述了“stsadm”最基本的WebPart部署功能，下列的其他要点： * 指定在某个虚拟站点（而不是前面演示的SPS服务器上的所有虚拟站点）上安装和删除WebPart; * 列出SPS服务器上所有安装的WebPart; * 将有StrongName的WebPart安装到SPS服务器的GAC中； * 在“bin”和“GAC”两种安装方式下，”stsadm”是如何放置WebPart所用到的资源文件的; 请参考”stsadm”的帮助（通过“stsadm -help”命令）。 下一辑： 将讲述Connection WebPart。