IronBarcode 操作指南 校验和 & 格式验证 如何在C#中验证条码校验和并使用格式感知阅读 Darrius Serrant 已更新:2026年3月4日 下载 IronBarcode NuGet 下载 DLL 下载 免费试用 LLM副本 LLM副本 将页面复制为 Markdown 格式,用于 LLMs 在 ChatGPT 中打开 向 ChatGPT 咨询此页面 在双子座打开 向 Gemini 询问此页面 在 Grok 中打开 向 Grok 询问此页面 打开困惑 向 Perplexity 询问有关此页面的信息 分享 在 Facebook 上分享 分享到 X(Twitter) 在 LinkedIn 上分享 复制链接 电子邮件文章 This article was translated from English: Does it need improvement? Translated View the article in English 条形码校验和有助于检测替换错误。 例如,EAN-13 标签中一个数字颠倒就可能导致包裹被送到错误的仓库。 格式感知读取通过将解码器限制为预期的符号体系,提供了额外的验证层。 这种方法通过跳过不必要的格式检测器来减少背景噪声造成的误报并缩短扫描时间。 IronBarcode在解码过程中会自动执行校验和验证。 每种条码编码的校验位算法默认运行,失败的条码会在返回结果之前被丢弃。 BarcodeReaderOptions.ExpectBarcodeTypes 属性将读取限制为特定格式,而 RemoveFalsePositive 则增加了对模糊读取的二次扫描。 本指南解释了如何验证条形码校验和,将读取限制为预期格式,并将这两种技术结合到一个分层质量门中,使用 BarcodeReaderOptions。 快速入门:使用校验和与格式约束验证条码 配置 BarcodeReaderOptions 与 ExpectBarcodeTypes 和 RemoveFalsePositive,以将读取限制为预期符号体系,并自动进行校验和验证。 :path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/quickstart.cs using IronBarCode; // Format-constrained read with false-positive removal. // Limit the decoder to EAN-13 and Code128; checksums are // validated automatically and failures are silently discarded. var options = new BarcodeReaderOptions { ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.Code128, RemoveFalsePositive = true, Speed = ReadingSpeed.Balanced }; BarcodeResults results = BarcodeReader.Read("label.png", options); $vbLabelText $csharpLabel 最小工作流程(5 个步骤) 从NuGet下载IronBarcode库 创建BarcodeReaderOptions实例 将ExpectBarcodeTypes设置为管道中存在的符号集 启用RemoveFalsePositive进行二次验证 调用BarcodeReader.Read进行解码,解码过程中会自动验证校验和。 如何验证条码校验和? IronBarcode在解码过程中会根据每种符号体系的规范验证校验和。 例如,读取 EAN-13 条形码时,模块10 校验位由前 12 位数字计算得出,并与第 13 位进行比较。 如果数字不匹配,则条形码将被默默拒绝,并且不会出现在 BarcodeResults 集合中。 这种方法适用于所有带有强制校验位的格式,包括 UPC-A、UPC-E、EAN-8、Code128、ITF 等。 这种隐式模型不同于那些公开显式开关的库。 下表比较了这两种方法: 校验和验证模型对比: IronBarcode与 Aspose.Barcode 方面IronBarcodeAspose.BarCode 验证触发自动运行;每次解码期间运行显式: 校验和Validation.On / Off / Default 需要开发者操作无;无效条形码已从结果中排除。读取条形码前,请设置BarcodeSettings.校验和Validation 校验和禁用未公开;强制格式始终强制执行校验和。是的; 校验和Validation.Off会跳过验证 可选校验和格式(Code39)使用Confidence + RemoveFalsePositive来过滤低质量读取数据显式启用Enable校验和.是 故障行为结果中静默遗漏条码条形码可能带有单独的校验和值,以便人工检查。 对于具有可选校验和的符号体系(例如 Code39),该库使用置信度评分和 RemoveFalsePositive 而不是校验和切换。 输入 Code128 仓库货架标签(成功路径)和没有条形码的空白图像(失败路径)。 warehouse-rack.png(成功路径) blank-no-barcode.png(失败路径——无条形码) :path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/checksum-confidence.cs using IronBarCode; // Constrain reads to 1D formats and enable secondary verification. // ConfidenceThreshold rejects decodes where the ML detector falls below 85%, // acting as a quality gate for optional-checksum symbologies like Code39. var options = new BarcodeReaderOptions { ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional, RemoveFalsePositive = true, ConfidenceThreshold = 0.85, Speed = ReadingSpeed.Detailed }; BarcodeResults results = BarcodeReader.Read("warehouse-rack.png", options); foreach (BarcodeResult result in results) { // Each result has passed checksum validation (mandatory formats) // and the 85% confidence threshold, so no additional filtering is needed. Console.WriteLine($"[{result.BarcodeType}] {result.Value} page={result.PageNumber}"); } if (results.Count == 0) { Console.Error.WriteLine("No valid barcodes found. Possible causes:"); Console.Error.WriteLine(" - Check digit mismatch (barcode silently rejected)"); Console.Error.WriteLine(" - Confidence below 85% threshold"); Console.Error.WriteLine(" - Format not in ExpectBarcodeTypes"); } $vbLabelText $csharpLabel 输出 成功之路 仓库货架条形码在第 0 页返回为 RACK-A1-LOT-7382。它通过了 85% 的置信度阈值并通过了校验和验证,因此显示在 BarcodeResults 中。 故障路径 将 ConfidenceThreshold 的值提高到其默认值 0.7 以上,可以进一步收紧 Code39 等可选校验和符号体系的此限制。 校验和验证完成后,下一步是将读取器限制为管道所需的条形码格式。 如何使用格式感知条码读取? BarcodeEncoding 枚举类型为标志类型,允许使用按位或运算符组合多种格式。 设置 ExpectBarcodeTypes 会将读取器限制为这些格式,并跳过对其他格式的检测。 常用的BarcodeEncoding值 Value翻译类别说明校验和 BarcodeEncoding.All元所有支持的格式(默认行为)每格式 BarcodeEncoding.AllOneDimensional元所有线性(1D)格式包括堆叠每格式 BarcodeEncoding.AllTwoDimensional元所有矩阵/网格(二维)格式每格式 BarcodeEncoding.Code1281D高密度字母数字字符集(物流、运输)强制(加权模块103) BarcodeEncoding.EAN131D零售产品识别码,13 位数字强制(模块10) BarcodeEncoding.QRCode二维高容量矩阵(URL、结构化数据)里德-所罗门 ECC BarcodeEncoding.Code391D字母数字(国防、汽车)可选(Mod43) BarcodeEncoding.UPCA1D北美零售,12位数强制(模块10) BarcodeEncoding.DataMatrix二维紧凑型矩阵(电子、制药)里德-所罗门 ECC BarcodeEncoding.PDF417二维堆叠(身份证、交通卡)里德-所罗门 ECC 除了速度之外,限制格式集还起到验证门的作用:即使条形码实际存在于图像中,任何未列出的符号体系的条形码也会被排除在结果之外。 输入 Code128 运输标签(成功路径)和不符合 Code128 限制的二维码(失败路径)。 shipping-label.png(成功路径 — Code128 符合约束) qr-format-mismatch.png(失败路径——二维码被仅支持 Code128 的过滤器拒绝) :path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/format-constrained.cs using IronBarCode; // Constrained read: only Code128 barcodes are returned. // Faster because the reader skips all other format detectors. var constrainedOptions = new BarcodeReaderOptions { ExpectBarcodeTypes = BarcodeEncoding.Code128, Speed = ReadingSpeed.Faster, ExpectMultipleBarcodes = false }; // Broad read: all supported formats are scanned. // Useful for verification or when the image format is unknown. var broadOptions = new BarcodeReaderOptions { ExpectBarcodeTypes = BarcodeEncoding.All, Speed = ReadingSpeed.Detailed, ExpectMultipleBarcodes = true }; string imagePath = "shipping-label.png"; BarcodeResults constrained = BarcodeReader.Read(imagePath, constrainedOptions); Console.WriteLine($"Constrained: {constrained.Count} Code128 barcode(s) found"); BarcodeResults broad = BarcodeReader.Read(imagePath, broadOptions); Console.WriteLine($"Broad: {broad.Count} barcode(s) found across all formats"); foreach (BarcodeResult result in broad) { Console.WriteLine($" [{result.BarcodeType}] {result.Value}"); } $vbLabelText $csharpLabel 输出 成功之路 发货标签的值为 SHIP-2024-00438。 受限读取立即检测到了它,因为 Code128 是过滤器所期望的,而广泛读取在所有格式中都确认了相同的结果。 故障路径 受限读取结果为空是验证信号,而不是错误; 记录差异以供审核。 对于混合使用条形码类型的流程(例如,装箱单上同时包含 EAN-13 产品代码和 Code128 跟踪编号),请将预期格式结合起来: :path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/multi-format-combine.cs using IronBarCode; // Combine multiple format flags with | to scan for more than one symbology // in a single pass. Each BarcodeResult.BarcodeType identifies which format // was decoded, enabling downstream routing logic per symbology. var options = new BarcodeReaderOptions { ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.Code128, ExpectMultipleBarcodes = true }; $vbLabelText $csharpLabel 每个返回的 BarcodeResult.BarcodeType 标识了解码后的格式,从而实现了下游路由。 哪些符号集支持校验和验证? 并非所有条码格式都以相同方式使用校验和。 下表将常用符号体系与其错误检测特性对应起来,从而说明如何针对每种格式设置 ConfidenceThreshold 和 RemoveFalsePositive: 按符号集划分的校验和特性 符号集校验和类型是否强制?建议 EAN-13 / EAN-8模块10是默认设置已足够;始终强制执行校验和。 UPC-A / UPC-E模块10是默认设置已足够;写入时校验位自动更正 Code128加权模块103是默认设置已足够;按规范要求必须使用。 Code39Mod43可选将ConfidenceThreshold提升到0.8+并启用RemoveFalsePositive CodabarMod16可选与 Code39 相同;使用置信度作为质量门控 ITF模块10可选为交错格式启用RemoveFalsePositive 二维码/数据矩阵里德-所罗门 ECC总是结构误差修正;无需额外配置 PDF417里德-所罗门 ECC总是与 QR/DataMatrix 相同;纠错功能是固有的。 对于 QR、DataMatrix 和 PDF417 等二维符号体系,纠错功能已集成到编码结构中。 这些格式无需依赖简单的校验位即可从部分损坏中恢复。 ConfidenceThreshold 在 ML 检测阶段仍然适用,而解码步骤则受益于符号系统的内置冗余。 既然我们已经了解了这两种技术,让我们将它们合并成一个可用于生产的单一验证模式。 如何结合校验和与格式约束? 生产就绪模式集 ConfidenceThreshold 和 Speed 位于单个 BarcodeReaderOptions 对象中。 它们共同构成了一个分层门:格式约束缩小了搜索空间,校验和验证确保了数据完整性,置信度阈值过滤了边缘解码,而误报消除则增加了一次二次验证。 输入 成功路径使用了来自 pos-scans/ 目录的三个 POS 扫描条形码:两个 EAN-13 和一个 UPC-A。 Code128 仓库货架标签被用作故障路径——EAN-13/UPC-A 约束拒绝它,并记录了 REJECT 行。 pos-scan-1.png(成功) pos-scan-2.png(成功) pos-scan-3.png(成功) warehouse-rack.png(失败——代码128被拒绝) :path=/static-assets/barcode/content-code-examples/how-to/checksum-and-format-validation/combined-validation.cs using IronBarCode; // Layered validation for retail POS: EAN-13, UPC-A, and UPC-E only. // Each property adds a distinct filter to the read pipeline. var options = new BarcodeReaderOptions { // Layer 1: format constraint, accept only retail symbologies ExpectBarcodeTypes = BarcodeEncoding.EAN13 | BarcodeEncoding.UPCA | BarcodeEncoding.UPCE, // Layer 2: confidence threshold, reject decodes below 80% ConfidenceThreshold = 0.8, // Layer 3: false-positive removal, runs a secondary verification pass RemoveFalsePositive = true, Speed = ReadingSpeed.Balanced, ExpectMultipleBarcodes = false, // Require 3 agreeing scan lines to reduce phantom reads from noisy images MinScanLines = 3 }; string[] scanFiles = Directory.GetFiles("pos-scans/", "*.png"); foreach (string file in scanFiles) { BarcodeResults results = BarcodeReader.Read(file, options); if (results.Count == 0) { // No barcode passed all validation layers Console.Error.WriteLine($"REJECT {Path.GetFileName(file)}: " + "no valid EAN-13/UPC barcode (checksum, confidence, or format mismatch)"); continue; } BarcodeResult primary = results.First(); // Post-read assertion: verify the decoded format matches expectations. // ExpectBarcodeTypes already constrains the reader; this check documents // intent and surfaces unexpected results during future changes. if (primary.BarcodeType != BarcodeEncoding.EAN13 && primary.BarcodeType != BarcodeEncoding.UPCA && primary.BarcodeType != BarcodeEncoding.UPCE) { Console.Error.WriteLine($"UNEXPECTED FORMAT {Path.GetFileName(file)}: " + $"got {primary.BarcodeType}, expected EAN-13/UPC"); continue; } Console.WriteLine($"OK {Path.GetFileName(file)}: [{primary.BarcodeType}] {primary.Value}"); } $vbLabelText $csharpLabel 输出 成功之路 三张POS扫描图像全部通过。 读取器返回了 4006381333931 和 012345678905 的值。 每个都与"EAN13"匹配 | 上层控制区 | UPCE` 滤波器具有有效的 模块10 校验和,置信度高于 0.8。 故障路径 将 MinScanLines 设置为 3 会增加 1D 条形码有效所需的最小一致扫描线数; 默认值为 2。提高此值可降低噪声扫描线出现虚假读取的风险,但可能会导致漏检细小或部分损坏的条形码。 在零售 POS 环境中,如果标签打印清晰,则取值为 3 是一个保守的选择,可以在不影响吞吐量的情况下加强验证。 读取后的 BarcodeType 断言是一种纵深防御:ExpectBarcodeTypes 已经进行了过滤,但显式检查记录了意图,并在不增加运行时成本的情况下捕获了配置偏差。为了进行速度调优,ReadingSpeed.Faster 适用于干净的机器打印标签; Detailed 和 ExtremeDetail 可以恢复损坏或光线不足的条形码,但代价是扫描时间更长。 我的下一个步骤是什么? 本文介绍了 IronBarcode 的隐式校验和验证模型、格式受限读取的 BarcodeEncoding 标志枚举,以及使用 RemoveFalsePositive 和 MinScanLines 作为分层质量门的组合验证模式。 欲了解更多信息,请探索以下资源: IronBarcode教程——条码读取 进行端到端读取指南。 详细了解 RemoveFalsePositive 机制的误报预防。 信心阈值示例 用于基于ML的检测调整。 BarcodeResult 属性引用的输出数据格式。 图像校正教程 通过滤镜提高解码准确率。 BarcodeReaderOptions API 参考手册 提供完整配置文档。 BarcodeEncoding API 参考手册 列出所有支持的符号集。 获取免费试用许可证在真实环境中测试所有功能,或在管道准备好投入生产时查看许可选项。 常见问题解答 什么是条码校验和验证? 条码校验和验证是通过将计算的校验和与条码中编码的值进行验证,以确保条码数据的准确性。这有助于检测扫描过程中的错误。 IronBarcode如何处理校验和验证? IronBarcode通过为条码数据计算校验和并将其与编码的校验和进行验证来隐式处理校验和验证,确保在扫描过程中数据的完整性。 什么是BarcodeEncoding过滤器? IronBarcode中的BarcodeEncoding过滤器允许您指定在扫描过程中要读取或忽略哪些条码格式,通过聚焦于特定的条码类型,实现更准确和高效的条码处理。 IronBarcode可以执行组合验证吗? 是的,IronBarcode可以通过扫描过程中检查条码的校验和和格式来执行组合验证,以确保只处理有效且格式正确的条码。 是否可以在C#中使用IronBarcode通过格式约束条码读取? 是的,IronBarcode允许您通过指定要包含或排除的格式来约束条码读取,确保您的应用程序只处理相关的条码类型。 格式感知读取在条码处理中为什么重要? 格式感知读取很重要,因为它允许您的应用程序仅处理特定类型的条码,提高速度和准确性,忽略不相关或不支持的条码格式。 如何在IronBarcode中实现格式感知读取? 要在IronBarcode中实现格式感知读取,使用BarcodeEncoding过滤器指定您希望读取的条码格式。这可以通过库的API完成,允许对条码扫描要求进行精确控制。 使用IronBarcode进行条码验证有什么好处? IronBarcode为条码验证提供了多项好处,包括强大的校验和验证、格式感知读取和处理多种条码标准的能力,确保条码处理中的高准确性和灵活性。 Darrius Serrant 立即与工程团队聊天 全栈软件工程师(WebOps) Darrius Serrant 拥有迈阿密大学的计算机科学学士学位,目前在 Iron Software 担任全栈 WebOps 市场工程师。从小就被编码吸引,他认为计算机既神秘又易于接触,使其成为创意和问题解决的理想媒介。在 Iron Software,Darrius 喜欢创造新事物,并简化复杂概念以使其更易理解。作为我们常驻的开发者之一,他还自愿教授学生,与下一代分享他的专业知识。对于 Darrius 来说,他的工作令人满意,因为它被重视并产生真正的影响。 准备开始了吗? Nuget 下载 2,121,847 | 版本: 2026.3 刚刚发布 免费试用 免费 NuGet 下载 总下载量:2,121,847 查看许可证 还在滚动吗? 想快速获得证据? PM > Install-Package BarCode 运行示例 观看您的字符串变成 BarCode。 免费 NuGet 下载 总下载量:2,121,847 查看许可证