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

Name: IronOCR
Brand: Iron Software
Availability: InStock
Rating: 4.86 (101 reviews)

Curtis Chau

更新:2026年4月21日

Translated

View the article in English

解決"System.Drawing.Com/mon 在此平台上不受支援"問題的替代方案

在 Linux 和 macOS 平台上，無法為 .NET 6 和 .NET 7 實作 System.Drawing.Com/mon。
您將收到一則例外訊息，指出"System.Drawing.Com/mon 在此平台上不受支援。"
針對 .NET 6，將 System.Drawing.EnableUnixSupport 執行階段設定設為 true。
請注意，.NET 7 亦不再提供此功能支援。
使用 IronSoftware.Drawing 開源函式庫來取代 .NET 7 中的 System.Drawing.Com/mon。

在 .NET 6 和 .NET 7 中，Microsoft 已停止在 Linux 和 macOS 上支援 System.Drawing.Com/mon。根據官方文件所述，此函式庫僅適用於 Windows 平台。

在非 Windows 作業系統上，會拋出 TypeInitializationException 異常，並以 PlatformNotSupportedException 作為內部異常。
在 .NET 6 中，當針對非 Windows 作業系統編譯的程式碼引用 System.Drawing.Com/mon 時，平台分析器會發出編譯時警告。此外，除非設定了特定配置選項，否則會拋出以下執行時例外：

System.TypeInitializationException : The type initializer for 'Gdip' threw an exception. --- System.PlatformNotSupportedException : System.Drawing.Com/mon is not supported on non-Windows platforms.

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

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

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

請在程式碼開頭加入以下程式碼，以程式化方式啟用 Unix 支援：

// Enables Unix support for System.Drawing in .NET 6. This setting is ignored in .NET 7.
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

// Enables Unix support for System.Drawing in .NET 6. This setting is ignored in .NET 7.
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

' Enables Unix support for System.Drawing in .NET 6. This setting is ignored in .NET 7.
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)

$vbLabelText $csharpLabel