萬盛學電腦網

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

ASP.NET 上傳圖片並生成高品質縮略圖(含水印)完整實作

前言

圖片上傳與縮略圖生成是 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);

關鍵畫質設定解析

屬性推薦值影響
InterpolationModeHighQualityBicubic縮放插值算法,雙三次最平滑
SmoothingModeHighQuality向量圖形/文字邊緣平滑
CompositingQualityHighQuality合成品質(透明度混合)
PixelOffsetModeHighQuality像素偏移修正,減少鋸齒
Encoder.Quality85~95LJPEG 壓縮品質,平衡檔案大小與畫質

常見坑點與解決

  • GDI+ 一般性錯誤:Image.FromFile 鎖定檔案 → 改用 Image.FromStream 或複製到 MemoryStream。
  • 記憶體洩漏:Image、Bitmap、Graphics、Font、Brush 全部實作 IDisposable,**務必用 using 包裹**。
  • 權限問題:上傳目錄需給 IIS_IUSRS 寫入權限。
  • 大圖 OOM:超大圖(如 4000x3000 以上)建議分塊處理或使用 ImageSharp/SkiaSharp 替代 System.Drawing(跨平台、無 GDI+ 限制)。

現代化替代:ImageSharp / SkiaSharp

// 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+ 綁定與記憶體管理陷阱。

copyright © 萬盛學電腦網 all rights reserved