幫幾位開發者排查過同一類怪問題:自訂的 JavaScript 腳本行為異常,UpdatePanel 明明該做局部更新,卻觸發整頁 postback。追下去,問題幾乎都指向 web.config 裡一行被自動移植工具留下的設定。
專案原本在 Visual Studio 2003 開發,透過升級精靈搬到 VS 2005 之後運作正常。但一旦往頁面加入新的客戶端腳本,就會出現難以解釋的行為,最典型的就是 UpdatePanel 失去局部更新的效果,變成整頁刷新。
打開 web.config,你會看到這樣一段:
<configuration>
<system.web>
<xHtmlConformance mode="Legacy" />
</system.web>
</configuration>
背景是這樣的:ASP.NET 1.0 與 1.1 的許多伺服器控制項輸出的標記並不符合 XHTML 規範;到了 ASP.NET 2.0,所有控制項預設都輸出 XHTML 相容的標記。早期 2.0 beta 階段發現,不少既有網站的版面其實依賴舊的非 XHTML 輸出,一旦改成標準輸出,視覺呈現就會跑掉。為了向後相容,才加入 xHtmlConformance 設定,讓開發者可以選擇 Legacy(等同 1.1 的非 XHTML 輸出)、Transitional 或 Strict 三種模式。
問題在於,用 VS 2003 的 Web 專案移植精靈升級時,不論是網站或 Web 應用程式專案,web.config 都會被自動加上 Legacy 這段設定。Legacy 模式輸出的標記往往不是良構(well-formed)的,開始標籤與結束標籤未必成對,而 ASP.NET AJAX 的更新機制正是靠 DOM 操作來替換頁面片段,標記不成對就會讓容器元素被誤判,腳本於是出錯。
除非你確定網站改用 XHTML 模式輸出後會出問題,而且短期內沒空修正,否則建議直接從 web.config 移除 xHtmlConformance 這段設定,或明確指定為 Transitional 或 Strict。
<configuration>
<system.web>
<xHtmlConformance mode="Transitional" />
</system.web>
</configuration>
這麼做有兩個好處:輸出的 HTML 符合標準,伺服器控制項產生的標記變成良構,標籤成對出現;而當你使用 AJAX 動態替換頁面上某個元素的內容時,客戶端腳本就不會找不到對應的容器節點。這是 ASP.NET AJAX 能穩定運作的前提之一。
升級專案後遇到莫名的 JavaScript 錯誤,別急著往腳本裡找答案。先檢查 web.config 有沒有被移植工具留下 Legacy 模式,往往一行設定就是根源。