ASP.NET Web User Control 正確引用 CSS 樣式表的關鍵屬性

問題情境

在 `<%@ Control %>` 宣告的 Web 使用者控制項（`.ascx`）中直接寫 ``，發現樣式不生效。

解決關鍵：`EnableTheming="true"`

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="gl1.ascx.cs" Inherits="admin_gl1" EnableTheming="True" %>
<link href="../App_Themes/qiantai.css" rel="stylesheet" type="text/css" />

原理說明

• ASP.NET 主題機制 預設只處理 `` 區塊的 `` 標籤。
• 使用者控制項不在 `` 內，若未啟用 `EnableTheming`，執行階段會忽略控制項內的樣式表連結。
• 設定 `EnableTheming="True"` 後，執行階段會將控制項內的 `` 標籤提升至頁面 `` 區塊，使樣式正常套用。

替代做法（不依賴主題機制）

1. 母版頁/內容頁統一引用：在 `.master` 或 `.aspx` 的 `` 區塊集中引用所有共用 CSS，控制項只使用 class 名稱。
2. 程式碼後置動態註冊：

   protected void Page_Init(object sender, EventArgs e)
   {
       var link = new HtmlLink { Href = ResolveUrl("~/App_Themes/qiantai.css"), Attributes = { ["rel"] = "stylesheet", ["type"] = "text/css" } };
       Page.Header.Controls.Add(link);
   }

3. ClientScriptManager 註冊（較舊做法）：

   Page.ClientScript.RegisterClientScriptInclude("qiantaiCss", ResolveUrl("~/App_Themes/qiantai.css"));

最佳實踐建議

1. **統一在母版頁/Layout 引用全站 CSS**，控制項只專注結構與 class，避免重複請求、優先序混亂。
2. 若控制項需獨立樣式（如第三方元件），採用 **程式碼後置動態註冊至 ``**，確保單一載入。
3. 避免在 `.ascx` 直接寫 ``，除非確定啟用 `EnableTheming` 且理解其提升機制。