萬盛學電腦網

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

C# 將文字檔內容轉存為圖片完整實作教學

需求背景

在系統開發中,有時需要將文字檔案或字串內容轉換成圖片格式儲存,例如產生驗證碼圖片、將日誌內容輸出為圖檔備份、或是製作含文字的報表圖片等。本文提供一個完整的 C# 實作範例,使用 System.Drawing 命名空間將文字內容繪製成 PNG 圖片。

呼叫方式

只需傳入來源文字檔路徑與目標圖片路徑即可:

ConvertTextFileToImage(Server.MapPath("~/Log.txt"), Server.MapPath("~/Log.png"));

核心實作程式碼

void ConvertTextFileToImage(String textFile, String imageFile)
{
    // 設定字型:新細明體,12 點大小
    System.Drawing.Font drawFont = new System.Drawing.Font("新細明體", 12);
    
    // 建立 1x1 像素的暫時點陣圖,用於量測文字尺寸
    System.Drawing.Bitmap image = new System.Drawing.Bitmap(1, 1);
    System.Drawing.Graphics g = System.Drawing.Graphics.FromImage(image);
    
    // 讀取文字檔內容(Big5 編碼)
    String text = System.IO.File.ReadAllText(textFile, Encoding.GetEncoding("Big5"));
    
    // 量測文字在指定寬度(1024 像素)下的實際大小
    System.Drawing.SizeF sf = g.MeasureString(text, drawFont, 1024);
    
    // 依量測結果建立正式尺寸的點陣圖
    image = new System.Drawing.Bitmap(image, new System.Drawing.Size(
        Convert.ToInt32(sf.Width), Convert.ToInt32(sf.Height)));
    g = System.Drawing.Graphics.FromImage(image);
    
    // 設定繪圖品質
    g.Clear(System.Drawing.Color.White); // 白色背景
    g.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit; // 反鋸齒
    
    // 繪製文字到圖片
    g.DrawString(text, drawFont, System.Drawing.Brushes.Black, 
        new System.Drawing.RectangleF(new System.Drawing.PointF(0, 0), sf));
    
    // 儲存為 PNG 格式
    image.Save(imageFile, System.Drawing.Imaging.ImageFormat.Png);
    
    // 釋放資源
    g.Dispose();
    image.Dispose();
}

關鍵技術點解析

1. 兩階段建立點陣圖

先建立 1x1 的暫時圖片量測文字實際寬高,再依量測結果建立正式尺寸的圖片,避免文字被截斷或留有過多空白。

2. 編碼處理

使用 Encoding.GetEncoding("Big5") 正確讀取繁體中文文字檔,防止亂碼。若來源檔案為 UTF-8,請改用 Encoding.UTF8。

3. 繪圖品質設定

  • TextRenderingHint.AntiAliasGridFit:啟用反鋸齒,文字邊緣更平滑
  • g.Clear(Color.White):設定白色背景,確保文字清晰可見

4. 記憶體管理

務必呼叫 Dispose() 釋放 Graphics 與 Bitmap 物件,避免 GDI+ 物件洩漏導致記憶體耗盡。

進階應用建議

  • 長文字換行:若內容極長,可加入換行邏輯,將文字分段繪製於多行
  • 自訂字型與顏色:可將字型、大小、顏色、背景色參數化,增加彈性
  • 非同步處理:大量轉檔時建議使用 Task.Run 移至背景執行緒,避免阻塞主執行緒
  • Linux 容器相容性:.NET Core / .NET 5+ 在 Linux 需安裝 libgdiplus 套件,或改用跨平台函式庫如 ImageSharp、SkiaSharp

完整範例下載

可參考 Microsoft 官方文件 Graphics.DrawString 方法 了解更多繪圖多載與參數選項。

copyright © 萬盛學電腦網 all rights reserved