WalkThroughSharePointWebPart入門指南三

1、WalkThroughSharePoint WebPart 入門指南 三Kaneboy MS MVP轉(zhuǎn)載聲明：此WalkThrough系列被轉(zhuǎn)載和引用時(shí)，請(qǐng)保持博客堂鏈接。Thanks.此WalkThrough將演示將一個(gè)Code-Behind方式編寫的User Control載入到WebPart中將所有的內(nèi)容（WebPart、User Control、包括.ascx）集成到WebPart所在的一個(gè)Assembly中，以簡(jiǎn)化部署背景知識(shí)請(qǐng)通過此WalkThrough系列的前兩輯了解在VS.NET中創(chuàng)建WebPart、加入U(xiǎn)ser Control、簡(jiǎn)單部署WebPart等基礎(chǔ)知識(shí)。如果希望深入了

2、解此WalkThrough中演示的部分代碼的含義，請(qǐng)參看MSDN中有關(guān)Assembly中Resource部分的文檔（如果不想了解，照葫蘆畫瓢亦可）。一、創(chuàng)建用戶控件創(chuàng)建一個(gè)“ASP.NET Web應(yīng)用程序”項(xiàng)目，在項(xiàng)目中添加一個(gè)名為“WebUserControl1”的用戶控件，并放入一個(gè)Calendar控件。在User Control的Code-Behind文件（這里是“WebUserControl1.ascx.cs”）中，加入自己想加入的代碼。我們的示例中在User Control的Page_Load事件中加入了一行代碼，用來設(shè)置Calendar控件的ToolTip屬性二、創(chuàng)建WebPart

3、項(xiàng)目在VS.NET中重新建立一個(gè)類型為“Web Part Library”，名稱為“SampleWebPart”的項(xiàng)目。在項(xiàng)目中通過“添加現(xiàn)有項(xiàng)”菜單，將第一步中建立的UserControl的三個(gè)文件全部加入到此項(xiàng)目中。打開“WebUserControl1.ascx.cs”文件，將此文件第一行指定的namespace改成和此項(xiàng)目一致的“SampleWebPart”：namespace SampleWebPart打開“WebUserControl1.ascx”文件，將第一行的“”標(biāo)簽中的“CodeBehind”屬性刪除，“Inherits”屬性的值改為“SampleWebPart.WebUser

4、Control1”：三、設(shè)置User Control的編譯目標(biāo)在“解決方案資源管理器”中選中User Control項(xiàng)“WebUserControl1.ascx”，點(diǎn)擊鼠標(biāo)右鍵，選擇“屬性”菜單。在出現(xiàn)的屬性窗口中，將“生成操作”屬性的值更改為“嵌入的資源”。四、在WebPart中載入Resource信息并輸出進(jìn)行這一步驟之前，請(qǐng)回憶WalkThrough第一輯中的第二步。我們這里在WebPart中嵌入一個(gè)UserControl的原理和第一輯中的基本相同。讓我們現(xiàn)在轉(zhuǎn)到“WebPart1.cs”文件，開始修改我們的WebPart。1、定義一個(gè)用來保存UserControl的對(duì)象：private

5、 System.Web.UI.Control _innerControl;四、在WebPart中載入Resource信息并輸出（二）前面兩行的意思是從當(dāng)前Assembly的Resource中取出指定信息并讀到變量resourceContent中。這兩行的意思是將resourceContent中的內(nèi)容寫入到一個(gè)名為“WebUserControl1.ascx”的文件中。2、重載CreateChildControls()方法。protected override void CreateChildControls() using (StreamReader reader = new StreamRea

6、der(System.Reflection.Assembly.GetExecutingAssembly().GetManifestResourceStream(SampleWebPart.WebUserControl1.ascx) String resourceContent = reader.ReadToEnd(); using (StreamWriter writer = new StreamWriter(this.Page.Server.MapPath(/bin/WebUserControl1.ascx), false) writer.Write(resourceContent); th

7、is._innerControl = this.Page.LoadControl(/bin/WebUserControl1.ascx); this.Controls.Add(this._innerControl);四、在WebPart中載入Resource信息并輸出（三）3、在RenderWebPart()方法中輸出載入的User Control：protected override void RenderWebPart(HtmlTextWriter output) this.EnsureChildControls(); this._innerControl.RenderControl(out

8、put);五、WebPart的其他工作1、編輯“WebPart1.dwp”，配置WebPart。2、編輯SPS虛擬站點(diǎn)上的“web.config”，添加“”標(biāo)簽以信任我們的WebPart。3、在VS.NET中編譯，生成最終的“SampleWebPart.dll”。將此(.dll)拷貝到SPS虛擬站點(diǎn)跟目錄的“bin”目錄下。（只需要拷貝這一個(gè)(.dll)文件，不需要再另行拷貝(.ascx)文件。）4、在SPS站點(diǎn)頁面中導(dǎo)入我們這個(gè)WebPart。上面的步驟詳細(xì)操作請(qǐng)參看此WalkThrough第一輯中的第三、四、五、六步驟。六、完成WebPart在頁面上面的效果如左圖。當(dāng)把鼠標(biāo)移到Calendar控件上時(shí)，可以看到有“Sample Calendar”的提示信息，驗(yàn)證了在第一步添加的Code-Behind代碼被執(zhí)行了。七、To Be Continued注意：我們前面的步驟僅僅用來演示如何實(shí)現(xiàn)我們需要的效果，但其細(xì)節(jié)代碼實(shí)現(xiàn)的方式并不推薦。首先不推薦將臨時(shí)的“WebUserControl1.ascx”文件直接寫到SPS虛擬