這是我們介紹SharePoint開發入門的第一篇,在這一篇里,我們會介紹SharePoint開發的幾個關鍵物理路徑,一些開發技巧和最基礎的WebPart開發。
開發工具
在SharePoint 2013開發中,我們使用的是Visual Studio 2012/2013均可,但是VS2012要額外安裝Microsoft Office Develop Tools for Visual Studio 2012,可以使用Microsoft Web PlatForm Install進行安裝。
幾個關鍵位置
SharePoint開發中,不僅僅是WebPart,我們都經常會使用的幾個關鍵位置,如下:
GAC:
C:\Windows\assembly,也就是部署的位置;
ISAPI位置,SharePoint API:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\ISAPI;
CONTROLTEMPLATES位置,SharePoint控件/模板:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\CONTROLTEMPLATES;
XML位置,SharePoint描述性文件位置:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\XML;
Layouts位置,SharePoint發布頁面:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\LAYOUTS;
Feature位置,SharePoint功能部署位置:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\FEATURES;
Images位置,SharePoint圖片素材庫:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\IMAGES;
LOGS位置,SharePoint日志文件:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\LOGS
WebPart簡介
WebPart,顧名思義就是Web部件的意思,簡單理解就是頁面上實現一定功能的一個個部分;SharePoint的WebPart,是將應用程序集部署到GAC或者Bin目錄下,在Web.Config加入強名稱(SharePoint不識別未加強名稱的WebPart),下面,我們簡單介紹下如何創建一個WebPart。
WebPart創建過程
1、創建項目,項目類型為SharePoint2013空項目,如下圖:
2、選擇解決方案類型,這里選擇場解決方案,如下圖:
3、在項目里添加新項,選擇Web部件,如下圖:
4、添加新項后,項目如下所示:
如上圖,右側目錄包括:一個Feature文件,WebPart文件,強名稱;左側包括,一個創建控件方法,一個輸出方法。
5、修改Feature文件,如下圖:
6、修改WebPart屬性(標題和描述),如下圖:
7、添加相應方法的代碼,然后部署,如下圖:
8、在頁面上添加webpart,如下圖:
9、添加后,保存頁面,如下圖:
10、點擊Button測試,如下圖:
如上圖,點擊測試后執行事件,將Label的Text修改了,說明程序執行成功。當然,這僅僅是一個測試WebPart的Demo,你可以寫簡單的圖片輪播部件,復制的邏輯處理部件,都是沒有問題的,只是豐富其中的方法罷了。
除了測試Demo,還有幾點要說明的是:
項目文件里CustomWebPart.webpart部署在網站設置,Web部件庫,如下圖:
WebPart屬性面板配置
當然,我們還可以為WebPart添加右側的屬性面板,方便將來對於WebPart的配置,我們只需要在CustomWebPart.cs文件里面,聲明一下變量即可:
private string url = "http://www.cnblogs.com/jianyus"; [WebBrowsable(true)] [WebDisplayName("Url")] [WebDescription("This is Site Url...")] [Category("設置")] [Personalizable(true)] public string myurl { get { return url; } set { url = value; } }
聲明如下圖:
效果如下圖:
當然,我這里測試是一個單行文本,你可以試試枚舉類型(下拉選項),布爾類型(選項)等,只要按照上面的方式聲明即可。
如果,你需要很復雜的屬性面板,或者需要帶有聯動的面板,那么,你可以參考EditorPart或者ToolsPart,在這里不進行深入介紹,我的博客有相關內容的博文,歡迎參考。
最后,介紹下一個webpart的部署過程,dll文件是部署到GAC或者bin目錄下的,如果你需要添加配置文件,可以添加到相關聯應用程序(端口下)web.config,然后在webpart里按照.net的方式讀取,即可。
由於本文是開發入門級別的博文,請大神勿噴,如有意見,歡迎在博客后留言進行探討,特別說一聲:謝謝!
總 結
以上,基本就是WebPart開發的基礎知識,現在,你可以參照上面,開發一個簡單的WebPart練練手了,記得,不要光寫代碼,要學着思考和理解。