QR Code .NET Core Generator & Reader | IronQR for .NET

如何在 .NET Core 中安装二维码库？

首先，打开 Visual Studio 并单击 "创建 "按钮启动一个新项目。 指定项目名称后，通过 NuGet 包管理器安装库只需几秒钟。 有些开发人员可能会搜索 QRCoder NuGet 软件包，而您可以通过在软件包管理器控制台中运行以下命令来安装 IronQR 框架：

Install-Package IronQR

或者使用 NuGet 软件包管理器用户界面，搜索 "IronQR "并点击安装按钮。 该库提供了与 .NET Core 3.x、.NET 5、6、7、8、9 和 10 兼容的 .NET 实现，是现代网络开发和多平台项目的理想选择。

安装完成后，IronQR在文件顶部添加所需的 using 指令。IronQR 与 IronSoftware.Drawing 集成以实现跨平台图像处理，从而无需使用平台特定的依赖项，例如 System.Drawing.Common(该依赖项在.NET 6 及更高版本中已弃用，无法用于跨平台)。

您可以通过检查 .csproj 文件中的项目包引用，或者确认NuGet包出现在包管理器控制台输出中来验证安装是否成功。 安装完成后， IronQR API 参考文档即可立即使用。

如何生成 QR 代码？

QrWriter 类通常与便捷的扩展方法一起使用，使生成二维码变得简单。 以下是使用顶级语句生成二维码的完整示例的源代码，只需几行代码即可完成：

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

什么是纠错级别，它们为什么重要？

纠错功能决定了 QR 符号在可扫描的同时能承受多大的损坏。 这是可选的高级功能之一，可实现品牌化和持久性。 二维码标准(ISO/IEC 18004)定义了四个级别的纠错，每个级别都以数据容量作为弹性。

使用QrOptions配置纠错：

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrection等级.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrection等级.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

如何使用徽标和颜色自定义 QR 代码外观？

IronQR 的QrStyleOptions功能支持生成与品牌一致的二维码，支持自定义颜色、尺寸和嵌入式徽标。 这对于注重视觉一致性的营销材料、产品包装和活动门票尤其有用。

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

如何在 ASP.NET Core 中生成二维码？

将二维码生成集成到 ASP.NET Core 中遵循模型视图控制器模式。 以下是一个 HomeController 类的实现，它直接从操作方法返回二维码图像：

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

该端点接受 QR 代码数据作为参数，并直接返回生成的 PNG 图像。 该方法同样适用于ASP.NET Core Web API 项目和Razor视图。

对于生产环境的ASP.NET Core应用程序，可以考虑使用 IMemoryCache 或 IDistributedCache 缓存频繁生成的二维码，以减少 CPU 开销。 用于静态 URL、产品标识符或活动链接的二维码在请求之间不会改变，是缓存的理想选择。

您还可以将IronQR集成到 Minimal API 端点中。 ASP.NET Core集成教程提供了一个完整的示例，包括依赖注入模式以及如何从Blazor组件提供二维码图像。

使用顶级语句模式在 Program.cs 注册 IronQR 的许可证密钥，可以保持启动配置的整洁：

using IronQr;

IronQr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronQr;

IronQr.License.LicenseKey = "YOUR-LICENSE-KEY";

在调用任何IronQR方法之前，请设置许可证密钥。 在开发过程中，您可以应用从IronQR许可页面获得的免费试用密钥。

如何对日语 Unicode 文本进行编码？

IronQR支持通过 Kanji 模式对日语 Unicode 文本进行编码，该模式使用比标准编码更少的数据段来高效地对日语 Unicode 字符进行编码。 这样可以减小相同内容的二维码版本(大小)，生成更简单的符号，从而加快扫描速度。

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
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("こんにちは世界");
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

如何使用机器学习读取 QR 码？

IronQR 的独特之处在于其机器学习驱动的二维码阅读器。 即使从一定角度或部分遮挡的图像中读取二维码，ML 模型也能达到很高的准确率——这比许多开源替代方案中使用的基于阈值的传统检测算法具有显著优势。

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

跨平台支持如何工作？

与依赖 System.Drawing.Common(在.NET 6+ 中已弃用，无法跨平台使用)的解决方案不同， IronQR使用 IronSoftware.Drawing 来实现真正的多平台项目。 您的代码可以在 Windows、macOS、Linux、iOS 和 Android 系统中一致运行。 对于多平台项目，无需使用 SkiaSharp 的替代方案IronQR内部会处理平台抽象。

.NET跨平台文档解释了.NET 10 更广泛的平台兼容性问题IronQR通过完全避免使用特定于平台的 API 来遵循这些原则。

IronQR支持以下部署目标：

• .NET 10、9、8、7、6——所有现代.NET版本
• .NET Core 3.x -- 适用于尚未迁移到现代.NET的应用程序
• Xamarin 和 MAUI——用于移动应用程序开发
• Azure Functions 和 AWS Lambda——用于无服务器工作负载

在 Docker 容器中运行时，除了标准的.NET运行时映像之外，不需要任何其他系统软件包。 与需要原生 GDI+ 依赖项的库相比，这简化了您的 Dockerfile。 IronQR部署指南涵盖了容器化和云环境的配置。

IronQR与其他.NET二维码库相比如何？

目前有多种.NET二维码库，各有优缺点。 了解这些差异有助于您为项目选择合适的工具。

QRCoder是一个采用 MIT 许可证的开源库。 它在生成二维码方面表现良好，但不具备二维码读取功能或机器学习检测功能。 与 IronQR 的样式化输出支持相比，其输出选项较为有限。

ZXing .NET是 Java ZXing 库的 C# 移植版。 它支持读写操作，但依赖于传统的计算机视觉技术，而这些技术难以处理损坏或旋转的代码。 跨平台图像处理需要额外的设置。

IronQR提供生成和读取功能，企业许可包含专门的支持服务。 ML 驱动的阅读器、样式化的输出以及 IronSoftware.Drawing 集成使其成为生产应用程序更完整的解决方案。

有关详细功能比较，请参阅IronQR与 QRCoder 的比较文章和IronQR与 ZXing 的比较文章。

下一步计划是什么？

IronQR为.NET Core中的二维码生成和读取提供了完整的解决方案。 通过自动处理复杂的有效载荷生成器和原始模块及数据的组装，简化了开发周期。 无论您需要一个简单的开源库替代方案，还是一个具有可选高级功能的系统，IronQR 的跨平台架构都能确保可靠运行。

要继续使用IronQR进行构建，请探索以下资源：

• IronQR NuGet包-- 安装最新稳定版本 IronQR API 参考文档——完整的类和方法文档 -二维码示例-- 适用于常见场景的可直接复制粘贴代码
• IronQR教程——针对特定用例的分步指南 -许可选项——选择适合您项目的方案

立即开始免费试用，无需任何前期投入即可解锁 IronQR 的全部功能。