Infragistics Barcode 与 IronBarcode：C# 条形码库对比

了解 Infragistics 条形码支持

Infragistics 是最成熟的.NET UI 组件供应商之一。 Infragistics UltimateSuite（涵盖条形码功能的订阅服务）包含数百个适用于 WinForms、WPF、 ASP.NET、 Blazor和移动平台的控件。对于已经在使用 Infragistics 网格、图表或日程安排工具的团队来说，条形码控件的加入顺理成章：他们已经为订阅付费了。

然而，条形码支持并不是一个统一的库。 这是两个功能各自独立的组件，只有部分功能重叠。

// InfragisticsWinFormsgeneration
using Infragistics.Win.UltraWinBarcode;

var barcode = new UltraWinBarcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.SaveTo(outputPath);

// InfragisticsWinFormsgeneration
using Infragistics.Win.UltraWinBarcode;

var barcode = new UltraWinBarcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.SaveTo(outputPath);

Imports Infragistics.Win.UltraWinBarcode

Dim barcode As New UltraWinBarcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.SaveTo(outputPath)

WPF阅读模式

以下是使用 Infragistics 在WPF中读取条形码的实际过程：

// InfragisticsWPFreading: event-driven, requiresWPFassemblies
using Infragistics.Controls.Barcodes;
using System.Windows.Media.Imaging;

private BarcodeReader _reader;
private TaskCompletionSource<string> _result;

public InfragisticsBarcodeService()
{
    _reader = new BarcodeReader();
    _reader.DecodeComplete += OnDecodeComplete;
}

public async Task<string> ReadBarcodeAsync(string imagePath)
{
    _result = new TaskCompletionSource<string>();

    // Load asWPFBitmapSource — not a file path
    var bitmap = new BitmapImage(new Uri(imagePath, UriKind.Absolute));

    // Must specify EVERY format — no auto-detection
    _reader.SymbologyTypes = SymbologyType.Code128 |
                             SymbologyType.Code39 |
                             SymbologyType.QR |
                             SymbologyType.EAN8 |
                             SymbologyType.EAN13 |
                             SymbologyType.UPCA |
                             SymbologyType.DataMatrix |
                             SymbologyType.Interleaved2of5;

    // Trigger decode — result comes via callback
    _reader.Decode(bitmap);

    return await _result.Task;
}

private void OnDecodeComplete(object sender, ReaderDecodeArgs e)
{
    _result?.TrySetResult(e.SymbologyValue ?? "No barcode found");
}

public void Dispose()
{
    if (_reader != null)
    {
        _reader.DecodeComplete -= OnDecodeComplete;
        _reader = null;
    }
}

// InfragisticsWPFreading: event-driven, requiresWPFassemblies
using Infragistics.Controls.Barcodes;
using System.Windows.Media.Imaging;

private BarcodeReader _reader;
private TaskCompletionSource<string> _result;

public InfragisticsBarcodeService()
{
    _reader = new BarcodeReader();
    _reader.DecodeComplete += OnDecodeComplete;
}

public async Task<string> ReadBarcodeAsync(string imagePath)
{
    _result = new TaskCompletionSource<string>();

    // Load asWPFBitmapSource — not a file path
    var bitmap = new BitmapImage(new Uri(imagePath, UriKind.Absolute));

    // Must specify EVERY format — no auto-detection
    _reader.SymbologyTypes = SymbologyType.Code128 |
                             SymbologyType.Code39 |
                             SymbologyType.QR |
                             SymbologyType.EAN8 |
                             SymbologyType.EAN13 |
                             SymbologyType.UPCA |
                             SymbologyType.DataMatrix |
                             SymbologyType.Interleaved2of5;

    // Trigger decode — result comes via callback
    _reader.Decode(bitmap);

    return await _result.Task;
}

private void OnDecodeComplete(object sender, ReaderDecodeArgs e)
{
    _result?.TrySetResult(e.SymbologyValue ?? "No barcode found");
}

public void Dispose()
{
    if (_reader != null)
    {
        _reader.DecodeComplete -= OnDecodeComplete;
        _reader = null;
    }
}

Imports Infragistics.Controls.Barcodes
Imports System.Windows.Media.Imaging
Imports System.Threading.Tasks

Private _reader As BarcodeReader
Private _result As TaskCompletionSource(Of String)

Public Sub New()
    _reader = New BarcodeReader()
    AddHandler _reader.DecodeComplete, AddressOf OnDecodeComplete
End Sub

Public Async Function ReadBarcodeAsync(imagePath As String) As Task(Of String)
    _result = New TaskCompletionSource(Of String)()

    ' Load as WPF BitmapSource — not a file path
    Dim bitmap As New BitmapImage(New Uri(imagePath, UriKind.Absolute))

    ' Must specify EVERY format — no auto-detection
    _reader.SymbologyTypes = SymbologyType.Code128 Or
                             SymbologyType.Code39 Or
                             SymbologyType.QR Or
                             SymbologyType.EAN8 Or
                             SymbologyType.EAN13 Or
                             SymbologyType.UPCA Or
                             SymbologyType.DataMatrix Or
                             SymbologyType.Interleaved2of5

    ' Trigger decode — result comes via callback
    _reader.Decode(bitmap)

    Return Await _result.Task
End Function

Private Sub OnDecodeComplete(sender As Object, e As ReaderDecodeArgs)
    _result?.TrySetResult(If(e.SymbologyValue, "No barcode found"))
End Sub

Public Sub Dispose()
    If _reader IsNot Nothing Then
        RemoveHandler _reader.DecodeComplete, AddressOf OnDecodeComplete
        _reader = Nothing
    End If
End Sub

读取一个条形码大约需要 35 条基础设施线路。 统计一下实际发生的事情：

1. 创建一个 BarcodeReader 实例，并将其作为字段保持存活。
2. 构造函数中连接了一个事件处理程序。
3. 每次调用 ReadBarcodeAsync 都会创建一个新的 TaskCompletionSource<string> 并分配给共享字段——这意味着按目前的写法，此服务不是线程安全的。 并发调用会覆盖 _result。
4. 图像必须以 BitmapImage 的形式从 Uri 加载——而不是文件路径字符串、字节数组或流。
5. Decode() 异步触发事件。 TaskCompletionSource 是回调世界和 async/await 世界之间的粘合剂。
6. 回调提取 e.SymbologyValue。
7. Dispose() 方法必须分离事件处理程序以防止内存泄漏。

这些逻辑都与条形码无关。 这是围绕事件驱动设计运行所需的基础设施。 在生产代码中，您还需要处理 _result.Task 永远不会完成的情况——超时、取消令牌或一些防止事件永远不会触发的保护措施。

WinForms差距

WinForms 与其他技术之间的差距比乍看起来要大得多。 构建WinForms应用程序的团队经常会访问 Infragistics 条形码页面，希望获得对称的体验——在两个 UI 框架上生成和读取条形码。 他们发现 Infragistics.Win.UltraWinBarcode 完全不具备读取功能。

这不是文件记录疏忽。WinForms条形码程序集被设计为生成控件。 如果您需要在WinForms应用程序中扫描条形码（例如，从用户上传的图像文件中读取条形码，或从摄像头画面中解码条形码），则无法使用 Infragistics 条形码工具完成此操作。 你需要引入一个完全独立的库，这样一来，使用 Infragistics 进行生成的理由就站不住脚了。

这种不对称性给运行混合框架项目的团队带来了非常尴尬的局面。 即使团队在其他所有地方都使用了 Infragistics，但如果他们同时拥有WPF桌面客户端和WinForms桌面客户端，则无法在WinForms项目中使用 Infragistics 进行条形码读取。

符号规范：一种静默故障模式

WPF 读取器中的 SymbologyTypes 标志属性值得单独介绍，因为它的故障模式很微妙，在生产环境中也很危险。

配置阅读器时，必须将要支持的每个条形码格式显式地按"或"关系连接起来：

// Must enumerate every format — miss one, that format silently returns empty
_reader.SymbologyTypes = SymbologyType.Code128 |
                         SymbologyType.Code39 |
                         SymbologyType.QR |
                         SymbologyType.EAN8 |
                         SymbologyType.EAN13 |
                         SymbologyType.UPCA |
                         SymbologyType.DataMatrix |
                         SymbologyType.Interleaved2of5;

// Must enumerate every format — miss one, that format silently returns empty
_reader.SymbologyTypes = SymbologyType.Code128 |
                         SymbologyType.Code39 |
                         SymbologyType.QR |
                         SymbologyType.EAN8 |
                         SymbologyType.EAN13 |
                         SymbologyType.UPCA |
                         SymbologyType.DataMatrix |
                         SymbologyType.Interleaved2of5;

' Must enumerate every format — miss one, that format silently returns empty
_reader.SymbologyTypes = SymbologyType.Code128 Or
                         SymbologyType.Code39 Or
                         SymbologyType.QR Or
                         SymbologyType.EAN8 Or
                         SymbologyType.EAN13 Or
                         SymbologyType.UPCA Or
                         SymbologyType.DataMatrix Or
                         SymbologyType.Interleaved2of5

如果条形码图像包含 EAN-8 条形码，并且 SymbologyType.EAN8 不在标志中，则 e.SymbologyValue 返回 null 或空值。 解码事件仍然会触发。 不会抛出异常。 呼叫者收到"未找到条形码"的提示，但无法判断图像是无法读取还是根本没有配置。

实际上，这意味着：

• 对于开发者测试过的格式，初始设置运行正常。
• 系统中引入了新的条形码格式（供应商更改了标签类型，新产品线使用了不同的符号体系）。
• 对于所有这种格式的图像，阅读器都会默默地失败。
• 该故障看起来与"图像没有条形码"完全相同，而不是"格式未配置"。

调试此问题的团队花费大量时间检查图像质量，才意识到该格式从未在标志列表中。

IronBarcode 没有 SymbologyTypes 属性。 每次读取时，它都会自动检测所有 50 多种受支持的格式。 没有需要遗忘的旗帜。

平台矩阵

跨平台能力差距是理解架构限制的最直接方式：

此表说明了为什么运行纯WPF桌面应用程序以外的任何应用程序的团队都会发现 Infragistics 条形码支持不足。 一旦项目跨越WinForms和ASP.NET Core ，或者WPF和后台工作服务，Infragistics 条形码库就只能覆盖部分代码库。

了解IronBarcode

IronBarcode是一个专用于.NET的条形码库，不依赖于 WinForms、WPF 或任何 UI 框架。 同一个NuGet包、同一个命名空间和同一个 API 可以在任何.NET项目中使用：WinForms、WPF、 ASP.NET Core、控制台、 Blazor Server、Docker、Azure Functions、AWS Lambda。

// IronBarcode: identical code in WinForms, WPF, ASP.NET Core, console, Docker
// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read — 2 lines, any platform
var results = BarcodeReader.Read(imagePath);
return results.FirstOrDefault()?.Value ?? "No barcode found";

// IronBarcode: identical code in WinForms, WPF, ASP.NET Core, console, Docker
// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read — 2 lines, any platform
var results = BarcodeReader.Read(imagePath);
return results.FirstOrDefault()?.Value ?? "No barcode found";

Imports IronBarCode

' Read — 2 lines, any platform
Dim results = BarcodeReader.Read(imagePath)
Return If(results.FirstOrDefault()?.Value, "No barcode found")

BarcodeReader.Read() 是一个静态方法。 没有实例需要管理，没有事件需要连接，也没有 TaskCompletionSource 来桥接回调模式。 它接受文件路径字符串、字节数组、Stream 或它们的数组，用于批量处理。

对于生成操作，BarcodeWriter.CreateBarcode() 返回一个条形码对象，您可以将其保存为 PNG、JPEG、SVG 格式，或将其获取为二进制数据：

using IronBarCode;

// Generate Code 128
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
             .ResizeTo(400, 100)
             .SaveAsPng("barcode.png");

// Generate QR code
QRCodeWriter.CreateQrCode("https://example.com", 500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qr.png");

using IronBarCode;

// Generate Code 128
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
             .ResizeTo(400, 100)
             .SaveAsPng("barcode.png");

// Generate QR code
QRCodeWriter.CreateQrCode("https://example.com", 500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Generate Code 128
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
             .ResizeTo(400, 100) _
             .SaveAsPng("barcode.png")

' Generate QR code
QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qr.png")

许可证初始化操作在应用程序启动时执行一次：

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

并排：批量处理

批量处理暴露了 InfragisticsWPF读取器的另一个结构性限制。 因为读取器使用共享事件处理程序，并且每次调用都会覆盖 _result 字段，所以上面显示的服务类不能安全地并发处理多个图像。 必须按顺序调用：

// Infragistics: must process sequentially — shared event handler and TaskCompletionSource
// are not thread-safe; concurrent calls would corrupt _result
var service = new InfragisticsBarcodeService();
var results = new List<string>();

foreach (var file in imageFiles)
{
    // Each call must await before starting the next
    var value = await service.ReadBarcodeAsync(file);
    results.Add(value);
}

// Infragistics: must process sequentially — shared event handler and TaskCompletionSource
// are not thread-safe; concurrent calls would corrupt _result
var service = new InfragisticsBarcodeService();
var results = new List<string>();

foreach (var file in imageFiles)
{
    // Each call must await before starting the next
    var value = await service.ReadBarcodeAsync(file);
    results.Add(value);
}

Imports System.Collections.Generic

' Infragistics: must process sequentially — shared event handler and TaskCompletionSource
' are not thread-safe; concurrent calls would corrupt _result
Dim service As New InfragisticsBarcodeService()
Dim results As New List(Of String)()

For Each file In imageFiles
    ' Each call must await before starting the next
    Dim value As String = Await service.ReadBarcodeAsync(file)
    results.Add(value)
Next

要实现并发，需要大量的额外基础设施：锁、队列或信号量，以确保在之前的解码仍在进行时，_result 不会被覆盖。 对于一个简单的 I/O 操作来说，这是一个相当复杂的并发问题。

IronBarcode 的静态 BarcodeReader.Read() 是线程安全的。 它可以同时从多个线程调用，无需任何额外的同步操作。 对于批量工作负载，您可以直接使用 Parallel.ForEach：

using IronBarCode;

// IronBarcode: parallel batch with thread-safe static API
var results = new System.Collections.Concurrent.ConcurrentBag<string>();

Parallel.ForEach(imageFiles, file =>
{
    var barcodeResults = BarcodeReader.Read(file);
    foreach (var result in barcodeResults)
    {
        results.Add(result.Value);
    }
});

using IronBarCode;

// IronBarcode: parallel batch with thread-safe static API
var results = new System.Collections.Concurrent.ConcurrentBag<string>();

Parallel.ForEach(imageFiles, file =>
{
    var barcodeResults = BarcodeReader.Read(file);
    foreach (var result in barcodeResults)
    {
        results.Add(result.Value);
    }
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' IronBarcode: parallel batch with thread-safe static API
Dim results As New ConcurrentBag(Of String)()

Parallel.ForEach(imageFiles, Sub(file)
    Dim barcodeResults = BarcodeReader.Read(file)
    For Each result In barcodeResults
        results.Add(result.Value)
    Next
End Sub)

您还可以通过一次调用传递多个文件，并通过 BarcodeReaderOptions 配置并行性：

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read(imageFiles, options);
foreach (var result in results)
{
    Console.WriteLine($"{result.Value} ({result.Format})");
}

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read(imageFiles, options);
foreach (var result in results)
{
    Console.WriteLine($"{result.Value} ({result.Format})");
}

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read(imageFiles, options)
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

功能对比

API 映射参考

当球队切换

某些特定情况总是导致团队放弃使用 Infragistics 条形码支持。

WinForms阅读材料需求。这是最常见的应用场景。WinForms应用程序可以正常生成条形码，例如 UltraWinBarcode，但后来出现了一个新的要求：扫描上传图像中的条形码或在打印前验证标签。 Infragistics 没有适用于WinForms的读取 API。 团队要么引入第二个库，要么用能够同时实现这两个功能的程序替换生成代码。

新增ASP.NET Core端点。带有 Infragistics 条形码生成功能的桌面应用程序现在拥有配套的 Web API。 该端点需要接受图像上传并返回条形码值，或者按需生成条形码图像。 在ASP.NET Core项目中使用 Infragistics 条形码包无法实现上述任何功能。IronBarcode使用 dotnet add package IronBarcode 安装，并且在控制器操作中的工作方式与在控制台方法中的工作方式相同。

Docker部署。WPF应用程序正在被容器化，或者其条形码逻辑正在被提取到微服务中。WPF程序集无法在Linux Docker容器中运行。 InfragisticsWPFBarcodeReader 与它们一起。 IronBarcode原生支持 Linux x64 系统。

批量处理性能。一个工作流程可以处理成百上千张条形码图像。 事件驱动型 Infragistics 读取器按顺序处理它们。IronBarcode的静态读取器是线程安全的，并且支持 Parallel.ForEach 或其内置的 MaxParallelThreads 选项，而无需任何并发基础架构。

生产环境中出现静默格式故障。一个团队发现，某种格式的条形码已经静默故障数周，原因是 SymbologyTypes 标志未包含该格式。 切换到自动检测模式可以彻底消除故障模式。

缩减 Infragistics 订阅范围。一些团队之所以支付 Infragistics Ultimate 订阅费用，正是因为其中包含条形码控制功能。 如果订阅的唯一原因是需要条形码，那么价格低廉的专用条形码库值得考虑。

结论

Infragistics 条形码支持的核心问题是架构方面的，而不是功能方面的。WPFBarcodeReader 可以读取条形码。WinFormsUltraWinBarcode 会生成它们。 在每个组件所设计的特定范围内，它们都能发挥作用。 问题在于，这两种情况并不能涵盖大多数.NET团队实际需要的内容。

在现代.NET应用程序中，条形码功能很少只存在于一个 UI 框架中。 它出现在WinForms客户端和 Web API 中。 它运行在 Docker 容器和桌面系统上。它需要扫描上传到ASP.NET端点的图像，并通过控制台工具打印标签。 这些方法都无法与 Infragistics 条形码包配合使用，而且WPF阅读器的事件驱动模式以及所需的符号标志即使在唯一能够正常工作的上下文中也增加了很大的复杂性。

IronBarcode解决了同样的问题——读取和生成条形码——它使用静态 API，可以在每种.NET项目类型中编译和运行，结果都一样。 在WPF服务类中编写的 BarcodeReader.Read() 调用与在 ASP.NET Core 控制器中编写的调用相同，也与在 Linux Docker 容器中编写的调用相同。 没有事件，没有标志，没有 TaskCompletionSource。 条形码逻辑只有两行而不是三十五行，而且这两行在任何地方都能正常工作。