类型规格要求

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

// Spire.Barcode: multi-format detection iterates through candidate types
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 iterates through candidate types
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的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: automatic format detection
var results = BarcodeReader.Read("barcode.png");

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

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

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

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

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

每个结果对象包括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: separate package and license required
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 for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
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 for each scan call
        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 for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

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

IronBarcode方法

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

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

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

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

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

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

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

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

Spire.条形码方法

Spire.Barcode的生成模型集中在一个可变的BarcodeSettings配置对象上。 开发人员实例化设置，分别分配属性，将设置对象传递给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代码库中每个BarCodeType 参数。 用BarcodeReader.Read()替换这些调用会完全去除类型参数。 类型猜测循环——foreach块遍历候选BarCodeType值——可以全部删除； 一个单一的BarcodeReader.Read()调用取代整个循环。

更新退货类型

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

移除 Spire.PDF 包

如果只为支持从PDF文件提取条码而安装了Spire.PDF，在迁移到IronBarcode之后可以将其删除。 所有的BarcodeReader.Read("file.pdf")调用替代。 如果Spire.PDF用于条码提取之外的其他文档操作，应该保留，只有条码相关的代码路径替换。

命名空间变更

用using IronBarCode;。 用于生成的BarcodeEncoding替换，读取时不需要等效物。 许可证初始化从IronBarCode.License.LicenseKey属性分配。