萬盛學電腦網

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

ASP.NET 伺服端動態載入 JavaScript 檔案的三種模式

依據業務邏輯 (如 A/B 測試、功能開關、多語系、權限) 決定是否載入特定 JS 檔案,是常見需求。本文介紹三種伺服端動態註冊 JS 的模式,比較優缺點與適用場景。

模式一:HtmlGenericControl 建立 <script> 標籤 (WebForms 原生)

protected void RegisterScript(string url, string key = null) {
    if (Page.Header == null) return; // 需 
    key = key ?? url;
    if (Page.ClientScript.IsClientScriptBlockRegistered(GetType(), key)) return;

    var script = new HtmlGenericControl("script");
    script.Attributes["type"] = "text/javascript";
    script.Attributes["src"] = ResolveClientUrl(url); // 支援 ~ 路徑
    Page.Header.Controls.Add(script);

    Page.ClientScript.RegisterClientScriptBlock(GetType(), key, "", true); // 標記已註冊防重複
}

呼叫:`RegisterScript("~/Scripts/feature-a.js");`

模式二:ScriptManager.RegisterClientScriptInclude (支援 UpdatePanel)

ScriptManager.RegisterClientScriptInclude(this, GetType(), "featureA", ResolveClientUrl("~/Scripts/feature-a.js"));
  • 優點:支援部分更新 (UpdatePanel 非同步回發後仍保留)。
  • 缺點:需頁面有 `ScriptManager`;輸出位置在表單結尾,非 ``。

模式三:ClientScriptManager.RegisterClientScriptBlock 內嵌程式碼

若需內嵌初始化參數而非外部檔案:

string script = $@"var FeatureAConfig = {{ apiUrl: '{ResolveUrl("~/api/feature")}', lang: '{CurrentCulture}' }};";
Page.ClientScript.RegisterClientScriptBlock(GetType(), "FeatureAConfig", script, true);

比較表

模式輸出位置支援 UpdatePanel去重機制適用場景
HtmlGenericControl否手動檢查靜態外部 JS、需放 head (如 SEO、預載)
ScriptManager.RegisterClientScriptInclude表單底部是自動 (key)AJAX 頁面、外部 JS 非阻塞載入
RegisterClientScriptBlock表單底部是自動 (key)內嵌配置物件、Inline 程式碼

進階:條件式載入與快取破壞

// 依功能開關決定
if (FeatureToggle.IsEnabled("NewDashboard")) {
    RegisterScript("~/Scripts/dashboard.v2.js?v=" + AppVersion);
}

// 依權限載入管理腳本
if (User.IsInRole("Admin")) {
    ScriptManager.RegisterClientScriptInclude(this, GetType(), "AdminTools", ResolveClientUrl("~/Scripts/admin.js"));
}

// 版本查詢字串防快取
string versionedUrl = $"{url}?v={Assembly.GetExecutingAssembly().GetName().Version}";

最佳實踐建議

  1. 優先使用 **ScriptManager** 系統統一管理,避免重複註冊、支援 AJAX。
  2. 外部 JS 檔案建議合併壓縮 (Bundling/Minification),減少 HTTP 請求。
  3. 非關鍵 JS 使用 `defer` 或 `async` 屬性 (需手動渲染 `
copyright © 萬盛學電腦網 all rights reserved