如何使用 C# 从图像中读取条形码

Hairil Hasyimi Bin Omar

Updated: 2026年6月4日

IronBarcode使用BarcodeReader.Read()在C#中以一行代码从图像中读取条形码，支持多种图像格式，包括PNG、JPEG、GIF、BMP、TIFF和SVG，并提供可自定义的选项以提高性能和准确性。

IronBarcode 的一个关键特性是它能够开箱即用地读取多种图像格式的条形码。 IronBarcode目前支持以下图像格式：

可缩放矢量图形 (SVG)
联合图像专家组 (JPEG)
便携式网络图形 (PNG)
图形交换格式 (GIF)
标签图像文件格式 (TIFF) 位图图像文件（BMP）

借助我们的开源库IronDrawing ，这一切才得以实现。有关支持的条形码格式（包括一维和二维类型）的完整列表，请查看我们的综合文档。

快速入门：几秒钟内从图像中读取BarCode

只需简单调用IronBarCode.BarcodeReader.Read()，即可直接从PNG、JPEG、GIF、BMP和TIFF等图像文件格式中提取条形码数据。立即开始使用——无需复杂设置，即可立即见效。

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2复制并运行这段代码。

var results = IronBarCode.BarcodeReader.Read("path/to/image.png");

var results = IronBarCode.BarcodeReader.Read("path/to/image.png");

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

通过免费试用立即在您的项目中开始使用IronBarcode

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

下载用于从图像中读取条形码的 C# 库
使用Read方法从各种图像格式中读取条形码值
使用BarcodeReaderOptions类配置读取设置
使用CropArea属性指定图像中的条形码区域
通过设置ExpectBarcodeTypes属性来指定要读取的条形码类型。

如何直接从图像中读取 BarCode？

下面介绍如何使用 IronBarcode 读取条码。有关在 C# / .NET 中读取 BarCode 的全面教程，包括 PDF 处理和批处理操作的高级技术，请访问我们的详细指南：

using IronBarCode;
using System;

var myBarcode = BarcodeReader.Read(@"image_file_path.jpg"); //image file path

foreach (var item in myBarcode)
{
    Console.WriteLine(item.ToString());
}

using IronBarCode;
using System;

var myBarcode = BarcodeReader.Read(@"image_file_path.jpg"); //image file path

foreach (var item in myBarcode)
{
    Console.WriteLine(item.ToString());
}

Imports IronBarCode
Imports System

Private myBarcode = BarcodeReader.Read("image_file_path.jpg") 'image file path

For Each item In myBarcode
	Console.WriteLine(item.ToString())
Next item

Imports IronBarCode
Imports System

Private myBarcode = BarcodeReader.Read("image_file_path.jpg") 'image file path

For Each item In myBarcode
	Console.WriteLine(item.ToString())
Next item

白色背景上带黑色垂直线条的示例条形码，用于测试基于图像的条形码读取 — 样品测试条形码

想知道样品中的条形码值是什么吗？试试这段代码片段吧！

要使用 IronBarcode，首先需要做的是通过 Microsoft Visual Studio NuGet 包管理器将 IronBarcode 库安装到您的项目中，如下图所示。这将允许您访问IronBarcode的BarcodeReader.Read()方法，以直接读取条形码图像。

IronBarcode通过允许用户仅使用BarcodeReader.Read()以读取已包含在项目中的图像文件，提供了简便性，方法是将文件名字符串或文件路径字符串作为方法的参数。最佳实践是在方法中指定文件路径时使用字符串字面量"@"，以避免在文件路径字符串中添加多个转义字符"\"。

在System.String[]对象。

要将结果输出到控制台，您可以使用Console.WriteLine()方法，将迭代变量作为参数。

IronBarcode能够读取一维条形码格式（QRCode）的各种图像格式。

如何配置条码阅读器选项以提高性能？

条形码读取速度太慢？图片中的条形码是否太小，导致 IronBarcode 无法读取？只想读取图像的特定区域？想从包含多种条形码的图像中只读取特定类型的条形码吗？想要提高整体阅读性能吗？

BarcodeReaderOptions允许用户调整或更改条形码阅读器的行为，以解决所有这些问题。有关设置条形码读取器选项的详细示例，请查看我们的综合指南。以下部分逐一讨论BarcodeReaderOptions中提供的所有可调整属性。

如何指定要读取图像的哪个区域？

IronSoftware.Drawing.CropRectangle类型的属性，允许用户指定IronBarcode应读取图像中的区域。这有助于提高读取性能，因为条形码读取器无需扫描整个图像来查找条形码，同时由于读取区域已指定，读取精度也得以提高。了解有关如何指定作物区域以获得最佳性能的更多信息。

要设置Rectangle类型对象，并指定矩形的坐标、宽度和长度作为参数。接受的测量单位为像素 (px)。

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

Imports IronSoftware.Drawing

' Example of setting CropArea
Dim cropArea As New Rectangle(x:=100, y:=100, width:=300, height:=300)
Dim options As New BarcodeReaderOptions() With {
    .CropArea = cropArea
}

Imports IronSoftware.Drawing

' Example of setting CropArea
Dim cropArea As New Rectangle(x:=100, y:=100, width:=300, height:=300)
Dim options As New BarcodeReaderOptions() With {
    .CropArea = cropArea
}

我应该指定哪种条形码类型以加快读取速度？

默认情况下，IronBarcode 中所有支持的条形码都会以图像形式扫描。不过，如果用户知道有哪些类型的条形码或希望在图像中读取哪些类型的条形码，那么将此属性设置为只读取特定类型的条形码将大大提高读取性能和准确性，因为条形码阅读器无需遍历条形码集合来解释和读取条形码。

要使用此属性，只需将BarcodeEncoding枚举的一个字段即可。以下是IronBarcode支持的每种条形码类型的示例。

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

' Example: Expect only QR codes and Code128
Dim options As New BarcodeReaderOptions() With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}

' Example: Expect only QR codes and Code128
Dim options As New BarcodeReaderOptions() With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}

何时应禁用多条形码读取？

IronBarcode 默认会扫描图像中所有可用的条形码，包括扫描整个图像文件并将读取的条形码值添加到字符串数组中。但是，如果用户不希望读取图像文件中的多个条形码，用户可以将此属性设置为false ，这样条形码读取器在找到条形码值后就会停止扫描。这将再次提高 IronBarcode 的性能和读取速度。有关读取多个条形码的更多信息，请参阅我们的专用指南。

图像过滤器如何提高条形码识别能力？

可以在BarcodeReaderOptions中添加的属性之一是图像滤镜的集合。图像滤波器对于预处理输入到 IronBarcode 的原始图像非常重要。要在ImageFilter集合。有关图像校正技术（包括过滤器应用）的全面指导，请访问我们的教程。

如何优化线程以提高性能？

IronBarcode 允许用户启用和调整并行线程执行的数量，从而提高处理速度和效率。并行线程是指在不同的处理器核心上同时执行多个线程。 IronBarcode中MaxParallelThread属性的默认值是4。用户可以根据其机器的能力和资源量进行调整。

我是否应该启用多线程处理？

该特性使 IronBarcode 能够并行读取多个图像。 #Multithreaded的默认设置为true，因此将自动管理多个线程以提高批处理条形码读取任务的性能。

为什么要删除假阳性读数？

此属性可消除所有误报的条形码读取结果。假阳性条形码读取是指对条形码值的错误读取，但却被识别为有效。这可能是由于排序过程中的错误，或是条形码标签或准备过程中的错误造成的。因此，将RemoveFalsePositive设置为true将消除误报的条形码读取，从而提高条形码读取的准确性。但是，如果用户为了追求性能而牺牲准确性，则将此属性设置为false会有所帮助。此属性的默认值为true 。

MinScanLines 如何影响检测准确率？

MinScanLines设置了必须同意条形码结果的最小扫描线数量，以使其被视为有效。默认值为 2。增加此值可减少误报，但可能会导致无法检测到条纹较细或质量较低的 BARCODE。将其调低至 1 可提高对难以识别的 BarCode 的灵敏度，但可能会引入噪点。

哪些扫描模式可用于不同的使用案例？

定义 IronBarcode 如何扫描和检测图像中的条形码。

Auto：以自动图像预处理和配置了最优读取选项的方式读取条形码。为获得最佳效果和性能，建议采用此方法。
IronSoftware.Drawing.PointF数组返回。此模式无法读取检测到的条形码；它只返回每个条形码的位置。
MachineLearningScan：通过机器学习检测扫描图像中的条形码并读取它们。
OnlyBasicScan：不使用机器学习检测、自动图像预处理或读取器选项配置读取条形码。此选项可以单独与IronBarCode.Slim一起使用。

阅读速度设置如何影响准确性？

顾名思义，Speed属性使用户能够进一步优化IronBarcode读取器的性能。与RemoveFalsePositive属性类似，调整此属性可以提高性能，但会以牺牲准确性为代价。要深入了解读取速度选项，包括性能基准，请查看我们的详细指南。它接受ReadingSpeed枚举，如下所示有4个级别：

Faster：启用最快的条形码读取，但降低准确性。该过程跳过了图像预处理，经常导致条形码结果为空。仅当输入图像清晰锐利时才使用此设置。
Speed属性。它通过尝试对图像进行轻微处理，使条形码区域更加清晰，从而在准确性和读取性能之间取得平衡，使条形码读取器能够检测到它。大多数情况下，这种设置足以让 IronBarcode 读取条形码图像并产生准确的输出。
ReadingSpeed.Detailed。 IronBarcode 将对图像进行中等处理，以进一步清晰地显示条形码区域，以便条形码阅读器能够检测到条形码。此设置对于检测较小或不太清晰的条形码图像非常有用。
ExtremeDetail：由于其高CPU消耗过程，此设置是最不推荐的。将对条形码图像进行大量处理，以便阅读器能够读取条形码。建议用户在选择此设置之前，先对图像进行预处理/应用滤镜。

何时应使用 Code39 扩展模式？

此设置允许以扩展模式读取和解释 Code39 类型的条形码，其中将应用完整的 ASCII 字符集。将UseCode39ExtendedMode设置为true将启用更准确的Code39条形码阅读。

如何使用自定义选项实现高级条形码读取？

既然我们已经了解了用户可以调整的所有选项，无论是提高性能还是准确性，下面就来看看如何在代码中应用这些选项。下面的代码片段展示了BarcodeReaderOptions的全面使用。

using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Linq;

// Create custom reader options
var options = new BarcodeReaderOptions()
{
    // Specify expected barcode types for better performance
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.Code39,
    
    // Define specific area to scan (x, y, width, height in pixels)
    CropArea = new Rectangle(100, 100, 500, 400),
    
    // Set reading speed to balance accuracy and performance
    Speed = ReadingSpeed.Balanced,
    
    // Enable multithreading for better performance
    Multithreaded = true,
    MaxParallelThreads = 4,
    
    // Remove false positives for accuracy
    RemoveFalsePositive = true,

    // Minimum scan lines that must agree for a valid result (default 2)
    MinScanLines = 1,

    // Enable Code39 extended mode if needed
    UseCode39ExtendedMode = true,
    
    // Set scan mode
    ScanMode = BarcodeScanMode.Auto,
    
    // Add image filters for better recognition
    ImageFilters = new ImageFilterCollection() { 
        new SharpenFilter(),
        new InvertFilter(),
        new ContrastFilter()
    }
};

// Read barcodes with custom options
var results = BarcodeReader.Read(@"C:\path\to\your\barcode-image.png", options);

// Process results
if (results.Any())
{
    foreach (var barcode in results)
    {
        Console.WriteLine($"Barcode Type: {barcode.BarcodeType}");
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Position: {string.Join(", ", barcode.Points.Select(p => $"({p.X}, {p.Y})"))}");
        Console.WriteLine("---");
    }
}
else
{
    Console.WriteLine("No barcodes found in the image.");
}

using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Linq;

// Create custom reader options
var options = new BarcodeReaderOptions()
{
    // Specify expected barcode types for better performance
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.Code39,
    
    // Define specific area to scan (x, y, width, height in pixels)
    CropArea = new Rectangle(100, 100, 500, 400),
    
    // Set reading speed to balance accuracy and performance
    Speed = ReadingSpeed.Balanced,
    
    // Enable multithreading for better performance
    Multithreaded = true,
    MaxParallelThreads = 4,
    
    // Remove false positives for accuracy
    RemoveFalsePositive = true,

    // Minimum scan lines that must agree for a valid result (default 2)
    MinScanLines = 1,

    // Enable Code39 extended mode if needed
    UseCode39ExtendedMode = true,
    
    // Set scan mode
    ScanMode = BarcodeScanMode.Auto,
    
    // Add image filters for better recognition
    ImageFilters = new ImageFilterCollection() { 
        new SharpenFilter(),
        new InvertFilter(),
        new ContrastFilter()
    }
};

// Read barcodes with custom options
var results = BarcodeReader.Read(@"C:\path\to\your\barcode-image.png", options);

// Process results
if (results.Any())
{
    foreach (var barcode in results)
    {
        Console.WriteLine($"Barcode Type: {barcode.BarcodeType}");
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Position: {string.Join(", ", barcode.Points.Select(p => $"({p.X}, {p.Y})"))}");
        Console.WriteLine("---");
    }
}
else
{
    Console.WriteLine("No barcodes found in the image.");
}

从代码片段中可以看出，要使用BarcodeReaderOptions的属性。初始化的BarcodeReaderOptions中的所有设置。

如果您遇到条形码无法识别的问题，我们的故障排除指南提供了常见问题的解决方案和提高条形码扫描准确性的技巧。

常见问题解答

C# 中的条形码读取支持哪些图像格式？

IronBarcode 支持从多种图像格式读取条形码，包括 SVG（可缩放矢量图形）、JPEG、PNG、GIF、TIFF（标记图像文件格式）和 BMP（位图图像文件）。这种全面的格式支持由 IronDrawing 提供，可实现从各种图像类型中无缝提取条形码。

如何仅用一行代码从图像文件中读取 BarCode？

using IronBarcode，您只需一行代码就能从图像中读取条形码：`var results = IronBarCode.BarcodeReader.Read("path/to/image.png");`.此简单方法调用可自动检测并提取 PNG、JPEG、GIF、BMP 和 TIFF 文件中的条码数据，无需任何复杂设置。

我能否指定在读取图像时要查找哪些类型的 BarCode？

是的，IronBarcode 允许您使用 BarcodeReaderOptions 中的 ExpectBarcodeTypes 属性指定条码类型。这种有针对性的方法通过只关注您期望在图像中找到的条码格式来提高读取性能。

是否可以从图像中的特定区域读取 BarCode？

当然可以！IronBarcode 提供的 CropArea 属性允许您在图像中指定条形码所在的特定区域。该功能对于大图像或当您知道条形码的大致位置时特别有用，可大大提高处理速度。

如何配置高级阅读设置以提高准确性？

IronBarcode 提供 BarcodeReaderOptions 类来配置高级读取设置。其中包括自定义条码检测灵敏度、图像预处理和其他参数的选项，这些参数可在处理具有挑战性的图像或特定条码类型时提高准确性。

是什么让 C# 开发人员从图像中读取 BarCode 变得简单？

IronBarcode 通过提供 BarcodeReader.Read() 方法简化了条形码读取，该方法开箱即用，支持多种图像格式。开发人员只需将文件名或文件路径指定为参数，即可将条形码读取功能直接集成到任何 C# 应用程序中。

What are the benefits of using multithreading in IronBarcode?

Multithreading in IronBarcode allows multiple barcodes to be processed simultaneously, improving the speed and efficiency of barcode reading, especially in batch processing tasks.

How do image filters improve barcode recognition in IronBarcode?

Image filters in IronBarcode enhance preprocessing by improving the clarity of barcode images. Filters like the `SharpenFilter` and `ContrastFilter` help optimize image quality for better recognition.

What is the `MinScanLines` property used for in IronBarcode?

The `MinScanLines` property sets the minimum number of scan lines that must agree on a barcode result for it to be considered valid, reducing false positives while ensuring detection accuracy.

How do I handle multiple barcode types with IronBarcode?

In IronBarcode, you can specify which barcode types to read by setting the `ExpectBarcodeTypes` property in `BarcodeReaderOptions`, which improves performance by focusing on specific barcode types.