国产化条码类库Spire.Barcode教程:使用 C# 读取二维码(QR Code)——从图片或数据流解析

翻译|使用教程|编辑:吉炜炜|2025-07-09 10:07:05.217|阅读 6 次

概述:本文将通过一个简洁明了的示例,演示如何使用 C# 从图像中读取二维码,并在桌面或服务器端项目中轻松实现识别功能。

# 界面/图表报表/文档/IDE等千款热门软控件火热销售中 >>

相关链接:

二维码已成为现代应用的常见组成部分,广泛应用于用户身份验证、移动支付、商品包装和活动票务等场景。很多使用 C# 开发的系统需要从图像或扫描件中提取二维码信息,因此掌握二维码识别技术显得尤为重要。

为满足这类需求,开发者需要一种既可靠又易于集成的二维码解码方式。本文将通过一个简洁明了的示例,演示如何借助 Spire.Barcode for .NET 使用 C# 从图像中读取二维码,并在桌面或服务器端项目中轻松实现识别功能。

   Spire.Barcode for .NET

加入Spire技术交流QQ群(125237868),与更多开发者一起提升文档开发技能。

1. 项目配置

首先我们需要使用支持二维码解码的 .NET 条码库。E-iceblue旗下Spire系列产品是国产化文档处理和转换领域的佼佼者,支持国产化信创。本指南采用 Spire.Barcode for .NET,该库提供简洁API帮助开发者轻松从图片文件和数据流读取二维码。

1.1 通过NuGet安装库

可通过NuGet包管理器安装:

Install-Package Spire.Barcode

1.2 创建控制台项目

演示案例使用 Visual Studio 创建 C# 控制台应用:

  • 支持 .NET Framework.NET Core/.NET 6+ASP.NET 或 Xamarin 跨平台移动开发
  • 添加 Spire.Barcode.dll 引用(如未使用NuGet)

2. 用 C# 从图片读取二维码

通过库提供的静态方法 BarcodeScanner.Scan() 即可从图片文件读取二维码。该方法接收图片路径和 BarcodeType 作为参数,返回匹配指定类型(如二维码)的所有解码结果。此方法支持 JPG、PNG、EMF 等图片格式,适用于控制台应用、桌面应用或处理上传图像的服务端程序。

2.1 C# 示例代码:从图片文件解码二维码

using Spire.Barcode;

class Program
{
    static void Main(string[] args)
    {
        // 加载二维码图片
        string imagePath = @"C:\qr-code.png";

        // 条码扫描器从图片读取二维码
        string[] results = BarcodeScanner.Scan(imagePath, BarCodeType.QRCode);

        // 显示解码结果
        foreach (string result in results)
        {
            Console.WriteLine("二维码内容: " + result + "\n");
        }
    }
}

二维码图片及 C# 解码效果:

C#解码二维码输出结果到控制台

2.2 代码说明

  • Scan() 方法读取并解码图片中所有条码
  • BarCodeType.QRCode 参数确保仅检测二维码(可修改为其他类型)
  • 返回数组格式以支持多二维码场景

3. 用 C# 从数据流读取二维码

在Web API或现代应用中处理内存图像时,常需操作 Stream 对象——例如处理文件上传或读取云存储时。

BarcodeScanner.Scan() 方法直接支持 Stream 输入,无需转换即可轻松解码二维码:

using Spire.Barcode;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        using (FileStream fs = new FileStream(@"C:\qr-code.png", FileMode.Open, FileAccess.Read))
        {
            // 直接从数据流解析二维码
            string[] results = BarcodeScanner.Scan(fs, BarCodeType.QRCode, false);
            foreach (string result in results)
            {
                Console.WriteLine("二维码内容: " + result);
            }
        }
    }
}
此方法特别适用于 WPF 或 ASP.NET Core 等需要内存处理的应用。

4. 提高准确率与错误处理

实际场景中可能因图像质量导致识别失败,以下是提升解码成功率的实践方案:

4.1 优化识别准确率

  • 使用高清图片,避免模糊或过度压缩
  • 保留静区(二维码周围空白区域)
  • 优先选择PNG格式保证清晰度
  • 避免透视畸变——使用正对拍摄的图片

4.2 增强错误处理

通过 try-catch 块优化异常处理:

try
{
    string[] results = BarcodeScanner.Scan(imagePath, BarCodeType.QRCode);

    if (results.Length == 0)
    {
        Console.WriteLine("未检测到二维码");
    }
    else
    {
        Console.WriteLine("二维码内容: " + results[0]);
    }
}
catch (Exception ex)
{
    Console.WriteLine("解码错误: " + ex.Message);
}

5. 进阶技巧:获取二维码在图片上的坐标

有时需要获取二维码在图片中的精确位置(用于裁剪或标注),可通过 ScanInfo() 方法获取边界框:

ScanResult[] results = scanner.ScanInfo(imagePath, BarCodeType.QRCode);
foreach (BarcodeInfo result in results)
{
    Console.WriteLine("内容: " + result.DataString);
    Console.WriteLine($"坐标: " + string.Join(",", result.Vertexes.Select(p => $"({p.X},{p.Y})")) + "\n");
}

该方案可同时获取二维码数据和位置信息。

效果演示:

用C#解码二维码并读取其在图片上的坐标

6. 常见问题

如何在 C# 中读取二维码?

使用 Spire.Barcode for .NET 库的 BarcodeScanner.Scan() 方法,几行代码即可实现从图片或数据流读取二维码。

如何读取其他类型条码(非二维码)?

向 Scan() 方法传入图片路径后,将自动检测所有支持类型。若需限定检测类型(如仅 QR 码或 Code128),传入对应的 BarCodeType 参数即可。

如何扫描一张图片上的多个二维码?

直接使用 BarcodeScanner.Scan() 方法即可扫描一张图片上的多个二维码。该方法支持自动识别图片上条码的类型,并返回所有条码的扫描结果。

7. 总结

使用 Spire.Barcode for .NET 库,仅需少量代码即可在 C# 中实现二维码读取。该方案支持图片和数据流解码,完美适配桌面应用、服务端及 WPF 程序,且配置简单性能优异。

基于此基础,可进一步探索二维码生成、文档集成和实时扫描等进阶应用。

————————————————————————————————————————

关于慧都科技:

慧都科技是一家行业数字化解决方案公司,长期专注于软件、油气与制造行业。公司基于深入的业务理解与管理洞察,以系统化的业务建模驱动技术落地,帮助企业实现智能化运营与长期竞争优势。在软件工程领域,我们提供开发控件、研发管理、代码开发、部署运维等软件开发全链路所需的产品,提供正版授权采购、技术选型、个性化维保等服务,帮助客户实现技术合规、降本增效与风险可控。慧都科技E-iceblue的官方授权代理商,提供E-iceblue系列产品免费试用,咨询,正版销售等于一体的专业化服务E-iceblue旗下Spire系列产品是国产文档处理领域的优秀产品,支持国产化,帮助企业高效构建文档处理的应用程序。

欢迎下载|体验更多E-iceblue产品

获取更多信息请咨询慧都在线客服  ;技术交流Q群(125237868


标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处、不得修改原文相关链接,如果存在内容上的异议请邮件反馈至chenjj@evget.com

文章转载自:慧都网

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
扫码咨询


添加微信 立即咨询

电话咨询

客服热线
023-68661681

TOP