BarcodeLib核心生成模式

標準的BarcodeLib生成工作流程需要建立一個實例，配置屬性，並使用尺寸調用 Encode()：

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

這是完整的生成工作流程。 屬性設置模式是設計：配置在調用 Encode() 之前發生，返回值是一個 SKImage，必須編碼並寫入流。

詳細特性比較

BarcodeLib方法

BarcodeLib 需要構建一個實例並在使用尺寸調用 Encode() 之前設置屬性。 輸出是 SKImage：

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

SKImage 返回型別意味著字節陣列輸出需要 SKEncodedImageFormat 編碼調用和 MemoryStream。 IncludeLabel 屬性是布尔開關——BarcodeLib 將編碼資料字串渲染為條形下方的可見標籤。

IronBarcode方法

IronBarcode 的生成是完全靜態的。 配置在 CreateBarcode() 之後連結，輸出方法直接終止鏈：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddBarcodeValueTextBelowBarcode() _
        .ToPngBinaryData()
End Function

.ToPngBinaryData() 直接返回字節陣列——無中介 Image 或 MemoryStream 物件。 .AddBarcodeValueTextBelowBarcode() 將編碼資料字串作為標籤渲染在條形下方。 對於高級生成方案，請參閱IronBarcode 條碼生成文件。

BarcodeLib方法

BarcodeLib 沒有讀取 API。 沒有 Decode()、Scan() 或 ReadBarcode() 方法。 讀取從未是該程式庫設計的一部分。 任何嘗試調用解碼方法的操作都會導致編譯錯誤：

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

需要同時生成和讀取以及BarcodeLib的團隊必須新增第二個程式庫——通常是 ZXing.Net——這引入了其自身的依賴管理負擔以及要維護的第二 API 表面。

IronBarcode方法

BarcodeReader.Read() 接受圖像文件、PDF 文件、流和 System.Drawing.Bitmap 物件。 從 PDF 讀取不需要額外的程式庫：

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed
var pdfResults = BarcodeReader.Read("invoice-batch.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed 枚舉允許調整高容量場景的掃描性能。 有關讀取配置的指導，請參閱IronBarcode 讀取文件。

BarcodeLib方法

從BarcodeLib3.x 開始，該程式庫引入 SkiaSharp 作為圖形後端以取代System.Drawing.Common，後者在 .NET 6 後成為僅限 Windows。BarcodeLib 3.1.5 宣告 SkiaSharp >= 2.88.8。 若專案透過其他依賴已經使用 SkiaSharp — 在使用 SkiaSharp.Views.Maui 和 Microsoft.Maui.Graphics 的 MAUI 專案中很常見，這些往往趨向於 SkiaSharp 3.x — 解決的版本可能無法收歛。 結果至少是 NU1608 警告，最壞情況下是運行時程式集綁定失敗：

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

透過顯式包引用強制解決是一種途徑，但不保證運行時的相容性：

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

即便有顯式覆寫，相容性取決於BarcodeLib的內部 API 調用與解析的 SkiaSharp 版本所暴露的一致性。 作為社區維護的專案，BarcodeLib 的發佈節奏未附商業支持合約。

IronBarcode方法

IronBarcode 不與應用程式碼共用 SkiaSharp 依賴圖譜。 無需管理版協調，無需診斷 NU1608，也無時間 SkiaSharp 版本解析綁定風險。 MAUI 專案、Blazor 專案及任何其他依賴 SkiaSharp 的應用程式可以安裝 IronBarcode，無任何版本衝突。 有關 MAUI 特定整合模式，請參閱IronBarcode MAUI 文件。

出現讀取需求

已生成運輸標籤數月的系統收到新需求：應用程式還必須處理來自供應商的退回標籤。 倉庫整合需要解析入境運輸清單的條碼。 文件管理系統需要索引掃描 PDF 上的條碼。BarcodeLib無法滿足這些需求 — 不存在讀取 API。團隊評估將 ZXing.Net 新增為BarcodeLib的配套，權衡雙程式庫維護負擔和兩個獨立依賴圖，並決定更乾淨的途徑是涵蓋生成和讀取的單個 NuGet 安裝的程式庫。

MAUI 專案中的 SkiaSharp 衝突

團隊將BarcodeLib新增到現有 MAUI 應用程式中，並在恢復期間立即遇到 NU1608 警告。 他們調查並找出BarcodeLib預期的 SkiaSharp 範圍與 MAUI 所需版本之間的不匹配，新增顯式 <PackageReference> 覆蓋以強制解決，並通過構建。 然後他們在裝置上運行時遇到當 SkiaSharp 的原生二進製載入錯誤版本時的崩潰。 此問題需要更深入調查程式集綁定日誌。 切換到IronBarcode從根源消除了衝突——不是透過找到相容的 SkiaSharp 版本，而是透過完全消除共用依賴。

需要 PDF 條碼處理

生成嵌入條碼的 PDF 文件的應用——如發票、工單、運輸清單——有時需要在下游處理時再次讀取這些條碼。BarcodeLib生成條碼圖像但在任何一端都不支持 PDF。 要從 PDF 中讀取條碼，需要使用單獨的 PDF 程式庫先將其渲染為圖像，然後再將這些圖像傳遞給單獨的讀取程式庫。IronBarcode原生處理完整鏈：BarcodeReader.Read("file.pdf") 遍歷每頁並返回所有檢測到的條碼，無需中介渲染步驟。

出現 QR Code 或其他 2D 符號需求

最初僅需線性條碼的專案常常演變為需要 QR Code、Data Matrix、PDF417 或 Aztec 輸出。BarcodeLib在其 3.x 系列中不生成任何 2D 符號——BarcodeStandard.Type 枚舉不包含 QR Code 或其他 2D 項目——因此任何 2D 需求意味著新增第二個程式庫或直接取代 BarcodeLib。IronBarcode的 QRCodeWriter 和 BarcodeWriter 涵蓋 QR Code（含標誌嵌入、顏色控制和錯誤校正調整）、Data Matrix、PDF417 和 Aztec，皆透過相同的流暢 API。 符號需求移入 2D 的團隊發現此差距驅動了遷移決策。

實例 API 到靜態流暢 API

BarcodeLib 程式碼使用可變物件模式：建立一個 Barcode 實例，設置屬性，調用 Encode()。IronBarcode使用靜態流暢模式：調用 BarcodeWriter.CreateBarcode()，連結配置方法，使用輸出方法終止。 現有的程式碼中將 Barcode 實例作為字段儲存或在方法之間傳遞將需要重構。 典型的變更是用方法鏈取代屬性設置塊：

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

從 SKImage 到直接輸出

BarcodeLib 3.x 返回 SKImage，需要 SKEncodedImageFormat 和流來生成字節。 任何型別於 SKImage 或通過 image.Encode(...).SaveTo(stream) 的程式碼需要更新。IronBarcode的流暢鏈直接以所需輸出格式終止——.SaveAsPng()、.ToPngBinaryData()、.ToAnyImageData()——消除了中介圖像物件和編碼到流的步驟。

型別枚舉到條碼編碼枚舉

BarcodeLib 3.x 使用含 PascalCase 值如 BarcodeStandard.Type 的枚舉。IronBarcode使用具有值如 BarcodeEncoding.Code128 的枚舉。 一維值直接映射：Code128 → Code128、Ean13 → EAN13、UpcA → UPCA、Code39 → Code39。 通過 BarcodeStandard.Type. 在 .cs 文件中進行 grep，識別需要更新的所有出現。

SkiaSharp 參考清理

專案中只為解決BarcodeLib的 NU1608 警告而新增顯式 <PackageReference Include="SkiaSharp"> 條目的專案可以在切換到IronBarcode後移除這些覆蓋。 dotnet list package --include-transitive 命令確認專案中其他包是否仍需要 SkiaSharp，然後再將其移除。