Go homepage(回首页) Upload pictures (上传图片) Write articles (发文字帖)
The author:(作者)delvpublished in(发表于) 2014/1/6 9:01:49 ASP.NET2.0服务器控件开发之简单属性_[Asp.Net教程]
1. 控件属性基本概念 本小节介绍有关创建服务器控件属性的基本内容,具体内容包括:(1)属性类型和形式;(2)从Control和WebControl继承的属性;(3)与属性相关的设计时元数据attribute。 1) 属性类型和形式 通常情况下,服务器控件属性可以分为两种类型:简单属性和复杂属性。 简单属性是指属性值可以很容易转换为字符串表达式的属性,这种属性的值通常为Boolean、Byte、Char、Double、Enum、Int32、DateTime等简单数值类型,以及String类型和枚举类型。开发人员可以通过添加代码,将简单属性存储在ViewState字典中,以在回发间进行状态管理。如果一个属性的类型是本身具有属性(称为子属性)的类,则该属性就称为复杂属性。例如,WebControl类的Font属性的类型是本身具有属性(如Bold和Name)的FontInfo类。Bold和Name是WebControl的Font属性的子属性。ASP.NET页框架可通过使用带有连字符的语法(例如Font-Bold="true")在控件的开始标记上保存子属性,但如果在控件的标记(例如<font Bold="true">)中保存子属性,则子属性在页中的可读性更强。 在上文中谈到了属性的标记形式,即添加连字符的形式。实际上,不同的属性表现出不同的标记形式。为了加深对简单属性和复杂属性的认识,下面介绍一下有关属性的4种标记形式。 · 通用形式属性 这是一种最为常见的属性标记形式。这种形式的属性标记位于控件内部,与runat="server"一起定义。通常为以下形式:
其中属性ListItem就是典型的内部嵌套形式默认属性。
2) 从Control和WebControl继承的属性 如前面文章所述,如果需要开发没有UI的控件或者组合其他呈现它们自己的UI的控件,则从System.Web.UI.Control基类派生。为此,读者应该了解一些Control类的常见属性。如表1列举了Control基类常用属性,它们在开发服务器控件过程中经常被使用。属性数据类型说明ControlsControlCollection获取 ControlCollection 对象,该对象表示 UI 层次结构中指定服务器控件的子控件AdapterControlAdapter获取控件的浏览器特定适配器。(asp.net 2.0新增)AppRelativeTemplateSourceDirectorystring获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。(asp.net 2.0新增)EnableThemingbool获取或设置一个值,该值指示是否对此控件应用主题。(asp.net 2.0新增)PagePage获取对包含服务器控件的 Page 实例的引用。ParentControl控件属于其Controls集合的控件。(如果控件B是A.Controls的一个元素,则控件A是控件B的父级)EnableViewStateBool 指示控件在往返过程中是否维护其视图状态。如果父控件不维护其视图状态,则自动不维护其子控件的视图状态 TemplateControl TemplateControl获取或设置对包含该控件的模板的引用。(asp.net 2.0新增)UniqueIDString页框架给控件分配的分层限定的唯一标识符ClientIDString 给控件分配的唯一标识符,该唯一标识符在客户端上呈现为HTML ID特性。ClientID与UniqueID是不同的,这是因为UniqueID可以包含冒号字符(:),而在HTML ID特性中该字符无效(并且不允许在客户端脚本的变量名中使用) 页框架 如前面文章所述,如果创建具有UI的自定义服务器控件,则应该从WebControl或System.Web.UI.WebControls中的任何控件派生,该命名空间为自定义控件提供适当的起点。同样的道理,读者应了解一些来自WebControl类的常见属性,它们可为控件自动继承。表2列举了这些属性。属性数据类型说明BackColorColor获取或设置Web服务器控件的背景色。BorderColorColor获取或设置Web控件的边框颜色。BorderStyleBorderStyle 获取或设置Web服务器控件的边框样式。BorderWidthUnit获取或设置Web服务器控件的边框宽度。ControlStyleStyle获取Web服务器控件的样式。CssClassString获取或设置由Web服务器控件在客户端呈现的级联样式表(CSS)类。EnabledBool获取或设置一个值,该值指示是否启用Web服务器控件。EnableThemingbool获取或设置一个值,该值指示是否对此控件应用主题。(asp.net 2.0新增)FontFontInfo 获取与Web服务器控件关联的字体属性。ForeColorColor获取或设置Web服务器控件的前景色(通常是文本颜色)。HeightUnit服务器控件高度WidthUnit 服务器控件宽度SkinIDstring获取或设置要应用于控件的外观。(asp.net 2.0新增) 3) 与属性相关的设计时元数据 创建服务器控件是为了提高应用开发效率,每个控件开发者都希望自己创建出的控件能够像.NET框架中的内置标准服务器控件那样功能强大且易于使用。例如,当控件应用者在设计界面点击控件时,可能会希望某些属性能够高亮显示,某些属性能够显示在属性浏览器中等等。如何才能使控件具有这样的功能呢?这就需要在代码中加入相关的设计时支持代码。 实际上,实现设计时元数据是一个比较复杂的内容。然而,作为初学者而言,我们没有必要掌握得过于深入,下面笔者只讲解一些常见的与属性相关的设计时元数据设置。如下所示代码,列举了一些与属性相关的设计时元数据设置和简要说明。 · Bindable 这个特性表示属性是否可以绑定一个有效数据源。通常使用布尔值进行设置,例如:Bindable(true)。如果使用值true标记属性,表示该属性可以绑定一个有效数据源,且应引发该属性的属性更改通知;如果属性值为false,则表示该属性不能绑定数据。 · Browsable 指定属性是否应该在属性浏览器中显示,使用布尔值设置。通常情况下,公用属性和那些希望在属性浏览器中显示的属性被设置为Browsable(true),只读属性和那些不希望在属性浏览器中见到的属性被设置为Browsable(false)。 · Category 指定属性在属性浏览器中进行分组显示的类别。该设计时特性帮助可视化编辑器将属性进行逻辑分组。通常分为:外观(Appearance)、行为(Behavior)、布局(Layout)、数据(Data)、操作(Action)、键盘(Key)、鼠标(Mouse)等。除此之外,读者还可以自定义分类,例如Category("ItemStyle"),表示该属性在属性浏览器中显示为ItemStyle一组。 · Description 指定显示在属性浏览器下方,属性的文字说明。例如:Description("this is a property")。以上内容是实现属性过程中最为常见的设计时元数据设置。无论对于简单属性,还是复杂属性都应该根据需要设置。 · DesignerSerializationVisibility 指定属性是否以及如何在代码中序列化,其值为DesignerSerializationVisibility的枚举值。存在三种设置方式: (1)DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),指定序列化程序不应该序列化属性的值; (2)DesignerSerializationVisibility(DesignerSerializationVisibility.Visible),指定应该允许序列化程序序列化属性的值; (3)DesignerSerializationVisibility(DesignerSerializationVisibility.Content),指定序列化程序应该序列化属性的内容,而不是属性本身。此字段为只读。需要注意的是:没有DesignerSerializationVisibility特性的成员将被视为具有值为DesignerSerializationVisibility.Visible的DesignerSerializationVisibility特性。如果可能,序列化程序会将标记为Visible的属性值序列化为该类型。 · NotifyParentProperty 指示当此特性应用到的属性的值被修改时将通知其父属性。换言之,如果属性的父属性应该在该属性值更改时接到通知,则向该属性应用NotifyParentProperty特性。通常使用布尔值进行设置。例如,Size属性具有两个嵌套的子属性:Width和Height。那么属性Width和Height就应标记为NotifyParentPropertyAttribute(true),以便当属性值更改时,它们可以通知父属性来更新其值并显示。 · ParseChildren 使用该特性指示当在页上以声明方式使用控件时,嵌套在服务器控件标记内的XML元素是应该视为属性还是应视为子控件。通常情况下,包含两种声明方式:(1)ParseChildren(true),表示将子XML元素作为服务器控件的属性分析,ParseChildren(false),表示将子XML元素作为服务器控件的子控件分析;(2)ParseChildren(bool childrenasProperty , string defaultProperty),其中childrenasPropety和方式1中的布尔值参数意义相同,defaultProperty定义默认情况下将子控件分析为的服务器控件的集合属性。 · 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")]。 · TypeConverter 指定用作此特性所绑定到的对象的转换器的类型。用于转换的类必须从TypeConverter继承。使用ConverterTypeName属性来获取为该特性所绑定到的对象提供数据转换的类名。
2. 简单属性实现方法 在前面的几篇文章中已经介绍了一些简单属性的实现方法。从中可以发现创建简单属性可以使用私有变量、视图状态和控件状态等。在此,笔者无意对这些内容进行重复。感兴趣的读者可参阅有关文章。本节仅对实现简单属性的过程进行总结,并通过一个实现简单枚举属性的示例加以说明。示例代码如下所示:
赞