asp.net2.0 控件开发（学习笔记之五）

ASP.NET2.0服务器控件之Render方法

实现服务器控件呈现主要有两种方式：一是Control类的Render方法，二是WebControl的RenderContents方法。

一、使用HtmlTextWriter类

·AddAttribute方法

对于HtmlTextWriter对象通过对RenderBeginTag方法的后续调用创建的元素，向其开始标记中添加指定的标记属性和值。

·AddStyleAttribute方法

对于 HtmlTextWriter 对象通过对 RenderBeginTag 方法的后续调用创建的元素，向其开始标记中添加标记样式属性。

·Write方法

将指定数据类型连同任何挂起的制表符间距一起写入到输出流。

·WriteAttribute方法

将标记属性及其值写入到输出流。

·WriteBeginTag方法

　　任何制表符间距和指定标记元素的开始标记写入到输出流。

　　·WriteEndTag方法

　　写入指定的标记元素的任何制表符间距和结束标记。

　　·Encoding属性

　　获取 HtmlTextWriter 对象用于将内容写入页的编码。

　　·Indent属性

　　获取或设置用以缩进每一行标记的开始位置的制表符位置数。

　　·NewLine属性

　　获取或设置由 HtmlTextWriter 对象使用的行结束符字符串。

　　对于初学者而言，建议重点掌握以上成员对象的应用。另外，ASP.NET 2.0还为HtmlTextWriter类新增了一些成员，这些成员包括：

　　·BeginRender方法

　　通知 HtmlTextWriter 对象或派生类的对象，某个控件将会呈现。

　　·EndRender方法

　　通知 HtmlTextWriter 对象或某个派生类的对象，某控件已完成呈现。

　　·IsValidFormAttribute方法

　　检查一个属性以确保它可以在 ＜form＞ 标记元素的开始标记中呈现。

　　·WriteEncodedUrl方法

　　对指定的 URL 进行编码，然后将它写入到输出流。URL 可以包括参数。

　　·WriteEncodedText方法

　　对请求的设备的指定文本进行编码，然后将其写入到输出流。

　　·WriteBreak方法

　　将 ＜br /＞ 标记元素写入到输出流。

二、Control类中包括三个用于实现控件呈现的方法

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

　　该方法用于将服务器控件内容发送到提供的HtmlTextWriter对象，此对象编写将在客户端呈现的内容。在开发服务器控件时，可以重写此方法以呈现服务器控件。

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

　　该方法用于将服务器控件子级的内容输出到提供的HtmlTextWriter对象，此对象编写将在客户端呈现的内容。该方法通知ASP.NET呈现页中的所有Active Server Pages代码。如果页上没有任何ASP代码，此方法将呈现服务器控件的所有子控件。

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

　　RenderControl有两个重载方法，它们都用于将服务器控件的内容输出到所提供的HtmlTextWriter对象中。如果已启用跟踪功能，则存储有关控件的跟踪信息。如果服务器控件的Visible属性设置为true，该方法将确定是否启用页的跟踪功能。如果启用，它将存储与控件有关的跟踪信息，同时向页呈现服务器控件的内容。另外，前一个重载方式是ASP.NET 2.0从ASP.NET 1.0中继承而言，后一个重载方式是ASP.NET 2.0新增的。后者具体使用提供的ControlAdapter对象将服务器控件内容输出到提供的HtmlTextWriter对象。其中参数adapter是ControlAdapter类型，它用于定义呈现的ControlAdapter。当实现在各种设备和浏览器中运行的服务器控件时，该方法比较常用。

以上3个方法看起来好像是独立的3个方法，然而，实际上它们之间存在密切的联系。例如：

//RenderCotrol方法基本实现

public void RenderControl(HtmlTextWriter output)

{

　if(Visible)

　{

　　Render(output);

　}

}

//Render方法基本实现

protected virtual void Render(HtmlTextWriter output)

{

　RenderChildren(output);

}

//RenderChildren方法基本实现

protected virtual void RenderChildren(HtmlTextWriter output)

{

　foreach(Control c in Controls)

　{

　　c.RenderControl(output);

　}

}

如上代码所示，其中列举了RenderControl、Render、RenderChildren方法的实现思路。显而易见的是，在控件呈现过程中，这三个方法都在起着作用，而且使用了一个简单的递归调用过程。大体而言，可以理解为：

　　（1）页面框架建立一个HtmlTextWriter类的实例；

　　（2）页面框架将这个实例对象传递给RenderControl方法；

　　（3）RenderControl方法检查控件的可视属性Visible是否为true。如果为true，RenderControl方法将调用Render方法；如果为false，则不呈现该控件和其子控件；

　　（4）Render方法执行默认实现，调用RenderChildren方法；

　　（5）RenderChildren方法按照默认实现中的设定调用每个子控件的RenderControl方法；

　　实际上，如果读者短时间内不能理解以上过程也没有很大的关系。对于初学者而言，关键是要记住最重要、最常用的是Render方法。控件开发者可以通过重写Render方法完成呈现控件的任务。

参考：http://dev.yesky.com/msdn/228/2411728_1.shtml