写自定义控件已经好久了,也有几个用得时间比较长的,但是对于“事件”一直是比较模糊,没有很详细的理解。
最近升级分页控件,由于原来使用的是(在里面添加一个事件是比较容易的),现在想改用C#,而原来的方法又写得比较笨拙,想换一个更简洁一点的方法,所以不得不重新认识一下事件。看了几遍《道不远人深入解析2.0控件开发》居然没有看懂,可能是自己太笨了吧。又找到了自定义分页控件开发看了几遍,还是比较迷糊,最后把《自定义分页控件开发》里提供的代码down下来看了一下,终于有点明白了。
先举一个简单的例子吧,我们建立一个复合控件,在CreateChildControls()里面添加两个控件,一个是Label,一个是LinkButton。我们的目的是要给自定义控件加一个事件,以便可以控制Label的Text属性。
1、内部事件。这个好像是我起的名称,就是只在自定义控件的内部相应的事件,使用控件的页面不用相应相关的事件。具体一点就是要在自定义控件内部,在单击LinkButton的时候修改Label的值。 publicclassEventTest:WebControl,INamingContainer
{
protectedoverridevoidCreateChildControls()
{
Labellbl=newLabel();
lbl.ID="lbl";
this.Controls.Add(lbl);
this.Controls.Add(newLiteralControl("<BR>"));
LinkButtonbtn=newLinkButton();
btn.ID="btn";
btn.Text="复合控件的事件测试";
this.Controls.Add(btn);
}
}
编写好这段代码,然后把控件拖拽到页面里面里进行测试,运行后点击LinkButton,我们可以看到页面已经提交了,但是什么变化也没有,恩,我们还没有些事件呢。现在我们就给LinkButton加一个Click的事件。
protectedoverridevoidCreateChildControls()
{
Labellbl=newLabel();
lbl.ID="lbl";
this.Controls.Add(lbl);
this.Controls.Add(newLiteralControl("<BR>"));
LinkButtonbtn=newLinkButton();
btn.ID="btn";
btn.Text="复合控件的事件测试";
this.Controls.Add(btn);
//给按钮添加内部事件
btn.Click+=newEventHandler(btn_Click);
}
voidbtn_Click(objectsender,EventArgse)
{
Labellbl=(Label)this.FindControl("lbl");
lbl.Text+="控件内部的事件,hi";
}
再次运行网页,单击,我们看到了想要的效果。
怎么样简单吧,但是这种方法很不灵活,如果调用控件的网页也想相应事件怎么办呢?
2、外部事件。这回我们要让自定义控件的外部也能相应事件。这个理论上我们要使用委托,也就是delegate,但是系统已经为我们定义好了一个(EventHandler),我们先用现成的。
这样我们就给自定义控件定义了一个事件,重新编译,我们可以在控件的属性里面看到这个事件。(如果您没有看到,说明没有刷新,可能需要把IDE关闭,再次打开)。
publiceventEventHandlermyClick
{
add{
Events.AddHandler(this,value);
}
remove{
Events.RemoveHandler(this,value);
}
}
我们可以添加外部的响应事件了,双击,我们加上几行代码。
在使用控件的网页里填写的代码 protectedvoidEventTest1_myClick(objectsender,EventArgse)
{
Labellbl=(Label)EventTest1.FindControl("lbl");
lbl.Text+="外部的事件,Hello";
}
运行,奇怪还是原来的样子,外部事件并没有相应,不是加了一个事件吗?外面的事件怎么没有被调用呢?这是因为,事件先触发自定义控件内部的事件,然后再由控件内部发出“命令”,调用外部的事件,那么我们怎样才能发出这个命令呢?我们需要要添加这个函数。这个也是最让我费解的地方,可能是对委托不是很了解的原因吧。
protectedvoidTestClick(objectsender,EventArgse)
{
EventHandlerhd=(EventHandler)base.Events[this];
if(hd!=null)
{
hd(sender,e);
}
}
在修改一下 btn_Click() 就可以了。 voidbtn_Click(objectsender,EventArgse)
{
Labellbl=(Label)this.FindControl("lbl");
lbl.Text+="控件内部的事件,hi";
//调用外部事件
TestClick(sender,e);
}
再次运行,OK。
(实现了内部和外部的事件相应,但是这时候我们还没有实现传说中的接口,这是为什么呢?)
3、“借用”事件,没有成功。
我们再给自定义控件加上几个<a>标签,让<a>也可以提交表单(就是触发事件),填写如下代码。
protectedoverridevoidCreateChildControls()
{
//省略。。。
this.Controls.Add(newLiteralControl("<BR><aid=\"aa\"href=\"javascript:__doPostBack('EventTest1$btn','')\">aa</a>"));
}
运行OK。然后我们修改一下:__doPostBack的第二个参数,
<aid=\"aa\"href=\"javascript:__doPostBack('EventTest1$btn','1')\">aa</a>")
奇怪,再次运行的时候出现了异常,看来不让这么做呀。
依赖别人是不行了,必须要实现自定义控件自己的事件了。我们请来 IPostBackEventHandler 帮忙。同时<a>的href修改成
this.Controls.Add(newLiteralControl("<BR><aid=\"a1\"href=\"javascript:__doPostBack('"+this.ClientID+"','1')\">[1]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a2\"href=\"javascript:__doPostBack('"+this.ClientID+"','2')\">[2]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a3\"href=\"javascript:__doPostBack('"+this.ClientID+"','3')\">[3]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a4\"href=\"javascript:__doPostBack('"+this.ClientID+"','4')\">[4]</a>"));
在实现 RaisePostBackEvent 函数
publicvoidRaisePostBackEvent(stringIndex)
{
Labellbl=(Label)this.FindControl("lbl");
lbl.Text+="自己的事件:"+Index;
}
再次运行,OK。同时我们也得到了<a>传递过来的数字(页号)。
还有一个IPostBackDataHandler接口,由于暂时没不需要,所以没有研究,等用到的时候在研究。
----------------------------------------------------------------------
vartheForm=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();
}
}
如果您打开IE的“查看源文件”,会看到这个js函数,这是怎么来的呢?这个是button的事件带来的,虽然后面的代码并不需要button了,但是我比较懒,不想自己输出这个js函数,所以还是保留了button的事件。
好像还是说的不太清楚。自定义控件的事件已经整理清楚了,我可以修改分页控件里的代码了,原来写的比较混乱。分页控件的下一个版本(v2.0.0.3)将增加两个事件,这样就可以向吴旗娃的分页控件那样灵活使用了。
附完整代码:
namespaceJYK.Controls.Page
{
[DefaultProperty("Text")]
[ToolboxData("<{0}:EventTestrunat=server></{0}:EventTest>")]
publicclassEventTest:WebControl,INamingContainer,IPostBackEventHandler
{
publiceventEventHandlermyClick
{
add
{
Events.AddHandler(this,value);
}
remove
{
Events.RemoveHandler(this,value);
}
}
protectedvoidTestClick(objectsender,EventArgse)
{
EventHandlerhd=(EventHandler)base.Events[this];
if(hd!=null)
{
hd(sender,e);
}
}
publicvoidRaisePostBackEvent(stringIndex)
{
Labellbl=(Label)this.FindControl("lbl");
lbl.Text+="自己的事件:"+Index;
}
protectedoverridevoidCreateChildControls()
{
Labellbl=newLabel();
lbl.ID="lbl";
this.Controls.Add(lbl);
this.Controls.Add(newLiteralControl("<BR>"));
LinkButtonbtn=newLinkButton();
btn.ID="btn";
btn.Text="复合控件的事件测试";
this.Controls.Add(btn);
//给按钮添加内部事件
btn.Click+=newEventHandler(btn_Click);
this.Controls.Add(newLiteralControl("<BR><aid=\"aa\"href=\"javascript:__doPostBack('EventTest1$btn','')\">aa</a>"));
this.Controls.Add(newLiteralControl("<BR><aid=\"a1\"href=\"javascript:__doPostBack('"+this.ClientID+"','1')\">[1]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a2\"href=\"javascript:__doPostBack('"+this.ClientID+"','2')\">[2]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a3\"href=\"javascript:__doPostBack('"+this.ClientID+"','3')\">[3]</a>"));
this.Controls.Add(newLiteralControl(" <aid=\"a4\"href=\"javascript:__doPostBack('"+this.ClientID+"','4')\">[4]</a>"));
}
/**////控件内部的事件,由现有的控件的事件触发
voidbtn_Click(objectsender,EventArgse)
{
Labellbl=(Label)this.FindControl("lbl");
lbl.Text+="控件内部的事件,hi";
//调用外部事件
TestClick(sender,e);
}
protectedoverridevoidRender(HtmlTextWriteroutput)
{
if((base.Site!=null)&&base.Site.DesignMode)
{
output.Write("<divstyle='TEXT-ALIGN:center;width:100%'>事件测试</div>");
}
else
{
//Page_Click();
//output.Write("<divid='"+this.ClientID+"Page'style='TEXT-ALIGN:center;width:90%'>");
base.Render(output);
//output.Write("</div>");
}
}
}
}