Atlas学习手记（3）：由UpdatePanel开始

UpdatePanel是Atlas中一个很重要的控件，功能强大且容易使用，可以使我们只做很小的改动就可以向已有的ASP.NET站点添加Ajax。采用Dflying的建议，我也是由UpdatePanel进入Atlas的世界。本文将通过可视化和代码两种方式来实现向已有的ASP.NET应用程序中添加UpdatePanel。

主要内容

1．UpdatePanel概述

2．使用可视化方式

3．使用代码方式

一．UpdatePanel概述

UpdatePanel是Atlas中一个很重要的控件，功能强大且容易使用，可以使我们只做很小的改动就可以向已有的ASP.NET站点添加Ajax。采用Dflying的建议，我也是由UpdatePanel进入Atlas的世界。本文将通过可视化和代码两种方式来实现向已有的ASP.NET应用程序中添加UpdatePanel。看一小段UpdatePanel的示例程序：

< Atlas:UpdatePanel  ID ="UpdatePanel1"  runat ="server"  Mode ="Always" >

     < Triggers >

         < Atlas:ControlEventTrigger  ControlID ="DropDownList1"  EventName ="SelectedIndexChanged"  />

     </ Triggers >

     < ContentTemplate >

        < asp:Label  ID ="Label1"  runat ="server"  Width ="164px"  Font-Bold ="True" ></ asp:Label >

     </ ContentTemplate >

</ Atlas:UpdatePanel >

我们需要注意的是：

1．UpdatePanel的更新方式有两种，即上面的Mode

更新方式	说明
Always	每次AJAX PostBack或是普通PostBack的时候都会更新该Panel的内容 Mode="Always"
Conditional	只有满足如下某一条件时才更新该Panel的内容： 当Panel中的某个控件引发了PostBack时 当Panel所指定的某个Trigger被引发时 当Panel的Update()方法在Codebehind中被调用时 Mode="Conditional"

2．Triggers元素指定了发生动作的事件源，UpdatePanel提供两种引发异步PostBack的Trigger：

Triggers	说明
ControlValueTrigger	当某个控件的某个指定的属性变化时更新。 <Atlas:ControlValueTrigger ControlID="DropDownList1" PropertyName="SelectedValue" />
ControlEventTrigger	当某个控件发出指定事件时更新。 <Atlas:ControlEventTrigger ControlID="DropDownList1" EventName="SelectedIndexChanged" />

3．ContentTemplate元素中指定了希望更新的部分，我们把需要动态更新的控件等都放在ContentTemplate中。下面我们将通过通过可视化和代码两种方式来看一下如何使用UpdatePanel。

二．使用可视化方式添加

1．新建Web Site项目，添加一个DropDownList和一个Label，并为DropDownList添加一些简单的Item：

< asp:DropDownList  ID ="DropDownList1"  runat ="server"  Width ="167px"  AutoPostBack ="True"  OnSelectedIndexChanged ="DropDownList1_SelectedIndexChanged" >

     < asp:ListItem > Nancy </ asp:ListItem >

     < asp:ListItem > Andrew </ asp:ListItem >

     < asp:ListItem > Janet </ asp:ListItem >

     < asp:ListItem > Margaret </ asp:ListItem >

</ asp:DropDownList >

设置DropDownList的AutoPostBack属性为True，在SelectedIndexChanged事件中添加如下代码：

protected  void  DropDownList1_SelectedIndexChanged( object  sender, EventArgs e)

{

    this.Label1.Text = "Selected : " + this.DropDownList1.SelectedValue;

}

2．运行程序，这是一个标准的ASP.NET应用程序，Label将根据DropDownList的选择不同显示不同的文本，但是这个页面是完全刷新的，在选择的时候，浏览器的状态栏将会显示一个进度条，如下图所示：

下面我们将通过可视化的方式为该应用程序添加上Atlas UpdatePanel。

3．托拽一个UpdatePanel控件到页面上，如何添加Atlas控件到工具箱请参考Add“Atlas”controls to the toolbox，这时将会自动添加Microsoft.Web.Atlas.dll到项目中。

4．添加ScriptManager到页面。

5．设置EnablePartialRendering属性为True。

6．拖拽Label控件到UpdatePanel中，并设置UpdatePanel的属性和Triggers。

至此，我们就通过可视化的方式完成了对UpdatePanel的添加，运行程序就会看到效果了。

三．使用代码方式添加

接上面的第二步，我们看看添加具体的代码。添加完Microsoft.Web.Atlas.dll的引用后，在页面中先添加：

<% @ Register Assembly="Microsoft.Web.Atlas" Namespace="Microsoft.Web.UI" TagPrefix="Atlas"  %>

添加ScriptManager控件，并设置EnablePartialRendering属性为true，这一点切记！关于ScriptManager的详细介绍可以参考Atlas学习手记（2）：全面了解ScriptManager。

< Atlas:ScriptManager  ID ="ScriptManager1"  runat ="server"  EnablePartialRendering ="true" >

</ Atlas:ScriptManager >

下面就该主角UpdatePanel登场了，在这里需要设置Triggers，Triggers指定了发生动作的事件源，也可以设置UpdatePanel的更新方式。

< Atlas:UpdatePanel  ID ="UpdatePanel1"  runat ="server" >

     < Triggers >

         < Atlas:ControlValueTrigger  ControlID ="DropDownList1"  PropertyName ="SelectedValue"  />

     </ Triggers >

     < ContentTemplate >

        < asp:Label  ID ="Label1"  runat ="server"  Width ="164px"  Font-Bold ="True" ></ asp:Label >

     </ ContentTemplate >

</ Atlas:UpdatePanel >

这里我们设置的是ControlValueTrigger，如果要设置ControlEventTrigger，代码如下：

< Atlas:UpdatePanel  ID ="UpdatePanel1"  runat ="server" >

     < Triggers >

         < Atlas:ControlEventTrigger  ControlID ="DropDownList1"  EventName ="SelectedIndexChanged"  />

     </ Triggers >

     < ContentTemplate >

        < asp:Label  ID ="Label1"  runat ="server"  Width ="164px"  Font-Bold ="True" ></ asp:Label >

     </ ContentTemplate >

</ Atlas:UpdatePanel >

到这儿所有的步骤都做完了，运行就可以体会到效果了。在这个过程中，我们并没有考虑任何的XMLHTTPRequest或者ActiveX对象，也没有编写任何的客户端脚本代码，这一切Atlas已经完全为我们做好了。