首页 > OOP语言 > AJAX > 正文

在使用AjaxControlTookit的控件时响应事件
2013-01-12 00:00:00   来源:www.bianceng.cn   评论:0 点击:

暂时无描述信息

背景

在《分清ASP.NET AJAX中的Extender和Behavior模型》一文中,我谈到了使 用AjaxControlTookit中控件的关键是客户端的各Behavior组件。微软官方推出 的示例都太过于重视演示效果,而忽略了实际使用中的问题——市场需要吧,要 让技术看上去吸引人,这么做无可厚非。但是作为一个实际开发产品的程序员, 如果要灵活地使用AjaxControlTookit中的组件,则必须了解该如何在客户端操 作各Behvaior对象的各个成员(属性、方法和事件等)。

在《分》文中,我举了一个操作ModalPopupBehavir对象的例子,这样显示和 隐藏模态窗口的功能就局限于在服务器端ModalPopupExtender中指定的控件了。 但是在这篇文章中,我想着重讲述一下在客户端操作那些组件事件的一些方法和 技巧。因为,服务器端那些Extender对于客户端Behavior组件的事件支持并没有 我们期望得那么良好。

Extender组件对于Behavior属性的支持

为什么AjaxControlToolkit中的控件使用起来那么方便?因为我们有了那么 多的Extender。有了丰富的Extender控件,开发人员就可以在服务器端进行编程 ——例如设置各种属性,最终Extender会在页面中写入一些脚本用于创建客户端 的Behavior对象。例如如果我们要使用ModalPopupExtender,最简单的情况下我 们只需要在Extender中指定TargetControlID和PopupControlID就可以了,如下 :

<asp:Button ID="Button1" runat="server" Text="Button" />
<asp:Panel ID="Panel1" runat="server" Height="50px" 

Width="125px">
  Hello World!
</asp:Panel>
<ajaxToolkit:ModalPopupExtender runat="server" 

TargetControlID="Button1" PopupControlID="Panel1" />

一行多余的代码页不要写,Extender会自动在页面上引入所需的脚本文件, 并生成如下的客户端代码(格式有所改变):

Sys.Application.add_init(function()
{
  $create(
    AjaxControlToolkit.ModalPopupBehavior,
    {
      "PopupControlID":"Panel1",
      "dynamicServicePath" : "/Default.aspx",
      "id":"ctl02"
    },
    null,
    null,
    $get("Button1"));
});

于是,在客户端的init阶段就会创建客户端的对象(init阶段在 window.onload事件执行之后才会开始,因此如果页面上的资源需要大量时间才 能完成加载的话,用户会发现Behavior的效果会很晚才出现——不过我们先不关 心这个)。一般来说,页面上有多少个Extender,客户端就会出现多少个类似的 语句。在$create方法的第二个参数是一个在页面上用JSON表示的对象,这是需 要设置的Behavior对象的属性集合。例如在上面的例子中,ModalPopupBehavior 对象的PopupControlID属性会被设置为"Panel"。

有过AjaxControlToolkit中控件开发经验的朋友一定知道,会被输出到客户 端作为Behavior属性的那些Extender的属性都被标记了 ExtenderControlPropertyAttribute,例如在ModalPopupExtender中就有如下的 成员定义:

[ExtenderControlProperty]
public string PopupControlID
{
  get { ... }
  set { ... }
}

这样,AjaxControlToolkit中定义的基础类库就会把这个属性的值作为客户 端Behavior的值,并将其输出至客户端——控件开发人员和控件使用者双方皆大 欢喜。

有人说:我要响应事件

客户端的Behavior除了属性之外还有各种事件——例如CalendarBehavior的 shown事件,它会在日历被打开之后触发。利用事件我们就可以在合适的时候执 行特定的代码,获得丰富的功能。在服务器端标记属性然后输出至客户端早已众 人皆知,那么我们可以在服务器端指定客户端的事件吗?

以前不行,不过现在已经可以了。在上一个版本AjaxControlToolkit中新增 了和属性差不多的支持功能。现在AjaxControlToolkit中包含了一个 ExtenderControlEventAttribute类,它的作用就是在服务器端标记某个属性, 使它与某个客户端的事件对应。这样我们就可以在服务器端设置客户端某个事件 的响应方法,我们只需要保证那个方法存在并且逻辑正确即可。

例如,我们这次使用CaledarExtender作为示例:

<asp:TextBox ID="TextBox1" 

runat="server"></asp:TextBox>
<ajaxToolkit:CalendarExtender runat="server" 

TargetControlID="TextBox1"
  OnClientShown="onShownHandler"/>
<textarea id="TraceConsole" cols="50" 

rows="10"></textarea>
<script language="javascript" type="text/javascript">
  function onShownHandler(sender, args)
  {
    Sys.Debug.trace("Calendar shown.");
  }
</script>

目前我在服务器端的CalendarExtender中指定了OnClientShown属性,于是在 页面上就出现了如下的JavaScript代码:

Sys.Application.add_init(function()
{
  $create(
    AjaxControlToolkit.CalendarBehavior,
    {"id":"ctl02"},
    {"shown":onShownHandler},
    null,
    $get("TextBox1"));
});

$create方法的第三个参数是响应事件方法的集合,其中onShownHandler被作 为shown事件的响应方法。因此,在每次Calendar被展开之后onShownHandler方 法都会被执行,于是在页面上的TextArea中就会显示出“Calendar shown.”的 字样。

服务器端OnClientShown属性和客户端shown事件的映射关系是由 CalendarExtender中以下代码决定的:

[DefaultValue("")]
[ExtenderControlEvent]
[ClientPropertyName("shown")]
public virtual string OnClientShown
{
  get { ... }
  set { ... }
}

ExtenderControlEventAttribute标记表明该属性将会映射到客户端Behavior 的某个事件,而ClientPropertyNameAttribute标记则会接受一个参数,表明具 体是哪个事件(如果不标记的话,则使用和属性同名的事件)。

相关热词搜索:

上一篇:Ajax框架ZK 2.2发布
下一篇:ASP.NET MVC中使用ASP.NET AJAX异步访问WebService

分享到: 收藏