ASP.NET 內建 `System.Drawing` (GDI+ 封裝) 提供強大的伺服器端圖形處理能力,無需第三方元件即可動態生成驗證碼、圖表、水印、縮圖。本文以 VB.NET 為例,示範核心類別與完整實戰流程。
核心命名空間
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.Drawing.Drawing2D
Imports System.Drawing.Text
基本流程:建立 Bitmap → Graphics → 繪圖 → 輸出串流
<%@ Page Language="VB" ContentType="image/jpeg" %><%
' 1. 清空回應,避免混入 HTML
Response.Clear()
Response.ContentType = "image/jpeg"
' 2. 建立畫布 (寬 120, 高 30, 24-bit RGB)
Dim img As New Bitmap(120, 30, PixelFormat.Format24bppRgb)
Dim g As Graphics = Graphics.FromImage(img)
' 3. 高品質繪圖設定
g.SmoothingMode = SmoothingMode.AntiAlias
g.TextRenderingHint = TextRenderingHint.AntiAliasGridFit
g.InterpolationMode = InterpolationMode.HighQualityBicubic
' 4. 漸層背景
Dim rect As New Rectangle(0, 0, 120, 30)
Dim brush As New LinearGradientBrush(rect, Color.LightBlue, Color.White, LinearGradientMode.Horizontal)
g.FillRectangle(brush, rect)
' 5. 繪製文字
Dim font As New Font("Arial", 14, FontStyle.Bold)
Dim sf As New StringFormat() With {.Alignment = StringAlignment.Center, .LineAlignment = StringAlignment.Center}
g.DrawString("ASP.NET", font, Brushes.DarkBlue, rect, sf)
' 6. 雜訊線 (驗證碼用)
Dim rnd As New Random()
For i As Integer = 0 To 5
g.DrawLine(Pens.Gray, rnd.Next(0, 120), rnd.Next(0, 30), rnd.Next(0, 120), rnd.Next(0, 30))
Next
' 7. 輸出到 Response.OutputStream (不落地)
img.Save(Response.OutputStream, ImageFormat.Jpeg)
' 8. 釋放非託管資源
g.Dispose()
img.Dispose()
brush.Dispose()
font.Dispose()
sf.Dispose()
Response.End()
%>
前端引用
<img src="captcha.aspx" alt="驗證碼" onclick="this.src='captcha.aspx?'+Math.random()" />
常見應用場景與關鍵代碼片段
1. 縮圖生成 (保持比例、高品質)
Public Function MakeThumbnail(srcPath As String, maxW As Int32, maxH As Int32) As Bitmap
Using src As Image = Image.FromFile(srcPath)
Dim ratio = Math.Min(maxW / src.Width, maxH / src.Height)
Dim nw = CInt(src.Width * ratio), nh = CInt(src.Height * ratio)
Dim thumb As New Bitmap(nw, nh)
Using g = Graphics.FromImage(thumb)
g.InterpolationMode = InterpolationMode.HighQualityBicubic
g.DrawImage(src, 0, 0, nw, nh)
End Using
Return thumb
End Using
End Function
2. 文字/圖片水印
Public Sub AddWatermark(target As Image, waterText As String, font As Font, color As Color, opacity As Single, position As ContentAlignment)
Using g = Graphics.FromImage(target)
Dim sz = g.MeasureString(waterText, font)
Dim x, y As Single
Select Case position
Case ContentAlignment.BottomRight : x = target.Width - sz.Width - 10 : y = target.Height - sz.Height - 10
Case ContentAlignment.Center : x = (target.Width - sz.Width) / 2 : y = (target.Height - sz.Height) / 2
' ... 其他位置
End Select
Dim brush As New SolidBrush(Color.FromArgb(CInt(opacity * 255), color))
g.DrawString(waterText, font, brush, x, y)
End Using
End Sub
3. 長條圖/圓餅圖 (簡易手繪)
' 長條圖範例
Dim values() As Integer = {120, 80, 200, 150, 90}
Dim maxVal = values.Max()
Dim barW = 40, gap = 15
For i = 0 To values.Length - 1
Dim h = CInt(values(i) / maxVal * 200)
g.FillRectangle(Brushes.SteelBlue, i * (barW + gap) + 20, 250 - h, barW, h)
g.DrawString(values(i).ToString(), New Font("Arial", 8), Brushes.Black, i * (barW + gap) + 20, 245 - h)
Next
⚠️ 關鍵坑點與最佳實務
| 問題 | 原因 | 解決方案 |
| GDI+ 一般性錯誤 | Bitmap/Font/Brush 未 Dispose、或在非 STA 執行緒使用 | 全面使用 `Using` 區塊;ASP.NET 預設 STA,但非同步/背景執行緒需 `[STAThread]` |
| 伺服器記憶體暴增 | 大量併發生成大圖、未釋放、未限制尺寸 | 限制最大輸出像素 (如 2000x2000);使用 `MemoryStream` 落地快取;考慮 ImageSharp/SkiaSharp 替代 |
| 字型缺失/顯示方塊 | 伺服器未安裝指定字型 | 安裝字型或嵌入 .ttf (PrivateFontCollection.AddFontFile) |
| 色彩失真 (CMYK/透明) | JPEG 不支援透明、GDI+ 預設 sRGB | 透明需用 PNG;專業列印請用專業色彩管理庫 |
| Linux/Docker 部署失敗 | `System.Drawing` 依賴 libgdiplus,跨平台相容性差 | **新專案強烈建議改用 ImageSharp / SkiaSharp / Magick.NET** (全托管/跨平台) |
現代化替代方案對比
| 庫 | 平台 | 相依性 | 效能 | 功能 | 推薦度 |
| System.Drawing | Windows (libgdiplus on Linux) | 原生 GDI+ | 中 | 基礎 | ⭐⭐ (僅維舊專案) |
| ImageSharp | 跨平台 (全托管) | 無 | 高 | 豐富 | ⭐⭐⭐⭐⭐ |
| SkiaSharp | 跨平台 (Skia 原生) | Native lib | 極高 | 極豐富 | ⭐⭐⭐⭐⭐ |
| Magick.NET | 跨平台 | ImageMagick | 高 | 最完整 | ⭐⭐⭐⭐ |
結語:`System.Drawing` 是 ASP.NET 經典利器,但在 .NET Core / Linux 容器化時代已非首選。維護舊專案請做好資源釋放與記憶體限制;新專務請直接採用 ImageSharp 或 SkiaSharp,獲得跨平台、高效能、無 GDI+ 依賴的優勢。