DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
ASP.NET AJAX 客戶端生命週期事件完整解析
編輯:AJAX詳解     

簡介

微軟的 ASP.NET AJAX 除了沿用 ASP.NET 2.0 既有的伺服器端生命週期,還額外提供了一整套客戶端生命週期事件。這套事件讓開發者在傳統整頁回傳與非同步回傳(部分頁面更新)兩種情境下,都能自行定製介面行為,也能在頁面存活的整段期間管理自有的指令碼與元件。

這些事件定義在 AJAX Library 的類別中。當頁面掛上含 AJAX 伺服器控制項的 ScriptManager 時,相關類別會自動被建立,並透過一組 API 讓你把事件綁定到自訂的處理函式。由於 AJAX Library 本身與瀏覽器無關,你寫的程式碼可以在所有支援的瀏覽器上運作。

其中最关键的兩個事件是 Application 的 init(初始化)與 load(載入);而在使用 UpdatePanel 做部分頁面更新時,主角則換成 PageRequestManager 類別。有了這些事件,你能實作出取消回傳、提高某次回傳的優先權、或讓 UpdatePanel 的更新過程更順暢等進階效果。對頁面開發者而言,它們也讓「頁面載入時注入腳本、卸載時清理資源」這類需求變得容易。

兩個核心客戶端類別

ASP.NET AJAX 的客戶端生命週期主要圍繞兩個類別:

Application 類別:當瀏覽器請求一個含 ScriptManager 的頁面時被建立。它在概念上對應伺服器端的 Page 控制項,同樣繼承自 Control,並額外繼承 Sys.Component,因而具備元件模型的能力與一組可在客戶端生命週期中操作的事件。

PageRequestManager 類別:當頁面同時具備 ScriptManager 與一個以上 UpdatePanel 時,這個類別的執行個體才會出現在瀏覽器中。它提供的事件全部圍繞非同步回傳。

掛上與移除事件處理函式

Application 與 PageRequestManager 都提供成對的 add_eventname 與 remove_eventname 方法。以下示範把名為 MyInit 的處理函式掛到 Application 的 init 事件,隨後再移除:

Sys.Application.add_init(MyInit);
function MyInit(sender) {
}
Sys.Application.remove_init(MyInit);

這個範例只示範語法。實務上 Application 的 load 與 unload 事件有更方便的寫法:直接定義保留名稱的 pageLoad 與 pageUnload 函式即可,不必顯式綁定。

function pageLoad(sender, args) {
}

值得注意的是,pageLoad 會在任何透過 add_load 掛上的處理函式之後被呼叫。

其他類別與 DOM 事件

除了上述兩個類別,AJAX Library 還提供一組用於 DOM 元素事件的工具,均為 Sys.UI.DomEvent 的靜態方法,並各有簡寫:

  • Sys.UI.DomEvent.addHandler,簡寫 $addHandler
  • Sys.UI.DomEvent.clearHandlers,簡寫 $clearHandlers
  • Sys.UI.DomEvent.removeHandler,簡寫 $removeHandler

事件清單與參數型別

以下依生命週期順序列出可使用的客戶端事件:

init(初始化):所有腳本載入完成、任何物件尚未建立之前觸發,只會觸發一次。撰寫元件時,這是掛載元件的理想切入點,讓後續腳本可以呼叫它。網頁開發者一般情況下建議改用 load。

load(載入):所有腳本載入完成,且透過 $create 建立的所有物件都就位之後觸發。任何一次回傳(含非同步回傳)都會觸發。事件參數為 Sys.ApplicationLoadEventArgs,可從中得知這次是否為部分頁面更新,以及哪些元件是這次才建立的。

unload(卸載):在瀏覽器的 window.unload 之前、所有物件被釋放之前觸發,可由 pageUnload 函式處理。此時應釋放程式碼占用的所有資源。

propertyChanged(屬性變更):繼承自 Sys.Component。只有當你明確呼叫 Sys.Component.raisePropertyChange 時才會觸發,不會因為直接改值而自動引發。

disposing(釋放):應用程式執行個體被釋放時觸發,同樣繼承自 Component。

initializeRequest(初始化請求):非同步請求即將開始時觸發。事件參數為 Sys.WebForms.InitializeRequestEventArgs,其中包含造成回傳的來源物件與底層請求物件,並暴露 cancel 屬性;將它設為 true 即可取消這次回傳,例如讓位給優先權更高的非同步回傳。

beginRequest(開始請求):請求送出前觸發。若已有回傳進行中,會被 abortPostBack 中止。適合用來設定請求標頭,或在頁面上顯示「處理中」的動畫提示。參數型別為 Sys.WebForms.BeginRequestEventArgs。

pageLoading(頁面載入中):伺服器已接受非同步回傳、頁面內容尚未更新之前觸發。可在此為即將更新的區域加入自訂的過場效果。參數型別為 Sys.WebForms.PageLoadingEventArgs,可取得本次將被刪除與更新的面板資訊。

pageLoaded(頁面載入完成):同步或非同步回傳的結果全部套用後觸發。同步回傳時面板只會被建立,非同步回傳時則可能同時被建立與更新。參數型別為 Sys.WebForms.PageLoadedEventArgs,可取得被更新與被建立的面板清單。

endRequest(結束請求):回傳完成並更新頁面後,或請求過程中發生錯誤時觸發。出錯時頁面不會更新,你可以在此向使用者顯示自訂錯誤訊息或寫入日誌。參數型別為 Sys.WebForms.EndRequestEventArgs,包含錯誤資訊、錯誤是否已處理,以及對應的 response 物件。

事件觸發順序:初始化請求

假設頁面含 ScriptManager 且 SupportsPartialRendering 與 EnablePartialRendering 皆為 true,請求為 GET 且伺服器正常回應,順序如下:

  1. 頁面發出初始化請求。
  2. 客戶端收到回應。
  3. Application 引發 init。
  4. Application 引發 load。

init 只會在應用程式執行個體建立時發生一次,後續的非同步回傳不會再觸發;初始化階段不會有任何 PageRequestManager 事件。

事件觸發順序:非同步回傳

假設 UpdatePanel 的 ChildrenAsTriggers 為 true,且面板內有觸發回傳的按鈕,成功取得回應:

  1. 點擊面板內按鈕,引發非同步回傳。
  2. PageRequestManager 引發 initializeRequest。
  3. PageRequestManager 引發 beginRequest。
  4. 請求送出至伺服器。
  5. 客戶端收到回應。
  6. PageRequestManager 引發 pageLoading。
  7. PageRequestManager 引發 pageLoaded。
  8. Application 引發 load。
  9. PageRequestManager 引發 endRequest。

請特別留意:Application 的 load 落在 pageLoaded 之後、endRequest 之前。

事件觸發順序:連續多次回傳

若第二次點擊發生在第一次請求仍在處理中,順序會是:第一次的 initializeRequest 與 beginRequest、請求送出、收到回應;接著第二次點擊再次引發 initializeRequest 與 beginRequest、第二次請求送出並收到回應;最後依序為 pageLoading、pageLoaded、Application load、endRequest。

預設行為是「後到的回傳優先」。若兩個回傳接連發生而第一個仍在瀏覽器端處理,第一個會被取消;若第一個已送到伺服器,伺服器通常不會在第二個請求抵達前先回覆第一個。

事件觸發順序:離開頁面

當使用者前往別的頁面,當前頁面卸載,順序為:發出請求、瀏覽器收到回應、Application 引發 unload、顯示新頁面。即使導覽過程發生錯誤,unload 仍會觸發,只是新頁面不會顯示。

巢狀 UpdatePanel 的實作範例

以下範例示範如何觀察巢狀 UpdatePanel 的事件順序。點擊外層面板的按鈕會更新外層面板,並連帶刪除再重建內層面板;點擊內層面板的按鈕則只更新內層。

頁面:

<%@ Page Language="C#" %>
<html xmlns="https://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Client Event Example</title>
  <style type="text/css">
    #OuterPanel   { width: 600px; height: 200px; border: 2px solid blue; }
    #NestedPanel  { width: 596px; height: 60px; border: 2px solid green;
                    margin-left: 5px; margin-right: 5px; margin-bottom: 5px;}
  </style>
</head>
<body>
  <form id="form1" runat="server">
  <div>
    <asp:ScriptManager ID="ScriptManager1" runat="server">
      <Scripts>
        <asp:ScriptReference Path="ClientEventTest.js" />
      </Scripts>
    </asp:ScriptManager>
    <asp:UpdatePanel ID="OuterPanel" UpdateMode="Conditional" runat="server">
      <ContentTemplate>
        Postbacks from inside the outer panel and inner panel are
        asynchronous postbacks. PRM = Sys.WebForms.PageRequestManager.
        APP = Sys.Application.
        <br /><br />
        <asp:Button ID="OPButton1" Text="Outer Panel Button" runat="server" />
        Last updated on <%= DateTime.Now.ToString() %>
        <br /><br />
        <asp:UpdatePanel ID="NestedPanel" UpdateMode="Conditional" runat="server">
          <ContentTemplate>
            <asp:Button ID="NPButton1" Text="Nested Panel 1 Button" runat="server" />
            Last updated on <%= DateTime.Now.ToString() %>
            <br />
          </ContentTemplate>
        </asp:UpdatePanel>
      </ContentTemplate>
    </asp:UpdatePanel>
    <input type="button" onclick="Clear();" value="Clear" />
    <asp:Button ID="FullPostBack" runat="server" Text="Full Postback" />
    <a href="https://www.microsoft.com">Test Window Unload</a>
    <br />
    <span id="ClientEvents"></span>
  </div>
  </form>
</body>
</html>

腳本:

// Hook up Application event handlers.
var app = Sys.Application;
app.add_load(ApplicationLoad);
app.add_init(ApplicationInit);
app.add_disposing(ApplicationDisposing);
app.add_unload(ApplicationUnload);

// Application event handlers for component developers.
function ApplicationInit(sender) {
  var prm = Sys.WebForms.PageRequestManager.getInstance();
  if (!prm.get_isInAsyncPostBack()) {
    prm.add_initializeRequest(InitializeRequest);
    prm.add_beginRequest(BeginRequest);
    prm.add_pageLoading(PageLoading);
    prm.add_pageLoaded(PageLoaded);
    prm.add_endRequest(EndRequest);
  }
  $get('ClientEvents').innerHTML += "APP:: Application init. <br/>";
}
function ApplicationLoad(sender, args) {
  $get('ClientEvents').innerHTML += "APP:: Application load. ";
  $get('ClientEvents').innerHTML +=
    "(isPartialLoad = " + args.get_isPartialLoad() + ")<br/>";
}
function ApplicationUnload(sender) { alert('APP:: Application unload.'); }
function ApplicationDisposing(sender) {
  $get('ClientEvents').innerHTML += "APP:: Application disposing. <br/>";
}

// Application event handlers for page developers.
function pageLoad() { $get('ClientEvents').innerHTML += "PAGE:: Load.<br/>"; }
function pageUnload() { alert('PAGE:: Page unload.'); }

// PageRequestManager event handlers.
function InitializeRequest(sender, args) {
  $get('ClientEvents').innerHTML += "<hr/>";
  $get('ClientEvents').innerHTML += "PRM:: Initializing async request.<br/>";
}
function BeginRequest(sender, args) {
  $get('ClientEvents').innerHTML += "PRM:: Begin processing async request.<br/>";
}
function PageLoading(sender, args) {
  $get('ClientEvents').innerHTML += "PRM:: Loading results of async request.<br/>";
  var updatedPanels = printArray("PanelsUpdating", args.get_panelsUpdating());
  var deletedPanels = printArray("PanelsDeleting", args.get_panelsDeleting());
  document.getElementById("ClientEvents").innerHTML +=
    "-->" + updatedPanels + "<br/>-->" + deletedPanels + "<br/>";
}
function PageLoaded(sender, args) {
  $get('ClientEvents').innerHTML += "PRM:: Finished loading results of async request.<br/>";
  var updatedPanels = printArray("PanelsUpdated", args.get_panelsUpdated());
  var createdPanels = printArray("PanelsCreated", args.get_panelsCreated());
  document.getElementById("ClientEvents").innerHTML +=
    "-->" + updatedPanels + "<br/>-->" + createdPanels + "<br/>";
}
function EndRequest(sender, args) {
  $get('ClientEvents').innerHTML += "PRM:: End of async request.<br/>";
}

// Helper functions.
function Clear() { $get('ClientEvents').innerHTML = ""; }
function printArray(name, arr) {
  var panels = name + '=' + arr.length;
  if (arr.length > 0) {
    panels += "(";
    for (var i = 0; i < arr.length; i++) { panels += arr[i].id + ','; }
    panels = panels.substring(0, panels.length - 1);
    panels += ")";
  }
  return panels;
}
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved