如何使用 IronOCR 在 C## 中读取条形码和二维码。

IronOCR 可通过在配置中设置 ReadBarCodes = true 在 C# 中读取条形码和二维码。 该单一设置可从 PDF 和图像中自动提取条形码值，同时还能识别常规文本，支持 20 多种条形码格式，包括 QR 码、Code 128 码和数据矩阵。

快速入门：立即从 PDF 读取条形码

只需一个设置即可启用条形码检测，并使用 IronOCR 扫描 PDF。 下面的代码展示了如何打开条形码读取、处理 PDF 和检索解码值。

```cs:title=立即试用 IronOCR 的条码阅读器 var result = new IronOcr.IronTesseract() { Configuration = new IronOcr.TesseractConfiguration { ReadBarCodes = true }.}.Read(new IronOcr.OcrPdfInput("document.pdf"))； foreach(var bc in result.BarCode) Console.WriteLine(bc.Value)；

<div class="hsg-featured-snippet">
    <h3>最小工作流程（5 个步骤）</h3>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://nuget.org/packages/IronOcr/">下载一个用于读取条形码和二维码的 C# 库。</a></li>
        <li>导入目标图像和PDF文档。</li>
        <li>通过将 <strong><code>ReadBarCodes</code></strong> 属性设置为 true 来启用条形码读取。</li>
        <li>使用<code>Read</code>方法执行 OCR 操作，操作方式与往常一样。</li>
        <li>输出检测到的文本和条形码值。</li>
    </ol>
</div>

<br class="clear">

<h2>如何从 PDF 文档中读取 BarCode？

创建一个 `IronTesseract` 对象来执行阅读。 将 **`ReadBarCodes`** 属性设置为 true 以启用条形码检测。 使用 [`OcrPdfInput`](https://ironsoftware.com/csharp/ocr/how-to/input-pdfs/) 构造函数导入 PDF 文档。 使用 ``Read`` 方法对导入的 PDF 执行 OCR。

下面是一个使用该 PDF 文档的示例：

<iframe loading="lazy" src="/static-assets/ocr/how-to/barcodes/pdfWithBarcodes.pdf#view=fit" width="100%" height="400px"></iframe>

```csharp
:path=/static-assets/ocr/content-code-examples/how-to/barcodes-read-barcodes.cs

多个条形码值出现在条形码下方，并包含在提取的文本中。

为什么 IronOCR 可同时提取文本和条形码值？ IronOCR 的双重提取功能可提供全面的文档分析。 在处理包含文本和条形码的文档时，该库可执行[标准 OCR 文本提取](https://ironsoftware.com/csharp/ocr/examples/simple-csharp-ocr-tesseract/)，同时解码条形码符号。 这种统一的方法无需进行多次处理或使用单独的库。 文本提取捕捉人类可读的元素，而条形码检测则识别和解码机器可读的数据。 这将使发票、运输标签或库存报告等文档受益匪浅，因为这些文档中的条形码值与打印文本相关联。 [`OcrResult` 类](https://ironsoftware.com/csharp/ocr/examples/results-objects/)将这些输出分开--通过 `Text` 属性访问文本，通过 `Barcodes` 集合访问条形码数据。

支持哪些 BarCode 格式？ IronOCR 支持 20 多种条形码格式： **一维条形码：** - 代码 128、代码 39、代码 93 - EAN-13、EAN-8 - UPC-A, UPC-E - Codabar - ITF（交错 2，共 5 页） - MSI - Plessey **二维条形码：** - 二维码 - 数据矩阵 - PDF417 - 阿兹台克代码 - MaxiCode 对于[读取 MICR 支票](https://ironsoftware.com/csharp/ocr/examples/read-micr-cheque/)或处理[身份文件](https://ironsoftware.com/csharp/ocr/troubleshooting/identity-documents/)等专业应用，IronOCR 的条形码功能是对其文本提取功能的补充。

什么情况下应使用 OCR 读取条形码而不是专用条形码库？ 在以下情况下选择 IronOCR 的集成条形码读取功能： 1.**混合内容处理**：文档包含文本和 BarCode（运输标签、发票或 [ 扫描文档](https://ironsoftware.com/csharp/ocr/examples/read-scanned-document/)）。 2.**单库偏好**：您希望尽量减少依赖性并使用一种解决方案 3.**PDF处理**：您已经在使用IronOCR进行[PDF OCR文本提取](https://ironsoftware.com/csharp/ocr/examples/csharp-pdf-ocr/)。 4.**复杂文档布局**：文档在文本区域或[表格](https://ironsoftware.com/csharp/ocr/examples/read-table-in-document/)中嵌入了 BarCode 使用专用条形码库时： - 处理大容量的纯条形码图像 - 要求实时扫描 BarCode（响应时间 < 50ms） - 处理损坏或低质量的 BarCode，需要专门的算法 - 利用摄像头优化实施移动条形码扫描

如何从文档中读取二维码？ <！-- 说明：显示逐步过程的截图 --> 与条形码读取一样，将 `ReadBarCodes` 属性设置为 true。 除文件路径外，无需更改其他代码。 使用二维码处理此 PDF 文档： ```csharp :path=/static-assets/ocr/content-code-examples/how-to/barcodes-read-qr-codes.cs ```

为什么相同的配置对 BarCode 和 QR 码都有效？ IronOCR 的统一条形码检测引擎对所有机器可读代码一视同仁。 The `ReadBarCodes` configuration activates a comprehensive symbology detector that recognizes both 1D (linear barcodes) and 2D (QR codes, Data Matrix) formats without requiring format-specific settings. 这种设计简化了实施过程，降低了配置的复杂性。 自动检测算法 - 根据模式识别识别符号类型 - 应用适当的解码算法 - 处理方向和尺寸变化 - 无论条形码类型如何，都能以一致的格式返回结果 这种方法反映了[计算机视觉模型](https://ironsoftware.com/csharp/ocr/how-to/computer-vision/)的工作方式--对多种格式进行培训，以提供通用的检测能力。

使用 OCR 阅读 QR 码时有哪些常见问题？ 处理 QR 代码时常见的挑战包括 1.** 解决问题**：PDF 中的 QR 代码可能被降采样，低于最小模块大小。请使用[DPI设置](https://ironsoftware.com/csharp/ocr/how-to/dpi-setting/)以确保足够的分辨率（建议最低为 300 DPI）。 2.**图像质量**：扫描的 QR 代码通常会出现模糊、噪点或失真。 应用[图像校正过滤器](https://ironsoftware.com/csharp/ocr/how-to/image-quality-correction/)以提高清晰度： ```csharp // Apply filters to improve QR code readability ocrTesseract.Configuration.ReadBarCodes = true; var input = new OcrImageInput("qr-code-scan.jpg"); input.DeNoise(); input.Sharpen(); input.EnhanceResolution(); var result = ocrTesseract.Read(input); ``` 3.**方向问题**：有角度的 QR 代码可能无法正确解码。 启用[页面旋转检测](https://ironsoftware.com/csharp/ocr/how-to/detect-page-rotation/)以处理错位文档。 4.**混合内容干扰**：文字或图形与 QR 代码重叠会妨碍检测。 必要时使用[裁剪区域](https://ironsoftware.com/csharp/ocr/troubleshooting/crop-regions-rectangles/)来隔离二维码区域。

如何提高二维码识别准确率？ 使用这些技术优化 QR 代码识别： 1.**预处理图像**：使用 [Filter Wizard](https://ironsoftware.com/csharp/ocr/how-to/filter-wizard/) 确定最佳增强设置： ```csharp // Enhanced QR code reading with preprocessing var ocrTesseract = new IronTesseract(); ocrTesseract.Configuration.ReadBarCodes = true; // Configure for better QR detection var input = new OcrImageInput("document-with-qr.pdf"); input.TargetDPI = 300; // Ensure sufficient resolution input.Binarize(); // Convert to black and white input.DeNoise(); // Remove image artifacts var result = ocrTesseract.Read(input); ``` 2.**处理多个页面**：适用于[多页文档](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multipage-tiff/)，其中包含跨多页的二维码： ```csharp // Process multi-page documents efficiently using var pdfInput = new OcrPdfInput("multi-page-qr-document.pdf"); pdfInput.TargetDPI = 300; var results = ocrTesseract.Read(pdfInput); foreach (var page in results.Pages) { Console.WriteLine($"Page {page.PageNumber}:"); foreach (var barcode in page.Barcodes) { Console.WriteLine($" QR Code: {barcode.Value}"); Console.WriteLine($" Location: X={barcode.X}, Y={barcode.Y}"); } } ``` 3.**同步处理**：使用 [async 方法](https://ironsoftware.com/csharp/ocr/how-to/async/)可提高处理多个文档的性能： ```csharp // Asynchronous QR code reading var result = await ocrTesseract.ReadAsync(imageInput); ``` 4.**调试识别问题**：启用[结果高亮显示](https://ironsoftware.com/csharp/ocr/how-to/highlight-texts-as-images/)以可视化 IronOCR 检测到的内容： ```csharp result.SaveAsHighlightedImage("qr-detection-debug.png"); ``` ### 大规模条形码处理的性能优化 在处理带有 BarCode 和 QR 码的数千份文件时，实施这些优化策略： 1.**多线程**：利用[多线程处理](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multithreading-for-speed/)同时处理多个文档： ```csharp // Process multiple documents in parallel var documents = new[] { "doc1.pdf", "doc2.pdf", "doc3.pdf" }; var results = documents.AsParallel().Select(doc => { var tesseract = new IronTesseract(); tesseract.Configuration.ReadBarCodes = true; return tesseract.Read(new OcrPdfInput(doc)); }).ToList(); ``` 2.**内存管理**：对于长期运行的操作，请使用 [ 中止令牌](https://ironsoftware.com/csharp/ocr/examples/abort-token/)： ```csharp // Implement cancellation for large batch processing using var cts = new CancellationTokenSource(); ocrTesseract.Configuration.CancellationToken = cts.Token; // Cancel if processing takes too long cts.CancelAfter(TimeSpan.FromMinutes(5)); ``` 3.**结果导出**：将结果保存为[可搜索的 PDF 文件](https://ironsoftware.com/csharp/ocr/examples/make-pdf-searchable/)，以保留文本和条形码数据： ```csharp // Export results with embedded barcode values result.SaveAsSearchablePdf("output-with-barcodes.pdf"); ``` ### 与业务应用程序集成 IronOCR 的 BarCode 功能可与现有的 .NET 应用程序无缝集成。 常见的集成场景包括 - **库存管理**：从装运清单中提取产品代码 - **文档存档**：通过嵌入的条形码标识符索引扫描文档 - **发票处理**：将条形码 SKU 与 [ 财务文档](https://ironsoftware.com/csharp/ocr/troubleshooting/financial-language-pack/)中的细列项目相匹配 - **医疗记录**：在处理医疗表格的同时处理患者腕带条形码 对于处理大量条形码和 QR 码的生产应用程序，可考虑实施 [ 进度跟踪](https://ironsoftware.com/csharp/ocr/how-to/progress-tracking/)，以监控处理状态并根据实际指标优化性能。