ASP.NET Core 条码扫描器
简介
ASP.NET Core 是一个用于构建现代 Web 应用程序的跨平台框架。 其 Razor Pages 模型提供了一种页面为基础的处理 HTTP 请求的方法，非常适合服务器端条码处理。 使用IronBarcode，上传的图像可以作为IFormFile对象接收，转换为字节数组，并直接传递给条形码读取器而不必在磁盘上写入临时文件。
本文演示了如何将 IronBarcode 集成到 ASP.NET Core Razor Pages 应用程序中，以扫描上传图像中的条码和 QR 码，并从服务器生成条码。
如何在 ASP.NET Core 中读取和扫描条码
- 安装 C# 库以读取和扫描条码
- 创建一个新的 ASP.NET Core Razor Pages 项目
- 设计文件上传表单以接受条码图像
- 使用
Read方法扫描上传图像中的条码 - 在页面上显示解码的条码值
IronBarcode: C#条码库
IronBarcode 为 .NET 应用程序提供了一个强大的读写条码的 API。 库会在内部处理图像处理，因此开发者可以将原始字节、文件路径或数据流直接传递给BarcodeReader.Read方法，而无需单独的图像处理库。 它支持广泛的条码格式，包括 QR Code、Code 128、Code 39、PDF417、EAN 等。
对于 Web 应用程序，IronBarcode 特别有用，因为它完全在内存中处理图像。 上传的文件不需要保存到磁盘，这简化了部署并减少了清理的工作量。 同一库还通过BarcodeWriter.CreateBarcode生成条形码，使其成为同时用于读取和写入的单一依赖项。
在 ASP.NET Core 中构建条码扫描器的步骤
按照以下步骤使用 ASP.NET Core Razor Pages 和 IronBarcode 创建一个基于 Web 的条码扫描器。
前提条件
- Visual Studio 2022 或更高版本（或任何支持 .NET 的 IDE）
- .NET 6.0 或更高版本的 SDK
创建项目
创建一个新的 ASP.NET Core Web App (Razor Pages) 项目。 这可以通过 Visual Studio 的项目向导或命令行完成：
dotnet new webapp -n BarcodeWebApp安装 IronBarcode 库
通过 NuGet 包管理器控制台安装 IronBarcode 库。 导航到Visual Studio中的Tools > NuGet Package Manager > Package Manager Console并运行：
或者，从命令行使用dotnet add package BarCode安装。 最新版本可在 NuGet 网站 上获取。
前端
前端由文件上传表单和结果显示区域组成。 表单使用enctype="multipart/form-data"来处理二进制文件上传。 当检测到条码时，结果将显示在上传图像下方的成功提示中。
用以下内容替换 Index.cshtml 文件中的内容：
@page
@model IndexModel
@{
ViewData["Title"] = "Barcode Scanner";
}
<div class="container mt-4">
<h1 class="mb-4">Barcode Scanner</h1>
<div class="card mb-4">
<div class="card-header"><h5>Upload & Read Barcode</h5></div>
<div class="card-body">
<form method="post" asp-page-handler="Upload" enctype="multipart/form-data">
<div class="mb-3">
<label for="file" class="form-label">Select a barcode image:</label>
<input type="file" class="form-control" id="file"
name="UploadedFile" accept="image/*" />
</div>
<button type="submit" class="btn btn-primary">Scan Barcode</button>
</form>
@if (Model.ImageDataUrl != null)
{
<div class="mt-3">
<h6>Uploaded Image:</h6>
<img src="@Model.ImageDataUrl" alt="Uploaded barcode"
style="max-width: 300px;" class="img-thumbnail" />
</div>
}
@if (Model.BarcodeResult != null)
{
<div class="alert alert-success mt-3">
<strong>Barcode Value:</strong> @Model.BarcodeResult
</div>
}
@if (Model.ErrorMessage != null)
{
<div class="alert alert-warning mt-3">@Model.ErrorMessage</div>
}
</div>
</div>
</div>布局使用 Bootstrap 类，这些类已包含在默认的 ASP.NET Core 模板中。 表单提交给Upload页面处理程序，并使用条件块显示上传的图像预览、解码结果或错误消息。
示例输入条码
以下示例条码可用于测试扫描器。 每个图像编码不同的格式和值：
QR Code 编码 "https://ironsoftware.com"
编码128条码编码"IronBarcode-2026"
Code 39 条码编码 "HELLO123"
使用 IronBarcode 进行条码扫描
服务器端逻辑处理OnPostUploadAsync方法中的上传文件。 上传的BarcodeReader.Read。 这避免了保存临时文件，并将处理完全保留在内存中。
用以下内容替换 Index.cshtml.cs 中的内容：
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using IronBarCode;
public class IndexModel : PageModel
{
[BindProperty]
public IFormFile? UploadedFile { get; set; }
public string? BarcodeResult { get; set; }
public string? ErrorMessage { get; set; }
public string? ImageDataUrl { get; set; }
public void OnGet()
{
}
public async Task<IActionResult> OnPostUploadAsync()
{
if (UploadedFile == null || UploadedFile.Length == 0)
{
ErrorMessage = "Please select an image file.";
return Page();
}
try
{
using var ms = new MemoryStream();
await UploadedFile.CopyToAsync(ms);
byte[] imageBytes = ms.ToArray();
// Store image as base64 for preview display
string base64 = Convert.ToBase64String(imageBytes);
ImageDataUrl = $"data:{UploadedFile.ContentType};base64,{base64}";
// Read barcode from uploaded image bytes
var results = BarcodeReader.Read(imageBytes);
if (results != null && results.Count() > 0)
{
BarcodeResult = string.Join("\n",
results.Select(r => r.Value));
}
else
{
ErrorMessage = "No barcode detected in the uploaded image.";
}
}
catch (Exception ex)
{
ErrorMessage = $"Error processing image: {ex.Message}";
}
return Page();
}
}Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages
Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks
Public Class IndexModel
Inherits PageModel
<BindProperty>
Public Property UploadedFile As IFormFile
Public Property BarcodeResult As String
Public Property ErrorMessage As String
Public Property ImageDataUrl As String
Public Sub OnGet()
End Sub
Public Async Function OnPostUploadAsync() As Task(Of IActionResult)
If UploadedFile Is Nothing OrElse UploadedFile.Length = 0 Then
ErrorMessage = "Please select an image file."
Return Page()
End If
Try
Using ms As New MemoryStream()
Await UploadedFile.CopyToAsync(ms)
Dim imageBytes As Byte() = ms.ToArray()
' Store image as base64 for preview display
Dim base64 As String = Convert.ToBase64String(imageBytes)
ImageDataUrl = $"data:{UploadedFile.ContentType};base64,{base64}"
' Read barcode from uploaded image bytes
Dim results = BarcodeReader.Read(imageBytes)
If results IsNot Nothing AndAlso results.Count() > 0 Then
BarcodeResult = String.Join(vbLf, results.Select(Function(r) r.Value))
Else
ErrorMessage = "No barcode detected in the uploaded image."
End If
End Using
Catch ex As Exception
ErrorMessage = $"Error processing image: {ex.Message}"
End Try
Return Page()
End Function
End ClassImports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages
Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks
Public Class IndexModel
Inherits PageModel
<BindProperty>
Public Property UploadedFile As IFormFile
Public Property BarcodeResult As String
Public Property ErrorMessage As String
Public Property ImageDataUrl As String
Public Sub OnGet()
End Sub
Public Async Function OnPostUploadAsync() As Task(Of IActionResult)
If UploadedFile Is Nothing OrElse UploadedFile.Length = 0 Then
ErrorMessage = "Please select an image file."
Return Page()
End If
Try
Using ms As New MemoryStream()
Await UploadedFile.CopyToAsync(ms)
Dim imageBytes As Byte() = ms.ToArray()
' Store image as base64 for preview display
Dim base64 As String = Convert.ToBase64String(imageBytes)
ImageDataUrl = $"data:{UploadedFile.ContentType};base64,{base64}"
' Read barcode from uploaded image bytes
Dim results = BarcodeReader.Read(imageBytes)
If results IsNot Nothing AndAlso results.Count() > 0 Then
BarcodeResult = String.Join(vbLf, results.Select(Function(r) r.Value))
Else
ErrorMessage = "No barcode detected in the uploaded image."
End If
End Using
Catch ex As Exception
ErrorMessage = $"Error processing image: {ex.Message}"
End Try
Return Page()
End Function
End Class上述代码中的关键步骤：
- 接收上传 - 通过
[BindProperty]@绑定IFormFile并在POST处理程序中接收。 - 转换为字节 - 文件被复制到一个
MemoryStream并转换为字节数组。 这是在网页浏览器扫描器示例中使用的相同方法，针对ASP.NET Core的IFormFile进行了调整，而不是base64字符串。 - 读取条形码 -
BarcodeReader.Read(imageBytes)处理图像并返回所有检测到的条形码。 - 显示结果 - 所有检测到的条码值被连接并显示在 UI 中。
以下 GIF 演示了条码阅读器的实际操作，上传条码图像并显示解码结果：
在 ASP.NET Core 应用程序中扫描上传图像的条码阅读器
处理 Base64 图像数据
对于接收图像数据为base64字符串的应用程序（例如，来自网络摄像头捕获或JavaScript画布），相同的BarcodeReader.Read方法可与从base64解码的字节数组一起使用。这种模式在通过AJAX发送图像数据的单页应用程序中很常见：
public string ReadBarCode(string imageDataBase64)
{
// Decode the base64 image data
var splitObject = imageDataBase64.Split(',');
byte[] imageByteData = Convert.FromBase64String(
(splitObject.Length > 1) ? splitObject[1] : splitObject[0]);
// Read barcode directly from byte array
var results = BarcodeReader.Read(imageByteData);
return $"{DateTime.Now}: Barcode is ({results.First().Value})";
}public string ReadBarCode(string imageDataBase64)
{
// Decode the base64 image data
var splitObject = imageDataBase64.Split(',');
byte[] imageByteData = Convert.FromBase64String(
(splitObject.Length > 1) ? splitObject[1] : splitObject[0]);
// Read barcode directly from byte array
var results = BarcodeReader.Read(imageByteData);
return $"{DateTime.Now}: Barcode is ({results.First().Value})";
}Public Function ReadBarCode(imageDataBase64 As String) As String
' Decode the base64 image data
Dim splitObject = imageDataBase64.Split(","c)
Dim imageByteData As Byte() = Convert.FromBase64String(
If(splitObject.Length > 1, splitObject(1), splitObject(0)))
' Read barcode directly from byte array
Dim results = BarcodeReader.Read(imageByteData)
Return $"{DateTime.Now}: Barcode is ({results.First().Value})"
End FunctionPublic Function ReadBarCode(imageDataBase64 As String) As String
' Decode the base64 image data
Dim splitObject = imageDataBase64.Split(","c)
Dim imageByteData As Byte() = Convert.FromBase64String(
If(splitObject.Length > 1, splitObject(1), splitObject(0)))
' Read barcode directly from byte array
Dim results = BarcodeReader.Read(imageByteData)
Return $"{DateTime.Now}: Barcode is ({results.First().Value})"
End Function此方法处理原始base64和数据URI格式（例如data:image/png;base64,...）通过在逗号上分割和提取实际的base64负载来实现。 有关使用此模式的完整 Blazor 实现，请参见 Blazor 集成指南。
在服务器上生成条码
IronBarcode还可以在服务器端生成条形码。使用BarcodeWriter.CreateBarcode添加生成端点到相同的应用程序是直接的：
public IActionResult OnPostGenerate()
{
var barcode = BarcodeWriter.CreateBarcode(
"https://ironsoftware.com", BarcodeEncoding.QRCode);
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png", "generated-barcode.png");
}public IActionResult OnPostGenerate()
{
var barcode = BarcodeWriter.CreateBarcode(
"https://ironsoftware.com", BarcodeEncoding.QRCode);
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png", "generated-barcode.png");
}Public Function OnPostGenerate() As IActionResult
Dim barcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.QRCode)
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png", "generated-barcode.png")
End FunctionPublic Function OnPostGenerate() As IActionResult
Dim barcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.QRCode)
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png", "generated-barcode.png")
End Function生成的条码以文件下载的形式返回。 下图显示了OnPostGenerate处理程序生成的二维码输出：
服务器端生成 QR 码使用 BarcodeWriter.CreateBarcode
有关更多条码生成选项，请参见 条码图像生成教程 和 条码样式指导。
运行应用程序
通过 Visual Studio 或命令行运行项目：
dotnet run应用程序在https://localhost:5001或类似）。 导航到主页以查看条码扫描器界面。
结论
本文展示了如何使用 ASP.NET Core Razor Pages 和 IronBarcode 构建服务器端条码扫描器。 通过调整接收图像数据的方式，同样的方法适用于 ASP.NET Core MVC 控制器、Web API 端点和 Blazor Server 应用程序。 IronBarcode 内部处理图像处理，因此无论使用哪种 Web 框架，集成都需要极少的代码。
有关在其他 .NET 平台中读取条码，请参见 .NET MAUI 条码扫描器教程 和 条码读取指导。 获取更多有关 IronBarcode 的教程从 读取条码教程。
要快速开始，请下载完整的BarcodeWebApp项目并使用dotnet run运行。
IronBarcode 必须获得开发和商业使用的许可。 许可详情可在 这里 获取。
常见问题解答
如何在ASP.NET Core中使用Razor Pages实现条形码扫描器？
您可以在您的ASP.NET Core Razor Pages项目中使用IronBarcode来实现条形码扫描器。该库允许您通过上传图像并使用BarcodeReader.Read处理它们来读取各种条形码格式，如二维码、代码128和代码39。
使用IronBarcode可以读取哪些类型的条形码？
IronBarcode支持读取多种条形码格式，包括二维码、代码128和代码39，适用于各种应用程序。
如何在ASP.NET Core项目中上传图像进行条形码扫描？
在ASP.NET Core项目中，您可以使用IFormFile上传图像。IronBarcode会处理这些图像以读取其中包含的条形码。
IronBarcode可以在ASP.NET Core中服务器端生成条形码吗？
是的，IronBarcode可以在ASP.NET Core中使用BarcodeWriter.CreateBarcode方法生成服务器端条形码，允许您动态创建和显示条形码。
BarcodeReader.Read方法用于什么？
IronBarcode中的BarcodeReader.Read方法用于从图像中解码条形码，是在ASP.NET Core中实现条形码扫描器的重要部分。
是否可以使用同一个库在ASP.NET Core中扫描二维码和条形码？
是的，IronBarcode允许您在同一ASP.NET Core应用程序中扫描二维码和各种其他条形码格式，提供统一的解决方案。
在C#中使用IronBarcode进行条形码扫描的优势是什么？
IronBarcode提供简单的集成、对多种条形码格式的支持以及强大的服务器端条形码生成功能，使其成为C#应用程序中条形码扫描的高效选择。
What method does IronBarcode provide to read barcodes from byte arrays?
IronBarcode provides the BarcodeReader.Read method to process images and read barcodes directly from byte arrays.
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
