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属性来获取为该 特性所绑定到的对象提供数据转换的类名。
这个特性表示属性是否可以绑定一个有效数据源。通常使用布尔值进行设置。例 如: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属性来获取为该 特性所绑定到的对象提供数据转换的类名。