ASP.NET AJAX入门系列(4):使用UpdatePanel控件(一)
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定义如下:重要的属性如下:
<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工作原理图:
<shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="[email protected]@[email protected]@[email protected]@[email protected]@5xe" filled="f" stroked="f"><stroke joinstyle="miter"></stroke><formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></formulas><path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></path><lock v:ext="edit" aspectratio="t"></lock></shapetype>
三.ContentTemplate属性
Contente Template标签用来定义UpdatePanel的内容,在它里面可以放任何ASP.NET元素。如果你想要使用编程的手法来控制UpdatePanel中的内容,就需要使用ContenteTemplateContainer,下面会说到,先来看一个简单的ContentTemplate的例子。四.ContentTemplateContainer属性
<ContentTemplate>
<asp:CalendarID="Calendar1"ShowTitle="True"runat="server"/>
<div>
Background:
<br/>
<asp:DropDownListID="ColorList"AutoPostBack="True"OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItemSelected="True"Value="White">
White</asp:ListItem>
<asp:ListItemValue="Silver">
Silver</asp:ListItem>
<asp:ListItemValue="DarkGray">
DarkGray</asp:ListItem>
<asp:ListItemValue="Khaki">
Khaki</asp:ListItem>
<asp:ListItemValue="DarkKhaki">D
arkKhaki</asp:ListItem>
</asp:DropDownList>
</div>
</ContentTemplate>
</asp:UpdatePanel>
事件代码:
voidDropDownSelection_Change(Objectsender,EventArgse)
{
Calendar1.DayStyle.BackColor=
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
</script>
如果要使用编程的手法去设置UpdatePanel中的内容,需要创建一个UpdatePanel,并且添加控件到ContentTemplateContainer,而不能直接添加控件到ContentTemplate,如果想直接设置ContentTemplate,则需要编写一个自定义的Template,并去实现位于System.Web.UI命名空间下的接口ITemplate。看一个简单的来自于官方网站的例子:
<scriptrunat="server">
protectedvoidPage_Load(objectsender,EventArgse)
{
UpdatePanelup1=newUpdatePanel();
up1.ID="UpdatePanel1";
up1.UpdateMode=UpdatePanelUpdateMode.Conditional;
Buttonbutton1=newButton();
button1.ID="Button1";
button1.Text="Submit";
button1.Click+=newEventHandler(Button_Click);
Labellabel1=newLabel();
label1.ID="Label1";
label1.Text="Afullpagepostbackoccurred.";
up1.ContentTemplateContainer.Controls.Add(button1);
up1.ContentTemplateContainer.Controls.Add(label1);
Page.Form.Controls.Add(up1);
}
protectedvoidButton_Click(objectsender,EventArgse)
{
((Label)Page.FindControl("Label1")).Text="Panelrefreshedat"+
DateTime.Now.ToString();
}
</script>
<htmlxmlns="http://www.w3.org/1999/xhtml">
<headid="Head1"runat="server">
<title>UpdatePanelAddedProgrammaticallyExample</title>
</head>
<body>
<formid="form1"runat="server">
<div>
<asp:ScriptManagerID="TheScriptManager"
runat="server"/>
</div>
</form>
</body>
</html>
五.Triggers属性
在ASP.NET AJAX中有两种Triggers:分别为AsyncPostBackTrigger和PostBackTrigger,AsyncPostBackTrigge用来指定某个服务器端控件以及其将触发的服务器端事件作为该UpdatePanel的异步更新触发器,它需要设置的属性有控件ID和服务端控件的事件;PostBackTrigger用来指定在UpdatePanel中的某个服务端控件,它所引发的回送不使用异步回送,而仍然是传统的整页回送。这一点跟Atlas有很大的区别,大家需要注意。看一个小例子,虽然两个Button都放在了UpdatePanel中,但是由于在PostBackTrigger中指定了Button2,所以它使用的仍然是整页回送。
<scriptrunat="server">
voidButton1_Click(objectsender,EventArgse)
{
this.Label1.Text="更新时间:"+System.DateTime.Now.ToString();
}
voidButton2_Click(objectsender,EventArgse)
{
this.Label1.Text="更新时间:"+System.DateTime.Now.ToString();
}
</script>
<htmlxmlns="http://www.w3.org/1999/xhtml">
<headrunat="server">
<title>UpdatePanelTriggerSample</title>
</head>
<body>
<formid="form1"runat="server">
<div>
<asp:ScriptManagerID="ScriptManager1"runat="server">
</asp:ScriptManager>
</div>
<asp:UpdatePanelID="UpdatePanel1"runat="server">
<ContentTemplate>
<div>
<asp:ButtonID="Button1"runat="server"Text="异步回送"OnClick="Button1_Click"/>
<asp:ButtonID="Button2"runat="server"Text="整页回送"OnClick="Button2_Click"/><br/>
<br/>
<asp:LabelID="Label1"runat="server"Text="当前时间"Font-Bold="True"Font-Size="Large"></asp:Label></div>
<