UpdatePanel 讓「部分頁面更新」(Partial-Page Updates)變得非常容易。要把它加進既有或全新頁面,只要幾個步驟。
步驟一:加入 ScriptManager,並確認 EnablePartialRendering 為 true。這個屬性的預設值就是 true,通常不用動;但若被設成 false,後續所有局部更新的設定都會失效。
<asp:ScriptManager ID="ScriptManager1" runat="server" />
步驟二:加入 UpdatePanel,把想局部更新的內容放進 ContentTemplate 裡。
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<fieldset>
<legend>In UpdatePanel</legend>
UpdatePanel 內容更新於 <%= DateTime.Now.ToString() %>
<asp:Button ID="Button1" Text="Refresh UpdatePanel" runat="server" />
</fieldset>
</ContentTemplate>
</asp:UpdatePanel>
<div>UpdatePanel 之外,重新整理於 <%= DateTime.Now.ToString() %></div>
執行後會看到兩處時間不同步:面板內的時間會更新,面板外的不會。局部更新就這樣完成了。
部分更新時,送回的資料其實和一般 postback 沒兩樣,包含 ViewState 在內全都會回傳伺服器。差別在於伺服器只回傳需要更新的那部分 HTML。因此 postback 被分成兩類:非同步回傳(asynchronous postback)造成 UpdatePanel 更新,一般回傳(normal postback)造成整頁更新。用 ScriptManager 的 IsInAsyncPostBack 屬性可以判斷回傳類型。
<Triggers>
<asp:PostBackTrigger ControlID="Button1" />
<asp:AsyncPostBackTrigger ControlID="Button2" EventName="Click" />
</Triggers>
有 Always 與 Conditional 兩個值,決定非同步回傳發生時面板是否一定更新。只有一個 UpdatePanel 時差異不明顯;但當頁面有多個面板,或出現面板巢嵌面板的結構時,這個設定就能讓各面板在恰當的時機各自更新。
布林值,預設 true。設為 false 時,子控制項引發的非同步回傳不會更新當前面板。這個屬性只在 UpdateMode 為 Conditional 時才有意義;若 UpdateMode 是 Always 卻把 ChildrenAsTriggers 設為 false,會產生非預期的行為。
此外 UpdatePanel 還提供 Update() 方法,可以用程式碼主動觸發面板更新。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button4_Click(object sender, EventArgs e)
{
UpdatePanel1.Update();
}
</script>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>UpdatePanel 屬性示範</title>
<style type="text/css">
.UpdatePanelTitle { color: red; }
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server" />
<fieldset>
<legend class="UpdatePanelTitle">UpdatePanel 之外</legend>
<asp:Button runat="server" ID="Button5" Text="引發一般回傳" /><br />
<asp:Button runat="server" ID="Button1" Text="引發非同步回傳" /><br />
Refreshed at <%= DateTime.Now.ToUniversalTime() %>
</fieldset>
<asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional" runat="server">
<Triggers>
<asp:PostBackTrigger ControlID="Button2" />
</Triggers>
<ContentTemplate>
<fieldset>
<legend class="UpdatePanelTitle">UpdatePanel1</legend>
<asp:Button runat="server" ID="Button2" Text="引發一般回傳" />
Refreshed at <%= DateTime.Now.ToUniversalTime() %>
</fieldset>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel2" UpdateMode="Conditional" runat="server">
<Triggers>
<asp:AsyncPostBackTrigger ControlID="Button1" />
</Triggers>
<ContentTemplate>
<fieldset>
<legend class="UpdatePanelTitle">UpdatePanel2</legend>
<asp:Button runat="server" ID="Button3" Text="In Panel2" />
Refreshed at <%= DateTime.Now.ToUniversalTime() %><br />
<asp:UpdatePanel ID="UpdatePanel3" runat="server" UpdateMode="Always">
<ContentTemplate>
<fieldset>
<legend class="UpdatePanelTitle">UpdatePanel3(Panel2 的子面板)</legend>
<asp:Button runat="server" ID="Button4" Text="In Panel3" />
Refreshed at <%= DateTime.Now.ToUniversalTime() %>
</fieldset>
</ContentTemplate>
</asp:UpdatePanel>
</fieldset>
</ContentTemplate>
</asp:UpdatePanel>
<asp:UpdatePanel ID="UpdatePanel4" UpdateMode="Conditional"
ChildrenAsTriggers="false" runat="server">
<ContentTemplate>
<fieldset>
<legend class="UpdatePanelTitle">UpdatePanel4</legend>
<asp:Button runat="server" ID="Button6" Text="引發一般回傳但不更新自己" />
Refreshed at <%= DateTime.Now.ToUniversalTime() %>
</fieldset>
</ContentTemplate>
</asp:UpdatePanel>
</div>
</form>
</body>
</html>
把這個範例跑起來,逐一按下各顆按鈕並觀察哪幾塊時間會變,就能實際理解 Trigger、UpdateMode 與 ChildrenAsTriggers 的互動關係。