1. IronPDF
  2. 故障排除
  3. IronPDF - System.Drawing.Common 的替代方案

System.Drawing.Common 的替代方案（.NET 7 及非 Windows 環境）

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

自 .NET 6 起，Microsoft 已停止在 Linux 和 macOS 上支援 System.Drawing.Common。 此函式庫現僅支援 Windows 系統。 更多詳細資訊，請參閱官方文件。

解決"System.Drawing.Common 無法在此平台上使用"錯誤的替代方案

.NET 6

在非 Windows 作業系統上，會拋出 TypeInitializationException 異常，並以 PlatformNotSupportedException 作為內部異常。 平台分析器會針對非 Windows 平台發出編譯時警告。 除非您設定了配置選項，否則系統會拋出以下執行時例外：

System.TypeInitializationException：'Gdip' 的類型初始化程式拋出了例外。

    ---- System.PlatformNotSupportedException : System.Drawing.Common 在非 Windows 平台上不受支援。

.NET 6 中的臨時解決方案：

請在 runtimeconfig.json 檔案中，將 System.Drawing.EnableUnixSupport 執行階段設定開關設為 true，以啟用對非 Windows 平台的支援：

{
    "runtimeOptions": {
        "configProperties": {
            "System.Drawing.EnableUnixSupport": true
        }
    }
}

此外，請在程式碼開頭加入以下這行，以透過程式化方式啟用此設定：

// Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);
// Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);
' Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)
$vbLabelText   $csharpLabel

.NET 7 及以上版本

自 .NET 7 起，微軟已完全移除了 Linux 和 macOS 平台上對 System.Drawing.Common 的支援，包括先前可用的替代方案。

Iron Software 已發布一款名為 IronSoftware.Drawing 的 System.Drawing.Common 開源替代方案。

如需進一步了解，請參閱官方文件。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。