ASP.NET AJAX入门系列（4）：使用UpdatePanel控件（一）

转自：http://www.cnblogs.com/Terrylee/archive/2006/10/29/543968.aspx 

UpdatePanel 可以用来创建丰富的局部更新Web应用程序，它是ASP.NET 2.0 AJAX Extensions中很重要的一个控件，其强大之处在于不用编写任何客户端脚本，只要在一个页面上添加几个UpdatePanel控件和一个ScriptManager控件就可以自动实现局部更新。通过本文来学习一下UpdatePanel简单的使用方法（第一篇）。

 

主要内容

1 ．UpdatePanel控件概述

2 ．UpdatePanel工作原理

3 ．ContentTemplate属性

4 ．ContentTemplateContainer属性

5 ．Triggers属性

 

一．UpdatePanel控件概述

UpdatePanel 可以用来创建丰富的局部更新Web应用程序，它是ASP.NET 2.0 AJAX Extensions中很重要的一个控件，其强大之处在于不用编写任何客户端脚本，只要在一个页面上添加几个UpdatePanel控件和一个ScriptManager控件就可以自动实现局部更新。通过本文来学习一下UpdatePanel工作原理和使用方法。简单的UpdatePanel定义如下：

< asp:UpdatePanel  ID ="UpdatePanel1"  runat ="server" >
     < ContentTemplate >

     </ ContentTemplate >
     < Triggers >
         < asp:AsyncPostBackTrigger  />
         < asp:PostBackTrigger  />
     </ Triggers >
</ asp:UpdatePanel >

UpdatePanel 重要的属性如下：

属性	说明
ChildrenAsTriggers	当UpdateMode属性为Conditional时，UpdatePanel中的子控件的异步回送是否会引发UpdatePanle的更新。
RenderMode	表示UpdatePanel最终呈现的HTML元素。Block（默认）表示<div>，Inline表示<span>
UpdateMode	表示UpdatePanel的更新模式，有两个选项：Always和Conditional。Always是不管有没有Trigger，其他控件都将更新该UpdatePanel，Conditional表示只有当前UpdatePanel的Trigger，或ChildrenAsTriggers属性为true时当前UpdatePanel中控件引发的异步回送或者整页回送，或是服务器端调用Update()方法才会引发更新该UpdatePanel。

 

二．UpdatePanel工作原理

UpdatePanel 的工作依赖于ScriptManager服务端控件（ASP.NET AJAX入门系列（2）：使用ScriptManager控件）和客户端PageRequestManager类（Sys.WebForms.PageRequestManager，在后面的客户端类中会专门说到），当ScriptManager中允许页面局部更新时，它会以异步的方式回传给服务器，与传统的整页回传方式不同的是只有包含在UpdatePanel中的页面部分会被更新，在从服务端返回HTML之后，PageRequestManager会通过操作DOM对象来替换需要更新的代码片段。

看一下官方网站提供的UpdatePanel工作原理图：

三．ContentTemplate属性

Contente Template 标签用来定义UpdatePanel的内容，在它里面可以放任何ASP.NET元素。如果你想要使用编程的手法来控制UpdatePanel中的内容，就需要使用ContenteTemplateContainer，下面会说到，先来看一个简单的ContentTemplate的例子。

< asp:UpdatePanel  ID ="UpdatePanel1"  runat ="server" >
     < ContentTemplate >
         < asp:Calendar  ID ="Calendar1"  ShowTitle ="True"  runat ="server"   />
         < div >
            Background:
             < br  />
             < asp:DropDownList  ID ="ColorList"  AutoPostBack ="True"  OnSelectedIndexChanged ="DropDownSelection_Change"
                runat ="server" >
                 < asp:ListItem  Selected ="True"  Value ="White" >  
                White  </ asp:ListItem >
                 < asp:ListItem  Value ="Silver" >  
                Silver  </ asp:ListItem >
                 < asp:ListItem  Value ="DarkGray" >  
                Dark Gray  </ asp:ListItem >
                 < asp:ListItem  Value ="Khaki" >  
                Khaki  </ asp:ListItem >
                 < asp:ListItem  Value ="DarkKhaki" >  D
                ark Khaki  </ asp:ListItem >
             </ asp:DropDownList >
         </ div >
     </ ContentTemplate >
</ asp:UpdatePanel >

事件代码:

< script  runat ="server" >
     void  DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor  =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }
</ script >

四．ContentTemplateContainer属性

如果要使用编程的手法去设置UpdatePanel中的内容，需要创建一个UpdatePanel，并且添加控件到ContentTemplateContainer，而不能直接添加控件到ContentTemplate，如果想直接设置ContentTemplate，则需要编写一个自定义的Template，并去实现位于System.Web.UI命名空间下的接口ITemplate。看一个简单的来自于官方网站的例子：

<% @ Page Language = " C# "   %>

< script  runat ="server" >
    protected  void  Page_Load(object sender, EventArgs e)
    {
        UpdatePanel up1  =   new  UpdatePanel();
        up1.ID  =   " UpdatePanel1 " ;
        up1.UpdateMode  =  UpdatePanelUpdateMode.Conditional;
        Button button1  =   new  Button();
        button1.ID  =   " Button1 " ;
        button1.Text  =   " Submit " ;
        button1.Click  +=   new  EventHandler(Button_Click);
        Label label1  =   new  Label();
        label1.ID  =   " Label1 " ;
        label1.Text  =   " A full page postback occurred. " ;
        up1.ContentTemplateContainer.Controls.Add(button1);
        up1.ContentTemplateContainer.Controls.Add(label1);
        Page.Form.Controls.Add(up1);
    }
    protected  void  Button_Click(object sender, EventArgs e)
    {
        ((Label)Page.FindControl( " Label1 " )).Text  =   " Panel refreshed at  "   +
            DateTime.Now.ToString();
    }
</ script >

< html  xmlns ="http://www.w3.org/1999/xhtml" >
< head  id ="Head1"  runat ="server" >
     < title > UpdatePanel Added Programmatically Example </ title >
</ head >
< body >
     < form  id ="form1"  runat ="server" >
         < div >
             < asp:ScriptManager  ID ="TheScriptManager"    runat ="server"   />
         </ div >
     </ form >
</ body >
</ html >

五．Triggers属性

在ASP.NET AJAX中有两种Triggers：分别为AsyncPostBackTrigger和PostBackTrigger，AsyncPostBackTrigge用来指定某个服务器端控件以及其将触发的服务器端事件作为该UpdatePanel的异步更新触发器，它需要设置的属性有控件ID和服务端控件的事件；PostBackTrigger用来指定在UpdatePanel中的某个服务端控件，它所引发的回送不使用异步回送，而仍然是传统的整页回送。这一点跟Atlas有很大的区别，大家需要注意。看一个小例子，虽然两个Button都放在了UpdatePanel中，但是由于在PostBackTrigger中指定了Button2，所以它使用的仍然是整页回送。

<% @ Page Language = " C# "  AutoEventWireup = " true "  CodeFile = " Default2.aspx.cs "  Inherits = " Default2 "   %>
< script  runat ="server" >
     void  Button1_Click(object sender, EventArgs e)
    {
         this .Label1.Text  =   " 更新时间： "   +  System.DateTime.Now.ToString();
    }

     void  Button2_Click(object sender, EventArgs e)
    {
         this .Label1.Text  =   " 更新时间： "   +  System.DateTime.Now.ToString();
    }
</ script >

< html  xmlns ="http://www.w3.org/1999/xhtml"   >
< head  runat ="server" >
     < title > UpdatePanel Trigger Sample </ title >
</ head >
< body >
     < form  id ="form1"  runat ="server" >
     < div >
         < asp:ScriptManager  ID ="ScriptManager1"  runat ="server" >
         </ asp:ScriptManager >
     </ div >
         < asp:UpdatePanel  ID ="UpdatePanel1"  runat ="server" >
             < ContentTemplate >
                 < div >
                     < asp:Button  ID ="Button1"  runat ="server"  Text ="异步回送"  OnClick ="Button1_Click" /> &nbsp;&nbsp;
                     < asp:Button  ID ="Button2"  runat ="server"  Text ="整页回送"  OnClick ="Button2_Click" />< br  />
                     < br  />
                     < asp:Label  ID ="Label1"  runat ="server"  Text ="当前时间"  Font-Bold ="True"  Font-Size ="Large" ></ asp:Label ></ div >
             </ ContentTemplate >
             < Triggers >
                 < asp:AsyncPostBackTrigger  ControlID ="Button1" />
                 < asp:PostBackTrigger  ControlID ="Button2"   />
             </ Triggers >
         </ asp:UpdatePanel >
     </ form >
</ body >
</ html >

 

示例代码下载：http://www.cnblogs.com/Files/Terrylee/ASPNETAJAXUpdatePanelDemo1