Barcoder 與 IronBarcode：C# 條碼庫對比

多包生成工作流程

安裝過程立刻就能說明範圍上的差異。 使用 條碼 時，基本的 PNG 輸出需要兩個單獨的軟體包：

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

產生 Code128 條碼並將其儲存為 PNG 格式的完整工作流程需要三個命名空間匯入、一個特定格式的編碼器呼叫、一個帶有選項物件的渲染器建構、一個檔案流和一個渲染呼叫：

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

切換條碼格式不是參數變更－它需要匯入不同的命名空間並呼叫不同的類別。 Code128Encoder.Encode 接受一個布林值，includeChecksum，QrEncoder.Encode 接受一個糾錯層級和兩個附加的布林值，而 DataMatrixEncoder.Encode 只接受一個字串。 目前還沒有統一的介面來創建指定格式的條碼。

詳細功能比較

條碼法

條碼器透過不同命名空間中的不同編碼器類別來選擇格式。 切換格式意味著新增一個新的 using 指令，並使用具有不同方法簽名的不同類別：

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

每個編碼器都有自己的參數合約。 在現有專案中新增格式並非簡單的文字變更－它需要匯入新的命名空間、學習新的類別並理解新的參數。

IronBarcode方法

IronBarcode 以統一的 BarcodeWriter 類別上的 BarcodeEncoding 枚舉路由所有格式選擇。 新增格式只需對枚舉值進行一個單字的變更：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

生產環境使用時，請在應用程式啟動時新增許可證密鑰：

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcode 條碼產生文件涵蓋了所有產生選項，包括樣式、邊距和顏色自訂。

條碼法

Barcoder 將編碼與渲染分離的架構理念是合理的，但每次輸出格式變更都會產生額外的開銷。 儲存到檔案需要開啟 FileStream。 取得二進位資料需要開啟一個 MemoryStream 並呼叫 ToArray()。 每種輸出場景都需要建立一個帶有選項物件的渲染器：

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

尺寸控制是間接的：PixelSize 是條碼模組尺寸的縮放倍數，而不是直接的寬度和高度規格。

IronBarcode方法

IronBarcode 傳回一個 GeneratedBarcode 對象，可以透過鍊式方法呼叫存取任何輸出形式。 無需渲染器構建，無需流管理：

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

.ResizeTo(width, height) 接受顯式像素尺寸，並與同一物件上的任何輸出方法連結。

條碼法

條碼器不具備讀取或解碼功能。 目前沒有 API，也沒有計畫推出 API，函式庫中也沒有任何變通方法。 如果應用程式需要讀取條碼，則必須將第二個程式庫（一個單獨的 NuGet 依賴項，具有自己的 API 介面和自己的版本追蹤）與 條碼 一起新增。 這意味著至少需要兩個與讀取相關的依賴項：用於產生的條碼，以及用於讀取的其他東西。

IronBarcode方法

IronBarcode 使用相同軟體包和一致的 API 模式，同時支援條碼產生和讀取。 BarcodeReader.Read() 方法原生支援圖像檔案、位元組數組、流和 PDF 檔案：

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// 從PDF文件閱讀 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// 從PDF文件閱讀 — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' 從PDF文件閱讀 — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

讀取 PDF 檔案是原生操作－無需中間影像擷取、轉換庫或額外軟體包。 IronBarcode 條碼讀取文件涵蓋多頁 PDF、感興趣區域讀取和效能調優。

閱讀被列入要求中。

許多項目最初都是純粹的生成流程——列印標籤、產生文件代碼、在報告中嵌入條碼。 條碼 為這些項目提供初始支援。 當同一個應用程式稍後需要驗證傳入的條碼、處理掃描的文件或解碼上傳的 PDF 中的條碼時，Barcoder 無法提供任何解決方案。 團隊必須評估第二個函式庫，了解其 API，單獨管理其 NuGet 版本，並處理兩個庫之間的整合介面。 達到這一步驟的團隊通常會合併到一個可以處理雙方的庫中，而不是維護兩個獨立的條碼依賴項。

.NET Framework相容性中斷

Barcoder.Renderer.Image 已放棄對.NET Framework的支援。 在.NET Framework4.x 上維護服務或桌面應用程式的團隊，如果在例行相依性維護期間更新映像渲染器包，則會遇到產生失敗。 這不是配置錯誤——這是庫的平台支援決定。IronBarcode支援.NET Framework4.6.2 至 .NET 9，無需針對不同目標進行特殊打包或條件依賴。

軟體包版本漂移導致協調問題

由於 Barcoder 和 Barcoder.Renderer.Image 是獨立版本化的，在依賴項刷新期間，如果只更新其中一個而不更新另一個，可能會引入細微的不相容性。 在一個包含多個專案的儲存庫中——每個專案都使用不同版本的渲染器套件——確保跨專案的行為一致就變成了一個協調問題，而且這個問題會隨著團隊規模的擴大而加劇。 使用IronBarcode整合團隊後發現，管理軟體包和一個版本可以徹底消除此類問題。

格式覆蓋範圍隨時間擴大

一個專案可能從 Code128 標籤開始，之後添加二維碼作為面向客戶的鏈接，然後添加 DataMatrix 以滿足合規性要求。 使用 條碼 時，每增加一種格式都意味著需要匯入一個新的命名空間，一個具有不同方法參數的不同編碼器類，並且可能需要一個新的 NuGet 套件。 使用 IronBarcode，新增格式是對現有呼叫中 BarcodeEncoding 枚舉值的變更。 對於規劃擴展條碼格式覆蓋範圍的團隊來說，基於枚舉的模型更容易維護。

MAUI 和跨平台部署要求

Barcoder 沒有提供 MAUI、Docker、AWS Lambda 或 Azure 部署的支援文件。 建立跨平台 MAUI 應用程式或將條碼處理部署到無伺服器基礎架構的團隊發現，Barcoder 的文件和測試並未涵蓋這些目標。IronBarcode提供文件並積極測試在 iOS、Android、Windows、macOS MAUI 目標、Docker 容器和主要雲端平台上的部署。

將 IBarcode 改為 GeneratedBarcode 類型更改

儲存 IBarcode 變數並將其傳遞給渲染器的條碼程式碼必須進行重構。 在IronBarcode中，GeneratedBarcode 有其自身的輸出方法—沒有單獨的渲染步驟。任何目前接受 IBarcode 的方法簽名都應該更改為接受 GeneratedBarcode，並且該方法內部的渲染調用應該改為直接調用，例如 .SaveAsPng() 或 @@--CODE-93508-- .SaveAsPng() 或 @@--CODE@@。 類型系統會在編譯期間顯示所有需要更新的位置－刪除 條碼 套件後，IBarcode 將無法解析。

PixelSize 沒有直接等效項

條碼的 PixelSize 是條碼自然模組尺寸的縮放倍數，而不是顯式的像素尺寸。 輸出寬度取決於條碼內容、格式和倍數的組合。IronBarcode使用 .ResizeTo(width, height)，並明確指定像素尺寸。 遷移過程中，測量現有條碼程式碼實際輸出的尺寸，並在 .ResizeTo() 呼叫中使用這些值：

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

命名空間合併

條碼項目會累積 using Barcoder.* 語句－每個使用的格式一個語句。 在遷移過程中，所有這些都合併為一個 using IronBarCode;。 在解決方案中搜尋 using Barcoder 將找到所有需要更新的檔案。 受影響的文件數量通常比團隊預期的要多，因為每個涉及條碼格式的文件都會匯入其自身特定於格式的命名空間。

SVG 輸出路徑更改

使用 Barcoder.Renderer.Svg 和 SvgRenderer 類別的項目將渲染器管道替換為對 GeneratedBarcode 的直接方法呼叫：

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

所有 SVG 渲染站點遷移完畢後，即可刪除 Barcoder.Renderer.Svg 軟體包。