条形码库核心生成模式

标准的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需要构建一个实例并在调用带有尺寸的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 没有读取 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)

需要同时具备 条形码库 的生成和读取功能的团队必须添加第二个库（通常是 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 3.x开始，库引入了SkiaSharp作为图形后端取代System.Drawing.Common，后者在.NET 6之后变为仅支持Windows。BarcodeLib 3.1.5声明了SkiaSharp >= 2.88.8。 如果一个项目已经通过其他依赖项使用SkiaSharp—常见于使用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文件中的条形码进行索引。 条形码库 无法满足这些要求——它没有读取 API。团队评估了将 ZXing .NET与 条形码库 结合使用的可能性，权衡了双库维护的负担和两个独立的依赖关系图，最终决定更简洁的方案是使用一个库，通过单个NuGet安装即可处理生成和读取操作。

SkiaSharp 在 MAUI 项目中的冲突

一个团队将 条形码库 添加到现有的 MAUI 应用程序中，并在恢复过程中立即遇到 NU1608 警告。 他们调查并识别了BarcodeLib期望的SkiaSharp范围与MAUI所需版本之间的不匹配，添加显式<PackageReference>覆盖以强制解析，并使构建通过。 然后，当 SkiaSharp 的本地二进制文件加载了错误的版本时，设备运行时就会崩溃。 修复此问题需要对程序集绑定日志进行更深入的调查。 切换到IronBarcode可以从根本上消除冲突——不是通过找到兼容的 SkiaSharp 版本，而是通过完全消除共享依赖项。

需要进行PDF条形码处理

能够生成带有嵌入式条形码的 PDF 文档（例如发票、工作单、发货清单）的应用程序，有时需要在下游处理过程中读取这些条形码。 条形码库 可以生成条形码图像，但两端均不支持 PDF。 使用 条形码库 从 PDF 中读取条形码需要先使用单独的 PDF 库将 PDF 渲染成图像，然后将这些图像传递给单独的读取库。 IronBarcode本地处理整个链：BarcodeReader.Read("file.pdf")遍历每个页面，并返回所有检测到的条码，没有中间渲染步骤。

QR码或其他二维符号需求出现

最初只需要线性条形码的项目往往发展为需要QR码、Data Matrix、PDF417或Aztec输出。 BarcodeLib在其3.x系列中不生成任何2D符号—BarcodeStandard.Type枚举不包含QR Code或其他2D条目—所以任何2D需求意味着添加第二个库或完全替换BarcodeLib。 IronBarcode 的 QRCodeWriter 和 BarcodeWriter 通过相同的流畅 API 覆盖 QR Code（带有标识嵌入、颜色控制和错误修正调优）、Data Matrix、PDF417 和 Aztec。 其符号需求进入二维的团队发现这一差距促使迁移决策。

实例 API 到静态 Fluent 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()—消除了对中间图像对象和编码到流步骤的需要。

类型枚举到BarcodeEncoding枚举

BarcodeLib 3.x 使用 BarcodeStandard.Type 枚举，其值采用 PascalCase 形式，例如 BarcodeStandard.Type.Code128。 IronBarcode使用BarcodeEncoding.Code128。 1D值直接映射：Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39。 在 .cs 文件中对 BarcodeStandard.Type. 进行 grep 可识别出所有需要更新的情况。

SkiaSharp 参考清理

在切换到IronBarcode后，项目中为了消除BarcodeLib的NU1608警告而添加的显式<PackageReference Include="SkiaSharp">条目可以删除这些覆盖。 dotnet list package --include-transitive命令确认SkiaSharp是否仍被项目中的其他软件包需要，然后再将其移除。