自定义控件属性

时间:2022-05-13 20:37:10
Bindable
指定属性是否支持Data Binding

这个特性表示属性是否可以绑定一个有效数据源。通常使用布尔值进行设置。例如:BIndable(true)。如果使用值true标记属性,表示该属性可以绑定一个有效数据源,且应引发该属性的属性更改通知。
Browsable
控制属性或事件是否显示于属性表。
指定属性是否应该在属性浏览器中显示,使用布尔值设置。通常情况下,功用属性和那些希望在属性浏览器中显示的属性被设置为Browsable(true),只读属性和那些不希望在属性浏览器中见到的属性被设置为Browsab(false)。
Catagory
对于属性或是事件的分类,当属性表采用分类模式显示时,会以此Attribute作为分类的依据。
指定属性在属性浏览器中进行分组显示的类别。该设计特性帮助可视化编辑器将属性进行逻辑分组。通常分为:外观(Appearance)、行为(Behavior)、布局(Layout)、数据(Data)、操作(Action)、键盘(Key)和鼠标(Mouse)等。除此之外,还可以自定义分组类别。
Description
对于属性或是事件的描述,当使用者选取该属性或事件时,其会显示于属性表下方。指定显示在属性浏览器下方,属性的文字说明。
EditorBrowsable
控制属性或事件是否显示于IntelliSense视窗中。Never不显示。Always显示,Advanced仅显示于进阶使用者模式,进阶使用者模式可经由Tools|Options|TextEditor|C#中开启。
DesignerSeriallizationVisibility
指定属性是否以及如何在代码中序列化,其值为
DesignerSerializationVisibility的枚举值。存在3中设置方式:
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)指定序列化程序不应该序列化属性值;
DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)指定应该允许序列化程序序列化属性的值;
DesignerSerializationVisibility(DesignerSerializationVisibility.Content)指定序列化程序应该序列化属性的内容,而不是属性本身。此字段为只读。.Visible为其默认值。
NotifyParentPropert
指示当此特性应用到属性的值被修改时将通知其父属性。换言之,如果属性的父属性应该在该属性值更改时接到通知,则向该属性应用NotifyParentPropert热性。通常使用布尔值进行设置。
除了需要熟悉以上设计时特性外,还有一些常用的设计时特性,这些特性声明于包含属性的类之前。通常情况下,它们应用于包含子属性的复杂属性的类的声明过程中,因此在声明复杂属性过程中意义重大,列举如下:
ParseChildren
使用该特性指示当前在页面上以声明方式使用控件时,嵌套在服务器控件标记内的XML元素是应该视为属性还是应视为子控件。通常情况下,包含两种声明方式:
1、ParseChildren(true)表示将子XML元素作为服务器控件的子控件分析“
2、ParseChildren(bool childrenasProperty,string defaultProperty),其中childrenasProperty和方式1中的布尔值参数意义相同,defaProperty定义默认情况将子控件分析为服务器控件的集合属性。
PersistChildren
该特性指示设计时是否应将服务器控件的子控件作为内部嵌套控件保持。如果该特性为PersistChildren(true),则将服务器控件的子控件作为嵌套服务器控件标记保持。如果为PersistChildren(false),则将该控件的属性作为嵌套元素保持。
PersistenceMode
指定如何将服务器控件属性或事件保持到ASP.NET页面的元数据属性。共存在4种枚举设置方式:
1、PersistenceMode(PersistenceMode.Attribute),指定属性或事件保持为特性;
2、PersistenceMode(PersistenceMode.EncodedInnerDefaultProperty),指定属性作为服务器控件的唯一内部文本二属性值是HTML编码的,只能对字符串做这种指定;
3、PersistenceMode(PersistenceMode.InnerDefaultProperty),指定属性在服务器控件中保持为内部文本,还指示将该属性定义为元素的默认属性。
4、PersistenceMode(PersistenceMode.InnerProperty),指定属性在服务器控件中保持为嵌套标记,这通常用于复杂对象,它们具有自己的持久性属性。
DefaultProperty
指定服务器控件的默认属性,例如[DefaultProperty("MyProperty")]。
DefaultEvent
指定预设的事件,当使用者于元件/控件上双点滑鼠时,Editor会建立此事件函数。
ReadOnly
指定属性是否只读(true/false)。
TypeConverter
指定用做此特性所绑定到的对象的转换器的类型。用于转换的类必须从TypeConverter继承。使用ConvertTypeName属性来获取为该特性所绑定到的对象提供数据转换的类名。
比如:将控件的WITFieldName属性显示在“CSWIT”分组中,初始值为“”,描述为“控件对应数据库中字段的名称”
[Bindable(true),Catagory("CSWIT"),DefaultVlaue(""),Description("控件对应数据库总字段的名称。")]
public string WITFieldName
{
get
{
return strFieldName;
}
set
{
strFieldName=value;
}
}