ASP.NET服務(wù)器控件之RenderContents的介紹：

本文重點介紹另一種實現(xiàn)控件呈現(xiàn)的常用方法--使用WebControl類的RenderContents方法實現(xiàn)控件呈現(xiàn)。

基礎(chǔ)知識

就ASP.NET服務(wù)器控件而言只存在兩種情況：一種是具有外觀可視化元素的控件，還有一種是不具有外觀可視化元素的控件。如果需要開發(fā)的服務(wù)器控件包含可視化元素，那么多數(shù)情況下，建議開發(fā)人員創(chuàng)建繼承自System.Web.UI.WebControls.WebControl基類的控件類。這種做法的主要原因是基于便捷性考慮。因為，WebControl類可提供服務(wù)器控件的部分與外觀有關(guān)的公共屬性、方法和事件等。通過該類定義的屬性，可以控制服務(wù)器控件的外觀和行為。例如，使用BackColor和ForeColor屬性，可以分別控制服務(wù)器控件的背景色和前景顏色；在可以顯示邊框的控件上，可以通過設(shè)置BorderWidth、BorderStyle和BorderColor屬性，控制邊框?qū)挾?、邊框樣式和邊框顏色；服?wù)器控件的大小可以通過Height和Width屬性來指定等等。如果控件基類是Control類，那么實現(xiàn)這些類似內(nèi)容則非常繁瑣。

在使用WebControl基類實現(xiàn)ASP.NET服務(wù)器控件呈現(xiàn)的過程中，必然要使用該類所提供的屬性和方法等成員對象。這是讀者需要重點掌握的內(nèi)容。另外，對于該基類的構(gòu)造函數(shù)也是不容忽視的。下面首先從WebControl的構(gòu)造函數(shù)開始入手進(jìn)行講解，隨后將說明常見的成員對象。

WebControl類包括三個構(gòu)造函數(shù)，它們都用于初始化WebControl類的新實例，然而它們之間還存在一些細(xì)小的差異。

◆protected WebControl ()

該構(gòu)造函數(shù)用于初始化表示Span HTML元素的WebControl類的新實例。通常情況下，開發(fā)人員并不直接調(diào)用此構(gòu)造函數(shù)。相反，它通常由派生類的構(gòu)造函數(shù)調(diào)用以將TagKey屬性初始化為Span枚舉值。在隨后的示例中，將重寫TagKey屬性，從而調(diào)用此構(gòu)造函數(shù)。

◆public WebControl (HtmlTextWriterTag tag)

開發(fā)人員可使用此構(gòu)造函數(shù)創(chuàng)建并初始化使用指定的System.Web.UI.HtmlTextWriterTag值的WebControl類的新實例。其中的參數(shù)tag表示HtmlTextWriterTag枚舉值之一。可能讀者對于HtmlTextWriterTag還不太熟悉。它是一個枚舉類型，其枚舉值多為HTML標(biāo)記，例如，A、B、Bold、Button等等。

◆protected WebControl (string tag)

使用此構(gòu)造函數(shù)可創(chuàng)建并初始化使用指定的HTML標(biāo)記的WebControl類的新實例。其中參數(shù)tag表示HTML標(biāo)記。當(dāng)使用該構(gòu)造函數(shù)時一定要注意：不能直接調(diào)用此構(gòu)造函數(shù)。相反，它通常由派生類的構(gòu)造函數(shù)調(diào)用以初始化TagKey和TagName屬性。

在了解了WebControl類的構(gòu)造函數(shù)之后，讀者還必須了解WebControl類的一些常用屬性和方法。下面列舉了這些常用成員對象，它們對于實現(xiàn)ASP.NET服務(wù)器控件呈現(xiàn)有著重要意義。

（1）Attributes屬性

該屬性用于獲取與控件的屬性不對應(yīng)的任意特性（只用于呈現(xiàn)）的集合，其屬性類型為AttributeCollection。

（2）ControlStyle屬性

該屬性用于獲取服務(wù)器控件的樣式，它是Style類型。ControlStyle屬性封裝WebControl類的所有外觀屬性，如BorderColor和Font。

（3）TagKey屬性

該屬性用于獲取與此服務(wù)器控件相對應(yīng)的System.Web.UI.HtmlTextWriterTag值，其屬性類型為HtmlTextWriterTag枚舉。

（4）protected virtual void AddAttributeToRender(HtmlTextWriter writer);

該方法將需要呈現(xiàn)的HTML屬性和樣式添加到指定的System.Web.UI.HtmlTextWriter中。注意在重寫過程中，一定要調(diào)用基類中相應(yīng)的方法。

（5）public void ApplyStyle(Style s);

該方法將指定樣式的所有非空白元素復(fù)制到控件，改寫控件的所有現(xiàn)有的樣式元素。

（6）public void MergeStyle(Style s);

該方法將指定樣式的所有非空白元素復(fù)制到控件，但不改寫該控件現(xiàn)有的任何樣式元素。

（7）protected override void Render(HtmlTextWriter writer);方法

該方法重寫了Control.Render。

（8）protected virtual void RenderContents(HtmlTextWriter writer);

該方法將ASP.NET服務(wù)器控件的內(nèi)容呈現(xiàn)到指定的編寫器中。如果要在控件的標(biāo)簽中寫入文本或其他內(nèi)容，則需要重寫該方法；如果要使用默認(rèn)邏輯來呈現(xiàn)子控件，那么一定要調(diào)用基類中相應(yīng)的方法。

可能讀者已經(jīng)注意到WebControl基類中包括的兩個方法：Render和RenderContents。根據(jù)上文所介紹的內(nèi)容可知，Control基類中包括Render方法。由于WebControl類繼承自Control類，因此，WebControl類中包含Render方法是無可非議的。然而，WebControl類中卻有一個RenderContents方法，并且該方法與Render方法在功能、參數(shù)等方面都非常相似。那么在呈現(xiàn)控件過程中到底應(yīng)該使用哪一個呢？

實際上，在通常情況下，如果服務(wù)器控件自WebControl基類派生，那么其中的Render方法很少使用，而主要使用RenderContents方法實現(xiàn)控件呈現(xiàn)。為了說明其中的原因，我們必須了解WebControl基類中Render方法的實現(xiàn)邏輯。

在WebControl基類中的Render方法的實現(xiàn)示意性代碼如下所示：

protected override void Render(HtmlTextWriter output)  
{  
　RenderBeginTag(output);  
　RenderContents(output);  
　RenderEndTag(output);  
}  

在WebControl基類中的RenderBeginTag方法的實現(xiàn)示意性代碼如下：

public virtual void RenderBeginTag(HtmlTextWriter output)  
{  
　AddAttributesToRender(output);   
　HtmlTextWriterTag tagKey = TagKey;  
　if(tagKey != HtmlTextWriterTag.Unknown)  
　{  
output.RenderBeginTag(tagKey);   
　} else {  
output.RenderBeginTag(this.TagName);  
　}  
}  

在WebControl基類中的RenderContents方法的實現(xiàn)示意性代碼如下：

protected override void RenderContents(HtmlTextWriter output){   
　//使用默認(rèn)邏輯來呈現(xiàn)子控件，那么一定要調(diào)用基類中的方法。   
　base.Render(output);  
}  

分析以上代碼可以得出以下結(jié)論：

一、為了在由WebControl派生的類中實現(xiàn)控件呈現(xiàn)，必須重寫AddAttributesToRender、RenderBeginTag、RenderEndTag、RenderContents等方法中的一個或者多個，而不必重寫Render方法。

二、重寫AddAttributesToRender、RenderBeginTag、RenderEndTag、RenderContents等方法非常重要（請注意重寫這些方法的條件及注意事項），否則服務(wù)器控件可能會出現(xiàn)丟失標(biāo)簽的情況，這將嚴(yán)重影響服務(wù)器控件的呈現(xiàn)。

三、當(dāng)呈現(xiàn)ASP.NET服務(wù)器控件標(biāo)簽中的內(nèi)容時，必須重寫RenderContents方法。

上文介紹了WebControl類的一些基本知識。尤其是對于上文所列舉的示意性代碼需要重點理解。這對于實現(xiàn)控件呈現(xiàn)有著重要作用。

ASP.NET服務(wù)器控件之RenderContents的基本內(nèi)容將你介紹到這里，希望對你了解ASP.NET服務(wù)器控件之RenderContents有所幫助。

【編輯推薦】

1. ASP.NET服務(wù)器控件Render方法的使用淺析
2. ASP.NET服務(wù)器控件開發(fā)之實現(xiàn)事件淺析
3. ASP.NET服務(wù)器控件之處理回傳數(shù)據(jù)淺析
4. ASP.NET服務(wù)器控件之捕獲回傳事件淺析
5. ASP.NET控件開發(fā)基礎(chǔ)之事件處理淺析