WEBTIMER控件研究的心得:丢开书本做一个WebTimer

先说说几个教训:
1,小心命名,别跟系统已经存在的命名起冲突,比如,我一时疏忽将控件的命名空间设成Control,编译通过后,运行总是不通过,查了半天,才发现这个小问题,再比如,NAMEspace别和类名相同,否则,写起来很是不方便
下面是WEBTIMER的全部代码加了注解的

using System;
using System.Web.UI;
using System.Text;
using System.Web;
using System.Data;
using System.ComponentModel;

namespace MyControl
{
    /**//// <summary>
    /// WebTimer 的摘要说明。
    /// </summary>
    ///Designer属性指定一个类作为设计时类,该类必须派生于ControlDesigner类，并且实现GetDesignHtml方法
    ///Designer性性是System.ComponentModel空间的类
    ///WebTimer继承了IPostBackEventHandler是因为任何要利用POSTBACK机制来进行事件处理的控件都必须
    ///继承该接口并实现RaisePostbackEvent方法
    [Designer(typeof(MyControl.WebTimerDesigner))]
    public class WebTimer:System.Web.UI.Control,System.Web.UI.IPostBackEventHandler
    {
        成员变量定义#region 成员变量定义
            private int _interval=5000;//计时器种子数
            private bool _enable=true;//是否允许此计时器
            private static  object TimerKey=new object();//TimerKey是做什么用的呢,它是用来做Events的KEY对象的,而且它是静态的,所以,对于类的所有实例,将只耗费一个变量的代价
        #endregion

        属性定义#region 属性定义
        [Browsable(true),Bindable(true),DefaultValue(5000),Description("计时器使用的种子数")]
        public int Interval
        {
            set{_interval=value;}
            get{return(_interval);}
        }

        [Browsable(true),Bindable(true),DefaultValue(true),Description("是否允许计时器")]
        public bool Enable
        {
            get{return _enable;}
            set{_enable=true;}
        }

        [Browsable(true),Bindable(true),DefaultValue(true),Description("是否输出控件")]
        public override bool Visible
        {
            get
            {return base.Visible;}
            set
            {base.Visible = value;}
        }

        #endregion

        事件定义#region 事件定义
        public event EventHandler Timer
        {
            add {Events.AddHandler(TimerKey,value);}
            remove{Events.RemoveHandler(TimerKey,value);}
        }
        #endregion

        方法定义#region 方法定义
        /**//// <summary>
        /// 这个私有方法是用来在引发POSTBACK事件后,调用事件处理的关键,它再调用相应的事件处理程序
        /// </summary>
        private  void ProcessTimer(string eventArgument)
        {
            EventHandler TimerHandler=(EventHandler)Events[TimerKey];
            if(TimerHandler!=null)
                TimerHandler(this,EventArgs.Empty);
        }

        private string BuildJavascript()
        {
            StringBuilder JsBuilder=new StringBuilder();
            JsBuilder.AppendFormat("<script language='javascript'>setTimeout(\"{0}\",{1});</script>",new object[]{Page.GetPostBackEventReference(this),Interval});
            return(JsBuilder.ToString());
        }

        #endregion

        IPostBackEventHandler 成员#region IPostBackEventHandler 成员
        /**//// <summary>
        /// 每个要使用POSTBACK机制并且想在POSTBACK后进行适当处理的控件
        /// 必须实现IPostBackEventHandler的RaisePostBackEvent方法
        /// 并在此方法中调用或间接调用事件处理程序
        /// </summary>
        /// <param name="eventArgument"></param>
        public void RaisePostBackEvent(string eventArgument)
        {
            // TODO:  添加 WebTimer.RaisePostBackEvent 实现
            ProcessTimer("");
        }
        #endregion

        OnRender方法用来输出HTML#region OnRender方法用来输出HTML
        protected override void Render(HtmlTextWriter writer)
        {
            if(Page!=null)
                Page.VerifyRenderingInServerForm(this);
            if(_enable)
                writer.Write(BuildJavascript());
        }

        #endregion

        OnPreRender方法用来产生HTML#region OnPreRender方法用来产生HTML
        protected override void OnPreRender(EventArgs e)
        {
            base.OnPreRender (e);
            Page.GetPostBackEventReference(this,"");
            //发现这一句可以不加,如果见了的话呢,DOPOSTBACK将会被绘制在前面,否则,绘制在后面
        }
        #endregion
        
    }
}

相应的Designer

using System;
using System.Web.UI;
using System.Web.UI.Design;
using System.Text;
namespace MyControl
{
    /**//// <summary>
    /// WebTimerDesigner 的摘要说明。
    /// </summary>
    public class WebTimerDesigner:System.Web.UI.Design.ControlDesigner
    {
        public override string GetDesignTimeHtml()
        {
            StringBuilder HtmlBuilder=new StringBuilder();
            Control TimerControl=(Control)this.Component;
            if(TimerControl is MyControl.WebTimer)
            {
                HtmlBuilder.AppendFormat("<span id=\"{0}\" style=\"border:1px solid #666666;font-size:9pt;font-weight:bold\" >{1}</span>",new object[]{TimerControl.ClientID,"WebTimer"});
            }
            return(HtmlBuilder.ToString());
        }        
    }
}

调用页面的HTML

<%@ Page language="c#" Codebehind="WebForm1.aspx.cs" AutoEventWireup="false" Inherits="TimerDemo.WebForm1" %>
<%@ Register TagPrefix="cc1" Namespace="MyControl" Assembly="MyControl.WebTimer" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" >
<HTML>
    <HEAD>
        <title>WebForm1</title>
        <meta name="GENERATOR" Content="Microsoft Visual Studio .NET 7.1">
        <meta name="CODE_LANGUAGE" Content="C#">
        <meta name="vs_defaultClientScript" content="JavaScript">
        <meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5">
    </HEAD>
    <body MS_POSITIONING="GridLayout">
        <form id="Form1" method="post" runat="server">
                <cc1:WebTimer id="WebTimer1" runat="server"></cc1:WebTimer>
        </form>
    </body>
</HTML>

相应的代码

using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;

namespace TimerDemo
{
    /**//// <summary>
    /// WebForm1 的摘要说明。
    /// </summary>
    public class WebForm1 : System.Web.UI.Page
    {
        protected MyControl.WebTimer WebTimer1;
    
        private void Page_Load(object sender, System.EventArgs e)
        {
            // 在此处放置用户代码以初始化页面
        }

        Web 窗体设计器生成的代码#region Web 窗体设计器生成的代码
        override protected void OnInit(EventArgs e)
        {
            //
            // CODEGEN: 该调用是 ASP.NET Web 窗体设计器所必需的。
            //
            InitializeComponent();
            base.OnInit(e);
        }
        
        /**//// <summary>
        /// 设计器支持所需的方法 - 不要使用代码编辑器修改
        /// 此方法的内容。
        /// </summary>
        private void InitializeComponent()
        {    
            this.WebTimer1.Timer += new System.EventHandler(this.WebTimer1_Timer);
            this.Load += new System.EventHandler(this.Page_Load);

        }
        #endregion

        private void WebTimer1_Timer(object sender, System.EventArgs e)
        {
            Response.Write(DateTime.Now);
        }
    }
}