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

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

Curtis Chau

更新:2025年6月1日

Translated

View the article in English

避免出現"System.Drawing.Common 在此平台上不受支援"的變通方法

在 Linux 和 macOS 平台上， .NET 6 和.NET 7 無法實作System.Drawing.Common 。
您將收到一則異常訊息，指示"此平台不支援 System.Drawing.Common"。
將.NET 6 的System.Drawing.EnableUnixSupport執行時期設定為true 。
請注意， .NET 7 也不再提供支援。
使用IronSoftware.Drawing開源程式庫來取代.NET 7 中的System.Drawing.Common 。

在.NET 6 和.NET 7 中，微軟已停止在 Linux 和 macOS 上支援System.Drawing.Common 。根據官方文檔，該程式庫僅適用於 Windows 平台。

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

System.TypeInitializationException : The type initializer for 'Gdip' threw an exception. --- System.PlatformNotSupportedException : System.Drawing.Common 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);

$vbLabelText $csharpLabel