C# 自訂縮略圖 Web 控制項：無實體檔案、單一類別完整實作

設計核心概念

1. WebControl 而非 UserControl：繼承 System.Web.UI.WebControls.WebControl，純 C# 類別，無 HTML 標記。
2. 零相依、自包含：除 .NET 基底類別庫外，無需額外組件、無需實體暫存檔。
3. 同頁雙重請求機制：
   1. 首次請求：頁面正常轉譯，控制項輸出 <img src="SamePage.aspx?thumb=1&w=100&h=80&src=photo.jpg" />。
   2. 瀏覽器解析 img，發起第二次請求 (含查詢字串參數)。
   3. 同一頁面再次執行，控制項偵測參數，直接 Response.BinaryWrite 輸出縮圖二進位流，Response.End()。

流程時序圖

Client → GET Page.aspx
Server → Page.aspx 執行 → 控制項 Render → 輸出 
Client → 解析 HTML → GET Page.aspx?thumb=1&...
Server → Page.aspx 執行 → 控制項偵測 thumb 參數 → 讀取原圖 → GDI+ 縮放 → Response.OutputStream → 圖片二進位
Client → 接收圖片 → 頁面載入完成

關鍵實作細節

• 覆寫 OnLoad 或 Render 檢查 Request.QueryString["thumb"]。
• 使用 System.Drawing.Image.GetThumbnailImage 或 Graphics.DrawImage 高品質縮放。
• 設定 Response.ContentType = "image/jpeg" (或 png/gif)。
• 輸出後 Response.End() 避免輸出頁面 HTML。
• 快取策略：可加入 OutputCache 或自行快取縮圖位元組陣列。

擴充方向

加入浮水印、版權保護、非同步處理、CDN 整合等。