UpdatePanel控件概述
UpdatePanel可以用来创建丰富的局部更新Web应用程序,它是ASP.NET 2.0 AJAX Extensions中很重要的一个控件,其强大之处在于不用编写任何客户端脚本,只要在一个页面上添加几个UpdatePanel控件和一个ScriptManager控件就可以自动实现局部更新。通过本文来学习一下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。 |
ContentTemplate属性
Contente Template标签用来定义UpdatePanel的内容,在它里面可以放任何ASP.NET元素。如果你想要使用编程的手法来控制UpdatePanel中的内容,就需要使用ContenteTemplateContainer,下面会说到,先来看一个简单的ContentTemplate的例子。
1<asp:UpdatePanel ID="UpdatePanel1" runat="server">
2
3 <ContentTemplate>
4
5 <asp:Calendar ID="Calendar1" ShowTitle="True" runat="server" />
6
7 <div>
8
9 Background:
10
11 <br />
12
13 <asp:DropDownList ID="ColorList" AutoPostBack="True" OnSelectedIndexChanged="DropDownSelection_Change"
14
15 runat="server">
16
17 <asp:ListItem Selected="True" Value="White">
18
19 White </asp:ListItem>
20
21 <asp:ListItem Value="Silver">
22
23 Silver </asp:ListItem>
24
25 <asp:ListItem Value="DarkGray">
26
27 Dark Gray </asp:ListItem>
28
29 <asp:ListItem Value="Khaki">
30
31 Khaki </asp:ListItem>
32
33 <asp:ListItem Value="DarkKhaki"> D
34
35 ark Khaki </asp:ListItem>
36
37 </asp:DropDownList>
38
39 </div>
40
41 </ContentTemplate>
42
43</asp:UpdatePanel>
事件代码:
1<script runat="server">
2
3 void DropDownSelection_Change(Object sender, EventArgs e)
4
5 {
6
7 Calendar1.DayStyle.BackColor =
8
9 System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
10
11 }
12
13</script>
ContentTemplateContainer属性
如果要使用编程的手法去设置UpdatePanel中的内容,需要创建一个UpdatePanel,并且添加控件到ContentTemplateContainer,而不能直接添加控件到ContentTemplate,如果想直接设置ContentTemplate,则需要编写一个自定义的Template,并去实现位于System.Web.UI命名空间下的接口ITemplate。看一个简单的来自于官方网站的例子:
1<%@ Page Language="C#" %>
2
3<script runat="server">
4
5 protected void Page_Load(object sender, EventArgs e)
6
7 {
8
9 UpdatePanel up1 = new UpdatePanel();
10
11 up1.ID = "UpdatePanel1";
12
13 up1.UpdateMode = UpdatePanelUpdateMode.Conditional;
14
15 Button button1 = new Button();
16
17 button1.ID = "Button1";
18
19 button1.Text = "Submit";
20
21 button1.Click += new EventHandler(Button_Click);
22
23 Label label1 = new Label();
24
25 label1.ID = "Label1";
26
27 label1.Text = "A full page postback occurred.";
28
29 up1.ContentTemplateContainer.Controls.Add(button1);
30
31 up1.ContentTemplateContainer.Controls.Add(label1);
32
33 Page.Form.Controls.Add(up1);
34
35 }
36
37 protected void Button_Click(object sender, EventArgs e)
38
39 {
40
41 ((Label)Page.FindControl("Label1")).Text = "Panel refreshed at " +
42
43 DateTime.Now.ToString();
44
45 }
46
47</script>
48
49<html xmlns="http://www.w3.org/1999/xhtml">
50
51<head id="Head1" runat="server">
52
53 <title>UpdatePanel Added Programmatically Example</title>
54
55</head>
56
57<body>
58
59 <form id="form1" runat="server">
60
61 <div>
62
63 <asp:ScriptManager ID="TheScriptManager"
64
65 runat="server" />
66
67 </div>
68
69 </form>
70
71</body>
72
73</html>
Triggers属性
在ASP.NET AJAX中有两种Triggers:分别为AsyncPostBackTrigger和PostBackTrigger,AsyncPostBackTrigge用来指定某个服务器端控件以及其将触发的服务器端事件作为该UpdatePanel的异步更新触发器,它需要设置的属性有控件ID和服务端控件的事件;PostBackTrigger用来指定在UpdatePanel中的某个服务端控件,它所引发的回送不使用异步回送,而仍然是传统的整页回送。这一点跟Atlas有很大的区别,大家需要注意。看一个小例子,虽然两个Button都放在了UpdatePanel中,但是由于在PostBackTrigger中指定了Button2,所以它使用的仍然是整页回送。
2
3 < script runat ="server" >
4
5 void Button1_Click(object sender, EventArgs e)
6
7 {
8 this.Label1.Text = "更新时间:" + System.DateTime.Now.ToString();
9 }
10
11 void Button2_Click(object sender, EventArgs e)
12
13 {
14 this.Label1.Text = "更新时间:" + System.DateTime.Now.ToString();
15 }
16
17 </ script >
18
19 < html xmlns ="http://www.w3.org/1999/xhtml" >
20
21 < head runat ="server" >
22
23 < title > UpdatePanel Trigger Sample </ title >
24
25 </ head >
26
27 < body >
28
29 < form id ="form1" runat ="server" >
30
31 < div >
32
33 < asp:ScriptManager ID ="ScriptManager1" runat ="server" >
34
35 </ asp:ScriptManager >
36
37 </ div >
38
39 < asp:UpdatePanel ID ="UpdatePanel1" runat ="server" >
40
41 < ContentTemplate >
42
43 < div >
44
45 < asp:Button ID ="Button1" runat ="server" Text ="异步回送" OnClick ="Button1_Click" />
46
47 < asp:Button ID ="Button2" runat ="server" Text ="整页回送" OnClick ="Button2_Click" />< br />
48
49 < br />
50
51 < asp:Label ID ="Label1" runat ="server" Text ="当前时间" Font-Bold ="True" Font-Size ="Large" ></ asp:Label ></ div >
52
53 </ ContentTemplate >
54
55 < Triggers >
56
57 < asp:AsyncPostBackTrigger ControlID ="Button1" />
58
59 < asp:PostBackTrigger ControlID ="Button2" />
60
61 </ Triggers >
62
63 </ asp:UpdatePanel >
64
65 </ form >
66
67 </ body >
68
69 </ html >
(未完待续)
转自:http://www.cnblogs.com/Terrylee/archive/2006/10/29/ASPNET_AJAX_UpdatePanel_Part1.html
示例代码下载:http://files.cnblogs.com/Terrylee/ASPNETAJAXUpdatePanelDemo1