WalkThrough SharePoint WebPart 入門指南 四

1、WalkThroughSharePoint WebPart 入門指南 四Kaneboy MS MVP轉(zhuǎn)載聲明：此WalkThrough系列被轉(zhuǎn)載和引用時(shí)，請(qǐng)保持博客堂鏈接。Thanks.此WalkThrough將演示 通過(.CAB)方式將WebPart部署到SPS服務(wù)器上 通過(.MSI)方式將WebPart部署到SPS服務(wù)器上背景知識(shí) 請(qǐng)通過此WalkThrough系列的第一輯了解在VS.NET中創(chuàng)建WebPart、加入U(xiǎn)ser Control、簡(jiǎn)單部署WebPart等基礎(chǔ)知識(shí)。一、下載、安裝Cabinet Manager 2003通過此鏈接下載Cabinet Manager 2003 漢

2、化版，并安裝在開發(fā)WebPart的計(jì)算機(jī)上。此WalkThrough中將通過這個(gè)軟件來方便的生成(.CAB)壓縮文件。Cabinet Manager的使用方法很簡(jiǎn)單。安裝后，在資源管理器中選擇一個(gè)或多個(gè)文件，然后點(diǎn)擊鼠標(biāo)右鍵呼出上下文菜單，選擇其中的“添加到Cabinet(A)”選項(xiàng)，就可以根據(jù)提示，將選中的文件壓縮到一個(gè)cab文件中。二、創(chuàng)建一個(gè)WebPart在VS.NET中建立一個(gè)類型為“Web Part Library”，名稱為“SampleWebPart”的項(xiàng)目。在“WebPart1.cs”文件的“RenderWebPart()”方法中將一個(gè)事先準(zhǔn)備好的名字為“boketang.jpg

3、”的圖片輸出。代碼如下：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會(huì)給我們的WebPart項(xiàng)目自動(dòng)生成一個(gè)用于部署的文件，“Manifest.xml”，將其打開進(jìn)行必要的修改：由于在第二步中，我們使

4、用了一個(gè)名為“boketang.jpg”的圖片文件，所以，我們需要告訴這個(gè)部署文件。在已有的“”標(biāo)簽下，增加一個(gè)新的標(biāo)簽“”，用來描述這個(gè)WebPart所用到的所有其他的資源文件。 如上，我們?cè)黾拥倪@三行標(biāo)簽告訴部署文件，我們需要一個(gè)名為“boketang.jpg”的資源文件。四、生成(.CAB)文件將我們這個(gè)WebPart所需要所有四個(gè)文件：SampleWebPart.dll （VS.NET編譯生成的Assembly文件）WebPart1.dwp （WebPart描述文件）Manifest.xml （WebPart部署文件）boketang.jpg （WebPart中用到的圖片資源文件）拷貝

5、到一處，然后用Cabinet Manager 2003將他們壓縮成一個(gè)名稱為“SampleWebPart.cab”的壓縮包。將“SampleWebPart.cab”文件拷貝到SPS服務(wù)器的“C:/”位置。五、將(.CAB)中的WebPart部署到SPS服務(wù)器上部署(.CAB)方式壓縮的WebPart需要SPS中的“stsadm.exe”這個(gè)命令行工具，它通常位于“C:Program FilesCommon FilesMicrosoft Sharedweb server extensions60BIN”目錄中，請(qǐng)將這個(gè)目錄加入到SPS服務(wù)器的系統(tǒng)“Path”環(huán)境變量中，以使我們可以直接調(diào)用到“s

6、tsadm.exe”。打開命令提示符窗口，將當(dāng)前路徑指定為“SampleWebPart.cab”所在的“C:/”，執(zhí)行下面的指令：stsadm o addwppack filename SampleWebPart.cab如果成功，它會(huì)提示我們類似下面的信息：samplewebpart.cab: 部署到部署到 http:/SPSServer/。操作成功完成。操作成功完成。至此，這個(gè)WebPart已經(jīng)成功部署到了SPS服務(wù)器上的所有虛擬站點(diǎn)中。六、將WebPart放入頁(yè)面中點(diǎn)擊頁(yè)面右上角的“修改我的網(wǎng)頁(yè)”鏈接，在打開的菜單中選擇“添加Web部件 瀏覽”，就可以在打開的Panel中瀏覽到。選擇“虛擬

7、服務(wù)器庫(kù)”，就可以在下方的“Web部件列表”中看到我們?cè)诘谖宀街屑尤氲教摂M服務(wù)器中的那個(gè)WebPart。通過Panel下方的“添加”按鈕，將這個(gè)WebPart加入到當(dāng)前頁(yè)面中。效果如左圖，它將指定的“boketang.jpg”圖片輸出來了。七、升級(jí)已部署的WebPart現(xiàn)在我們回到VS.NET開發(fā)界面，重新打開“WebPart1.cs”文件，修改RenderWebPart()方法，增加一行代碼，給Image控件增加一個(gè)Tooltip效果，如下：protected override void RenderWebPart(HtmlTextWriter output) System.Web.UI.W

8、ebControls.Image image = new Image(); image.ImageUrl = /wpresources/samplewebpart/boketang.jpg; image.ToolTip = 博客堂，博客堂，.NET技術(shù)站點(diǎn)！技術(shù)站點(diǎn)！; image.RenderControl(output);重新編譯、壓縮生成(.CAB)文件、拷貝到SPS服務(wù)器上，然后在服務(wù)器的命令提示行輸入命令（與第四、五步驟相同）：stsadm o addwppack filename SampleWebPart.cab force“-force”參數(shù)可以將已部署的WebPart升級(jí)成為

9、最新的版本。再次瀏覽已加入此WebPart的頁(yè)面，可以發(fā)現(xiàn)Tooltip效果已經(jīng)加上去了。八、刪除已部署的WebPart首先打開已加入WebPart的頁(yè)面，通過此WebPart的下拉按鈕，選擇“刪除”選項(xiàng)，將這個(gè)WebPart從頁(yè)面上刪除。在SPS服務(wù)器的命令提示行下輸入下面的指令：stsadm o deletewppack name SampleWebPart.cab就可以將SPS服務(wù)器上所有虛擬站點(diǎn)中的“SampleWebPart”刪除。九、用(.MSI)方式部署WebPart下面開始介紹如何將WebPart制作成(.MSI)安裝包，在SPS上以安裝程序的形式部署WebPart。在此鏈接中

10、下載WebPart Packager。將下載的壓縮包展開（一共7個(gè)文件）到“C:/WPPackager”目錄。將第四步中提到的WebPart所需要的4個(gè)文件拷貝到“C:/WPPackager”目錄。SampleWebPart.dll （VS.NET編譯生成的Assembly文件）WebPart1.dwp （WebPart描述文件）Manifest.xml （WebPart部署文件）boketang.jpg （WebPart中用到的圖片資源文件）十、編輯WebPart Packager的打包配置文件打開WebPart Packager自帶的“wppackager.xml”文件，根據(jù)各自的打包需要

11、，編輯它。此例中打包配置文件的完整格式如下： Manifest標(biāo)簽“FileName”屬性的值為WebPart的部署文件之所在，在這個(gè)例子中，WebPart的部署文件就是“manifest.xml”。MSI標(biāo)簽“Name”屬性的值為打包生成的(.MSI)文件的名稱?！癡ersion”屬性為(.MSI)安裝包的版本（可用于升級(jí)更新的WebPart）?！癕anufacturer”為WebPart的開發(fā)商信息。十一、生成(.MSI)安裝包打開命令提示符窗口，將當(dāng)前目錄設(shè)置為“C:/WPPackager”，執(zhí)行指令：wppackager wppackager.xmlWebPart Packager將為

12、你生成一個(gè)“SampleWebPart.msi”的安裝文件。十二、安裝、刪除(.MSI)安裝包將第十步生成的(.MSI)文件拷貝到SPS服務(wù)器中，雙擊執(zhí)行它，就會(huì)啟動(dòng)WebPart的安裝過程。在安裝過程中，安裝程序會(huì)詢問是否將WebPart安裝到SPS服務(wù)器所在的所有虛擬站點(diǎn)中，還是只安裝到指定的虛擬站點(diǎn)中。如左圖所示，我們只安裝到“http:/vpc1”這個(gè)虛擬站點(diǎn)中。要?jiǎng)h除這個(gè)WebPart，只需要進(jìn)入“控制面板 添加或刪除程序”，就可以看到我們安裝的WebPart被列在了程序列表中。點(diǎn)擊“刪除”按鈕就可以將這個(gè)WebPart從SPS服務(wù)器上刪除。十三、 To Be Continued注意：注意：此WalkThrough只講述了“stsadm”最基本的WebPart部署功能，下列的其他要點(diǎn)：* 指定在某個(gè)虛擬站點(diǎn)（而不是前面演示的SPS服務(wù)器上的所有虛擬站點(diǎn)