DOTNET类库里,服务器控件都继承自System.Web.UI.Controls.Control类,该类提供了Render, RenderChildren,RenderControl等3种方法实现控件呈现。这些方法都使用HtmlTextWriter的实例做为参数,它们允许为一个HtmlTextWriter对象提供服务器控件的内容,并将其内容封装至HTTP输出流中输出到客户端显示。
方法原型:
protected virtual void Render(HtmlTextWriter writer);
protected virtual void RenderChildren(HtmlTextWriter writer);
protected virtual void RenderControl(HtmlTextWriter writer);
实际上3个方法之间存在着密切的关系。下面的代码说明了3种方法之间的联系。
//RenderCotrol 方法的基本实现
public void RenderControl(HtmlTextWriter output)
{
if(Visible)
Render(output);
}
//Render 方法的基本实现
public void Render(HtmlTextWriter output)
{
RenderChildren(output);
}
//RenderChildren 方法的基本实现
public void RenderChildren(HtmlTextWriter output)
{
foreach(Control c in Controls)
c.RenderControl(output);
}
上面的代码说明了RenderControl、Render、RenderChildren方法的基本实现,同时也说明了空间呈现的大致逻辑。实际上,控件呈现是一个递归调用的过程,其过程为:
页面框架建立一个HtmlTextWriter类的实例;
页面框架将这个实例对象传递给RenderControl方法:
RenderControl方法检查控件的可视书香Visible是否为true,如果为true,RenderControl方法将调用Render方法;如果为false,则不呈现该控件和其子控件;
Render方法执行默认实现,调用RenderChildren方法;
RenderChildren方法按照默认实现中的设定调用每个子控件的RenderControl方法。
以上3种方法中最重要、最常用的是Render方法。空间开发者可以通过重写Render方法完成呈现控件的任务。存在两种方式将需要输出的内容封装入HTTP输出流中。
· 调用Write方法。这个方法将直接把需要输出的内容写入字符串中。
· 调用HtmlTextWriter类中提供的多种方法和相关枚举来组织需要输出的内容,而不是像Write方法那样直接编写标记文本。
二:一些属性
自定义服务器控件属性的特性:
Bindable
这个特性表示属性是否可以绑定一个有效数据源。通常使用布尔值进行设置。例如:Bindable(true)。如果使用值true标记属性,表示该属性可以绑定一个有效数据源,且应引发该属性的属性更改通知。
Browsable
指定属性是否应该在属性浏览器中显示,使用布尔值设置。通常情况下,功用属性和那些希望在属性浏览器中显示的属性被设置为 Browsable(true),只读属性和那些不希望在属性浏览器中见到的属性被设置为 Browsable(false)。
Category
指定属性在属性浏览器中进行分组显示的类别。该设计时特性帮助可视化编辑器将属性进行逻辑分组。通常分为:外观(Appearance)、行为(Behavior)、布局(Layout)、数据(Data)、操作(Action)、键盘(Key)和鼠标(Mouse)等。除此之外,还可以自定义分组类别。
Description
指定显示在属性浏览器下方,属性的文字说明。
DesignerSerializationVisibility
指定属性是否以及如何在代码中序列化,其值为DesignerSerializationVisibility的枚举值。存在3种设置方式:DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)指定序列化程序不应该序列化属性值;DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)指定应该允许序列化程序序列化属性的值;
DesignerSerializationVisibility(DesignerSerializationVisibility.Content)指定序列化程序应该序列化属性的内容,而不是属性本身。此字段为只读。.Visible为其默认值。
NotifyParentProperty
指示当此特性应用到的属性的值被修改时将通知其父属性。换言之,如果属性的父属性应该在该属性值改改时接到通知,则向该属性应用NotifyParentProperty特性。通常使用布尔值进行设置。
除了需要熟悉以上设计时特性外,还有一些常用的设计时特性,这些特性声明于包含属性的类之前。通常情况下,它们应用于包含子属性的复杂属性的类的声明过程中,因此在声明复杂属性过程中意义重大,列举如下:
ParseChildren
使用该特性指示当在页面上以声明方式使用控件时,嵌套在服务器控件标记内的XML元素是应该视为属性还是应视为子控件。通常情况下,包含两种声明方式:①ParseChildren(true)表示将子XML元素作为服务器控件的子控件分析;②ParseChildren(bool childrenasProperty, string defaultProperty),其中childrenasProperty和方式①中的布尔值参数意义相同,defaultProperty定义默认情况下将子控件分析为服务器控件的集合属性。
PersistChildren
该特性指示设计时是否应将服务器控件的子控件作为内部嵌套控件保持。如果该特性为PersistChildren(true),则将服务器控件的子控件作为嵌套服务器控件标记保持。如果为PersistChildren(false),则将该控件的属性作为嵌套元素保持。
PersistenceMode
指定如何将服务器控件属性或事件保持到ASP.NET页面的元数据属性。共存在4种枚举设置方式:①PersistenceMode(PersistenceMode.Attribute),指定属性或事件保持为特性;②PersistenceMode(PersistenceMode.EncodedInnerDefaultProperty),指定属性作为服务器控件的唯一内部文本而属性值是HTML编码的,只能对字符串作这种指定;③PersistenceMode(PersistenceMode.InnerDefaultProperty),指定属性在服务器控件中保持为内部文本,还指示将该属性定义为元素的默认属性,只能指定一个属性为默认属性;④PersistenceMode(PersistenceMode.InnerProperty),指定属性在服务器控件中保持为嵌套标记,这通常用于复杂对象,它们具有自己的持久性属性。
DefaultProperty
指定服务器控件的默认属性,例如[DefaultProperty("MyProperty")]。
TypeConverter
指定用做此特性所绑定到的对象的转换器的类型。用于转换的类必须从TypeConverter继承。使用ConverterTypeName属性来获取为该特性所绑定到的对象提供数据转换的类名
本文作者:网友 来源: http://hi.baidu.com/dpxdqx/blog/
CIO之家 www.ciozj.com 微信公众号:imciow