Spire.Barcode 与 IronBarcode：C# 条形码库比较

类型规格要求

Spire.Barcode 的 BarcodeScanner.Scan() 没有只接受文件路径的重载。 每次读取操作都要求调用代码预先声明条形码格式。 对于单一格式的工作流程，这种方法是可行的，但对于混合格式的文档处理，它会产生一个候选迭代循环：

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection requires a guessing loop
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

候选数组中每增加一种类型，就需要额外进行一次扫描。 列表中未包含的任何格式都会被默默忽略。 开发人员负责维护详尽的类型清单，并在新格式进入工作流程时进行重新测试。

详细功能对比

Spire.条形码方法

Spire.Barcode 的 BarcodeScanner.Scan() 每次调用都需要一个 BarCodeType 参数。 当格式已知且有保证时，单类型调用是合适的：

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

当格式事先未知时，唯一可行的方法是遍历候选类型。每次遍历都是一次完整的扫描，任何不在列表中的格式都会被忽略。 结果是一个 string[]，它不携带任何类型信息，因此基于格式的下游路由需要调用者进行额外的状态管理。

IronBarcode方法

IronBarcode 的 BarcodeReader.Read() 不需要类型参数。 该库只需一次扫描即可自动检测所有受支持符号体系的格式。 无论源图像包含多少种不同的条形码格式，从图像中读取条形码都只需要一次方法调用：

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

//IronBarcode— auto-detection built in
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");
}

Imports IronBarcode

'IronBarcode— auto-detection built in
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.BarcodeType}: {result.Value}")
Next

每个结果对象包含 BarcodeType、Value 和位置元数据。 基于格式的下游路由不需要额外的状态——类型本身就存在于结果中。

Spire.Barcode 免费层

FreeSpire.Barcode 会在生成的条形码图像上应用大型评估水印。 水印覆盖了条形码，使其不适合生产使用，并妨碍了对生产质量的有效评估。 免费版有意降低了扫描性能，这意味着评估期间进行的吞吐量测量并不能代表 Spire.Barcode 的商业性能。 免费版软件包还需要从 E-iceblue 获取注册密钥，才能在执行过程中抑制警告对话框。 免费版提供的符号集是商业版符号集的子集。 这些限制共同意味着，基于 FreeSpire.Barcode 进行的评估并不能准确反映商业产品的功能。

IronBarcode试用模式

IronBarcode 的试用版是无需许可证密钥即可使用的授权软件包。 阅读功能以全速运行，支持所有符号，且无行为限制。 阅读速度和准确度选项在试用模式和授权模式下表现完全相同。 试用模式下生成的条形码输出图像边缘带有一个小水印； 它不会遮挡条形码本身。 IronBarcode评估期间测量的行为就是最终部署到生产环境中的行为。

Spire.条形码方法

Spire.Barcode本身不具备PDF读取功能。 要从 PDF 文件中提取条形码，开发人员必须安装单独的 Spire.PDF 软件包，购买单独的 Spire.PDF 许可证，并编写手动页面迭代和图像提取代码，然后才能开始条形码扫描：

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: two libraries, two licenses
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required even here
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required even here
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

此模式需要两个NuGet包、两份许可协议以及开发人员编写的页面管理代码。 如果条形码嵌入在 PDF 的矢量内容中而不是栅格图像中，则图像提取方法可能会完全错过它们。

IronBarcode方法

IronBarcode可原生处理 PDF 文件，无需任何额外依赖。 从 PDF 文档中读取条形码只需调用一个方法，使用与图像文件相同的 BarcodeReader.Read() API。 每个结果对象中都包含页码：

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

// IronBarcode: native PDF support, no additional library
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}");
}

Imports IronBarcode

Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.BarcodeType} = {barcode.Value}")
Next

无需手动提取页面，无需二级软件包，也无需购买额外许可证。

Spire.条形码方法

Spire.Barcode 的生成模型以可变的 BarcodeSettings 配置对象为中心。 开发人员实例化设置，分别分配属性，将设置对象传递给 BarCodeGenerator，然后调用 GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

可变设置对象意味着，当在多个生成操作中重用单个实例时，配置可能会意外地在多个调用之间共享。 生成器类增加了一个额外的实例化步骤，该步骤本身不包含任何配置逻辑。

IronBarcode方法

IronBarcode使用静态工厂方法，并可选地进行流畅的链式调用。 没有设置对象，也没有生成器实例需要管理：

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

//IronBarcodegeneration
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

所有IronBarcode许可级别均提供带有自定义徽标的二维码：

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

混合格式文档处理

最初只使用一种条形码格式的团队，往往会发现随着时间的推移，其条形码格式会变得越来越多样化。例如，一个最初使用 Code128 标签的仓储应用，现在可能会收到供应商使用 DataMatrix、GS1-128 或二维码的货物。 每次有新格式进入工作流程时，都需要更新类型猜测循环中的候选数组，重新测试检测逻辑，并确认迭代顺序不会改变现有格式。 当格式多样性达到一定程度，使得该循环的维护开销成为持续的开发成本时，团队会评估自动检测是否可以完全消除这种负担。

PDF集成

文档密集型应用程序经常会遇到需要从 PDF 文件而不是独立图像中提取条形码的情况。 在 Spire.Barcode 工作流程中，这种转变需要获得 Spire.PDF 许可证，集成第二个软件包，并编写页面迭代和图像提取基础架构，然后才能进行任何条形码读取。 如果团队在最初购买时没有预料到这一要求，他们就会发现自己需要管理两个产品许可证和两个 API 接口，而这项任务在概念上属于条形码读取。 发现 PDF 支持需要单独购买，是促使用户重新评估产品选择的常见原因。

免费层级评估限制

评估过 FreeSpire.Barcode 并购买了商业许可证的团队有时会报告说，商业产品的表现与他们的评估结果有所不同。 这是有意为之：免费层级故意降低读取性能并限制符号集，这意味着在评估期间进行的基准测试和格式覆盖率测试无法转移到商业部署中。 当团队在购买后发现这种差异时，他们通常会寻找替代品，这些替代品的试用行为能够代表生产行为。

减少产品数量

对技术栈进行标准化的组织有时会将 Spire.Barcode 视为不断增长的 E-iceblue 产品库中的一个组件，每个组件都有自己的许可费用和续订周期。 如果 Spire.Barcode 的主要驱动力是在文档处理流程中读取条形码，而不是与 Spire.Doc 或 Spire.XLS 深度集成，那么团队会评估一个独立的条形码库是否可以降低许可复杂性和支持范围。

移除 BarCodeType 参数

Spire.Barcode 代码库中的每个 scanner.Scan() 调用都带有一个 BarCodeType 参数。 将这些调用替换为 BarcodeReader.Read() 可以完全移除类型参数。 类型猜测循环——遍历候选 BarCodeType 值的 foreach 块——可以完全删除； 一次调用 BarcodeReader.Read() 即可替换整个循环。

更新退货类型

Spire.Barcode 的 Scan() 返回 string[]。IronBarcode返回一个 BarcodeResults 集合。 调用分配给 string[] 或将结果传递给期望该类型的方法的站点需要更新。 将值提取为数组使用 .Select(r => r.Value).ToArray(); 访问第一个结果使用 .First()?.Value。

移除 Spire.PDF 包

如果安装 Spire.PDF 仅仅是为了支持从 PDF 文件中提取条形码，那么在迁移到IronBarcode后可以将其删除。 所有 using Spire.Pdf; 导入和手动页面迭代块都被单个 BarcodeReader.Read("file.pdf") 调用所取代。 如果 Spire.PDF 用于条形码提取以外的其他文档操作，则应保留该条形码，并仅替换与条形码相关的代码路径。

命名空间变更

将 using Spire.Barcode; 替换为 using IronBarCode;。 枚举 BarCodeType 被 BarcodeEncoding 替换以进行生成，读取时不需要等效项。 许可证初始化从 BarcodeSettings.ApplyKey() 或 Spire.License.LicenseProvider.SetLicenseKey() 更改为在应用程序启动时进行单个 IronBarCode.License.LicenseKey 属性赋值。