平台和維護記錄

MessagingToolkit.Barcode 的 NuGet 包元資料記錄了其預期目標。 下表中的每個條目代表在該程式庫開發時是現有或近現有的平台：

該程式庫對於 .NET Core、.NET 5、.NET 6、.NET 7、.NET 8 或 .NET 9 沒有相容的目標框架。在針對這些運行時的專案中，當包無法解析相容框架標識時，會遭遇構建時失敗 — 這不是運行時警告，而是編譯錯誤。

詳細特性比較

MessagingToolkit.Barcode 方法

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 上仍具有技術功能，但僅從 Microsoft 收到安全補丁，沒有新的功能開發。

實際的後果是 MessagingToolkit.Barcode 阻止了框架升級。 一個專案文件針對 net472 並引用該程式包後，不能將其更改為 net8.0，除非先解除程式包。 該包不僅僅是過時 — 缺乏現代目標框架標識會阻止目標框架更改，使專案能夠存取現代 .NET 功能。

探索 IronBarcode 平台文件 以獲取支援框架和部署目標的完整列表。

IronBarcode方法

IronBarcode 支援從 .NET Framework 4.6.2 至 .NET 9，涵蓋遺留的 Windows 應用程式和現代跨平台部署。 單個 NuGet 程式包安裝於所有支援的平台，無需單獨的圖形庫或平台特定配置。

在實踐美意義上，跨平台支持非常重要。IronBarcode 的內部圖像管道不依賴於 System.Drawing，該管道在 .NET 6 中變為僅限 Windows。將IronBarcodeAPI 和行為如同 Windows 部署一樣使用於針對 Linux 或 macOS 的應用程式 — 包括 Docker 容器、Linux 上的 Azure 應用服務或 AWS Lambda 上的應用程式。

MessagingToolkit.Barcode 方法

using MessagingToolkit.Barcode 閱讀需要建立 BarcodeDecoder 實例，從圖像文件構造 Bitmap，將位圖傳遞給 .Decode() 並在存取 .Text 之前檢查結果是否為空。 生成遵循相同的實例模式：建立一個 BarcodeEncoder，設置其 .Format 屬性，調用 .Encode() 接收 Bitmap，然後在該位圖上調用 .Save()。

// MessagingToolkit.Barcode — .NET Framework target frameworks
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");

// MessagingToolkit.Barcode — .NET Framework target frameworks
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。即使在現代 .NET 專案中可以載入 MessagingToolkit.Barcode 程式集 – 由於缺少框架目標，這是不可能的 – @ @--CODE-1624--@@ 的依賴將阻止跨平台部署。

IronBarcode方法

IronBarcode 全部使用靜態方法。 BarcodeReader.Read() 接受文件路徑、Stream、字節陣列或 PDF 文件路徑 — 不需要 Bitmap。 結果是集合，而不是可為空的單一物件。 Generation使用BarcodeWriter.CreateBarcode()，將編碼型別作為參數傳遞，並且結果物件直接暴露保存方法。

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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");

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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

IronBarCode.License.LicenseKey = "YOUR-LICENSE-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")

有關從圖像閱讀條碼的詳細指南，請參閱 如何從圖像閱讀條碼。 有關生成 1D 條碼（包括程式碼 128、EAN-13 和 UPC 格式）的詳細指南，請參閱 如何建立 1D 條碼。

MessagingToolkit.Barcode 方法

MessagingToolkit.Barcode 自 2013 年 4 月以來沒有收到更新。自該日期之後發現的任何漏洞 – 在程式庫自身的圖像解析邏輯中、在其 ZXing派生的解碼實現中，或在其間接依賴項中 – 都仍然未修補。 沒有可通知的公開維護者，沒有可監控的安全公告流程，也沒有通過修復機制將修復措施傳遞給使用者的機制，即使有開發。

安全掃描工具 — Snyk, WhiteSource, GitHub Dependabot, NuGet 審核 — 通常將不維護的程式包標示為風險升高。 標記不是依賴於確認的 CVE； 它反映了確認漏洞無法被補救的過程的缺失。 這與一個有活躍維護者和記錄的安全響應流程的程式庫有著截然不同的風險剖染。

對於運作於合規框架下的團隊 — PCI DSS, HIPAA, SOC 2, ISO 27001 — 這具有實際的審核後果。 這些框架預期第三方軟體的積極修補管理，且沒有安全響應機製的不維護包在審审核覧中通常會被標示，不論其是否有行針有已遞交的特定 CVE 。 發現與相依的維護狀態有關，而不是已知的 exploit 的存在與否。

IronBarcode方法

IronBarcode 定期收到 NuGet 更新，涵蓋安全補丁，相依更新和新功能。 Iron 軟體開發了該程式庫，並維持了記錄的支持流程，還對每次更新發布了發布說明。 發布了安全公告，如果適用，在補丁版本中解決。

IronBarcode 支持 超過 50 種條碼格式，包括 MessagingToolkit.Barcode 處理的所有格式 — QR Code、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 的承载能力出現時，會出現第三種狀況。 處理操作多幅圖像掃描及其程式碼文件的應用，需從這些格式能夠讀取條碼 – MessagingToolkit.Barcode 僅接受位圖輸入，無法從 PDF 讀取的問題，除非有獨立的提取層。 想要針對網頁生成條碼的應用，需要SVG或base64的輸出 — MessagingToolkit.Barcode 返回 Bitmap，需要附加的轉換步驟和 System.Drawing.Imaging 依賴。 當產品需求向這些方面擴展，較舊的庫的限制成為工程約束，不能在其API範圍內繞過。

平台目標成長

第四種情況是增加新的部署目標。 最初構建 Windows 專用應用程式並擴展到 Linux 託管、macOS 開發環境、Docker 容器或使用 Linux 運行時的雲功能的團隊遇到的@@--CODE-1654--dependency 作爲一個阻塞問題。 MessagingToolkit.Barcode 的所有輸入和輸出操作都需要System.Drawing.Bitmap，并且在 .NET6 和更高版本中，System.Drawing 僅限於 Windows。 任何不是 Windows 的部署目標都會使此依賴成爲運行時故障，而不僅僅是相容性問題。 向IronBarcode的遷移完全去除了@@--CODE-1657--依賴，使團隊試圖實現的跨平臺部署成爲可能。

命名空間更換

每個包含using IronBarCode;。 有效識別遷移範圍的最佳起點是對舊命名空間字串的程式碼庫範圍搜索。 專為使用 MessagingToolkit.Barcode 的 Bitmap 型別而導入 System.Drawing 的文件，一旦引入 IronBarcode，可能會完全刪除此導入，因為IronBarcode不需要它。

目標框架更改

從專案文件中移除 MessagingToolkit.Barcode 可啟用目標框架標識更新。 在去除阻塞的相依後，可以進行從 <TargetFramework>net472</TargetFramework> 到 <TargetFramework>net8.0</TargetFramework> 的更改。IronBarcode支持這個變更的兩面 — 它與 .NET Framework 4.6.2 和 .NET 8 相容 — 所以它可以在框架升級完成之前安裝，允許遷移是分步進行，而不是在單一步驟中完成。

BarcodeWriter 命名空間差異

MessagingToolkit.Barcode 使用 BarcodeEncoder 作為生成類，格式設置為屬性 (barcodeWriter.Format = BarcodeFormat.QrCode) 然後再調用 .Encode()。IronBarcode則使用 BarcodeWriter.CreateBarcode() 作為靜態方法，並將編碼型別作為參數傳遞。 枚舉的名字不同：BarcodeFormat.QrCode 變成 BarcodeEncoding.QRCode，而 BarcodeFormat.Code128 變成 BarcodeEncoding.Code128。 CreateBarcode() 的結果是具有 .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() 和其他輸出方法的通暢物件 — 它不返回 Bitmap。