一切福田,不離方寸,從心而覓,感無不通。

ASP.NET服务器控件开发(3)--事件和回传数据的处理

 

前两篇介绍了服务器控件的基本显示,属性的设定,继承Webcontrol开发控件等内容,这篇介绍下定制服务器控件的事件的处理和回传数据的处理。

ASP.NET页面处理回传到服务器端的表单时,两种信息会传递给页面中的控件:

回传事件,如Button一类控件触发的回传,会引发服务器端事件;

回传数据:是Web表单中包含的数据,该数据是在Web表单提交到服务器端时传递给如TextBox一类的控件。

处理回传数据

PostBack(回传):ASP.NET控件提交表单到服务器端,将信息从浏览器传递到服务器端的过程。

我们可能经常会在Page_Load事件中写这样的代码:

复制代码

protectedvoid Page_Load(object sender, EventArgs e)
        {
if (!IsPostBack)
            {
.
            }
        }

复制代码

但是初学的时候我们很少回去问,为什么要写这段代码,只知道这么写就是对的。其实这就是数据回传的一个表现,通过该值指示该页是否正为响应客户端回发而加载。

ASP.ENT服务器控件处理回传数据,基本上完成以下两个工作:

-->继承并实现IPostBackDataHandler接口的 

-->实现RaisePostDataChangedEvent方法,处理回发数据

通过例子说明一下,这里创建一个自己的文本框:创建一个ASP.NET服务器控件项目(MyTextBox)


namespace NewTextBox
{
    [DefaultProperty(
"Text")]
    [ToolboxData(
"<{0}:NewTextBox runat=server></{0}:NewTextBox>")]
publicclass NewTextBox : WebControl, IPostBackDataHandler
    {
publicevent EventHandler TextChanged;

publicstring ViewText//定义显示文字属性
        {
get
            {
if (ViewState["Text"].Equals(null))
                {
return String.Empty;
                }
else
                {
return ViewState["Text"].ToString();
                }
            }
set
            {
                ViewState[
"Text"= value;
            }
        }

protectedoverride HtmlTextWriterTag TagKey//向页面中添加文本框
        {
get
            {
return HtmlTextWriterTag.Input;
            }
        }

protectedoverridevoid AddAttributesToRender(HtmlTextWriter writer)
        {
            writer.AddAttribute(HtmlTextWriterAttribute.Type, 
"text");
            writer.AddAttribute(HtmlTextWriterAttribute.Value, ViewText);
            writer.AddAttribute(HtmlTextWriterAttribute.Name, 
this.UniqueID);

base.AddAttributesToRender(writer);
        }

publicbool LoadPostData(string postDataKey, System.Collections.Specialized.NameValueCollection postCollection)//表单域的值和控件的ViewText(此示例中)属性的当前值不匹配,那么将新的值赋给ViewText属性,并且返回True。只有当LoadPostData返回True的时候,才会调用RaisePostDataChangedEvent方法。

        {
if (postCollection[postDataKey] != ViewText)
            {
                ViewText 
= postCollection[postDataKey];
returntrue;
            }
returnfalse;
        }

publicvoid RaisePostDataChangedEvent()
        {
if (TextChanged !=null)
                TextChanged(
this, EventArgs.Empty);
        }

    }
}

测试一下:

protectedvoid Button1_Click(object sender, EventArgs e)
        {
            Label1.Text 
= NewTextBox1.ViewText;
        }

只有当文本框中是文字发生变化是,才会引起数据的回发并从新获得数据。(控件拖到页面时,要给viewText赋值)

 

处理回发事件

ASP.NET服务器控件处理回发事件,基本上需要完成以下两个工作:

-->继承并实现IPostBackEventHandler接口的 

-->实现RaisePostBackEvent方法,处理回发事件

Button控件继承IPostBackEventHandler接口(所有的按钮控件,ImageButton,LinkButtton都继承了这个接口)。IPostBackEventHandler接口专门定义了处理回发事件的方法,如果自定义控件需要处理回发事件,你就需要继承IPostBackEventHandler接口。

通过例子说明一下,这里我们定制一个自己的按钮:创建一个ASP.NET服务器控件项目(MyButton)


namespace MyButton
{
    [DefaultProperty(
"Text")]
    [ToolboxData(
"<{0}:MyButton runat=server></{0}:MyButton>")]
publicclass MyButton : WebControl, IPostBackEventHandler
    {
privatestaticreadonlyobject ClickKey =newobject();

publicevent EventHandler Click //定义事件的委托
        {
            add
            {
                Events.AddHandler(ClickKey, value);
            }
            remove
            {
                Events.RemoveHandler(ClickKey, value);
            }
        }

protectedvirtualvoid OnClick(EventArgs e)//定义单击事件的处理程序
        {
            EventHandler clickEventDelegate 
= (EventHandler)Events[ClickKey];

if (clickEventDelegate !=null)
            {
                clickEventDelegate(
this, e);
            }
        }

publicvoid RaisePostBackEvent(string eventArgument)//处理回发事件
        {
            OnClick(
new EventArgs());
        }

protectedoverridevoid RenderContents(HtmlTextWriter output)
        {
            output.Write(
"<INPUT TYPE=submit name="+this.UniqueID +
" Value='这是自己定制的按钮!' />");
        }
    }
}

测试一下:

protectedvoid MyButton1_Click(object sender, EventArgs e)
        {
            Label1.Text 
="Hello World!!!!!!!!!";
        }

按钮的事件回发处理成功。

客户端回发事件

在asp.net2.0中,Button 控件多了一个UseSubmitBehavior 属性,指示 Button 控件使用客户端浏览器的提交机制(客户端回发)还是 ASP.NET 回发机制,默认采用ASP.NET回发机制,如果设置为false的话,则需要调用GetPostBackEventReference 方法来返回 Button 的客户端回发事件。

当设置UseSubmitBehavior 属性为flase时,运行页面时,则会发现一段自动生成的javascript代码(查看源文件)


<script type="text/javascript">
//<![CDATA[
var theForm = document.forms['form1'];
if (!theForm) {
    theForm 
= document.form1;
}
function __doPostBack(eventTarget, eventArgument) {
if (!theForm.onsubmit || (theForm.onsubmit() !=false)) {
        theForm.__EVENTTARGET.value 
= eventTarget;
        theForm.__EVENTARGUMENT.value 
= eventArgument;
        theForm.submit();
    }
}
//]]>
</script>

这里我们创建一个按钮,根据属性的设定,更改其事件回发的方式:


namespace MyLinkButton
{
    [DefaultProperty(
"Text")]
    [ToolboxData(
"<{0}:MyLinkButton runat=server></{0}:MyLinkButton>")]
publicclass MyLinkButton : WebControl, IPostBackEventHandler
    {
publicvirtual ButtonDisplay Display
        {
get
            {
object display = ViewState["Display"];
if (display ==null)
return ButtonDisplay.Button;
else
return (ButtonDisplay)display;
            }
set
            {
                ViewState[
"Display"= value;
            }
        }

publicvirtualstring Text
        {
get
            {
object text = ViewState["Text"];
if (text ==null)
returnstring.Empty;
else
return (string)text;
            }
set
            {
                ViewState[
"Text"= value;
            }
        }

privatestaticreadonlyobject ClickKey =newobject();

publicevent EventHandler Click//定义委托
        {
            add
            {
                Events.AddHandler(ClickKey, value);
            }
            remove
            {
                Events.RemoveHandler(ClickKey, value);
            }
        }

protectedvirtualvoid OnClick(EventArgs e)//定义Click事件处理函数
        {
            EventHandler clickEventDelegate 
=
               (EventHandler)Events[ClickKey];
if (clickEventDelegate !=null)
            {
                clickEventDelegate(
this, e);
            }
        }

publicvoid RaisePostBackEvent(string argument)
        {

            OnClick(EventArgs.Empty);
        }

overrideprotectedvoid Render(HtmlTextWriter writer)
        {
base.Render(writer);
            Page.VerifyRenderingInServerForm(
this);

if (Display == ButtonDisplay.Button)
            {
                writer.Write(
"<INPUT type=\"submit\"");
                writer.Write(
" name=\"" + this.UniqueID + "\"");
                writer.Write(
" id=\"" + this.UniqueID + "\"");
                writer.Write(
" value=\"" + Text + "\"");
                writer.Write(
" />");
            }
elseif (Display == ButtonDisplay.Hyperlink)
            {
                writer.Write(
"<A href=\"");
                writer.Write(Page.ClientScript.GetPostBackClientHyperlink(this""));
                writer.Write(
"\">" + Text + "</A>");
            }
        }

publicenum ButtonDisplay
        {
            Button 
=0,
            Hyperlink 
=1
        }

    }

}

根据属性Display的属性的设置,对事件的回发进行控制,如果是Hyperlink则是客户端回发机制。

 

小结:新手在对事件的回发上可能会迷糊,但是不要紧,慢慢的理解。简单的理解事件的回发就是我们点击一个按钮发生的事件,而这个事件的处理ASP.NET给我们提供了两种方式。更多ASP.NET服务器控件事件可以参考:

http://msdn.microsoft.com/zh-cn/library/cc437696(VS.71).aspx

http://msdn.microsoft.com/zh-cn/library/xax2hw3x.aspx

写的不好,希望能对新手有帮助。

转自:http://www.cnblogs.com/gaoweipeng/archive/2009/06/19/1506243.html