MessagingToolkit 條碼庫與 IronBarcode 比較：C# 條碼庫比較

平台和維護記錄

MessagingToolkit.Barcode 的 NuGet 包元資料記錄了其預期目標。 下表中的每個條目都代表該庫開發時處於當前或接近當前狀態的平台：

該程式庫沒有與 .NET Core、.NET 5、.NET 6、.NET 7、.NET 8 或 .NET 9 相容的目標框架。面向這些運行時的專案在建置時會遇到失敗，因為該套件無法解析相容的框架名稱——這不是運行時警告，而是編譯錯誤。

詳細功能比較

MessagingToolkit.條碼方法

MessagingToolkit.Barcode 僅針對 .NET Framework 3.5、4.0 和 4.5。 它沒有 .NET Standard 的名稱，沒有 .NET Core 的目標，也沒有針對現代運行時的兼容性修補程式。 當專案檔案引用此套件並面向任何現代 .NET 版本時，NuGet 還原作業將失敗，並出現框架相容性錯誤—產生不會繼續。

NuGet 元資料中的平台表使這一點變得具體。 Silverlight 3、4 和 5 是列出的目標； 這三款系統均已於 2021 年停產。列出的系統包括 Windows Phone 7.0、7.5、7.8 和 8.0； 所有這些框架都在 2014 年至 2017 年間停止了支援。剩餘的目標框架——.NET Framework 3.5、4.0 和 4.5——在 Windows 上仍然具有技術功能，但微軟只會提供安全性補丁，不會進行任何新功能開發。

實際結果是，MessagingToolkit.Barcode 會阻礙框架現代化。 目標為 net472 且引用此套件的項目檔案不能在不先刪除該套件的情況下更改為 net8.0。 該軟體包不僅過時，而且還會主動阻止目標框架的更改，而這種更改本可以讓專案存取現代 .NET 功能。

請查閱IronBarcode 平台文檔，以取得支援的框架和部署目標的完整清單。

IronBarcode方法

IronBarcode 支援 .NET Framework 4.6.2 至 .NET 9，涵蓋傳統 Windows 應用程式和現代跨平台部署。 一個 NuGet 套件即可安裝在所有支援的平台上，無需單獨的圖形庫或特定於平台的配置。

跨平台支援在實務上意義重大。IronBarcode的內部鏡像管道不依賴 System.Drawing，後者在 .NET 6 中已僅限於 Windows。以 Linux 或 macOS 為導向的應用程式（包括執行在 Docker 容器、Linux 版 Azure 應用程式服務或 AWS Lambda 中的應用程式）使用與 Windows 部署相同的IronBarcodeAPI 和行為。

MessagingToolkit.條碼方法

使用 MessagingToolkit.Barcode 讀取資料需要建立一個 BarcodeDecoder 實例，從影像檔案建構一個 Bitmap，將位圖傳遞給 .Decode()，並在存取 @@--CODE-94043--CO 產生遵循相同的實例模式：建立一個 BarcodeEncoder，設定其 .Format 屬性，呼叫 .Encode() 以接收 Bitmap，然後對該位圖呼叫 @@-- 4000040。

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// Only compiles on .NET Framework 4.5 or earlier
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

Bitmap 依賴並非偶然。 System.Drawing.Bitmap 需要在 Windows 上安裝 GDI+。 在 .NET 6 及更高版本中，嘗試在 Linux 或 macOS 上使用 System.Drawing 會在運行時拋出 PlatformNotSupportedException 錯誤。即使 MessagingToolkit.Barcode 組件可以在現代 .NET 專案中載入（由於缺少框架目標，實際上無法載入），Bitmap 依賴項仍然會阻止跨平台部署。

IronBarcode方法

IronBarcode 全程使用靜態方法。 BarcodeReader.Read() 接受檔案路徑、Stream、位元組陣列或 PDF 檔案路徑－不需要 Bitmap。 結果是一個集合，而不是一個可為空的單一物件。 生成過程使用 BarcodeWriter.CreateBarcode()，並將編碼類型作為參數傳遞，結果物件直接公開保存方法。

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-KEY";

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

// Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-KEY";

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

' Works on .NET 6, 7, 8, 9 — Windows, Linux, macOS, Docker
IronBarCode.License.LicenseKey = "YOUR-KEY"

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

有關如何從圖像中讀取條碼的詳細指導，請參閱如何從圖像中讀取條碼。 若要產生包含 Code 128、EAN-13 和 UPC 格式在內的 1D 條碼，請參閱如何建立 1D 條碼。

MessagingToolkit.條碼方法

MessagingToolkit.Barcode 自 2014 年以來就沒有收到任何更新。此後發現的任何漏洞——無論是在庫本身的圖像解析邏輯中、在其 ZXing 衍生的解碼實現中，還是在其傳遞依賴項中——都將永久未修補。 沒有維護人員需要通知，沒有安全公告流程需要監控，即使開發出了修復程序，也沒有發布機制可以將修復程序傳遞給使用者。

安全掃描工具——Snyk、WhiteSource、GitHub Dependabot、NuGet audit——將廢棄的軟體包標記為高風險。 標記並不取決於是否已確認存在 CVE； 這反映出目前沒有任何程式可以修復已確認的漏洞。 這與擁有活躍維護者和完善的安全回應流程的程式庫的風險狀況截然不同。

對於在合規框架（PCI DSS、HIPAA、SOC 2、ISO 27001）下運作的團隊而言，這會產生實際的稽核後果。 這些框架需要對第三方軟體進行積極的修補程式管理。 如果一個廢棄的軟體包沒有漏洞回應機制，無論是否已針對該軟體包提交了特定的 CVE 編號，該軟體包都將無法通過合規性審計。 審計結果顯示不存在可維護的依賴關係，而不是存在已知的漏洞。

IronBarcode方法

IronBarcode 會定期收到 NuGet 更新，內容包含安全性修補程式、相依性更新和新功能。 該庫由 Iron Software 開發，該公司維護完善的支援流程，並為每次更新發布發行說明。 安全公告（如有）會在修補程式版本中解決。

IronBarcode 支援50 多種條碼格式，包括 MessagingToolkit.Barcode 處理的所有格式——QR 碼、Code 128、EAN-13、EAN-8、UPC-A 等——以及舊庫從未支援的格式：DataMatrix、Aztec、PDF417 和各種現代 2D 條碼。

框架現代化要求

最常見的觸發因素是計劃內或正在進行的 .NET 升級。 當團隊決定將專案從 .NET Framework 4.x 遷移到 .NET 6 或更高版本時，必須審核依賴關係圖，找出缺少現代框架支援的套件。 MessagingToolkit.Barcode 將在稽核中顯示為阻塞依賴項－無法針對現代目標框架名稱進行解析。 因此，遷移到IronBarcode是更廣泛的 .NET 升級的先決條件，而不是一項獨立的計劃。負責應用程式現代化改造的團隊通常會在升級分析階段早期發現這種依賴關係。

安全與合規義務

第二種情況涉及安全審查和合規性審計。 根據 PCI DSS、HIPAA、SOC 2 或 ISO 27001 框架運作的團隊會定期接受審核，以檢查第三方依賴項的健康狀況。 如果一個被遺棄的軟體包沒有安全回應機制，那麼無論是否已發現特定漏洞，該軟體包都會因流程問題而無法通過這些審計。 當安全團隊將 MessagingToolkit.Barcode 標記為不合規的依賴項時，解決方法是替換——沒有修補程式可以應用，沒有版本可以升級，也沒有供應商可以聯繫以獲取安全建議。 遷移到IronBarcode解決了審計發現的問題，方法是將沒有維護路徑的依賴項替換為定期接收安全性更新的依賴項。

能力擴展

第三種情況是，當新的需求超出 MessagingToolkit.Barcode 所能提供的範圍。 處理掃描文件或 PDF 文件的應用程式需要從這些格式中讀取條碼——MessagingToolkit.Barcode 只接受點陣圖輸入，因此如果沒有單獨的提取層，就無法讀取 PDF。 為網路交付產生條碼的應用程式需要 SVG 或 base64 輸出 — MessagingToolkit.Barcode 回傳了 Bitmap，需要額外的轉換步驟和 System.Drawing.Imaging 依賴項。 當產品需求擴展到這些領域時，舊函式庫的限制就變成了工程上的限制，無法透過其 API 介面來解決。

平台目標成長

第四種情況是增加新的部署目標。 最初建置僅限 Windows 應用程式的團隊，如果擴展到 Linux 託管、macOS 開發環境、Docker 容器或 Linux 運行時上的雲端函數，則會遇到 System.Drawing 依賴項此阻塞性問題。 MessagingToolkit.Barcode 需要 System.Drawing.Bitmap 來進行所有輸入和輸出操作，而 System.Drawing 僅適用於 .NET 6 及更高版本中的 Windows。 任何非 Windows 部署目標都會導致此相依性出現執行階段故障，而不僅僅是相容性問題。 遷移到IronBarcode完全消除了 System.Drawing 的要求，從而實現了團隊正在嘗試實現的跨平台部署。

命名空間替換

所有包含 using MessagingToolkit.Barcode; 的檔案都需要更新為 using IronBarCode;。 在程式碼庫範圍內搜尋舊命名空間字串是確定遷移範圍最可靠的起點。 如果導入 System.Drawing 只是為了 MessagingToolkit.Barcode 使用的 Bitmap 類型，那麼一旦IronBarcode就位，該導入就可以完全刪除，因為IronBarcode不需要它。

目標框架變更

從專案檔案中移除 MessagingToolkit.Barcode 可以更新目標框架別名。 一旦阻塞依賴項被移除，從 <TargetFramework>net472</TargetFramework> 到 <TargetFramework>net8.0</TargetFramework> 的變更就成為可能。IronBarcode支援此變更的兩個面向——它與 .NET Framework 4.6.2 和 .NET 8 相容——因此可以在框架升級完成之前安裝它，從而允許分階段遷移，而不是一步完成。

條碼寫入器命名空間差異

MessagingToolkit.Barcode 使用 BarcodeEncoder 作為生成類，並在呼叫 .Encode() 之前將格式設為屬性 (barcodeWriter.Format = BarcodeFormat.QrCode)。IronBarcode使用 BarcodeWriter.CreateBarcode() 作為靜態方法，並將編碼類型作為參數傳遞。 枚舉名稱有所不同：BarcodeFormat.QrCode 變為 BarcodeEncoding.QRCode，而 BarcodeFormat.Code128 變為 BarcodeEncoding.Code128。 CreateBarcode() 的結果是一個具有 .SaveAsPng()、.SaveAsJpeg()、.SaveAsSvg() 和其他輸出方法的流暢物件—它不傳回 @@--CODE-94105--@。