本文將舉例說明如何在wssv3中創(chuàng)建一個(gè)Filter consumer WebPart 來顯示頭條新聞。這些頭條新聞內(nèi)容依賴于地理區(qū)域的篩選提供者WebPart中用戶的選擇。頭條新聞WebPart將通過調(diào)用Microsoft Excel Services從一個(gè)Excel工作簿中得到。
下面是創(chuàng)建filter consumer WebPart的五大步驟
在Visual Studio 2005中創(chuàng)建一個(gè)web control library項(xiàng)目。
添加到Microsoft.SharePoint.dll的引用。
設(shè)置assembly的版本號(hào)。
為assembly添加強(qiáng)命名。
編寫頭條新聞filter consumer webpart的代碼。
在Visual Studio 2005中創(chuàng)建一個(gè)web control library項(xiàng)目
創(chuàng)建一個(gè)filter consumer WebPart最簡單的方式是套用Visual Studio 2005的自定義Web控件模板。
下面是創(chuàng)建的步驟:
文件->新建->項(xiàng)目,出現(xiàn)新建項(xiàng)目對話框。
在項(xiàng)目類型中,選擇C#,選擇Windows類別。
在模板選擇中,選擇web控件庫。
為項(xiàng)目指定一個(gè)名稱NewsHeadlinesWebPart 。
指定保存的位置,確定。現(xiàn)在,項(xiàng)目中包含一個(gè)名為WebCustomControl1.cs的代碼文件。
在解決方案瀏覽器中右擊該文件,選重名名。將該文件重命名為NewsHeadlinesWebPart.cs。
添加必要的程序集的引用
我們將要編寫的頭條新聞篩選消費(fèi)者WebPart是要從Microsoft.SharePoint.WebPartPages.WebPart類繼承而來。因此,必須添加Windows SharePoint Services的程序集;由于使用到了Excel Services,還要引用Excel Services的程序集,以便允許使用其中的類。
下面的步驟是展示了如何直接連接到Excel Web Serivces庫。之所以如此是因?yàn)轭^條新聞WebPart運(yùn)行域SharePoint環(huán)境中,這與使用SOAP通過HTTP訪問Web service的方式不同。在我們的這種場景下直接連接可以提供更高的性能和安全性,并允許我們的頭條新文WebPart可以工作在所有的SharePoint拓?fù)浣Y(jié)構(gòu)下。而當(dāng)我們創(chuàng)建獨(dú)立的Web應(yīng)用程序(Web應(yīng)用程序并不運(yùn)行在SharePoint中)時(shí),實(shí)際上是真正用到Web service的接口。關(guān)于何時(shí)選擇使用SOAP方式通過HTTP訪問,何時(shí)直接連接到Excel Web Services DLL,您可以參考這篇MOSS SDK文章:Loop-back SOAP Calls and Direct Linking
如果Visual Studio運(yùn)行在office SharePoint Server 2007服務(wù)器上,請以下面的步驟進(jìn)行引用:
項(xiàng)目->添加引用,出現(xiàn)添加引用對話框。
點(diǎn)擊.NET標(biāo)簽,選擇Excel Web Service 組件(Microsoft.office.Excel.Server.WebServics.dll)。接著向下滾動(dòng),找到Windows SharePoint Services組件(Microsoft.SharePoint.dll),按住Ctrl鍵,再選擇。
確定,完成引用的添加。
如果Visual Studio與office SharePoint Server 2007不在同一臺(tái)機(jī)器上,我們需要從一臺(tái)裝有office SharePoint Server 2007的機(jī)器上拷貝該文件到我們的開發(fā)環(huán)境所在機(jī)器的項(xiàng)目文件夾下。默認(rèn)情況下,Microsoft.SharePoint.dll和Microsoft.office.Excel.Server.WebServics.dll位于裝有SharePoint的機(jī)器的以下目錄中:
拷貝過來后,將這兩個(gè)文件添加到引用中。
添加到本地拷貝的程序集的引用
項(xiàng)目->添加引用,出現(xiàn)添加引用對話框。
點(diǎn)擊瀏覽,導(dǎo)航到放Windows SharePoint Services和Excel Web Service程序集文件的目錄
選中Microsoft.SharePoint.dll 和Microsoft.office.Excel.Server.WebServices.dll 文件。
確定,完成引用的添加。
如果要使Excel Web Service正常工作,還需要添加到System.Web.Services程序集的引用:
項(xiàng)目->添加引用,出現(xiàn)添加引用對話框。
點(diǎn)擊.NET標(biāo)簽,選擇System.Web.Services 組件。
確定,完成引用的添加。
設(shè)置WebPart程序集的版本號(hào)
默認(rèn)情況下,自定義Web控件項(xiàng)目的AssemblyVersion屬性設(shè)為每次重新編譯時(shí)自動(dòng)增加。Web部件頁通過Web.config文件中注冊的版本號(hào)來識(shí)別WebPart。如果AssemblyVersion屬性設(shè)為每次重新編譯時(shí)自動(dòng)增加,當(dāng)我們把WebPart導(dǎo)入到Web部件頁后又重新編譯了該WebPart,就會(huì)因?yàn)檎也坏匠绦蚣鲥e(cuò)了。避免字增的方法就是手工指定一個(gè)版本號(hào)。
為WebPart程序集手工指定版本號(hào)
項(xiàng)目->NewsHeadlinesWebPart 屬性。
在項(xiàng)目屬性頁面中,點(diǎn)應(yīng)用程序標(biāo)簽。
點(diǎn)程序集信息
在程序集信息對話框中,設(shè)定版本為1.0.0.0
確定,保存。
關(guān)閉項(xiàng)目屬性頁。
為WebPart程序集進(jìn)行強(qiáng)命名
為了使我們的WebPart可以部署到GAC(global assembly cache)中,供多個(gè)應(yīng)用程序共享,我們必須為WebPart增加強(qiáng)命名。強(qiáng)名稱由一個(gè)文本格式的名稱,版本號(hào),地區(qū)語言信息(如果提供了的話)和一個(gè)公鑰數(shù)字簽名組成。
在Visual Studio中為WebPart強(qiáng)命名
項(xiàng)目->NewsHeadlinesWebPart 屬性。
在項(xiàng)目屬性頁面中,點(diǎn)簽名標(biāo)簽。
在選擇一個(gè)強(qiáng)名key文件處,點(diǎn)新建。
在創(chuàng)建強(qiáng)命名key文件對話框中,填寫keypair文件名。取消下面的使用密碼保護(hù)我的密鑰的選擇框。
關(guān)閉項(xiàng)目屬性頁。
實(shí)現(xiàn)頭條新聞Filter Consumer WebPart
下面我們將創(chuàng)建一個(gè)類實(shí)現(xiàn)頭條新聞篩選消費(fèi)者部件。在代碼文件頭部添加下列引用。
新聞熱點(diǎn)
疑難解答
圖片精選