asp.NET自定义服务器控件内部细节系列教程四
如大家要转载,请保留本人的版权:
/*
*Description:asp.NET自定义服务器控件内部细节系列教程
*Auther:崇崇-天真的好蓝
*MSN:chongchong2008@msn.com
*Dates:2007-05-20
*Copyright:ChongChong2008 YiChang HuBei China
*/
四 服务器控件相关元数据Attribute
1.设计期Attribute
设计期Attribute对于控件在可视化设计器内正确运行是很重要的.设计器,属性浏览器和其它的设计期元素使用由设计期attribute提供的元数据的作用如下:
显示属性和事件
执行设计期的序列化
把用来实现设计期的功能的类与控件或者属性类型关联起来
1.1 显示属性和事件的Attribute
System.ComponentModel.BindableAttribute
描述 : 告知属性浏览器绑定数据到属性是否有意义,带有Bindable(true)标记的属性能显示在从属性浏览器中装载的DataBinding对话框里.
应用 : 只应用于属性
System.ComponentModel.BrowsableAttribute
描述 : 告知属性浏览器是否在属性浏览器中显示属性或者事件,属性浏览器默认显示所有公用属性和事件
应用 : 属性和事件
System.ComponentModel.CategoryAttribute
描述 : 提供一个分类名,以这个分类名来显示属性或事件.
应用 : 属性和事件
System.ComponentModel.DefaultEventAttribute
描述 : 告知属性浏览器哪一个控件事件是默认事件.允许页面开发者双击设计界面中的控件,为默认事件编写事件处理代码
应用 : 只应用事件
System.ComponentModel.DefaultPropertyAttribute
描述 : 告知属性浏览器哪一个控件属性是默认属性.允许页面开发者在计界面中选择控件时,该属性被属性浏览器突出显示
应用 : 只应用属性
System.ComponentModel.DescriptionAttribute
描述 : 提供一个简要的描述信息.在用户选择了属性或事件时,属性浏览器就显示这个描述
应用 : 属性和事件
System.ComponentModel.EditorBrowsableAttribute
描述 : 告知代码编辑器是否为属性,方法或事件显示对InterlliSense的支持
应用 : 属性,方法和事件
1.2 设计期的序列化的Attribute
System.ComponentModel.DefaultValueAttribute
描述 : 为属性提供一个默认值
应用 : 属性
System.ComponentModel.DesignerSerializationVisibilityAttribute
描述 : 告知设计器是否序列化属性或者属性的内容,复杂属性含有内容,如子属性或者集合项.DesignerSerializationVisibility具有以下几种值:
Content - 促使属性的内容(如子属性或者集合项)序列化
Hidden - 从序列化机制中隐藏属性
Visible - 序列化属性值
应用 : 属性
System.ComponentModel.NotifyParentPropertyAttribute
描述 : 告知属性浏览器从子属性到父属性或者到控件上传一个更改通知
应用 : 复杂属性和它们的子属性
System.Web.UI.PersistChildrenAttribute
描述 : 告知设计器嵌套在控件标签内的内容是否和子控或者属性对应.WebControl标记为PersistChildren(false)
应用 : 控件
System.Web.UI.PersistenceModeAttribute
描述 : 告知设计器是否把属性保存到控件的标签上,或者把它作为一个嵌套属性进行保存.
PersistenceMode枚举类型具有以下几个值:
Attribute - 使属性保存为控件标签上的一个attribute
EncodeInnerDefaultProperty - 使属性作为控件标签中仅有的内容进行保存.内容是编码的HTML
InnerProperty - 使属性作为控件标签中仅有的内容进行保存.
InnerDefaultProperty - 使属性和控件的任何其它属性一起保存为控件标签中嵌套的内容
应用 : 属性
System.Web.UI.TagPrefixAttribute
描述 : 告知设计器生成一个Register指令,把一个标签前缀映射到命名空间和配件中.当页面开发者把控件从工具箱拖放到设计界面时,这个指令就在.aspx页面冲生成
应用 : 包含服务器控件的配件
1.3 提供高级设计期功能的相关联类的Attribute
System.ComponentModel.DesignerAttribute
描述 : 把设计器与控件关联
应用 : 控件
System.ComponentModel.EditorAttribute
描述 : 把一个用户界面类型编辑器与类型或属性相关联,也把一个组件编辑器与控件相关联
应用 : 类或属性
System.ComponentModel.TypeConverterAttribute
描述 : 把一个类型转换器与类型或属性相关联
应用 : 类或属性
2.解析期Attribute
用于被页面解析器解析.aspx页面的语法,为相应页面中的类生成代码
System.Web.UI.ControlBuilderAttribute
描述 : 将控件与自定义的控件生成器相关联
应用 : 类或属性
System.Web.UI.ParseChildrenAttribute
描述 : 通知解析器是否把控件标签内的嵌套内容翻译为属性或者子控件。
Control没有标记这个属性,意味着解析器把嵌套内容当作子控件。
WebControl标记为ParseChildren(true),因此解析器把嵌套内容当作属性
这个Attribute的两参数形式中的第二个参数是属性名,使用两参数形式时,把控件标签内的嵌套内容必须和第二个参数设定的属性一致
应用 : 控件
System.Web.UI.TemplateContainerAttribute
描述 : 将ITemplate属性的容器控件的类型通知解析器。解析器把这个类型作为数据绑定表达式中的Container的确切类型
应用 : 雷行为ITemplate的属性