Barcode4NET生成 API

Barcode4NET 中的完整生成工作流程使用了属性设置器模式：

//Barcode4NET— manual DLL,.NET Frameworkonly
// NoNuGet 软件包— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

//Barcode4NET— manual DLL,.NET Frameworkonly
// NoNuGet 软件包— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

这代表了Barcode4NETAPI 接口的全部范围。 该库不提供流畅链，无法读取功能，不支持QR Code，也没有高级二维选项如标识嵌入或错误校正控制。

详细功能对比

Barcode4NET方法

Barcode4NET 使用了命令式属性设置器模式。 开发人员实例化了一个System.Drawing.Bitmap：

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

返回类型 — System.Drawing.Bitmap — 意味着调用代码负责保存、显示或流化图像。 这对WinForms应用程序来说是合适的，其中一个PictureBox，但对于其他输出目标需要额外的转换步骤。

IronBarcode方法

IronBarcode使用流畅的静态 API。 单个方法调用即可启动生成过程，而链式方法会在最终保存或转换方法之前配置结果：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

Symbology枚举。 Height属性分配。 终端方法 — .ToPngBinaryData() — 替代了独立的GenerateBarcode()和位图保存调用。 有关更高级的生成场景，请参阅IronBarcode条形码生成文档。

Barcode4NET方法

Barcode4NET 没有读取 API。 需要从图像或扫描文档中解码条形码的团队必须完全集成一个单独的库——要么是开源替代方案 ZXing .NET，要么是商业扫描仪 SDK。 结果是形成了两条独立的依赖链：Barcode4NET 用于生成，第二个库用于读取。

IronBarcode方法

IronBarcode提供BarcodeReader.Read()作为一个静态方法，接受图像文件路径、流对象和PDF文档：

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

对于高容量或噪点图像场景，BarcodeReaderOptions类提供了对读取速度和多条形码检测的控制。 有关配置选项，请参阅条形码读取文档。

Barcode4NET方法

Barcode4NET 是针对.NET Framework集编译的。 它可在 Windows 系统、 .NET Framework应用程序、IIS 托管的 Web Forms 和 Windows Forms 项目中运行。 没有 Linux 版本，没有.NET Core版本，也没有云运行时支持。 当微软推出.NET Core并后来将该平台统一为.NET 5+ 时，Barcode4NET 没有相应的更新。 任何针对net5.0或更高版本的项目都不能引用该库。

DLL分发模式加剧了平台限制。 每个构建环境——开发人员工作站、构建代理、Docker 容器——都要求 DLL 位于已知路径中。 在基于容器的部署中，这意味着要么将DLL烘焙到自定义基础映像中，要么在容器构建期间复制它，这两种方式都不与标准dotnet restore工作流兼容。

IronBarcode方法

IronBarcode通过单个NuGet包支持多个框架：.NET Framework4.6.2 到.NET 9，以及 Windows、Linux 和 macOS 上的所有当前.NET版本。 部署到多克容器时，使用标准的.NET运行时镜像，无需修改。 Azure Functions、AWS Lambda 和其他无服务器运行时都可通过同一个NuGet包获得支持。 dotnet restore命令解决所有依赖项，无需手动DLL管理。

Barcode4NET方法

Barcode4NET实际上已到寿命终点。新许可证不再通过ComponentSource销售，尽管现有客户可能会根据供应商的条款通过ComponentSource续约支持和软件更新。 如果有新的开发人员加入使用Barcode4NET的团队，则没有机制购买额外的席位。 最后一个代码发布是2007年的2.0版本，因此在此发布后发现的任何缺陷或安全问题都未通过补丁解决。

IronBarcode方法

IronBarcode是一款持续维护的商业产品，拥有永久授权。 单人开发者Lite许可证起价为 749 美元，另有Plus （1499 美元，3 位开发者）、 Professional （2999 美元，10 位开发者）和 Unlimited（5999 美元）版本可供选择。 所有级别均包含免版税部署。 安全补丁、错误修复和.NET版本兼容性更新会定期发布。 提供 30 天免费试用期，无需许可证密钥即可进行评估。

.NET升级被阻止

最常见的强制事件是.NET现代化项目。 一个团队在他们的net8.0为目标，运行构建，并遭遇加载失败，因为Barcode4NET是为.NET Framework 1.1 / 2.0 / 3.x建立的，无法从现代的.NET目标引用。 此时，团队面临着一个二选一的选择——要么撤销目标框架的更改并继续使用.NET Framework，要么替换 Barcode4NET。 如果不推迟迁移，就会阻碍更广泛的现代化进程。

基础设施变更后 CI/CD 流水线故障

Barcode4NET 的 DLL 分发模型会在构建管道中造成潜在的脆弱性。 当重新配置构建代理、更新容器镜像或配置新的 CI 环境时，必须手动将Barcode4NETDLL 放置在项目文件期望的路径中。 没有仔细记录这一步骤的团队，只有在管道出现故障时才会发现问题。 过渡到IronBarcode意味着dotnet restore处理所有问题——DLL位置问题不复存在。

新团队成员不能获得执照

当承包商加入项目或第二个开发人员需要处理条形码功能时，无需购买许可证。 团队必须想办法克服这个限制——要么新开发人员完全避开条形码，要么有人转让一个根据原条款可能无法合法转让的许可证。 对于一个正在积极开发产品的团队来说，这两种情况都不可持续。

安全与合规审计

运行软件物料清单生成或对照生命周期结束数据库检查依赖项的组织会发现Barcode4NET是一个问题。 这是一种商业产品，自2007年以来没有代码发布，也没有CVE跟踪或补丁流。 安全审计人员通常将这种状态的依赖项与积极维护的库区别对待，发现通常成为正式的补救项目，而不是延迟的风险。

在现有工作流程中添加读取功能

最初使用Barcode4NET进行仅生成工作流程的团队后来发现，他们需要验证扫描文档中的条形码、处理用户上传的图像或从 PDF 发票中提取数据。 使用Barcode4NET时，需要集成第二个库。 IronBarcode的BarcodeReader.Read()本地处理图像和PDF，将依赖项整合到一个维护的包中。

移除 DLL 引用

Barcode4NET从未作为NuGet包分发，因此没有dotnet remove package命令。 每个引用该库的<Reference Include="Barcode4NET">元素。 必须手动查找并删除这些元素。 在解决方案中使用 grep 命令可以找到它们：

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

源代码控制中的DLL目录 — 通常是lib/ — 也必须准备删除git rm。

返回类型从位图更改为字节数组

Barcode4NET的System.Drawing.Bitmap。 IronBarcode的流畅链在.SaveAsPng()直接写入磁盘。 将返回值分配给Bitmap的方法（如WinForms Image.FromStream()。

符号枚举重命名

Barcode4NET中的BarcodeEncoding枚举。 所有通用值 — QRCode — 其名称保持不变。 解决方案范围内用Symbology.可以覆盖大多数情况，但每个替换应经过审核以确认上下文。

构建脚本清理

必须更新将Barcode4NETDLL 复制到输出目录或构建代理的构建脚本和 CI/CD 配置文件。 NuGet迁移之后，这些步骤没有对应步骤 — dotnet restore取代了所有手动DLL管理。 迁移后保留过时的 DLL 复制步骤不会导致构建失败，但这代表着失效的配置，会给未来的维护人员带来困惑。