服务器控件如何自动加载回发数据

    技术2022-05-11  78

            以创建一个 TextBox 的服务器控件为例,我们继承 System.Web.UI.WebControls.WebControl,在重载的 Render  方法中编写将在客户端呈现的内容:

    protected   override   void  Render(HtmlTextWriter output) {         output.WriteLine("<input type = /"text/"  value = /"{0}/">",  this.Text);}

            但这样简单的代码实现的TextBox在页面刷新时无法保存在用户的输入,为了自动加载回发数据,这个控件需要实现IPostBackDataHandler接口(定义 ASP.NET 服务器控件为自动加载回发数据而必须实现的方法)。IPostBackDataHandler接口有两个需要实现的方法:LoadPostData 和 RaisePostDataChangedEvent 。

            bool LoadPostData (s tring postDataKey, N ameValueCollection postCollection) 为 ASP.NET 服务器控件处理回发数据,postDataKey为控件的主要标识符,即控件的 UniqueID,当页面回发时,如果自定义控件中有name为 UniqueID 的 html 控件,这个方法将会被调用。参数 postCollection 是一个名称值的集合,里面存放的是客户端 Html<input> 元素在回发之前的值,元素的name属性作为Key。因此,在 LoadPostData 方法中我们可以根据控件的name找到回发前的值并加载,从而恢复控件回发前的状态。

            LoadPostData方法的返回值是一个布尔值,如果返回 true 将会调用 RaisePostDataChangedEvent 方法,通知 ASP.NET 应用程序该控件的状态已更改,因此在 RaisePostDataChangedEvent  方法中,我们可以加入处理服务器控件值变化的事件,比如在 TextBox 中就可以定义一个 TextChanged 事件。 

    最后,一个 TextBox 控件就可以用如下代码实现:

          public   class  MyTextBox : System.Web.UI.WebControls.WebControl, IPostBackDataHandler     {        public string Text        {            get            {                return (string)this.ViewState["Text"];            }            set            {                this.ViewState["Text"= value;            }        }        public event EventHandler TextChanged;        public virtual bool LoadPostData(string postDataKey,           NameValueCollection postCollection)        {            string presentValue = Text;            string postedValue = postCollection[postDataKey];            if (presentValue == null || !presentValue.Equals(postedValue))            {                this.Text = postedValue;                return true;            }            return false;        }        public virtual void RaisePostDataChangedEvent()        {            this.OnTextChanged(EventArgs.Empty);        }        protected virtual void OnTextChanged(EventArgs e)        {            if (this.TextChanged != null)            {                this.TextChanged(this, e);            }        }        protected override void Render(HtmlTextWriter output)        {            output.WriteLine("<input type=/"text/" name=/"{0}/" value=/"{1}/"",                this.UniqueID, this.Text);        }    }

        充分利用这个机制,我们可以作出更加复杂的服务器控件,并且可以与JavaScript相结合,将使用JavaScript修改的值在回发时自动加载,从而实现操作更加简洁便利的服务器控件。

         有几点需注意:         1.  服务器控件写入客户端的Html中必须有一个<input>元素的name为服务器控件的UniqueID,否则将不会调用控件的 LoadPostData 方法;         2.  服务器控件所在页面中所有的 Html <input> 元素的值都可以在 LoadPostData 的 postCollection 参数中找到,Key 值是<input> 元素的 name 属性,因此在服务器控件中可以定义多个 <input> 元素存放多个值,只要知道 name 就可以取到值;         3.  RaisePostDataChangedEvent  方法中的事件在回发后触发,如果希望 AutoPostBack, 需实现 IPostBackEventHandler 接口,定义回发事件。

     


    最新回复(0)