asp.net 自定义服务器控件标签属性说明

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属性来获取为该特性所绑定到的对象提供数据转换的类名。

 

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace MyCC
{
        //制定默认属性为Dir
        [DefaultProperty("Dir")]
        //置作为IDE工具箱的控件，被拖拉后自动生成的标签
        [ToolboxData("<{0}:MyCC runat=server></{0}:MyCC>")]
        //定义派生于WebControl类的MyCC类
        public class ServerControl1 : WebControl
        {
                //指定成员是否通常用于绑定.msdn解释
                [Bindable(true)]
                //指定当属性 (Property) 或事件显示在一个设置为“按分类顺序”模式的 PropertyGrid 控件中时，用于给属性或事件分组的类别的名称。
                [Category("Appearance")]
                //默认属性值
                [DefaultValue("")]
                //设置是否本地化
                [Localizable(true)]
                public string Text
                {
                        get
                        {
                                String s = (String)ViewState["Text"];
                                return ((s == null) ? "[" + this.ID + "]" : s);
                        }

                        set
                        {
                                ViewState["Text"] = value;
                        }
                }

                //重写RenderContents方法，该方法接受一个HtmlTextWriter参数
                protected override void RenderContents(HtmlTextWriter output)
                {
                        //将Text写入HTML输出流
                        output.Write(Text);
                }
        }
}

 

 

 

来自：http://visionsky.blog.51cto.com/733317/223230