圖片上傳與縮略圖生成是 Web 系統基礎功能。本文提供完整實作:檔案驗證、唯一檔名、等比例縮放、高品質插值、文字/圖片水印、資源正確釋放,並解析關鍵 Graphics 設定對畫質的影響。
<form id="form1" runat="server" enctype="multipart/form-data">
<asp:FileUpload ID="UploadImage" runat="server" />
<asp:TextBox ID="txtWidth" runat="server" Text="200" /> 寬
<asp:TextBox ID="txtHeight" runat="server" Text="200" /> 高
<asp:TextBox ID="txtWatermark" runat="server" Text="Copyright © 2024" /> 浮水印文字
<asp:Button ID="btnUpload" runat="server" Text="上傳並產生縮略圖" OnClick="btnUpload_Click" />
</form>
using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;
using System.Web;
protected void btnUpload_Click(object sender, EventArgs e)
{
var postedFile = UploadImage.PostedFile;
if (postedFile.ContentLength == 0)
{ ShowMsg("請選擇圖片"); return; }
// 1. 驗證檔案類型
string[] allowedTypes = { "image/jpeg", "image/png", "image/gif", "image/bmp" };
if (!allowedTypes.Contains(postedFile.ContentType))
{ ShowMsg("僅允許 JPG/PNG/GIF/BMP"); return; }
// 2. 產生唯一檔名(時間戳 + GUID + 原副檔名)
string ext = Path.GetExtension(postedFile.FileName).ToLower();
string fileName = $"{DateTime.Now:yyyyMMddHHmmss}_{Guid.NewGuid():N}{ext}";
string uploadDir = Server.MapPath("~/Uploads/");
string thumbDir = Server.MapPath("~/Uploads/Thumbs/");
Directory.CreateDirectory(uploadDir);
Directory.CreateDirectory(thumbDir);
string originalPath = Path.Combine(uploadDir, fileName);
string thumbPath = Path.Combine(thumbDir, $"thumb_{fileName}");
try
{
// 3. 儲存原圖
postedFile.SaveAs(originalPath);
// 4. 產生縮略圖
GenerateThumbnail(originalPath, thumbPath,
int.Parse(txtWidth.Text), int.Parse(txtHeight.Text),
txtWatermark.Text);
ShowMsg($"上傳成功!
原圖: {fileName}
縮略圖: thumb_{fileName}");
}
catch (Exception ex)
{
ShowMsg($"失敗: {ex.Message}");
// 失敗時清理已上傳檔案
if (File.Exists(originalPath)) File.Delete(originalPath);
}
}
private void GenerateThumbnail(string sourcePath, string destPath,
int maxWidth, int maxHeight, string watermarkText)
{
using (var srcImage = Image.FromFile(sourcePath))
{
// 計算等比例縮放尺寸
double ratioX = (double)maxWidth / srcImage.Width;
double ratioY = (double)maxHeight / srcImage.Height;
double ratio = Math.Min(ratioX, ratioY); // 等比例,完整顯示
int newWidth = (int)(srcImage.Width * ratio);
int newHeight = (int)(srcImage.Height * ratio);
// 建立目標位圖
using (var bitmap = new Bitmap(newWidth, newHeight))
using (var g = Graphics.FromImage(bitmap))
{
// === 關鍵高品質設定 ===
g.InterpolationMode = InterpolationMode.HighQualityBicubic; // 雙三次插值
g.SmoothingMode = SmoothingMode.HighQuality;
g.CompositingQuality = CompositingQuality.HighQuality;
g.PixelOffsetMode = PixelOffsetMode.HighQuality;
g.Clear(Color.White); // 白色背景(JPG 無透明通道)
// 繪製縮放後圖片
g.DrawImage(srcImage,
new Rectangle(0, 0, newWidth, newHeight),
new Rectangle(0, 0, srcImage.Width, srcImage.Height),
GraphicsUnit.Pixel);
// === 文字水印 ===
if (!string.IsNullOrEmpty(watermarkText))
{
using (var font = new Font("微軟正黑體", 12, FontStyle.Bold))
using (var brush = new SolidBrush(Color.FromArgb(128, 0, 0, 0))) // 半透明黑
using (var sf = new StringFormat { Alignment = StringAlignment.Far, LineAlignment = StringAlignment.Far })
{
// 右下角留 10px 邊距
g.DrawString(watermarkText, font, brush,
new RectangleF(0, 0, newWidth - 10, newHeight - 10), sf);
}
}
// === 圖片水印(可選)===
// using (var mark = Image.FromFile(Server.MapPath("~/watermark.png")))
// g.DrawImage(mark, newWidth - mark.Width - 10, newHeight - mark.Height - 10);
// 儲存為 JPEG(品質 90%)
var encoderParams = new EncoderParameters(1);
encoderParams.Param[0] = new EncoderParameter(Encoder.Quality, 90L);
var jpegCodec = GetEncoderInfo("image/jpeg");
bitmap.Save(destPath, jpegCodec, encoderParams);
}
}
}
private ImageCodecInfo GetEncoderInfo(string mimeType)
{
return ImageCodecInfo.GetImageEncoders()
.FirstOrDefault(c => c.MimeType == mimeType);
}
private void ShowMsg(string msg) => ClientScript.RegisterStartupScript(GetType(), "msg", $"alert('{msg}');", true);
| 屬性 | 推薦值 | 影響 |
|---|---|---|
| InterpolationMode | HighQualityBicubic | 縮放插值算法,雙三次最平滑 |
| SmoothingMode | HighQuality | 向量圖形/文字邊緣平滑 |
| CompositingQuality | HighQuality | 合成品質(透明度混合) |
| PixelOffsetMode | HighQuality | 像素偏移修正,減少鋸齒 |
| Encoder.Quality | 85~95L | JPEG 壓縮品質,平衡檔案大小與畫質 |
Image.FromFile 鎖定檔案 → 改用 Image.FromStream 或複製到 MemoryStream。Image、Bitmap、Graphics、Font、Brush 全部實作 IDisposable,**務必用 using 包裹**。// SixLabors.ImageSharp (全純 managed,跨平台)
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;
using (var img = Image.Load(sourcePath))
{
img.Mutate(x => x.Resize(new ResizeOptions
{
Mode = ResizeMode.Max,
Size = new Size(maxWidth, maxHeight)
}));
// 水印...
img.Save(destPath, new JpegEncoder { Quality = 90 });
}
掌握 Graphics 高品質設定、等比例縮放邏輯、水印繪製與資源釋放,即可建構穩健的圖片處理管線。新專案強烈建議改用 ImageSharp 或 SkiaSharp,徹底擺脫 System.Drawing 的 Windows/GDI+ 綁定與記憶體管理陷阱。