ASP.NET服務器控件編程淺析
當用戶向請求一個頁面時,服務器端會向客戶端發(fā)送一段文本,包括可顯示標記字符和不可顯示的文本,當這段文本到達客戶端后,再通過客戶端的瀏覽器(如IE)把可視化的標記字符轉(zhuǎn)化為可視呈現(xiàn)給用戶,所以在用戶請求一個aspx頁面時,頁面上的Asp.net服務器控件,也會把文本寫入到返回的文本流中,在本章中我們將講述這一過程,學習ASP.NET服務器控件編程的相關知識。
ASP.NET服務器控件編程提供了4個有關呈現(xiàn)的方法,分別是Render、RenderChildren、RenderContents和RenderControl,這4個方法都有一個HtmlTextWriter類型的參數(shù)。HtmlTextWriter的作用就是把標記字符和文本寫入倒Asp.net服務器控件流中,它是System.Web.UI名稱空間所有標記編寫器的基類,包括ChtmlTextWriter、Html32TextWriter和XhtmlTextWriter,這些類用于針對不同的標記類型編寫元素、屬性、樣式和布局信息。
既然有4個有關呈現(xiàn)的方法,那它們的作用分別是什么?它們之間有什么區(qū)別呢?我們以一個控件的生成過程來說明:
每個頁面都有一個控件樹,代表本頁面所擁有的所有子控件,頁面控件就是控件樹的根,為了生成控件樹,頁面將建立一個HtmlTextWriter類的實例;在這個實例中封裝了相應流,接著頁面會把HtmlTextWriter對象傳遞給RenderControl,RenderControl會檢查控件的Visible屬性是否為真,如果是真,RenderControl會調(diào)用Render方法,而Render方法會去調(diào)用RenderContents,RenderContents方法負責將控件的內(nèi)容呈現(xiàn)到指定的編寫器中,如果控件有子控件的話,Render方法又會把HtmlTextWriter傳遞給RenderChildren方法,RenderChildren方法負責生成控件的子控件。
我們以一個例子來說明ASP.NET服務器控件編程的過程。
- public class Class1 : WebControl
- {
- protected override void Render
- (System.Web.UI.HtmlTextWriter writer)
- {
- writer.Write("RenderChildren〈br 〉");
- base.Render(writer);
- }
- protected override void RenderChildren
- (System.Web.UI.HtmlTextWriter writer)
- {
- writer.Write("RenderChildren〈br 〉");
- base.RenderChildren(writer);
- }
- public override void RenderControl
- (System.Web.UI.HtmlTextWriter writer)
- {
- writer.Write("RenderControl〈br 〉");
- base.RenderControl(writer);
- }
- protected override void RenderContents
- (System.Web.UI.HtmlTextWriter writer)
- {
- writer.Write("RenderContents〈br 〉");
- base.RenderContents(writer);
- }
- }
效果如下的圖1(RenderControl—〉Render—〉RenderContents—〉RenderChildren):
在ASP.NET服務器控件編程中HtmlTextWrite的各種方法的參數(shù)取值用到三種枚舉類型:HtmlTextWriteTag、HtmlTextWriteAttribute和HtmlTextWriteStyle,在這里不作詳細的講解,舉例如下,效果如上圖的圖2:
- [DefaultProperty("Text")]
- [ToolboxData("〈{0}:WebCustomControl1
- runat=server〉〈/{0}:WebCustomControl1〉")]
- public class WebCustomControl1 : WebControl
- {
- protected override void Render
- (HtmlTextWriter output)
- {
- // -----------------------------------------
- // ***種方式,通過Add + [Attribute、
- StyleAttribute、BeginTag\EndTag]
- // AddAttribute、AddStyleAttribute
- 在RenderBeginTag和RenderEndTag之前
- output.BeginRender(); // 開始Render
- output.AddAttribute(HtmlTextWriterAttribute.
- Value, "This is input.");
- // 使用HtmlTextWriteAttribute枚舉
- output.AddStyleAttribute(HtmlTextWriterStyle.
- BackgroundColor, ColorTranslator.ToHtml
- (Color.GreenYellow));
- // 使用HtmlTextWriteStyle枚舉
- output.RenderBeginTag(HtmlTextWriterTag.Input);
- // 使用HtmlTextWriteTag枚舉
- output.RenderEndTag();
- output.EndRender(); // 結(jié)束Render
- // ------------------------------------------
- // -------------------------------------------
- // 第二種方式,通過Write + [Attribute、
- StyleAttribute、BeginTag\EndTag]
- // WriteAttribute、WriteStyleAttribute
- 在WriteBeginTag和WriteEndTag之間
- output.WriteBeginTag("input");
- // 直接標記的名稱,不使用HtmlTextWriteTag枚舉
- output.WriteAttribute("value", "This is input too.");
- // 直接使用屬性名稱,不使用HtmlTextWriteAttribute枚舉
- output.Write(" style=\"");
- output.WriteStyleAttribute("background-color",
- ColorTranslator.ToHtml(Color.Lavender));
- // 直接使用樣式標記,不使用HtmlTextWriteStyle枚舉
- output.Write("\"");
- output.Write(HtmlTextWriter.TagRightChar); // 添加“〉”標記
- output.WriteEndTag("input");
- // -----------------------------------------------
- // 第二種適用于對html比較熟悉的朋友。
- }
- }
【編輯推薦】