萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET AJAX 與 jQuery Ready 衝突解決:PageRequestManager EndRequest 重新初始化

前言

ASP.NET AJAX(UpdatePanel)執行部分頁面回發後,$(document).ready() **不會再次觸發**,導致 jQuery 綁定事件、UI 初始化失效。本文解釋根本原因,並提供標準解決方案:掛載 PageRequestManager.endRequest 事件重新執行初始化邏輯。

問題根因

  • $(document).ready() 只在**文檔首次載入完成**觸發一次。
  • UpdatePanel 非同步回發只替換局部 HTML,**不重新載入文檔**,故 ready 不再執行。
  • 動態載入的新元素、綁定的事件處理器全部遺失。

標準解決方案:endRequest 重新初始化

<script type="text/javascript">
    // 1. 取得 PageRequestManager 實例
    var prm = Sys.WebForms.PageRequestManager.getInstance();

    // 2. 註冊 endRequest 事件處理器
    prm.add_endRequest(EndRequestHandler);

    // 3. 封裝初始化邏輯為可重複呼叫的函數
    function PageInit() {
        // 在這裡放置原本在 ready() 內的所有代碼
        $('.datepicker').datepicker();
        $('.tooltip').tooltip();
        $('#btnSubmit').off('click').on('click', handleSubmit);
        // ...
    }

    // 4. endRequest 觸發時重新初始化
    function EndRequestHandler(sender, args) {
        if (args.get_error() === undefined) { // 無錯誤時才初始化
            PageInit();
        }
    }

    // 5. 頁面首次載入也要執行一次
    PageInit();
</script>

關鍵放置位置:避免 Sys 未定義

  • 錯誤:放在 <head> 中 → ScriptManager 尚未渲染,Sys 未定義。
  • 正確:放在 <body> 結尾(</body> 前),確保 ScriptManager 已初始化完成。

進階:針對特定 UpdatePanel 範圍初始化

function EndRequestHandler(sender, args) {
    if (args.get_error()) return;
    
    var updatedPanels = args.get_panelsUpdated();
    updatedPanels.forEach(function(panel) {
        var $panel = $('#' + panel.id);
        // 僅在更新區域內重新初始化
        $panel.find('.datepicker').datepicker();
        $panel.find('.select2').select2();
    });
}

常見坑點與解決

問題原因解決
事件重複綁定每次 endRequest 都 .on() 疊加先 .off() 再 .on(),或用事件委派 $(document).on('click', '.selector', fn)
外掛重複初始化報錯如 datepicker、select2 不支援重複初始化先 .destroy() 或檢查 .hasClass('hasDatepicker')
ScriptManager 未找到腳本放在 Head 或 MasterPage 錯誤位置移至 Body 結尾,或用 ScriptManager.RegisterStartupScript 從後端註冊

現代化替代:棄用 UpdatePanel

  • 採用 Web API / ASP.NET Core MVC + jQuery AJAX / Fetch 手動局部更新。
  • 或改用 Blazor / React / Vue 客戶端渲染,徹底消除此類生命週期衝突。
  • 若必須維護舊專案,endRequest 重新初始化是標準修補方案。

結語

ASP.NET AJAX 部分回發破壞了 jQuery ready() 單次執行假設。掛載 PageRequestManager.endRequest 並在其中重新執行 PageInit(),是 WebForm + UpdatePanel + jQuery 共存的**標準修正模式**。記住:腳本放 Body 尾、初始化邏輯冪等化、善用事件委派避免重複綁定。

copyright © 萬盛學電腦網 all rights reserved