萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 圖片處理核心技術:System.Drawing 命名空間完整實戰指南

核心命名空間

  • System.Drawing:基礎繪圖類別
  • System.Drawing.Imaging:進階影像格式、編碼器
  • System.Drawing.Drawing2D:漸層、筆刷、轉換、抗鋸齒
  • System.Drawing.Text:字體集合、PrivateFontCollection

場景一:動態生成驗證碼/水印圖片 (輸出至 Response)

<%@ Page Language="C#" ContentType="image/jpeg" %>
<%@ Import Namespace="System.Drawing" %>
<%@ Import Namespace="System.Drawing.Imaging" %>
<%@ Import Namespace="System.Drawing.Drawing2D" %>
<%
    Response.Clear();
    
    // 1. 建立畫布 (寬120, 高30, 24bit RGB)
    using (Bitmap bitmap = new Bitmap(120, 30, PixelFormat.Format24bppRgb))
    using (Graphics g = Graphics.FromImage(bitmap))
    {
        // 2. 背景漸層
        g.Clear(Color.White);
        g.SmoothingMode = SmoothingMode.AntiAlias;
        
        using (LinearGradientBrush brush = new LinearGradientBrush(
            new Point(0, 0), new Point(120, 30),
            Color.FromArgb(0, 0, 0, 0),      // 透明
            Color.FromArgb(255, 255, 255, 255))) // 白
        {
            g.FillRectangle(brush, 0, 0, 120, 30);
        }
        
        // 3. 繪製干擾線
        Random r = new Random();
        for (int i = 0; i < 10; i++)
        {
            g.DrawLine(Pens.LightGray, 
                r.Next(120), r.Next(30), r.Next(120), r.Next(30));
        }
        
        // 4. 繪製驗證碼文字
        string code = GenerateRandomCode(4); // 實作略
        using (Font font = new Font("Arial", 16, FontStyle.Bold))
        using (SolidBrush textBrush = new SolidBrush(Color.FromArgb(r.Next(100), r.Next(100), r.Next(100))))
        {
            g.DrawString(code, font, textBrush, 2, 2);
        }
        
        // 5. 輸出 JPEG
        bitmap.Save(Response.OutputStream, ImageFormat.Jpeg);
    }
    Response.End();
%>

場景二:讀取圖片、縮放、儲存 (縮圖生成)

public static void GenerateThumbnail(string sourcePath, string destPath, int maxWidth, int maxHeight, long quality = 85L)
{
    using (Image src = Image.FromFile(sourcePath))
    {
        // 計算縮放比例 (保持比例)
        double ratio = Math.Min((double)maxWidth / src.Width, (double)maxHeight / src.Height);
        if (ratio >= 1) { File.Copy(sourcePath, destPath, true); return; }
        
        int newW = (int)(src.Width * ratio);
        int newH = (int)(src.Height * ratio);
        
        using (Bitmap thumb = new Bitmap(newW, newH))
        using (Graphics g = Graphics.FromImage(thumb))
        {
            g.InterpolationMode = InterpolationMode.HighQualityBicubic; // 高質量插值
            g.SmoothingMode = SmoothingMode.HighQuality;
            g.CompositingQuality = CompositingQuality.HighQuality;
            g.DrawImage(src, 0, 0, newW, newH);
            
            // 設定 JPEG 品質
            ImageCodecInfo jpegCodec = GetEncoderInfo("image/jpeg");
            EncoderParameters eps = new EncoderParameters(1);
            eps.Param[0] = new EncoderParameter(Encoder.Quality, quality);
            thumb.Save(destPath, jpegCodec, eps);
        }
    }
}

static ImageCodecInfo GetEncoderInfo(string mimeType)
{
    return ImageCodecInfo.GetImageEncoders().FirstOrDefault(c => c.MimeType == mimeType);
}

場景三:圖片合成/水印 (文字/圖片水印)

public static void AddWatermark(string sourcePath, string destPath, string watermarkText, string fontName, int fontSize, Color color, float opacity, int margin)
{
    using (Image src = Image.FromFile(sourcePath))
    using (Bitmap bmp = new Bitmap(src.Width, src.Height, PixelFormat.Format32bppArgb))
    using (Graphics g = Graphics.FromImage(bmp))
    {
        g.DrawImage(src, 0, 0);
        
        using (Font font = new Font(fontName, fontSize, FontStyle.Bold))
        using (SolidBrush brush = new SolidBrush(Color.FromArgb((int)(opacity * 255), color)))
        {
            StringFormat sf = new StringFormat { Alignment = StringAlignment.Far, LineAlignment = StringAlignment.Far };
            RectangleF rect = new RectangleF(margin, margin, src.Width - margin * 2, src.Height - margin * 2);
            g.DrawString(watermarkText, font, brush, rect, sf);
        }
        
        // 保存 (保持原格式)
        ImageFormat fmt = src.RawFormat;
        bmp.Save(destPath, fmt);
    }
}

場景四:驗證碼儲存至 Session 驗證

<%-- Captcha.ashx --%>
<%@ WebHandler Language="C#" Class="CaptchaHandler" %>
using System; using System.Drawing; using System.Drawing.Imaging; using System.Web; using System.Web.SessionState;

public class CaptchaHandler : IHttpHandler, IRequiresSessionState
{
    public void ProcessRequest(HttpContext context)
    {
        context.Response.Clear();
        context.Response.ContentType = "image/jpeg";
        
        string code = GenerateCode(4);
        context.Session["CaptchaCode"] = code; // 儲存到 Session
        
        using (Bitmap bmp = new Bitmap(100, 36))
        using (Graphics g = Graphics.FromImage(bmp))
        {
            // ... 繪製邏輯同場景一 ...
            bmp.Save(context.Response.OutputStream, ImageFormat.Jpeg);
        }
    }
    
    string GenerateCode(int len) { /* 產生隨機字母數字 */ return "A1B2"; }
    public bool IsReusable => false;
}

前端驗證:

<img id="captchaImg" src="Captcha.ashx" onclick="this.src='Captcha.ashx?'+Math.random()" />
<input type="text" id="txtCaptcha" />
<button onclick="verify()">驗證</button>
<script>
function verify() {
    fetch('Verify.ashx?code=' + document.getElementById('txtCaptcha').value)
        .then(r => r.json()).then(d => alert(d.valid ? '正確' : '錯誤'));
}
</script>

⚠️ 關鍵限制與替代方案 (生產環境必讀)

限制影響解決方案
System.Drawing 依賴 GDI+Windows 專用,Linux/Docker 容器需安裝 libgdiplus (效能/穩定性差)遷移至 ImageSharp (跨平台、純 managed、效能優)
非執行緒安全靜態方法併發調用可能崩潰每請求新建實例、鎖定、或用 ImageSharp
記憶體洩漏風險未正確 Dispose 導致 GDI 物件洩漏嚴格 `using` 區塊、finalizer 保護
字體依賴伺服器需安裝對應字體嵌入字體檔 (PrivateFontCollection) 或用 Web 安全字體

現代替代:ImageSharp (強烈推薦)

// NuGet: Install-Package SixLabors.ImageSharp
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;

public void ResizeWithImageSharp(string input, string output, int w, int h)
{
    using (var img = Image.Load(input))
    {
        img.Mutate(x => x.Resize(new ResizeOptions {
            Size = new Size(w, h),
            Mode = ResizeMode.Max, // 保持比例
            Sampler = KnownResamplers.Lanczos3
        }));
        img.Save(output, new JpegEncoder { Quality = 85 });
    }
}

優點:跨平台、無非託管依賴、執行緒安全、API 現代、效能優異、活躍維護。

System.Drawing 是 ASP.NET 經典圖片處理基石,理解其 API 設計有助於遷移至現代跨平台函式庫。新專案**首選 ImageSharp**,舊專案維護時嚴守 Dispose 模式與併發安全。

copyright © 萬盛學電腦網 all rights reserved