服务器控件属性的设计时特性.doc

服务器控件属性的设计时特性 Bindable 指定属性是否可以绑定一个数据源,通常使用布尔值进行设置.Bindable(true)表示该属性可以绑定一个有效数据源. Browsable 指定属性是否应该在属性窗口中显示,使用布尔值设置. EditorBrowsable 设置属性在编辑器中的可见性,比如设置在智能提示列表不显示或高级用户才可以看到该属性. CateGory 指定属性在浏览器中进行分组显示的类别,该设计时特性帮助可视化编辑器将属性进行逻辑分组,通常分为:外观(Appearance)、行为(Behavior)、布局(Layout)、数据(Data)、操作(Action)、键盘(Key)和鼠标(Mouse)等. Description 设置显示在属性窗口最下面的描述属性功能的文字说明. DesignOnly 如果此属性设置为true,表示该属性只能在设计期间使用,不能再页面代码中设置其值. ReadOnly 设置该属性是否为只读状态,如果此特性设置为true,则在属性窗口能看到属性,但不能设置其值,另外,通过属性语句体中set语句段去掉也可以起到相同的效果 Themeable 设置该属性是否支持主题特性,默认情况下属性都支持主题.当该主题与界面无关时可以设置其值为false,禁用该属性的主题功能. DesignerSerializationVisibility 指定属性是否以及如何在代码中序列化,其值为DesignerSerializationVisibility的枚举值,存在3种设置方式: DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)指定序列化程不应该序列化属性值; DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)指定应该允许序列化程序序列化属性的值; DesignerSerializationVisibility(DesignerSerializationVisibility.Content)指定序列化程序应该序列化属性的内容,而不是属性本身, 此字段为只读,Visible为其默认值. 这里说的序列化是指在IDE中的设计器界面切换到代码视图时,看到的代码的标记,或者反向切换时把代码标记转化到设计器界面. NotifyParentProperty 指示当设计特新应用到的属性的值被修改时将通知其父属性.如果属性的父属性应该在该属性值被修改是接到通知,则向该属性应用NotifyParentProperty特性.通常用布尔值进行设置.一般用于复杂属性,通知转换器更新到父级标记. ParseChildren 使用该设计特性指示当在页面上以声明方式使用控件时,嵌套在服务器控件标记内的XML元素是应该视为属性还是应视为子控件.通常情况下,包含两种声明方式: ParseChildren(true)表示将子XML元素作为服务器控件的属性分析; ParseChildren(bool childrenasProperty, string defaultProperty),其中childrenProperty和上面的方式中的布尔值参数意义相同,defaultProperty定义默认情况下将子控件分析为服务器控件的集合属性. PersistChildren 该设计特性指示设计时是否将服务器的子控件作为内部嵌套控件保持,如果该特性为PersistChildren(true),将服务器控件的子控件作为嵌套服务器控件标记保持,如果为PersistChildren(false),则将该控件的属性作为嵌套元素保持. PersistenceMode 指定如何将服务器控件属性或事件保持到ASP.NET页面的元数据属性,共存在4中枚举设置方式: PersistenceMode(PersistenceMode.Attribute)指定属性或事件保持为属性; PersistenceMode(PersistenceMode.EncodedInnerProperty)指定属性作为服务器控件的唯一内部文本,如果属性值是HTML编码的,字符串做这种指定; PersistenceMode(PersistenceMode.InnerDefaultProperty)指定属性在服务器控件中保持为内部文本,还指示将该属性定义为元素的默认属性,只能指定一个属性为默认属性; PersistenceMode(PersistenceMode.InnerProperty)指定属性在服务器控件中保持为嵌套标记,通常用于复杂对象,它们具有自己的持久性属性. DefaultValue 指定属性的