.NET 2.0 完美解決方案：單一頁面同時停用 Theme 中的 .skin 與 .css

在 web.config 全域啟用 Theme 後，若想讓特定頁面（如 Web Service、AJAX 端點、XML 輸出頁）完全不套用主題，單靠 EnableTheming="false" 往往失效——它只能停用 .skin 檔，無法阻擋 .css 樣式表注入。本文提供徹底解決方案。

問題重現場景

<!-- web.config 全域啟用 Theme -->
<pages theme="DefaultTheme"></pages>

<!-- 頁面指示詞嘗試停用 -->
<%@ Page EnableTheming="false" %>

錯誤訊息：「使用主題的 CSS 檔案要求頁面上有標頭控制項 (如 <head runat="server" />)」

原因：XMLHTTP/ASMX/ASHX 等無 HTML 輸出的端點，被強制注入 CSS 連結導致例外。

核心解決方案：雙重屬性組合拳

在 @Page 指示詞中同時設定：

<%@ Page EnableTheming="false" StyleSheetTheme="" %>

進階情境：UserControl (ASCX) 在 SharePoint/MOSS 中的處理

ASCX 無 @Page 指示詞，無法直接設定 StyleSheetTheme。變通做法：

1. 在 ASCX 加入空 <head runat="server"></head> 滿足 Theme 引擎檢查
2. Code-behind 中徹底清除輸出：

this.Response.Clear();
this.Response.ClearHeaders();
this.Response.ClearContent();
this.Response.Write("");
this.Response.End();

原理深度解析

ASP.NET 2.0 Theme 機制分兩階段：

1. StyleSheetTheme 階段：在 OnPreInit 之前，注入 <link> 標籤引用 .css
2. Theme 階段：在 OnPreInit 之後，套用 .skin 定義的控制項屬性

EnableTheming 僅影響第二階段；必須用 StyleSheetTheme="" 空字串覆蓋第一階段，才能徹底切斷 CSS 注入管線。

最佳實踐建議

• Web Service/HTTP Handler：繼承 IHttpHandler 而非使用 .aspx，根源避免 Theme 處理
• AJAX 端點：使用 [ScriptService] 或 Web API，不經由頁面生命週期
• 若必須用 .aspx 輸出非 HTML 內容：ContentType 設正確 + 雙重屬性停用 Theme