1. IronBarcode
  2. 操作指南
  3. 读取多个条形码
How to Read Multiple Barcodes at Once in C#

如何在 C# 中一次读取多个条形码

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

同时读取多个条形码对于物流、零售、医疗保健和库存管理等各个行业至关重要，因为它能够实现高效的数据处理。 借助 IronBarcode，您可以轻松实现这一功能，使其成为简化操作和提高生产力的强大工具。

快速入门：轻松读取图像中的所有条形码

这个例子展示了使用 IronBarcode 可以多么快速地扫描图像，找到图像中包含的每个条形码。 只需在所需的条形码类型旁边设置ExpectMultipleBarcodes = true即可——无需样板代码，轻松便捷。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件：

  1. 使用 NuGet 包管理器安装 IronBarcode

    PM > Install-Package BarCode

  2. 复制并运行这段代码。

    var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { ExpectMultipleBarcodes = true, ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.AllOneDimensional });

  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronBarcode，免费试用！
    arrow pointer

最小工作流程（5 个步骤）

  1. 下载用于读取多个条形码的 C# 库
  2. 使用Read方法从各种图像格式中提取条形码值
  3. 利用ExpectMultipleBarcodes属性配置读取单个或多个条形码。
  4. 将ExpectMultipleBarcodes属性设置为 false 可提高性能
  5. 打印出条形码的值


读取多个条形码示例

默认情况下，IronBarcode 会持续扫描文档以读取多个条形码。 然而，有时即使图像中存在多个条形码，也只会返回一个条形码值。 为了解决这个问题，用户可以自定义设置以启用读取多个条形码的功能，如下面的代码片段所示。 请注意， ExpectMultipleBarcodes属性同时存在于BarcodeReaderOptions和PdfBarcodeReaderOptions类中，允许用户使用它来读取图像和 PDF 文档中的条形码。

示例图像

待读图像 
:path=/static-assets/barcode/content-code-examples/how-to/read-multiple-barcodes-read-multiple-barcodes.cs
using IronBarCode;
using System;

// Set the option to read multiple barcodes
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}
Imports IronBarCode
Imports System

' Set the option to read multiple barcodes
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = True,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result
$vbLabelText   $csharpLabel

通过在代码片段中将ExpectMultipleBarcodes设置为 true，IronBarcode 会扫描整个文档中的多个条形码，并将它们存储在BarcodeResults变量中。 使用 foreach 循环，用户可以轻松访问所有条形码值并将其打印到控制台。

读取单个条形码示例

IronBarcode 可以读取图像或 PDF 中的单个或多个条形码。 默认情况下，即使只有一个条形码，引擎也会扫描整个文档。 但是，为了提高读取单个条形码时的性能，您可以将ExpectMultipleBarcodes设置为 false。 这样可以防止引擎在检测到第一个条形码后扫描整个文档，从而加快条形码检索速度。 下面的代码片段演示了如何实现这一点。

示例图像

待读图像 
:path=/static-assets/barcode/content-code-examples/how-to/read-multiple-barcodes-read-single-barcode.cs
using IronBarCode;
using System;

// Set the option to read single barcode
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional,
};

// Read barcode
var results = BarcodeReader.Read("testbc1.png", options);

foreach (var result in results)
{
    Console.WriteLine(result.ToString());
}
Imports IronBarCode
Imports System

' Set the option to read single barcode
Private options As New BarcodeReaderOptions() With {
	.ExpectMultipleBarcodes = False,
	.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
}

' Read barcode
Private results = BarcodeReader.Read("testbc1.png", options)

For Each result In results
	Console.WriteLine(result.ToString())
Next result
$vbLabelText   $csharpLabel

在上面的代码片段中，我们使用了与之前相同的带有多个条形码的图像，但这次我们将ExpectMultipleBarcodes设置为 false。 因此，只会返回第一个条形码值，扫描过程在检索到第一个条形码后停止。

性能比较

将ExpectMultipleBarcodes设置为 false 可以大大提高读取图像中单个条形码的效率。

使用提供的代码片段，以下是同一台机器上将ExpectMultipleBarcodes设置为 true 和 false 时性能差异的粗略估计：

ExpectMultipleBarcodes = true ExpectMultipleBarcodes = false
0.91秒 0.10 秒

常见问题解答

如何用 C# 读取图像中的多个条形码？

要使用 C# 读取图像中的多个条形码，可以在 BarcodeReaderOptions 或 PdfBarcodeReaderOptions 类中将 IronBarcode 的 Read 方法与 ExpectMultipleBarcodes 属性设置为 true。

在 IronBarcode 中将 ExpectMultipleBarcodes 设置为 true 的好处是什么？

将 ExpectMultipleBarcodes 设置为 true 允许 IronBarcode 扫描和读取图像中存在的所有条形码，这对于需要同时处理多个条形码以提高数据效率的行业至关重要。

我可以在读取单个条形码时提高性能吗？

是的，通过在 IronBarcode 中将 ExpectMultipleBarcodes 设置为 false，您可以提高性能。这将在检测到第一个条形码后停止扫描过程，从而实现更快的检索时间。

如何用 C# 从 PDF 文档读取条形码？

IronBarcode 提供功能以使用 Read 方法从 PDF 文档读取条形码，并在 PdfBarcodeReaderOptions 中配置适当的选项。

如果在检测到多个条形码时只检测到一个怎么办？

确保在 IronBarcode 中将 ExpectMultipleBarcodes 属性设置为 true，以启用图像或 PDF 中所有条形码的检测和读取。

如何配置 IronBarcode 以便从各种图像格式读取条形码？

要配置 IronBarcode 以读取各种图像格式的条形码，您应使用 Read 方法，并在 BarcodeReaderOptions 类中设置 ExpectMultipleBarcodes 属性。

使用 ExpectMultipleBarcodes 设置为 true 和 false 时的性能差异是什么？

性能差异显著；将 ExpectMultipleBarcodes 设置为 false 会减少处理时间，因为它在检测到第一个条形码后停止扫描，而设置为 true 则扫描所有条形码，这需要更长时间。

是否有用于有效读取多个条形码的 C# 库？

是的，IronBarcode 是一个 C# 库，允许从图像和 PDF 文档中有效读取多个条形码，并提供改善性能和简化数据处理的工具。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  立即与工程团队聊天
软件工程师
如所有伟大的工程师一般，Hairil 是个热心的学习者。他正在提高对 C#、Python 和 Java 的知识，并利用这些知识为 Iron Software 团队成员增值。Hairil 从马来西亚的玛拉工业大学加入 Iron Software 团队，获得化学与工艺工程学士学位。
准备开始了吗？
Nuget 下载 1,979,979 | Version: 2025.11 刚刚发布