型別枚舉設計邊界

Type 枚舉是NetBarcode可以生成的權威列表。 檢查它會揭示程式庫的範疇：

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// 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
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

//NetBarcodeType enum — complete list as of v1.8
public enum Type
{
    Codabar,
    Code11,
    Code128,
    Code128A,
    Code128B,
    Code128C,
    Code39,
    Code39E,
    Code93,
    EAN13,
    EAN8
}

// 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
// Type.UPCA        — does not exist
// Type.UPCE        — does not exist
// Type.ITF         — does not exist
// Type.MSI         — does not exist

Public Enum Type
    Codabar
    Code11
    Code128
    Code128A
    Code128B
    Code128C
    Code39
    Code39E
    Code93
    EAN13
    EAN8
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
' Type.UPCA        — does not exist
' Type.UPCE        — does not exist
' Type.ITF         — does not exist
' Type.MSI         — does not exist

該枚舉在八個線性符號家庭中有十一個條目，這反映了該程式庫的預期範疇。 任何需要 QR Code、DataMatrix、PDF417、Aztec、UPC-A、UPC-E、ITF 或 MSI 的應用程式必須獲得額外的程式包以提供這些格式。

詳細特性比較

NetBarcode方法

NetBarcode 通過 Type 枚舉提供 11 種線性條碼枚舉值，涵蓋 8 種符號家族。 在該範疇內，格式選擇很簡單——將適當的枚舉成員傳遞給構造函式。 邊界同樣明確：嘗試使用超出枚舉的格式會導致編譯時錯誤。

//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
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // 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
// var upca   = new Barcode("data", Type.UPCA);        // error CS0117
// var itf    = new Barcode("data", Type.ITF);         // 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
' Dim upca As New Barcode("data", Type.UPCA)     ' error CS0117
' Dim itf As New Barcode("data", Type.ITF)       ' error CS0117

這種限制在制藥跟踪（根據 FDA 2D 條碼要求需要 DataMatrix）、航空公司登機牌（Aztec）、物流清單（PDF417）和移動營銷（QR Code）等行業中成為約束。 這些需求中的每一個都使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")

完整的支援常量列表可在 支援條碼格式 參考中找到，涵蓋所有 2D 條碼建立 格式及完整的 1D 集。

NetBarcode方法

NetBarcode 的生成模型是基於構造函式的。 一個 Barcode 物件使用資料字串和一個 Type 枚舉值被實例化。 輸出要麼直接保存在 SaveImageFile() 中，要麼透過 Image<Rgba32> 來檢索 GetImage()。 自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

詳細選項包括1D 條碼建立的寬度、高度及標籤配置都在IronBarcode文件中覆蓋。

NetBarcode方法

NetBarcode 沒有讀取 API。 沒有方法、類別或配置可以將條碼圖像解碼回其資料字串。 這是刻意的範疇邊界而非尚未釋出的省略。 一個生成條碼且後來需要讀取它們的專案 — 例如驗證已列印標籤、掃描退貨包裝或從供應商發票中提取值 — 必須引入一個單獨的程式庫來實現該目的。

//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 表面並且一個與已經存在於QR Code的 2D 程式庫同時需要版本管理的包。

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.Format}: {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.Format}: {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.Format}: {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 中可用的速度調整、多條碼檢測及圖像校正選項。

NetBarcodeand ImageSharp

NetBarcode 是MIT授權的。 它所依賴的 SixLabors.ImageSharp 程式庫使用的是不同的模型：對開源專案免費使用及適用於年營收在定義門檻以下的公司，但在超過門檻時需要商業授權。 這一分裂條件適用於，不論 ImageSharp 是否被專案的 .csproj 中明確列出或是經由NetBarcode傳遞地引入。

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

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

對於在大規模處理條碼的零售或物流公司來說 — 應對NetBarcode主要目標的用例 — 年收入通常高於 ImageSharp 商業授權適用的門檻。 合規審計可能揭示這種義務嵌入於包樹中。

v1.8 版本引入了 ImageSharp 依賴的另一個後果：GetImage() 的返回型別從內部表示變成 SixLabors.ImageSharp.Image<Rgba32>。 現有未加型別聲明調用 GetImage() 的程式碼在編譯時中斷，並且新 using 指令必須可用於 SixLabors.ImageSharp 和 SixLabors.ImageSharp.PixelFormats。 當 ImageSharp 在未來版本中自身 API 演變時，NetBarcode 的公共 API 表面會受影響。

IronBarcode

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

QR Code和 2D 格式需求

評估NetBarcode替代方案的最頻繁觸發因素是新的QR Code需求。 為零售標籤或運輸清單開始 1D 條碼建立的應用程式通常會收到後續對於QR Code的需求 — 無接觸連結、行動應用深層連結、行銷活動。 由於 Type 枚舉中沒有 QR 條目，這一需求在NetBarcode無法實現。 解決這一缺口的團隊加入了單獨的 QR 程式庫，當需要DataMatrix用於制藥整合時，或物流貨運商要求其在運輸標籤上使用PDF417時，則面臨第二次評估。

條碼讀取變得必要

某些專案以純生成開始，然後新增驗證或文件處理需求：確認已列印條碼與其來源資料匹配，從進口供應商發票中提取條碼值，或掃描退貨包裝標籤。NetBarcode沒有為此提供途徑。 新增 ZXing.Net 或類似的讀取程式庫會在已經有NetBarcode和 QR 程式庫的程式碼基礎中引入第三個需學習和維護的 API。 即使未來的階段可能出現讀取需求的專案通常發現選擇一個同時解決兩者問題的初始程式庫更有效率。

ImageSharp 商業授權審計

對第三方依賴關係進行的法律和合規審查偶爾會在NetBarcode包樹中影響的 ImageSharp 商業授權條件浮現。 對於年營收超過門檻的公司來說，這一義務無論是 ImageSharp 是故意選擇還是經由NetBarcode傳遞引入適用。 在審計過程中 — 而非在採用之前 — 發現這一點的團隊面臨的是追溯補救而非計劃遷移。 在開始專案前評估依賴授權是更乾淨的路徑。

減少多程式庫複雜性

積累了NetBarcode用於 1D 建立、一個 QR 專用程式庫的 2D 輸出及 ZXing.Net 進行讀取的團隊發現自己在維護三個程式包的版本相容性。 每次升級週期都需要檢查三個程式庫是否在其共享的 ImageSharp 版本上達成一致。 每位專案新開發人員都會遇到三個不同的 API，而它們在概念上是一個問題。 合併到一個條碼程式庫簡化了入門階段，減少版本衝突面，並且專注於一個釋出週期的維護。

包替換及傳遞依賴清理

用 dotnet remove package NetBarcode 移除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;。 專案範圍內搜索這些使用語句可識別每個在嘗試建置前需要注意的文件。