WalkThroughSharePointWebPart入门指南四.ppt

WalkThroughSharePoint WebPart 入门指南 四Kaneboy MS MVP转载声明：此WalkThrough系列被转载和引用时，请保持博客堂链接。Thanks.此WalkThrough将演示通过(.CAB)方式将WebPart部署到SPS服务器上通过(.MSI)方式将WebPart部署到SPS服务器上背景知识请通过此WalkThrough系列的第一辑了解在VS.NET中创建WebPart、加入User Control、简单部署WebPart等基础知识。一、下载、安装Cabinet Manager 2003通过此链接下载Cabinet Manager 2003 汉化版，并安装在开发WebPart的计算机上。此WalkThrough中将通过这个软件来方便的生成(.CAB)压缩文件。Cabinet Manager的使用方法很简单。安装后，在资源管理器中选择一个或多个文件，然后点击鼠标右键呼出上下文菜单，选择其中的“添加到Cabinet(A)”选项，就可以根据提示，将选中的文件压缩到一个cab文件中。二、创建一个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);三、编辑WebPart的部署文件VS.NET会给我们的WebPart项目自动生成一个用于部署的文件，“Manifest.xml”，将其打开进行必要的修改：由于在第二步中，我们使用了一个名为“boketang.jpg”的图片文件，所以，我们需要告诉这个部署文件。在已有的“”标签下，增加一个新的标签“”，用来描述这个WebPart所用到的所有其他的资源文件。如上，我们增加的这三行标签告诉部署文件，我们需要一个名为“boketang.jpg”的资源文件。四、生成(.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:/”位置。五、将(.CAB)中的WebPart部署到SPS服务器上部署(.CAB)方式压缩的WebPart需要SPS中的“stsadm.exe”这个命令行工具，它通常位于“C:Program FilesCommon FilesMicrosoft Sharedweb server extensions60BIN”目录中，请将这个目录加入到SPS服务器的系统“Path”环境变量中，以使我们可以直接调用到“stsadm.exe”。打开命令提示符窗口，将当前路径指定为“SampleWebPart.cab”所在的“C:/”，执行下面的指令：stsadm o addwppack filename SampleWebPart.cab如果成功，它会提示我们类似下面的信息：samplewebpart.cab:部署到部署到 http:/SPSServer/。操作成功完成。操作成功完成。至此，这个WebPart已经成功部署到了SPS服务器上的所有虚拟站点中。六、将WebPart放入页面中点击页面右上角的“修改我的网页”链接，在打开的菜单中选择“添加Web部件 浏览”，就可以在打开的Panel中浏览到。选择“虚拟服务器库”，就可以在下方的“Web部件列表”中看到我们在第五步中加入到虚拟服务器中的那个WebPart。通过Panel下方的“添加”按钮，将这个WebPart加入到当前页面中。效果如左图，它将指定的“boketang.jpg”图片输出来了。七、升级已部署的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效果已经加上去了。八、删除已部署的WebPart首先打开已加入WebPart的页面，通过此WebPart的下拉按钮，选择“删除”选项，将这个WebPart从页面上删除。在SPS服务器的命令提示行下输入下面的指令：stsadm o deletewppack name SampleWebPart.cab就可以将SPS服务器上所有虚拟站点中的“SampleWebPart”删除。九、用(.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中用到的图片资源文件）十、编辑WebPart Packager的打包配置文件打开WebPart Packager自带的“wppackager.xml”文件，根据各自的打包需要，编辑它。此例中打包配置文件的完整格式如下：Manifest标签“FileName”属性的值为WebPart的部署文件之所在，在这个例子中，WebPart的部署文件就是“manifest.xml”。MSI标签“Name”属性的值为打包生成的(.MSI)文件的名称。“Version”属性为(.MSI)安装包的版本（可用于升级更新的WebPart）。“Manufacturer”为WebPart的开发商信息。十一、生成(.MSI)安装包打开命令提示符窗口，将当前目录设置为“C:/WPPackager”，执行指令：wppackager wppackager.xmlWebPart Packager将为你生成一个“SampleWebPart.msi”的安装文件。十二、安装、删除(.MSI)安装包将第十步生成的(.MSI)文件拷贝到SPS服务器中，双击执行它，就会启动WebPart的安装过程。在安装过程中，安装程序会询问是否将WebPart安装到SPS服务器所在的所有虚拟站点中，还是只安装到指定的虚拟站点中。如左图所示，我们只安装到“http:/vpc1”这个虚拟站点中。要删除这个WebPart，只需要进入“控制面板 添加或删除程序”，就可以看到我们安装的WebPart被列在了程序列表中。点击“删除”按钮就可以将这个WebPart从SPS服务器上删除。十三、To Be Continued注意：注意：此WalkThrough只讲述了“stsadm”最基本的WebPart部署功能，下列的其他要点：*指定在某个虚拟站点（而不是前面演示的SPS服务器上的所有虚拟站点）上安装和删除WebPart;*列出SPS服务器上所有安装的WebPart;*将有StrongName的WebPart安装到SPS服务器的GAC中；*在“bin”和“GAC”两种安装方式下，”stsadm”是如何放置WebPart所用到的资源文件的;请参考”stsadm”的帮助（通过“stsadm-help”命令）。下一辑：下一辑：将讲述Connection WebPart。