如何使用NuGet包在 C# 中生成二维码

如何安装二维码NuGet包？

通过 NuGet 软件包管理器安装 IronQR 只需几秒钟。 在 Visual Studio 中打开NuGet包管理器控制台并运行以下命令，或者在 CLI 环境中使用 dotnet add package 命令：

Install-Package IronQR

NuGet 软件包会自动处理所有依赖关系，确保与目标框架兼容。 IronQR支持.NET Framework 4.6.2+、. .NET Core 2.0+ 和.NET 5-10，使其成为任何 Visual Studio 项目的多功能库。

在编写任何代码之前，您需要一个免费试用许可证密钥。 在应用程序启动时尽早设置，以便所有后续调用都经过身份验证：

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

有了许可证密钥，您的应用程序就可以生成、读取和自定义二维码，而不会在输出图像上添加水印。

如何生成你的第一个二维码？

创建你的第一个二维码只需要极少的代码。 QrWriter 类处理二维码生成，其默认值合理，适用于大多数使用场景：

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

如何选择合适的纠错级别？

二维码支持ISO/IEC 18004 二维码标准中定义的四个纠错级别，这些级别决定了二维码在保持可扫描性的同时可以承受多大的损坏。 IronQR通过 QrOptions 类支持所有四个级别：

using IronQr;
using IronSoftware.Drawing;

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

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

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

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

如何自定义二维码外观？

IronQR通过 QrStyleOptions 提供丰富的样式选项，支持自定义颜色、尺寸、边距和徽标嵌入。 品牌二维码在营销环境中表现更佳，因为它们在视觉上将二维码与已知的身份联系起来：

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

如何将二维码保存为不同的输出格式？

IronQR 支持多种输出格式，包括 PNG、JPEG、GIF、TIFF、BMP 和 SVG。 SaveAs 方法会自动根据文件扩展名检测文件格式：

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

如何比较IronQR NuGet包和 QRCoder？

QRCoder 库是.NET中用于生成二维码的流行开源选项。 使用过 QRCoder 的开发者都熟悉它的多步骤 API，其中涉及 QRCodeData 以及单独的渲染类，例如 PngByteQRCode。 IronQR将其简化为单个 QrWriter.Write() 调用。

QRCoder 在 Windows 环境下可以很好地用于基本二维码生成。 IronQR 的机器学习模型能够从任何角度提供卓越的二维码读取性能——这对于处理用户提交的图像(输入质量无法控制)的应用程序至关重要。 单方法 API 还减少了交付可用功能所需的代码行数。

对于从 QRCoder 迁移的团队，请参阅QRCoder 到IronQR迁移指南，以获取并排 API 映射。

如何在二维码中编码二进制数据？

除了文本之外， IronQR还支持对二进制二维码有效载荷进行字节数组编码。 这对于无法用 UTF-8 字符串表示的加密令牌、序列化对象或原始二进制标识符非常有用：

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

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

IronQR同时处理写入和读取操作。 QrReader 类接受图像文件、位图和相机帧，使其既适用于批量处理也适用于实时扫描场景：

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

这款由机器学习驱动的读取引擎可以处理任意方向的图像，并能处理误差校正阈值范围内的部分损坏。 对于生产环境中的读取场景，请查看二维码读取教程，以获取有关处理低质量输入、多码图像和扫描模式配置的指导。

如何在ASP.NET Core应用程序中使用IronQR ？

Web 应用程序经常需要按需生成二维码——用于用户帐户链接、一次性登录代码或支付请求。 以下示例展示了如何通过ASP.NET Core最小 API 端点直接提供二维码图像：

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

这种模式既适用于ASP.NET Core 的极简 API，也适用于标准的 MVC 控制器。ExportBytes() 调用避免了将临时文件写入磁盘，这在文件系统可能是只读或临时的容器化部署中非常重要。

有关完整的ASP.NET Core集成演练，请参阅ASP.NET Core二维码生成器教程。 Blazor二维码生成器教程中也提供了 Blazor 专用指南。

如何给二维码图片添加边距并调整大小？

控制尺寸和静区对于保证打印质量至关重要。 IronQR通过 QrStyleOptions 公开了这两种方式，并且有专门的操作指南详细介绍了每一种方式：

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

有关不同输出介质的尺寸和边距要求的完整指南，请参阅有关调整二维码图像大小和为二维码添加边距的操作指南文章。 创建二维码图像指南涵盖了从许可证激活到文件输出的完整图像创建工作流程。

针对具体的二维码使用场景(包括 为名片生成二维码、 构建动态二维码生成器以及从图像中读取二维码) ，专门的文章涵盖了每种场景，并提供了完整的代码示例。

下一步计划是什么？

IronQR将二维码生成从多步骤流程简化为简单的NuGet集成。 安装软件包，调用 QrWriter.Write()，然后保存结果——这三个操作涵盖了大多数现实世界的场景。 同一个库提供纠错级别、自定义样式、PDF 标记和机器学习驱动的阅读功能。

IronQR文档提供了完整的 API 参考，包括高级主题，例如使用扫描模式读取二维码、批量处理和特定于平台的部署说明。 IronQR教程部分包含.NET MAUI、VB .NET和控制台应用程序的分步指南。

开始免费试用，即可不受限制地探索所有功能，或者购买许可证进行生产部署，并享受 24/5 全天候工程支持。