asp.net控件开发基础(8)

上一篇写了复合控件基本的概念，这次就继续上次的话题，来学习复合控件如何触发事件  有一些复合控件直接把按钮触发事件所需的事情封装好，另外一种则是自定义事件，更具灵活性，当然这是根据需要设计的。以下会以例子来说明的.下面我们假设我们控件中有两个按钮.以下不列出所有代码,具体可在文章最后下载代码.

(1) 直接实现按钮事件

在控件中(以下代码并非实现复合控件)直接实现事件则无需自定义事件,如下代码(如果对数据回传有些不熟悉的话,可先看第三篇,希望对你有帮助)

示例一(只列出局部代码,具体可在文章最后下载代码)

void  IPostBackEventHandler.RaisePostBackEvent( string  eventArgument) {if (eventArgument == "Previous")PreviousText = "你点击了PreviousText按钮";else if (eventArgument == "Next")NextText = "你点击了NextText按钮";} protected   override   void  RenderContents(HtmlTextWriter writer) {writer.AddAttribute(HtmlTextWriterAttribute.Onclick, Page.GetPostBackEventReference(this, "Previous"));writer.RenderBeginTag(HtmlTextWriterTag.Button);writer.Write(this.PreviousText);writer.RenderEndTag();writer.AddAttribute(HtmlTextWriterAttribute.Onclick, Page.GetPostBackEventReference(this, "Next"));writer.RenderBeginTag(HtmlTextWriterTag.Button);writer.Write(this.NextText);writer.RenderEndTag();} 还记得 第三篇时示例一中下面的代码吗?此控件中只触发了一个事件,所以无需根据服务器传递的参数来判断出发哪个事件 // 实现RaisePostBackEvent方法,处理回发事件 public void RaisePostBackEvent( string eventArgument) {OnClick(EventArgs.Empty);}

RaisePostBackEvent方法有一个eventArgument参数用来传递事件数据.代码实现了一个空参数传递(eventArgument参数为空)的事件OnClick(EventArgs.Empty)

再比较一下示例一的代码,因为其用到了两个按钮

Page.GetPostBackEventReference方法用来传递参数

RaisePostBackEvent方法则以传递参数来判断触发哪个按钮

小结:

在控件中直接实现按钮事件,则无需定义自定义事件,但别忘了在RaisePostBackEvent方法中根据传递过来的不同参数来加以判断.

(2)以自定义事件实现

根据示例一上面的代码加上自定义委托和事件,如下代码(只列出局部代码,具体可在文章最后下载代码)

示例二

void  IPostBackEventHandler.RaisePostBackEvent( string  eventArgument) {if (eventArgument == "Previous")OnClickPrevious(EventArgs.Empty);else if (eventArgument == "Next")OnClickNext(EventArgs.Empty);}

调用代码如下

protected   void  NavButtons2_1_ClickPrevious( object  sender, EventArgs e) {Label1.Text = "你点击了PreviousText按钮";} protected   void  NavButtons2_1_ClickNext( object  sender, EventArgs e) {Label1.Text = "你点击了NextText按钮";}

小结:在示例一的基础上去除直接实现好的按钮事件,然后自定义事件.

再次提醒如果大家对回发事件,还请再参考一些文章先弄清楚,或者也可以看看我写的第三篇文章.

好了,上面讲的都非复合控件,但复合控件实现起来却很相似,或者可以说更加简单.

下面先来看个简单的示例(大家知道button按钮有CommandName属性和CommandArgument属性)

示例三

<% @ Page Language="C#"  %> <! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" > < script  runat ="server" > protected void Button1_Click(object sender, EventArgs e){Label1.Text = "你点击了左按钮";}protected void Button2_Click(object sender, EventArgs e){Label1.Text = "你点击了右按钮";}protected void btn_command(object sender, CommandEventArgs e){switch (e.CommandName){case "left":Label2.Text = "你点击了左按钮";break;case "right":Label2.Text = "你点击了右按钮";break;}}protected void btn2_command(object sender, CommandEventArgs e){switch (e.CommandName){case "left":Button1_Click(this, e);break;case "right":Button2_Click(this, e);break;}} </ script > < html  xmlns ="http://www.w3.org/1999/xhtml"   > < head  runat ="server" > < title > 无标题页 </ title > </ head > < body > < form  id ="form1"  runat ="server" > < div > < asp:Button  ID ="Button1"  runat ="server"  OnClick ="Button1_Click"  Text ="左按钮"   /> < asp:Button  ID ="Button2"  runat ="server"  Text ="右按钮"  OnClick ="Button2_Click"   />< br  /> < br  /> < asp:Label  ID ="Label1"  runat ="server" ></ asp:Label >< br  /> < br  /> < asp:Button  ID ="Button3"  runat ="server"  Text ="左按钮"  CommandName ="left"  OnCommand ="btn_command"   /> < asp:Button  ID ="Button4"  runat ="server" Text ="右按钮"  OnCommand ="btn_command"  CommandName ="right"   />< br  /> < br  /> < asp:Label  ID ="Label2"  runat ="server" ></ asp:Label >< br  /> < br  /> < asp:Button  ID ="Button5"  runat ="server"  Text ="左按钮"  CommandName ="left"  OnCommand ="btn2_command"   />< asp:Button  ID ="Button6"  runat ="server" Text ="右按钮"  OnCommand ="btn2_command"  CommandName ="right"   /></ div > </ form > </ body > </ html >

以上代码以三种方式来实现按钮的触发事件.这里本应该再举一个数据绑定控件如(DataList控件的使用)的一个例子的一个例子的,这里目的只为了说明冒泡法的使用,冒泡法在DataList等数据绑定控定控件中最能体现出来.

那我们先来看下,在复合控件中怎么做?1.直接实现按钮事件 2.以自定义事件实现

(1)以下为微软网站的示例代码,如下代码

示例四

namespace  CompositionSampleControls {public class Composition2 : Control, INamingContainer{public int Value{get{this.EnsureChildControls();return Int32.Parse(((TextBox)Controls[1]).Text);}set{this.EnsureChildControls();((TextBox)Controls[1]).Text = value.ToString();}}protected override void CreateChildControls(){// Add Literal Controlthis.Controls.Add(new LiteralControl("<h3>" + "Value: "));// Add TextboxTextBox box = new TextBox();box.Text = "0";this.Controls.Add(box);// Add Literal Controlthis.Controls.Add(new LiteralControl("</h3>"));// Add "Add" ButtonButton addButton = new Button();addButton.Text = "Add";addButton.Click += new EventHandler(this.AddBtn_Click);this.Controls.Add(addButton);// Add Literal Controlthis.Controls.Add(new LiteralControl(" | "));// Add "Subtract" ButtonButton subtractButton = new Button();subtractButton.Text = "Subtract";subtractButton.Click += new EventHandler(this.SubtractBtn_Click);this.Controls.Add(subtractButton);}private void AddBtn_Click(Object sender, EventArgs e){this.Value++;}private void SubtractBtn_Click(Object sender, EventArgs e){this.Value--;}}}

因为内部事件已经实现好了，所以比较简单，相信大家都看的懂。

再看复合控件的自定义事件,这里才是我们所要讲的重点.通常我们提倡在复合控件中采用冒泡法实现事件的上传,上一篇已经说过了,复合控件是一个树结构的控件,最典型的就是asp.net的数据邦定控件(特殊的复合控件)了如DataList,此控件有很多以Command结尾的事件,我们刚开始学这个控件的时候,总要考虑,如何在此控件中实现按钮事件,所采用的就是我们常说的"事件冒泡",当然还有另一种方法,应该说是普通的实现方法,asp.net服务器控件开发技术与示例称之为包含法,下面我们以例子来说明上面两种方法.

1.包含法

还是以微软的快速入门教程的代码为例.与上面的代码对比有几处变动,如下

注意粗体字,自定义事件为复合控件顶层的事件,而非其子控件button按钮的事件,button按钮的事件需调用顶层事件处理程序.即实现子控件事件上传的过程.

示例五

// 自定义事件 public   event  EventHandler Change; // 自定义事件处理程序 protected   void  OnChange(EventArgs e)  { Change(this, e); } // 子控件事件处理程序调用顶层事件处理程序,此处需注意 private   void  AddBtn_Click(Object sender, EventArgs e)  { this.Value++; OnChange(EventArgs.Empty); }  

 2.冒泡法上面已经介绍过了,并且MSDN也已经作出了详细的解释,控件可以将其定义的事件上传到控件顶层,在引发事件时处理事件,了解冒泡法,你需要了解以下两个方法

protected   virtual   bool  OnBubbleEvent(    object  source,   EventArgs args); protected   void  RaiseBubbleEvent(    object  source,   EventArgs args );

RaiseBubbleEvent不可重写,用于向上传递数据要引发冒泡事件，控件必重写 OnBubbleEvent 看OnBubbleEvent方法,看下面代码你需要先熟悉一下CommandEventArgs,其为Command事件提供了数据,通过其可以访问控件命令名称和参数,并根据不同参数和名称触发不同事件.其下代码为上一篇登录控件例子实现事件冒泡的方法,具体代码可在最后下载,且CreateChildControls方法中的触发事件的控件无须添加一个事件委托 

addButton.Click  +=   new  EventHandler( this .AddBtn_Click);

 

         protected   override   bool  OnBubbleEvent( object  source, EventArgs e)  {               bool handled = false;            if (e is CommandEventArgs) {                CommandEventArgs ce = (CommandEventArgs)e;                if (ce.CommandName == "Logon") {                    OnLogon(EventArgs.Empty);                    handled = true;                   }              }            return handled;                    }

你也可以为控件定义的事件定义事件冒泡,引发该时间则必须调用RaiseBubbleEvent,示例三就是具体的例子使用

protected   virtual   void  OnCommand(CommandEventArgs e)  {            CommandEventHandler handler = (CommandEventHandler)Events[EventCommand];            if (handler != null)                handler(this,e);            // The Command event is bubbled up the control hierarchy.            RaiseBubbleEvent(this, e);        } 本次讲的重点在于冒泡法的使用,但我却用很多篇幅介绍写前面的东西,主要目的是为了让大家用复合控件与非符合控件进行比较,总的来说复合控件为我们带来了便利,不用实现IPostBackEventHandler接口,简化了操作.如果大家熟悉事件回传机制,则不难了解冒泡法的使用.最后还是要注意一点的是 复合控件是一个树级的控件,即由子控件组成的一个控件,这次的例子很多都是直接取自书上和微软的教程上,只供大家参考吧. 好了,这次就写到这里,感觉这次写的并不是太好,望见谅,有错误请指出.