当前位置：首页 > news >正文

在 ASP.NET 项目中用 C# 生成二维码

news 2025/8/12 6:29:42

二维码（QR Code）已广泛应用于网址分享、支付链接、票务验证、身份登录等场景。在 ASP.NET 项目中，我们可以通过 C# 结合 Free Spire.Barcode for .NET 快速生成二维码，并将其直接显示在网页上，或制作下载链接。

本文将以 ASP.NET Core Web App（Razor Page） 为示例，演示如何实现 输入文本/URL → 生成二维码 → 在线显示与下载 的完整流程。

创建输入与显示二维码的页面
在后台生成二维码图片并返回 Base64 编码
将二维码显示到页面并提供下载功能

本文示例使用 Free Spire.Barcode for .NET 生成二维码。你可以通过 NuGet 安装：

dotnet add package FreeSpire.Barcode

1. 创建前端页面（Index.cshtml）

在 Razor Page 中，我们需要一个输入框供用户填写二维码内容，以及一个提交按钮触发后台生成逻辑。生成的二维码将直接以图片的形式显示，并提供下载链接。

优化后的 HTML 代码示例：

@page
@model IndexModel
@{ViewData["Title"] = "QR Code Generator";
}<h2 style="font-family: Arial; color: #2c3e50;">QR Code Generator</h2><form method="post" style="margin-bottom:20px; background-color:#f9f9f9; padding:15px; border-radius:5px; width: fit-content;"><label for="InputData" style="font-weight:bold;">Enter text or URL:</label><br /><input type="text" id="InputData" name="InputData" style="width:300px; padding:5px; margin:5px 0;" required /><button type="submit" style="padding:5px 15px; background-color:#3498db; color:white; border:none; border-radius:3px; cursor:pointer;">Generate QR Code</button>
</form>@if (!string.IsNullOrEmpty(Model.QrCodeBase64))
{<div style="margin-top:20px; border:1px solid #ddd; padding:10px; display:inline-block; border-radius:5px;"><img src="data:image/png;base64,@Model.QrCodeBase64" alt="QR Code" style="display:block; margin-bottom:10px;" /><a href="data:image/png;base64,@Model.QrCodeBase64" download="qrcode.png" style="background-color:#2ecc71; color:white; padding:5px 10px; border-radius:3px; text-decoration:none;">Download QR Code</a></div>
}

前端实现要点：

表单通过 POST 提交输入数据；
二维码显示采用 data:image/png;base64 形式，无需保存到磁盘；
提供下载按钮，直接保存二维码图片到本地。

2. 后端二维码生成逻辑（Index.cshtml.cs）

后台逻辑的核心是利用 Spire.Barcode 提供的 BarcodeSettings 与 BarCodeGenerator 类生成二维码，并将生成的图片转换为 Base64 字符串返回给前端页面显示。

代码示例：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Spire.Barcode;public class IndexModel : PageModel
{[BindProperty]public string InputData { get; set; }public string QrCodeBase64 { get; set; }public void OnPost(){if (!string.IsNullOrWhiteSpace(InputData)){QrCodeBase64 = GenerateQrCodeBase64(InputData);}}private string GenerateQrCodeBase64(string input){var settings = new BarcodeSettings{Type = BarCodeType.QRCode,            // 指定二维码类型Data = input,                         // 编码数据Data2D = input,                       // 二维码需要设置 Data2DQRCodeDataMode = QRCodeDataMode.Byte, // 字节模式（支持多语言）QRCodeECL = QRCodeECL.M,              // 中等级纠错（可恢复 15% 数据）X = 3,                                // 模块大小ShowText = false,                     // 不显示默认条码文字ShowBottomText = true,                // 显示自定义底部文字BottomText = input                    // 底部显示输入内容};var generator = new BarCodeGenerator(settings);using var ms = new MemoryStream();var qrImage = generator.GenerateImage();qrImage.Save(ms, System.Drawing.Imaging.ImageFormat.Png);return Convert.ToBase64String(ms.ToArray());}
}