下載本文源代碼

　　控件呈現(xiàn)是指向HTTP輸出流中寫(xiě)入標(biāo)記文本的過(guò)程。服務(wù)器通過(guò)HTTP輸出流向客戶端發(fā)送生成的標(biāo)記文本，這些文本將會(huì)通過(guò)客戶端瀏覽器轉(zhuǎn)換為可視化的元素顯示出來(lái)。使用控件呈現(xiàn)，開(kāi)發(fā)人員可以將HTML標(biāo)記、腳本代碼、CSS樣式表等等輸入到客戶端瀏覽器。實(shí)現(xiàn)服務(wù)器控件呈現(xiàn)主要有兩種方式：一是Control類的Render方法，二是WebControl的RenderContents方法。本文重點(diǎn)介紹使用Control類的Render方法實(shí)現(xiàn)控件呈現(xiàn)的應(yīng)用。

　　使用HtmlTextWriter類

　　Control類的Render方法主要用于實(shí)現(xiàn)控件呈現(xiàn)，其聲明代碼如下：

　　如上代碼所示，Render方法的參數(shù)是一個(gè)HtmlTextWriter類型。為了更好的應(yīng)用Render方法，讀者應(yīng)首先了解HtmlTextWriter類及其相關(guān)內(nèi)容。

　　根據(jù)MSDN2005的描述，HtmlTextWriter類用于將標(biāo)記字符和文本寫(xiě)入到ASP.NET服務(wù)器控件輸出流。此類提供了ASP.NET服務(wù)器控件在向客戶端呈現(xiàn)標(biāo)記時(shí)所使用的格式設(shè)置功能。為了實(shí)現(xiàn)類的功能，HtmlTextWriter類定義了多個(gè)字段、屬性和方法。由于成員對(duì)象眾多，本文只挑選了一些常用成員加以說(shuō)明，同時(shí)，還將介紹一些ASP.NET 2.0的新增成員。

　　常用成員對(duì)象包括：

　　·AddAttribute方法

　　對(duì)于HtmlTextWriter對(duì)象通過(guò)對(duì)RenderBeginTag方法的后續(xù)調(diào)用創(chuàng)建的元素，向其開(kāi)始標(biāo)記中添加指定的標(biāo)記屬性和值。

　　·AddStyleAttribute方法

　　對(duì)于 HtmlTextWriter 對(duì)象通過(guò)對(duì) RenderBeginTag 方法的后續(xù)調(diào)用創(chuàng)建的元素，向其開(kāi)始標(biāo)記中添加標(biāo)記樣式屬性。

　　·Write方法

　　將指定數(shù)據(jù)類型連同任何掛起的制表符間距一起寫(xiě)入到輸出流。

　　·WriteAttribute方法

　　將標(biāo)記屬性及其值寫(xiě)入到輸出流。

　　·WriteBeginTag方法

　　任何制表符間距和指定標(biāo)記元素的開(kāi)始標(biāo)記寫(xiě)入到輸出流。

　　·WriteEndTag方法

　　寫(xiě)入指定的標(biāo)記元素的任何制表符間距和結(jié)束標(biāo)記。

　　·Encoding屬性

　　獲取 HtmlTextWriter 對(duì)象用于將內(nèi)容寫(xiě)入頁(yè)的編碼。

　　·Indent屬性

　　獲取或設(shè)置用以縮進(jìn)每一行標(biāo)記的開(kāi)始位置的制表符位置數(shù)。

　　·NewLine屬性

　　獲取或設(shè)置由 HtmlTextWriter 對(duì)象使用的行結(jié)束符字符串。

　　對(duì)于初學(xué)者而言，建議重點(diǎn)掌握以上成員對(duì)象的應(yīng)用。另外，ASP.NET 2.0還為HtmlTextWriter類新增了一些成員，這些成員包括：

　　·BeginRender方法

　　通知 HtmlTextWriter 對(duì)象或派生類的對(duì)象，某個(gè)控件將會(huì)呈現(xiàn)。

　　·EndRender方法

　　通知 HtmlTextWriter 對(duì)象或某個(gè)派生類的對(duì)象，某控件已完成呈現(xiàn)。

　　·IsValidFormAttribute方法

　　檢查一個(gè)屬性以確保它可以在 ＜form＞ 標(biāo)記元素的開(kāi)始標(biāo)記中呈現(xiàn)。

　　·WriteEncodedUrl方法

　　對(duì)指定的 URL 進(jìn)行編碼，然后將它寫(xiě)入到輸出流。URL 可以包括參數(shù)。

　　·WriteEncodedText方法

　　對(duì)請(qǐng)求的設(shè)備的指定文本進(jìn)行編碼，然后將其寫(xiě)入到輸出流。

　　·WriteBreak方法

　　將 ＜br /＞ 標(biāo)記元素寫(xiě)入到輸出流。

使用Render方法實(shí)現(xiàn)控件呈現(xiàn)

　　1、基礎(chǔ)知識(shí)

　　本文所講解的Render方法隸屬于System.Web.UI.Controls.Control類。該類是創(chuàng)建服務(wù)器控件的基類，很多控件類均繼承自該類。在Control類中包括三個(gè)用于實(shí)現(xiàn)控件呈現(xiàn)的方法：Render、RenderChildren和RenderControl。它們都使用HtmlTextWriter的實(shí)例作為參數(shù)，它們?cè)试S為一個(gè)HtmlTextWriter對(duì)象提供服務(wù)器控件的內(nèi)容，并將其內(nèi)容封裝至HTTP輸出流中輸出到客戶端顯示。下面簡(jiǎn)單對(duì)這三個(gè)方法進(jìn)行簡(jiǎn)單介紹。

　　(1) protected virtual void Render(HtmlTextWriter writer);

　　該方法用于將服務(wù)器控件內(nèi)容發(fā)送到提供的HtmlTextWriter對(duì)象，此對(duì)象編寫(xiě)將在客戶端呈現(xiàn)的內(nèi)容。在開(kāi)發(fā)服務(wù)器控件時(shí)，可以重寫(xiě)此方法以呈現(xiàn)服務(wù)器控件。

　　(2) protected virtual void RenderChildren(HtmlTextWriter writer);

　　該方法用于將服務(wù)器控件子級(jí)的內(nèi)容輸出到提供的HtmlTextWriter對(duì)象，此對(duì)象編寫(xiě)將在客戶端呈現(xiàn)的內(nèi)容。該方法通知ASP.NET呈現(xiàn)頁(yè)中的所有Active Server Pages代碼。如果頁(yè)上沒(méi)有任何ASP代碼，此方法將呈現(xiàn)服務(wù)器控件的所有子控件。

　　(3) protected virtual void RenderControl(HtmlTextWriter writer);和protected void RenderControl (HtmlTextWriter writer,ControlAdapter adapter)

　　RenderControl有兩個(gè)重載方法，它們都用于將服務(wù)器控件的內(nèi)容輸出到所提供的HtmlTextWriter對(duì)象中。如果已啟用跟蹤功能，則存儲(chǔ)有關(guān)控件的跟蹤信息。如果服務(wù)器控件的Visible屬性設(shè)置為true，該方法將確定是否啟用頁(yè)的跟蹤功能。如果啟用，它將存儲(chǔ)與控件有關(guān)的跟蹤信息，同時(shí)向頁(yè)呈現(xiàn)服務(wù)器控件的內(nèi)容。另外，前一個(gè)重載方式是ASP.NET 2.0從ASP.NET 1.0中繼承而言，后一個(gè)重載方式是ASP.NET 2.0新增的。后者具體使用提供的ControlAdapter對(duì)象將服務(wù)器控件內(nèi)容輸出到提供的HtmlTextWriter對(duì)象。其中參數(shù)adapter是ControlAdapter類型，它用于定義呈現(xiàn)的ControlAdapter。當(dāng)實(shí)現(xiàn)在各種設(shè)備和瀏覽器中運(yùn)行的服務(wù)器控件時(shí)，該方法比較常用。

　　以上3個(gè)方法看起來(lái)好像是獨(dú)立的3個(gè)方法，然而，實(shí)際上它們之間存在密切的聯(lián)系。讀者可通過(guò)閱讀以下示意性代碼，從而理解它們之間的關(guān)系。

　　如上代碼所示，其中列舉了RenderControl、Render、RenderChildren方法的實(shí)現(xiàn)思路。顯而易見(jiàn)的是，在控件呈現(xiàn)過(guò)程中，這三個(gè)方法都在起著作用，而且使用了一個(gè)簡(jiǎn)單的遞歸調(diào)用過(guò)程。大體而言，可以理解為：

　?。?）頁(yè)面框架建立一個(gè)HtmlTextWriter類的實(shí)例；

　　（2）頁(yè)面框架將這個(gè)實(shí)例對(duì)象傳遞給RenderControl方法；

　?。?）RenderControl方法檢查控件的可視屬性Visible是否為true。如果為true，RenderControl方法將調(diào)用Render方法；如果為false，則不呈現(xiàn)該控件和其子控件；

　?。?）Render方法執(zhí)行默認(rèn)實(shí)現(xiàn)，調(diào)用RenderChildren方法；

　?。?）RenderChildren方法按照默認(rèn)實(shí)現(xiàn)中的設(shè)定調(diào)用每個(gè)子控件的RenderControl方法；

　　實(shí)際上，如果讀者短時(shí)間內(nèi)不能理解以上過(guò)程也沒(méi)有很大的關(guān)系。對(duì)于初學(xué)者而言，關(guān)鍵是要記住最重要、最常用的是Render方法?？丶_(kāi)發(fā)者可以通過(guò)重寫(xiě)Render方法完成呈現(xiàn)控件的任務(wù)。

　　2、示例應(yīng)用

　　上文介紹了使用Control類的Render方法實(shí)現(xiàn)控件呈現(xiàn)的基礎(chǔ)知識(shí)。下面將通過(guò)一個(gè)典型示例，幫助讀者初步理解Render的使用方法。示例效果如圖1所示。

　　如圖1所示，該服務(wù)器控件呈現(xiàn)了一個(gè)超鏈接，并且設(shè)置了文本為紅色。當(dāng)用戶單擊紅色文字時(shí)，頁(yè)面將轉(zhuǎn)向微軟站點(diǎn)。當(dāng)然，用戶可以通過(guò)屬性LinkUrl來(lái)設(shè)置超鏈接地址。

　　下面列舉了示例實(shí)現(xiàn)源代碼。

　　如上代碼實(shí)現(xiàn)了自定義服務(wù)器控件類RenderControl。該類從Control基類繼承，具體實(shí)現(xiàn)了表示超鏈接地址的LinkUrl（默認(rèn)值為http://localhost/），并重寫(xiě)了Render方法。在重寫(xiě)Render的過(guò)程中，調(diào)用了一些HtmlTextWriter類成員，例如，Writer、AddAttribute、AddStyleAttribute、RenderBeginTag和RenderEndTag方法等。另外，可能開(kāi)發(fā)人員在使用Writer方法過(guò)程中，需要呈現(xiàn)一個(gè)比較長(zhǎng)的字符串。建議此時(shí)多多使用Writer方法，而不要使用字符串級(jí)聯(lián)或者StringBuilder類的相關(guān)方法進(jìn)行實(shí)現(xiàn)。因?yàn)?，那樣將?huì)消耗大量的系統(tǒng)時(shí)間和內(nèi)存，效率較低。

可能有一些讀者會(huì)問(wèn)，如果將服務(wù)器控件呈現(xiàn)的多行代碼的順序變化一下，是否會(huì)有什么不同呢？例如，假設(shè)首先依次應(yīng)用RenderBeginTag、Write、RenderEndTag方法，然后再調(diào)用AddAttribute和AddStyleAttribute方法，那么會(huì)顯示相同的效果嗎？答案是否定的。這里需要強(qiáng)調(diào)的是：在呈現(xiàn)控件的過(guò)程中，首先要定義服務(wù)器控件的屬性和CSS樣式等內(nèi)容，然后再定義服務(wù)器控件的主體內(nèi)容，這種順序不能改變的。

　　另外，如果讀者感興趣可以在代碼中實(shí)現(xiàn)一個(gè)Text屬性，用于獲取或者設(shè)置控件所顯示的文本。這樣，在Render方法中，使用Write方法輸出的"瀏覽網(wǎng)站"文字內(nèi)容則可由Text屬性代替。

　　下面列舉了為使用以上的自定義服務(wù)器控件，而創(chuàng)建的Default.aspx文件源代碼。

＜%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %＞ ＜%@ Register TagPrefix="Sample" Assembly="UsingRenderControl" Namespace="UsingRenderControl" %＞ ＜!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"＞ ＜html xmlns="http://www.w3.org/1999/xhtml"＞ ＜head runat="server"＞ ＜title＞使用Render方法實(shí)現(xiàn)控件呈現(xiàn)＜/title＞ ＜/head＞ ＜body＞ ＜form id="form1" runat="server"＞ ＜div＞ ＜Sample:RenderControl runat="server" ID="CustomerControl" LinkUrl="http://www.microsoft.com/"＞ ＜/Sample:RenderControl＞ ＜/div＞ ＜/form＞ ＜/body＞ ＜/html＞

　　以上代碼比較簡(jiǎn)單，其中主要聲明了自定義服務(wù)器控件RenderControl，并設(shè)置其LinkUrl屬性值為http://www.microsoft.com，即微軟站點(diǎn)地址。

　　當(dāng)用戶在瀏覽器中運(yùn)行以上頁(yè)面，并查看相關(guān)的Html源文件時(shí)，可得到如下的代碼：

＜!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"＞ ＜html xmlns="http://www.w3.org/1999/xhtml"＞ ＜head＞ ＜title＞ 使用Render方法實(shí)現(xiàn)控件呈現(xiàn)＜/title＞ ＜/head＞ ＜body＞ ＜form name="form1" method="post" action="Default.aspx" id="form1"＞ ＜div＞ ＜input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" value="/wEPDwUJNzMyMTY5NTU2ZGQQYrLd/G+vm1h41r2CEkxID63o5g==" /＞ ＜/div＞ ＜div＞ ＜a style="color:red;"＞瀏覽網(wǎng)站＜/a＞ ＜/div＞ ＜/form＞ ＜/body＞ ＜/html＞

　　通過(guò)觀察以上代碼可知，自定義服務(wù)器控件RenderControl實(shí)際呈現(xiàn)的結(jié)果是粗體所示部分的代碼，其最終呈現(xiàn)為一個(gè)表示超鏈接的＜a＞標(biāo)記。

　　小結(jié)

　　本文首先介紹了HtmlTextWriter類的基本知識(shí)，然后講解了使用Render方法實(shí)現(xiàn)控件呈現(xiàn)的應(yīng)用。在隨后的一篇文章中，筆者將說(shuō)明另外一種實(shí)現(xiàn)控件呈現(xiàn)的方法。從服務(wù)器控件開(kāi)發(fā)技術(shù)總體而言，控件呈現(xiàn)技術(shù)是開(kāi)發(fā)過(guò)程中最為常用，也是最為簡(jiǎn)單的內(nèi)容。建議讀者能夠熟練掌握其中的內(nèi)容。