QR Code .NET Core：使用 C# 读取和生成二维码

如何安装二维码库？

通过NuGet安装IronQR只需几秒钟。 打开 Visual Studio，转到"工具"> "NuGet程序包管理器">"管理解决方案的NuGet程序包" ，搜索 IronQR，然后单击"安装" 。 该软件包依赖项极少，开箱即用，支持 Windows、macOS 和 Linux 系统。

Install-Package IronQR

IronQR 的目标平台为.NET Core 6、7、8、9 和 10，以及.NET Framework 4.6.2 及更高版本。 对于跨平台项目，SkiaSharp 集成可以处理非 W​​indows 运行时上的图像处理。 该库无需额外的运行时配置即可与ASP.NET Core Web 应用程序、控制台应用程序和桌面解决方案配合使用。 安装完成后，所有必要的扩展方法和类型均可立即使用。

如何从图像中读取基本二维码？

从图像文件中读取二维码数据只需要几行代码。 QrReader 类使用先进的机器学习模型来评估图像质量并自动选择正确的分割模式，即使输入图像不理想，也能提供准确的结果。

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

如何提取高级二维码数据？

除了基本的数值解码之外， IronQR还公开了每个扫描符号的坐标、原始数据段和模块级信息。 这对于需要准确知道二维码在页面上位置的文档处理工作流程，或者对于必须在单个图像中处理多个二维码的应用程序来说至关重要。

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

纠错级别如何影响二维码质量？

纠错机制允许二维码扫描器即使在部分代码被遮挡、印刷不良或物理损坏的情况下也能恢复原始数据。 二维码标准定义了四个级别——低(L)、中(M)、四分位(Q)和高(H)——每个级别都以存储容量换取损坏容忍度。

生成二维码时，指定更高的纠错级别可确保输出在实际扫描条件下保持稳定：

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

如何生成包含国际字符的二维码？

IronQR支持所有类型的 QR 编码模式：数字、字母数字、字节和汉字。 对于日文文本和其他Unicode内容，该库会自动选择最节省空间的编码方式：

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

如何使用有效载荷生成器生成结构化二维码数据？

编码纯 URL 的二维码适用于简单的链接共享，但许多应用程序需要编码结构化数据——WiFi 凭据、 vCard 格式的联系人卡片或事件数据。 手动格式化这些有效载荷容易出错； 缺少分号或字段顺序错误会导致扫描仪错误解读数据。

IronQR提供了有效负载辅助函数，可以正确构建这些结构化字符串：

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

如何自定义二维码外观？

IronQR让您可以控制生成的二维码的视觉外观，同时又不影响其可扫描性。 您可以更改前景和背景颜色，应用自定义品牌标识，或将徽标嵌入到中心的静默区。

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

嵌入徽标会减少有效数据区域，因此当提供徽标时，库需要 H 级纠错。 中心预留的安静区域约占代码表面积的 30%，这在 H 级的恢复能力范围内。 该库会自动强制执行此约束——如果您在徽标旁边设置较低的纠错级别， IronQR将引发带有描述性消息的异常，而不是生成扫描不可靠的代码。

对于ASP.NET Core应用程序， ASP.NET Core二维码生成器教程展示了如何从控制器操作中提供生成的二维码作为图像响应。 输出流直接写入响应，无需中间文件 I/O，从而保持高流量端点的低延迟。

如何在ASP.NET Core应用程序中读取二维码？

从上传的图像、文档处理流程或自动检测系统中扫描服务器端的二维码是读取 API 的常见用例。 ASP.NET二维码扫描器指南涵盖了完整的控制器和服务设置，但其核心读取模式与控制台应用程序相同：

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

AnyBitmap.FromStream() 方法接受任何可读流，因此相同的代码路径适用于通过表单上传的文件、从 Blob 存储中获取的图像或从视频管道中提取的帧。控制器不会将任何临时文件写入磁盘，这对于文件系统可能为只读的容器化部署至关重要。

对于高吞吐量场景，请将 QrReader 作为单例在每个应用程序生命周期内实例化一次，因为 ML 模型加载成本是在首次构造时支付的。 后续对同一实例的 Read() 调用是线程安全的，并且共享已加载的模型。

如何在.NET MAUI应用程序中生成二维码？

.NET MAUI QR 码教程演示了在 iOS、Android、macOS 和 Windows 上的完整跨平台生成过程。 IronQR在非 Windows 平台上运行时使用SkiaSharp渲染后端，从而在所有 MAUI 目标上提供一致的输出。

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

在移动目标上，ExportBytes() 返回一个 PNG 字节数组，您可以将其直接输入到 StreamImageSource 或写入到 ImageButton。 MAUI 脚手架不需要特定于平台的代码路径——相同的生成逻辑在所有四个 MAUI 目标平台上运行完全相同。

对于.NET项目， API接口是相同的； 只有语法不同。 该库以单个NuGet包的形式提供，无需单独的 VB .NET程序集。

下一步计划是什么？

IronQR涵盖了.NET中完整的二维码生命周期——从基本生成和结构化有效载荷编码到利用机器学习读取损坏或品牌化的二维码。 该库处理汉字编码、纠错配置和跨平台图像输出，让您可以专注于应用程序特有的逻辑。

将所学知识付诸实践：

• 查看C# 二维码阅读器教程，深入了解读取 API 和结果处理。
• 完成C# 二维码生成器应用程序教程，获得完整的项目演示。
• 浏览代码示例，查看更多生成和读取模式。 -购买IronQR许可证即可解锁所有功能以进行生产部署，或者如果您需要更多评估时间，可以延长免费试用期。