透過 IHttpHandler 攔截圖片請求,在伺服器端以 GDI+ 繪製浮水印後再輸出,可實現「不修改原圖、動態加浮水印、支援快取」的保護機制。本文提供完整可用的 ImageHandler.ashx 實作,涵蓋多種圖片格式、索引色處理、浮水印位置/字型/透明度設定。
<%@ WebHandler Language="C#" Class="ImageHandler" %>
using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;
using System.Web;
public class ImageHandler : IHttpHandler
{
public bool IsReusable => true;
public void ProcessRequest(HttpContext context)
{
string physicalPath = context.Request.PhysicalPath;
if (!File.Exists(physicalPath))
{
context.Response.StatusCode = 404;
context.Response.End();
return;
}
// 1. 設定輸出 Content-Type
context.Response.ContentType = GetContentType(physicalPath);
// 2. 可選:設定快取 (ETag/Last-Modified)
context.Response.Cache.SetCacheability(HttpCacheability.Public);
context.Response.Cache.SetLastModified(File.GetLastWriteTimeUtc(physicalPath));
// 3. 產生含浮水印的圖片位元組
byte[] watermarked = AddWatermark(physicalPath, context);
// 4. 輸出
context.Response.BinaryWrite(watermarked);
}
private byte[] AddWatermark(string imagePath, HttpContext context)
{
string watermarkText = "浮水印文字"; // 可從 config/DB 讀取
Font font = new Font("微軟雅黑", 18, FontStyle.Bold);
Color watermarkColor = Color.FromArgb(128, 255, 0, 0); // 半透明紅
StringAlignment align = StringAlignment.Far; // 右下角
using (Image original = Image.FromFile(imagePath))
{
// 處理索引色圖片 (GIF/8bpp PNG) 無法直接建立 Graphics
Image workingImage = original;
if (IsIndexedPixelFormat(original.PixelFormat))
{
workingImage = new Bitmap(original.Width, original.Height, PixelFormat.Format32bppArgb);
using (Graphics g = Graphics.FromImage(workingImage))
g.DrawImage(original, 0, 0, original.Width, original.Height);
}
using (Graphics g = Graphics.FromImage(workingImage))
{
g.SmoothingMode = SmoothingMode.AntiAlias;
g.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
// 計算浮水印尺寸
SizeF textSize = g.MeasureString(watermarkText, font);
float margin = 10;
float x, y;
// 九宮格定位邏輯 (此處示範右下)
x = workingImage.Width - textSize.Width - margin;
y = workingImage.Height - textSize.Height - margin;
// 繪製陰影 (可選)
using (Brush shadowBrush = new SolidBrush(Color.FromArgb(80, 0, 0, 0)))
g.DrawString(watermarkText, font, shadowBrush, x + 2, y + 2);
// 繪製主浮水印
using (Brush brush = new SolidBrush(watermarkColor))
g.DrawString(watermarkText, font, brush, x, y);
}
// 輸出至 MemoryStream 保持原格式
using (MemoryStream ms = new MemoryStream())
{
ImageFormat fmt = GetImageFormat(imagePath);
workingImage.Save(ms, fmt);
return ms.ToArray();
}
}
}
private bool IsIndexedPixelFormat(PixelFormat fmt)
{
return (fmt & PixelFormat.Indexed) != 0;
}
private string GetContentType(string path)
{
return Path.GetExtension(path).ToLowerInvariant() switch
{
".bmp" => "image/bmp",
".gif" => "image/gif",
".jpg" => "image/jpeg",
".jpeg" => "image/jpeg",
".png" => "image/png",
_ => "application/octet-stream"
};
}
private ImageFormat GetImageFormat(string path)
{
return Path.GetExtension(path).ToLowerInvariant() switch
{
".bmp" => ImageFormat.Bmp,
".gif" => ImageFormat.Gif,
".jpg" => ImageFormat.Jpeg,
".jpeg" => ImageFormat.Jpeg,
".png" => ImageFormat.Png,
_ => ImageFormat.Png
};
}
}
<system.webServer>
<handlers>
<add name="ImageWatermarkHandler" path="*.jpg;*.jpeg;*.png;*.gif;*.bmp" verb="GET"
type="ImageHandler" preCondition="integratedMode" />
</handlers>
</system.webServer>
或針對特定資料夾:path="/WatermarkedImages/*.jpg"。
<!-- 直接引用原圖路徑,Handler 自動攔截加浮水印 -->
<img src="/Images/Products/photo1.jpg" alt="產品圖" />
<!-- 若需原圖不加浮水印,可加查詢字串略過 -->
<img src="/Images/Products/photo1.jpg?nowm=1" alt="原圖" />
在 ProcessRequest 中檢查 context.Request.QueryString["nowm"] 若為 1 則直接 TransmitFile 原圖。
MemoryCache (Key: 檔案路徑+最後寫入時間+浮水印文字),避免重複 GDI+ 運算。IHttpAsyncHandler 或改用 ASP.NET Core Middleware。Cache.SetMaxAge、ETag,讓瀏覽器/CDN 快取結果。Font 物件建立昂貴,建議靜態唯讀單例。| 問題 | 原因 | 解決 |
|---|---|---|
| GIF 透明背景變黑 | 索引色無法直接 DrawString | 轉為 Format32bppArgb 再繪製 (程式碼已處理) |
| 中文顯示方塊 | 伺服器缺字型 | 安裝「微軟雅黑」或改用系統保有字型 (Arial Unicode MS) |
| CPU 飆高 | 大量並發即時繪圖 | 啟用記憶體快取、限制並發、考慮預先批次產生 |
| 浮水印位置錯誤 | 圖片 DPI 不同導致 Graphics 單位差異 | 使用 g.PageUnit = GraphicsUnit.Pixel 統一像素座標 |
private void DrawImageWatermark(Graphics g, Image watermarkImg, Image target)
{
float x = target.Width - watermarkImg.Width - 10;
float y = target.Height - watermarkImg.Height - 10;
// 設定透明度
ImageAttributes attr = new ImageAttributes();
ColorMatrix matrix = new ColorMatrix { Matrix33 = 0.5f }; // 50% 透明
attr.SetColorMatrix(matrix);
g.DrawImage(watermarkImg, new Rectangle((int)x, (int)y, watermarkImg.Width, watermarkImg.Height),
0, 0, watermarkImg.Width, watermarkImg.Height, GraphicsUnit.Pixel, attr);
}