DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
深入 ASP.NET AJAX 的 UpdatePanel 控制項
編輯:AJAX詳解     

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

  • AsyncPostBackTrigger:指定某個控制項的某個事件引發非同步回傳(即局部更新)。有 ControlID 與 EventName 兩個屬性;不指定 EventName 時會採用控制項的預設事件(Button 就是 Click)。把 ControlID 設成 UpdatePanel 外部的控制項,就能讓外部控制項去觸發面板更新。
  • PostBackTrigger:指定 UpdatePanel 內的某個控制項引發整頁的一般回傳。
<Triggers>
    <asp:PostBackTrigger ControlID="Button1" />
    <asp:AsyncPostBackTrigger ControlID="Button2" EventName="Click" />
</Triggers>

UpdateMode

有 Always 與 Conditional 兩個值,決定非同步回傳發生時面板是否一定更新。只有一個 UpdatePanel 時差異不明顯;但當頁面有多個面板,或出現面板巢嵌面板的結構時,這個設定就能讓各面板在恰當的時機各自更新。

ChildrenAsTriggers

布林值,預設 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 的互動關係。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved