自定义控件最好的例子

在学习了自己定义控件后,总结了一些关键点.

下面的是一个比较实在的好例子.

 using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Web.UI; using System.Drawing; using System.ComponentModel; using System.Web.UI.WebControls; namespace 控件库.test2 { public class Class4 : Control { [Bindable(true)] [Category("Appearance")] [DefaultValue(typeof(Color),"")] [Description("the backgroup color")] [TypeConverter(typeof(WebColorConverter))] public Color BackColor { get { object oo = ViewState["oo"]; return((oo == null) ? Color.Empty : (Color)oo); } set { ViewState["oo"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(typeof(Color), "")] [Description("the border color")] [TypeConverter(typeof(WebColorConverter))] public Color BorderColor { get { object oo = ViewState["BorderColor"]; return ((oo == null) ? Color.Empty : (Color)oo); } set { ViewState["BorderColor"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(BorderStyle.NotSet)] [Description("the border style")] [TypeConverter(typeof(WebColorConverter))] public BorderStyle BorderStyle { get { object oo = ViewState["BorderStyle"]; return ((oo == null) ? BorderStyle.None : (BorderStyle)oo); } set { ViewState["BorderStyle"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(typeof(Unit),"")] [Description("the border style")] public Unit BorderWidth { get { object oo = ViewState["BorderWidth"]; return ((oo == null) ? Unit.Empty : (Unit)oo); } set { ViewState["BorderWidth"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue( "")] [Description("the text to display on the button")] public string ButtonText { get { string oo = (string)ViewState["ButtonText"]; return ((oo == null) ? string.Empty : oo); } set { ViewState["ButtonText"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue("")] [Description("the font")] public string FontFamily { get { string oo = (string)ViewState["FontFamily"]; return ((oo == null) ? string.Empty : oo); } set { ViewState["FontFamily"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(typeof(FontUnit))] [Description("the size of font")] public FontUnit FontSize { get { object oo = ViewState["FontSize"]; return ((oo == null) ? FontUnit.Empty : (FontUnit)oo); } set { ViewState["FontSize"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(false)] [Description("the weight of font")] public bool FontBold { get { object oo = ViewState["FontBold"]; return ((oo == null) ? false : (bool)oo); } set { ViewState["FontBold"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(false)] [Description("the label for the name text")] public string NameLabel { get { string oo = (string)ViewState["NameLabel"]; return ((oo == null) ? string.Empty : (string)oo); } set { ViewState["NameLabel"] = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue(false)] [Description("the label for the password text")] public string PassWordLabel { get { string oo = (string)ViewState["PassWordLabel"]; return ((oo == null) ? string.Empty : (string)oo); } set { ViewState["PassWordLabel"] = value; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string ButtonID { get { return this.ClientID + "_Button"; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string ButtonName { get { return this.UniqueID + ":Button"; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string PassWordInputID { get { return this.ClientID + "_PassWord"; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string PassWordInputName { get { return this.UniqueID + ":PassWord"; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string UserNameInputID { get { return this.ClientID + "_UserNane"; } } [Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)] public string UserNameInputName { get { return this.UniqueID + ":UserName"; } } protected override void Render(HtmlTextWriter writer) { writer.AddAttribute(HtmlTextWriterAttribute.Cellspacing,"1"); if (!BackColor.IsEmpty) { writer.AddStyleAttribute(HtmlTextWriterStyle.BackgroundColor, ColorTranslator.ToHtml(BackColor)); } if (!BorderColor.IsEmpty) { writer.AddStyleAttribute(HtmlTextWriterStyle.BorderColor, ColorTranslator.ToHtml(BorderColor)); } if (BorderStyle!= BorderStyle.None && BorderStyle!= BorderStyle.NotSet) { writer.AddStyleAttribute(HtmlTextWriterStyle.BorderStyle, BorderStyle.ToString()); } if (!BorderWidth.IsEmpty) { writer.AddStyleAttribute(HtmlTextWriterStyle.BorderWidth, BorderWidth.ToString()); } if (FontFamily != string.Empty) { writer.AddStyleAttribute(HtmlTextWriterStyle.FontFamily, FontFamily); } if (!FontSize.IsEmpty) { writer.AddStyleAttribute(HtmlTextWriterStyle.FontSize, FontSize.ToString()); } if (!FontBold == true) { writer.AddStyleAttribute(HtmlTextWriterStyle.FontWeight,"FontBold"); } writer.AddAttribute(HtmlTextWriterAttribute.Id, this.ClientID); writer.RenderBeginTag(HtmlTextWriterTag.Table); writer.RenderBeginTag(HtmlTextWriterTag.Tr); writer.RenderBeginTag(HtmlTextWriterTag.Td); if (NameLabel != string.Empty) { writer.Write(NameLabel); } writer.RenderEndTag(); writer.RenderBeginTag(HtmlTextWriterTag.Td); writer.AddAttribute(HtmlTextWriterAttribute.Type, "text"); writer.AddAttribute(HtmlTextWriterAttribute.Name, UserNameInputName); writer.AddAttribute(HtmlTextWriterAttribute.Id, UserNameInputID); writer.AddAttribute(HtmlTextWriterAttribute.Value, string.Empty); writer.RenderBeginTag(HtmlTextWriterTag.Input); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderBeginTag(HtmlTextWriterTag.Tr); writer.RenderBeginTag(HtmlTextWriterTag.Td); if (PassWordLabel != string.Empty) { writer.Write(PassWordLabel); } writer.RenderEndTag(); writer.RenderBeginTag(HtmlTextWriterTag.Td); writer.AddAttribute(HtmlTextWriterAttribute.Type, "Password"); writer.AddAttribute(HtmlTextWriterAttribute.Name, PassWordInputName); writer.AddAttribute(HtmlTextWriterAttribute.Id, PassWordInputID); writer.AddAttribute(HtmlTextWriterAttribute.Value,string.Empty); writer.RenderBeginTag(HtmlTextWriterTag.Input); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderBeginTag(HtmlTextWriterTag.Tr); writer.AddAttribute(HtmlTextWriterAttribute.Colspan, "2"); writer.AddAttribute(HtmlTextWriterAttribute.Align, "right"); writer.RenderBeginTag(HtmlTextWriterTag.Td); writer.AddAttribute(HtmlTextWriterAttribute.Type, "submit"); writer.AddAttribute(HtmlTextWriterAttribute.Name, ButtonName); writer.AddAttribute(HtmlTextWriterAttribute.Id, ButtonID); writer.AddAttribute(HtmlTextWriterAttribute.Value, ButtonText); writer.RenderBeginTag(HtmlTextWriterTag.Input); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderEndTag(); writer.RenderEndTag(); } } }

给自定义的控件属性加上枚举值.

Page本身也是一个控件,继承自Control类,它是控件树的根.为了生成控件树,页面将建立一个HtmlTextWrite类实例.

在这个实例中封装了响应流,接着页面将主个HtmlTextWrite对象传递给RenderControl方法。RenderControl方法检查控件的visible属性是否为真。如果为真。RenderControl调用Render方法。Render方法的默认实现会调用RenderChildren方法。RenderChildren方法默认调用每个子控件的RenderControl方法，通过这种递归调用的方法就可以生成控件树。除了visible属性为假的控件。控件树中所有控件都会自动最终生成。

 

Control基类定义了三种Rendering方法。

1.Render(HtmlTextWriter writer)

2.RenderChildren(HtmlTextWriter writer)

3.RenderControl(HtmlTextWriter writer)

 

HtmlTextWrite的各种方法的参数取值为以下三种枚举类型：

1.HtmlTextWriteTag        2.HtmlTextWriteAttribute         3.HtmlTextWriteStyle

 

 

返回客户端时显示为Div标签功能（重载DIV属性）

Protected override HtmlTextWriteTag TagKey

{

        return HtmlTextWriteTag.Div;

}