ASHX 實戰總結：從圖片輸出到動態 JS/CSS/XML 的多元應用模式

.ashx 常被視為「圖片處理專用」，實則是輕量級 HTTP 端點的萬能鑰匙。本文彙整五大實戰模式，並釐清常見誤區與最佳實踐。

模式一：動態圖片輸出 (經典用法)

實作 IHttpHandler，依查詢字串參數 (PhotoID/AlbumID、Size) 從資料庫/檔案系統讀取圖片流，設定 ContentType 並寫入 Response.OutputStream。前端直接用 <img src="Handler.ashx?id=123" /> 引用。

模式二：輸出純文字 / JavaScript 片段

context.Response.ContentType = "text/plain";
context.Response.Write("alert('hi');"); // 或 document.write(...)

前端以 <script src="Handler.ashx"></script> 引入，實現動態 JS 生成（如根據用戶權限輸出不同配置）。

模式三：偽裝為 CSS 檔案

<link href="css/Handler.ashx" rel="stylesheet" type="text/css" />

Handler 設定 ContentType = "text/css" 並輸出動態樣式規則，支援主題切換、租戶隔離等場景。

模式四：輸出 XML 資料

orderDoc.load("Handler.ashx"); // MSXML / XmlDocument 載入

適合舊系統整合、RSS/Atom Feed、Sitemap 動態生成。

模式五：嵌入式文字輸出 (document.write)

context.Response.Write("document.write('Hello World');");

前端 <script src="TestHandler.ashx"></script> 直接在頁面寫入內容，早期廣告輪播、第三方嵌入常用。

關鍵進階：在 Handler 中存取 Session

預設 Handler 無 Session，需顯式實作介面：

• 唯讀：IReadOnlySessionState
• 讀寫：IRequiresSessionState

public class DownloadHandler : IHttpHandler, IReadOnlySessionState {
  public void ProcessRequest(HttpContext ctx) {
    ctx.Response.Write(ctx.Session["fred"]);
  }
}

避坑指南與最佳實踐

1. 別濫用：上述模式二~五雖可行，但現代架構建議用 Web API / Minimal API / Controller 統一管理，.ashx 宜限於「極簡、無框架依賴、舊系統相容」場景。
2. 快取策略：圖片類 Handler 必加 Response.Cache.SetCacheability(HttpCacheability.Public) 並設定 ETag/Last-Modified，減輕伺服器壓力。
3. 錯誤處理：資源不存在時回傳 404 而非空內容，利於前端錯誤攔截與 CDN 快取判斷。
4. 安全性：動態 JS/CSS 輸出務必防範 XSS，嚴格驗證輸入參數，避免直接拼接用戶輸入至腳本/樣式。

延伸閱讀

研究 Rewirte.dll (URL Rewrite) 如何將 .ashx 映射為偽靜態路由，進一步理解 HTTP 管線的攔截與分發機制。