DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
ASP.NET 中的 ScriptManager 標籤詳解
編輯:AJAX詳解     

以下整理 <asp:ScriptManager> 標籤所支援的屬性與子標籤。

主要屬性

  1. AllowCustomError:在異步更新發生異常時,是否採用 Web.config 中 <customErrors> 一節的設定。若設為 true,發生異常後便會像一般 ASP.NET 程式那樣重定向到專門的錯誤頁;但對 Ajax 程式而言,頁面跳轉是我們應竭力避免的,因此一般建議設為 false。
  2. AsyncPostBackErrorMessage:異步更新發生異常時送給用戶端的錯誤訊息,可在 AsyncPostBackError 事件的處理函式中依異常類型動態設定,再由用戶端 Web Form 框架格式化顯示。這也是推薦的 Ajax 異常處理方式。
  3. AsyncPostBackTimeout:異步更新的逾時時限,單位為秒,預設 90 秒,一般無須更動。
  4. EnablePartialRendering:是否支援頁面局部更新,預設為 true。使用 UpdatePanel 時便不必每次留意設定,但也會帶來輕微的效率影響。
  5. ScriptMode:指定使用用戶端腳本的版本(Debug 或 Release),其結果亦受設定檔中 retail 設定影響。需注意:若設為 Debug 或執行時被判定需載入 Debug 版腳本,自訂腳本檔名會自動加入「debug」部分,例如「myjs.js」會變成「myjs.debug.js」。
  6. ScriptPath:作為所有腳本檔的根目錄(全域路徑)。設定後,用戶端腳本會以靜態引用方式載入(格式為 ScriptPath+組件名+版本號+腳本檔名),而非預設透過 axd 資源取得。如此一來,若修改了框架自帶的某個腳本,便能方便地引入修改後的新版本,同時也不知不覺提升了執行效率。
  7. OnAsyncPostBackError:指定 AsyncPostBackError 事件的伺服器端處理函式,可從中取得引發的異常,並據此設定不同的 AsyncPostBackErrorMessage,給使用者足夠友善的提示。
  8. OnResolveScriptReference:指定 ResolveScriptReference 事件的伺服器端處理函式,可修改某條腳本的相關資訊,例如路徑、名稱、版本等。

子標籤變化

1. <ErrorTemplate> 標籤

已完全移除。由於有了 AsyncPostBackErrorMessage 屬性、OnAsyncPostBackError 事件以及用戶端 Web Form 框架,開發者可極其靈活地完全自訂異常顯示介面。ASP.NET Ajax 中預設的異步更新異常顯示,就是一個簡單的 JavaScript alert() 對話框。

2. <asp:ScriptReference> 標籤

包含在 <Scripts> 標籤中,用來為頁面引入用戶端 JavaScript 腳本。若需使用附加腳本或自訂腳本,便應使用此標籤。它移除了 ScriptName 列舉的支援,目前支援的屬性有:

  • Assembly:要引用的腳本所嵌入的組件。
  • Name:嵌入組件中的腳本資源名稱(通常與 Assembly 成對使用)。
  • Path:以路徑指定要引用的自訂腳本檔。
  • ScriptMode:作用同 ScriptManager 中的同名屬性,並覆蓋其設定。
  • IgnoreScriptPath:是否忽略 ScriptManager 中 ScriptPath 屬性的定義。

3. <asp:ServiceReference> 標籤

移除了 GenerateProxy、OnScriptLoad、Type 三個屬性,僅留:

  • InlineScript:是否將此 Proxy 內聯到頁面中,內聯可省去一次 HTTP 連線,某種程度加快初始化速度。
  • Path:Web Service 的檔案路徑。

4. <AuthenticationService> 標籤

  • Path:驗證服務的檔案路徑。

5. <ProfileService> 標籤

  • Path:使用者個性化服務的檔案路徑。
  • LoadProperties:將內聯到頁面中的使用者個性化屬性。

其中 <AuthenticationService> 與 <ProfileService> 分別與 AuthenticationServiceManager、ProfileServiceManager 相關,同樣用於用戶端 Web Form 模型中。

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