如何用 C# 一次读取多个 BarCode；

高级多重条形码读取场景

在处理多个 BarCode 时，可能会遇到需要额外配置的情况。 下面是一个综合示例，演示如何从复杂的文档中读取不同格式的多个 BarCode：

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read from various sources
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);
var pdfResults = BarcodeReader.ReadPdf("document-with-barcodes.pdf", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read from various sources
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);
var pdfResults = BarcodeReader.ReadPdf("document-with-barcodes.pdf", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

这个高级示例展示了几个重要功能：

• 支持混合条形码格式：结合不同的条形码编码类型。
• 图像校正过滤器：使用图像过滤器提高阅读准确性
• 阅读速度优化：利用阅读速度选项平衡速度和准确性
• 信心分数：访问每个检测到的 BarCode 的置信度阈值</a

为了在读取单个条形码时获得更好的性能，请将 ExpectMultipleBarcodes = false 设置与 裁剪区域规范相结合。 当您知道 BarCode 的大致位置时，这种技术就特别有用：

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
    Console.WriteLine($"Read time: {result.ReadTime}ms");
}

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
    Console.WriteLine($"Read time: {result.ReadTime}ms");
}

单个条形码读取速度有多快？

将 ExpectMultipleBarcodes 设置为 false 可以大大提高读取单个条形码的效率。 在处理高分辨率图像或在高吞吐量应用程序中实施 异步条形码读取时，性能提升尤为明显。

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

在读取单个 BarCode 时，性能大约提高了 9倍。 实际绩效收益根据以下因素而变化：

• 图像分辨率和复杂程度
• 图像中出现的 BarCode 数量
• 选定的 BarCode 格式
• 应用图像过滤器
• 硬件规格

多条码读取的最佳实践

在生产应用程序中实施多条形码读取时，请考虑这些最佳实践：

1.指定预期条形码类型：不要使用 BarcodeEncoding.All，而只指定您期望的格式。 这将大大提高性能。

2.使用适当的图像格式：为获得最佳效果，请使用高对比度的图片。 了解有关创建最佳条形码图像的更多信息。

3.处理不完善的条形码：现实世界中的条形码可能会损坏或打印不良。 使用图像校正技术提高阅读成功率。

4.流处理：对于大批量数据，请考虑从流中读取，以优化内存使用。

5.错误处理：在无法读取 BarCode 的情况下，始终执行适当的错误处理：

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        ExpectMultipleBarcodes = true 
    });

    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        ExpectMultipleBarcodes = true 
    });

    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

通过遵循这些实践并利用 IronBarcode 的综合功能，您可以构建强大的应用程序，有效处理不同行业和用例中的多种条码读取场景。