NetBarcode 與 IronBarcode：C# 條碼庫對比

枚舉類型設計邊界

Type 枚舉是 NetBarcode 可以產生的權威清單。 檢查它可知該函式庫的範圍：

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

// NetBarcode Type enum — complete list as of v1.8
public enum Type
{
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39Extended,
    Code93,
    EAN8,
    EAN13,
    UPCA,
    UPCE,
    Codabar,
    ITF,
    MSI
}

// These entries do not exist — attempting to use them produces a CS0117 compile error:
// Type.QRCode      — does not exist
// Type.DataMatrix  — does not exist
// Type.PDF417      — does not exist
// Type.Aztec       — does not exist

Public Enum Type
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39Extended
    Code93
    EAN8
    EAN13
    UPCA
    UPCE
    Codabar
    ITF
    MSI
End Enum

' These entries do not exist — attempting to use them produces a BC30456 compile error:
' Type.QRCode      — does not exist
' Type.DataMatrix  — does not exist
' Type.PDF417      — does not exist
' Type.Aztec       — does not exist

這並非一個等待提交 pull request 的缺失功能。枚舉類型包含十四個條目，全部為一維類型，這符合庫的預期範圍。 任何需要 QR 碼、DataMatrix、PDF417 或 阿茲特克 格式的應用程式都必須單獨取得相應的軟體包。

詳細功能比較

NetBarcode 方法

NetBarcode 透過 Type 枚舉提供 14 種線性條碼格式。 在這個範圍內，格式選擇很簡單－將對應的枚舉成員傳遞給建構函式即可。 界線同樣清晰：嘗試使用枚舉範圍以外的格式會產生編譯時錯誤。

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

// NetBarcode — formats that compile and produce output
using NetBarcode;

var code128 = new Barcode("12345678901234", Type.Code128);
code128.SaveImageFile("shipping.png");

var ean13 = new Barcode("5901234123457", Type.EAN13);
ean13.SaveImageFile("product.png");

// NetBarcode — formats that produce CS0117 compile errors
// var qr     = new Barcode("data", Type.QRCode);     // error CS0117
// var dm     = new Barcode("data", Type.DataMatrix);  // error CS0117
// var p417   = new Barcode("data", Type.PDF417);      // error CS0117
// var aztec  = new Barcode("data", Type.Aztec);       // error CS0117

Imports NetBarcode

Dim code128 As New Barcode("12345678901234", Type.Code128)
code128.SaveImageFile("shipping.png")

Dim ean13 As New Barcode("5901234123457", Type.EAN13)
ean13.SaveImageFile("product.png")

' NetBarcode — formats that produce CS0117 compile errors
' Dim qr As New Barcode("data", Type.QRCode)     ' error CS0117
' Dim dm As New Barcode("data", Type.DataMatrix) ' error CS0117
' Dim p417 As New Barcode("data", Type.PDF417)   ' error CS0117
' Dim aztec As New Barcode("data", Type.Aztec)   ' error CS0117

在某些行業，這種邊界會成為一種限制，例如藥品追蹤（根據 FDA 2D 條碼規定需要使用 DataMatrix）、航空公司登機證（Aztec）、物流清單（PDF417）和行動行銷（二維碼）。 這些要求都使得 NetBarcode 無法作為獨立解決方案使用。

IronBarcode。 方法

IronBarcode 以相同的 BarcodeWriter.CreateBarcode 方法公開所有支援的格式。 從 1D 格式過渡到 2D 格式時，API 介面不會改變－只有 BarcodeEncoding 常數有所不同。

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

using IronBarCode;

// 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("shipping.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product.png");

// 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .SaveAsPng("qr.png");

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-label.png");

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec)
    .SaveAsPng("boarding-pass.png");

Imports IronBarCode

' 1D formats — identical API to the 2D examples below
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product.png")

' 2D formats — same method, different encoding constant
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .SaveAsPng("qr.png")

BarcodeWriter.CreateBarcode("01034531200000111719112510ABCD1234", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-label.png")

BarcodeWriter.CreateBarcode("M1DOE/JOHN MR ABC123 JFKLHR 0012 123Y015A0001 100", BarcodeEncoding.Aztec) _
    .SaveAsPng("boarding-pass.png")

支援的常數完整清單可在支援的條碼格式參考中找到，涵蓋所有二維條碼產生格式以及完整的 1D 條碼集。

NetBarcode 方法

NetBarcode 的生成模型是基於建構函式的。 使用資料字串和枚舉值實例化一個 Barcode 物件。 輸出可以直接儲存為 SaveImageFile()，也可以透過 GetImage() 以 Image<Rgba32> 的形式檢索。 自 1.8 版本起，GetImage() 的傳回類型為 SixLabors.ImageSharp 類型，這表示任何儲存或處理傳回值的程式碼都必須匯入 ImageSharp API 並在其中執行。

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

using NetBarcode;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Constructor-based creation
var barcode = new Barcode("12345678901234", Type.Code128);

// Save to file — straightforward
barcode.SaveImageFile("code128.png");

// GetImage() returns Image<Rgba32> — ImageSharp import required
Image<Rgba32> image = barcode.GetImage();

// Further processing requires familiarity with the ImageSharp API
using var stream = new MemoryStream();
image.SaveAsPng(stream);
byte[] bytes = stream.ToArray();

Imports NetBarcode
Imports SixLabors.ImageSharp
Imports SixLabors.ImageSharp.PixelFormats
Imports System.IO

' Constructor-based creation
Dim barcode As New Barcode("12345678901234", Type.Code128)

' Save to file — straightforward
barcode.SaveImageFile("code128.png")

' GetImage() returns Image(Of Rgba32) — ImageSharp import required
Dim image As Image(Of Rgba32) = barcode.GetImage()

' Further processing requires familiarity with the ImageSharp API
Using stream As New MemoryStream()
    image.SaveAsPng(stream)
    Dim bytes As Byte() = stream.ToArray()
End Using

GetImage() 方法的傳回類型將下游程式碼與 ImageSharp 函式庫關聯起來。 任何接受或儲存結果的方法都必須將其聲明為 Image<Rgba32>，從而向呼叫程式碼引入傳遞依賴。

IronBarcode。 方法

IronBarcode 使用流暢的鍊式架構。 BarcodeWriter.CreateBarcode 傳回一個 GeneratedBarcode 對象，該物件包含多個輸出方法。 影像處理是內部的－不會向呼叫程式碼公開 ImageSharp 類型。

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

using IronBarCode;

// Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
    .SaveAsPng("code128.png");

// Multiple output options on the same GeneratedBarcode object
var barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128);
barcode.SaveAsPng("code128.png");
barcode.SaveAsJpeg("code128.jpg");
byte[] bytes = barcode.ToPngBinaryData();

using var stream = new MemoryStream();
barcode.SaveAsPng(stream);

Imports IronBarCode

' Fluent generation — save directly to file
BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128) _
    .SaveAsPng("code128.png")

' Multiple output options on the same GeneratedBarcode object
Dim barcode = BarcodeWriter.CreateBarcode("12345678901234", BarcodeEncoding.Code128)
barcode.SaveAsPng("code128.png")
barcode.SaveAsJpeg("code128.jpg")
Dim bytes As Byte() = barcode.ToPngBinaryData()

Using stream As New MemoryStream()
    barcode.SaveAsPng(stream)
End Using

IronBarcode 文件中詳細介紹了1D 條碼產生的選項，包括寬度、高度和標籤配置。

NetBarcode 方法

NetBarcode沒有讀取API。 目前沒有任何方法、類別或配置可以將條碼圖像解碼回其資料字串。 這是有意設定的範圍界限，並非在發布前故意省略的內容。 使用 NetBarcode 產生條碼，之後需要讀取條碼的項目（例如驗證列印標籤、掃描退貨或從供應商發票中提取數值）必須為此目的引入單獨的庫。

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

// NetBarcode — no reading method exists
// The following does not compile because the method does not exist:
// var result = barcode.Read("image.png");  // method does not exist

// The typical workaround requires ZXing.Net as a third-party dependency

' NetBarcode — no reading method exists
' The following does not compile because the method does not exist:
' Dim result = barcode.Read("image.png")  ' method does not exist

' The typical workaround requires ZXing.Net as a third-party dependency

ZXing.Net 函式庫是與 NetBarcode 一起讀取時最常見的附加元件，它帶來了第三個 API 介面和第三個軟體包，需要與 NetBarcode 和任何已新增的二維碼庫一起進行版本管理。

IronBarcode。 方法

IronBarcode 將 BarcodeReader 包含在與 BarcodeWriter 相同的軟體包中。 讀取 API 接受圖像文件和 PDF 文檔，並返回一組解碼結果，每個結果都包含條碼值、格式類型和頁碼（如果是從 PDF 讀取）。

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

using IronBarCode;

// Read barcodes from an image file
var imageResults = BarcodeReader.Read("shipping-label.png");
foreach (var r in imageResults)
{
    Console.WriteLine($"{r.BarcodeType}: {r.Value}");
}

// Read barcodes from a PDF document — no additional library required
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var r in pdfResults)
{
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}");
}

Imports IronBarCode

' Read barcodes from an image file
Dim imageResults = BarcodeReader.Read("shipping-label.png")
For Each r In imageResults
    Console.WriteLine($"{r.BarcodeType}: {r.Value}")
Next

' Read barcodes from a PDF document — no additional library required
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each r In pdfResults
    Console.WriteLine($"Page {r.PageNumber}: {r.Value}")
Next

從影像讀取條碼指南涵蓋了讀取 API 中提供的速度調整、多條碼偵測和影像校正選項。

NetBarcode 和 ImageSharp

NetBarcode 採用 和 許可證。 它所依賴的 SixLabors.ImageSharp 庫採用不同的模式：對於開源專案和年總收入低於規定門檻的公司是免費的，但超過該門檻則需要商業許可。 無論 ImageSharp 是否在專案的 .csproj 中明確列出，還是透過 NetBarcode 傳遞過來，此拆分均適用。

<PackageReference Include="NetBarcode" Version="1.8.2" />

<PackageReference Include="NetBarcode" Version="1.8.2" />

對於大規模處理條碼的零售或物流公司（NetBarcode 的主要目標用例）而言，其年收入通常高於 ImageSharp 商業許可適用的門檻。 合規性審計可能會揭示出軟體包樹中蘊含的這項義務。

v1.8 版本引入了 ImageSharp 依賴項的另一個後果：GetImage() 的回傳類型從內部表示變為 SixLabors.ImageSharp.Image<Rgba32>。 現有程式碼在沒有明確類型的情況下呼叫 GetImage()，導致編譯時出錯，因此需要為 SixLabors.ImageSharp 和 SixLabors.ImageSharp.PixelFormats 新增新的 using 指令。 當 ImageSharp 本身的 API 在未來的版本中持續發展時，NetBarcode 的公共 API 介面也會受到影響。

IronBarcode。

IronBarcode 不依賴 SixLabors.ImageSharp。 其授權條款直接在IronBarcode 授權頁面上列明，沒有拆分門檻或傳遞商業義務。 提供試用金鑰供評估； 購買的許可證可以移除生成輸出中的試用浮水印。

二維碼和二維格式要求

評估 NetBarcode 替代方案最常見的觸發因素是對二維碼的新需求。 最初為零售標籤或貨運清單產生一維條碼的應用，通常會有後續需求產生二維碼——非接觸式連結、行動應用深度連結、行銷活動。 因為 Type 枚舉沒有 QR 條目，所以 NetBarcode 無法滿足此要求。 如果團隊添加單獨的 QR 庫來彌補差距，那麼在製藥整合需要 數據矩陣 或物流承運商要求在運輸標籤上使用 PDF417 時，他們將面臨第二次評估。

條碼讀取變得不可或缺

有些項目從純粹的生成開始，後來又增加了驗證或文件處理要求：確認列印的條碼與其來源資料匹配，從供應商發票中提取條碼值，或掃描退貨標籤。 NetBarcode 沒有提供此路徑。 增加 ZXing.Net 或類似的讀取庫，就意味著需要在同一個程式碼庫中學習和維護第三個 API，而該程式碼庫已經包含了 NetBarcode 和 QR 庫。 即使在未來的階段，如果專案需要滿足閱讀需求，那麼選擇一個從一開始就能解決這兩個問題的圖書館通常會更有效率。

ImageSharp商業許可審核

對第三方依賴項的法律和合規性審查有時會發現 NetBarcode 軟體包樹中嵌入的 SixLabors.ImageSharp 商業許可條件。 對於年總收入超過門檻的公司，無論 ImageSharp 是有意選擇還是透過 NetBarcode 間接取得，都適用該義務。 如果團隊在審計過程中（而不是在採用之前）發現這個問題，則需要進行追溯性補救，而不是計劃性遷移。 在專案啟動前評估依賴項許可證是更明智的做法。

降低多庫複雜性

已經累積了用於生成一維條碼的 NetBarcode、用於二維輸出的 QR 專用庫以及用於讀取的 ZXing.Net 的團隊發現，他們需要在三個不同的軟體包之間保持版本相容性。 每次升級週期都需要檢查這三個庫是否對其共享的 ImageSharp 版本達成一致。 專案中的每個新開發人員都會遇到三個不同的 API，而這些 API 在概念上都是同一個問題。 將條碼庫整合為單一的條碼庫，可以簡化上線流程，減少版本衝突，並將維護工作集中在一個發布週期內。

包交換和傳遞依賴清理

第一步是移除 NetBarcode（dotnet remove package NetBarcode）。如果專案中的其他套件也間接引入了 SixLabors.ImageSharp 套件，那麼它可能會重新出現在依賴關係樹中。 刪除後，使用 dotnet list package --include-transitive 檢查恢復的軟體包列表，以確認 ImageSharp 是否仍然存在，以及其商業許可條件是否仍然適用。

GetImage() 傳回類型替換

任何將 GetImage() 的結果儲存為 Image<Rgba32> 的程式碼都必須更新。 ImageSharp 類型在IronBarcode中沒有直接對應的類型； 替換方式取決於影像在下游的用途。 將影像儲存到流中的程式碼可以直接替換為 .SaveAsPng(stream) 物件上的 GeneratedBarcode 物件。 檢索原始位元組的程式碼可以使用 .ToPngBinaryData()。 對傳回的影像執行進一步 ImageSharp 操作的程式碼需要單獨評估這些操作。

命名空間更新

導入了 using NetBarcode;、using SixLabors.ImageSharp;、using SixLabors.ImageSharp.PixelFormats; 或 using SixLabors.Fonts; 的檔案需要將這些指令替換為 using IronBarCode;。 在專案範圍內搜尋這些 using 語句，可以識別出在嘗試建置之前需要注意的每個檔案。