如何在 Blazor 中构建二维码扫描器

Q: 如果在Blazor扫描器中上传了一张没有QR代码的图像，会发生什么？

如果上传了没有QR代码的图像，调用`QrReader.Read()`返回的`IEnumerable `上的`FirstOrDefault`可以安全地处理情况，而不会抛出异常。

Updated: 2026年3月3日

Blazor Server 是一个 .NET Web 框架，它在服务器端运行 C#，并通过 SignalR 连接将 UI 更新推送至浏览器。 IronQR 可直接集成到 Blazor Server 中，支持通过浏览器上传的图片进行服务器端二维码扫描，且无需任何 JavaScript 代码。

在本操作指南中，我们将构建一个 Blazor Server 页面，该页面支持图片上传，并使用 IronQR 解码其中的任何嵌入式二维码。

如何在 Blazor 中扫描二维码

安装 IronQR C# 库以扫描网页上的二维码
添加一个 InputFile 组件，用于接收来自浏览器的图片上传
将上传的文件流式传输到服务器上的临时路径
加载图片并将其封装在 QrImageInput 中
调用 Read 方法并在 Blazor 组件中显示解码后的值

前提条件

已安装 ASP.NET 和 Web 开发工作负载的 Visual Studio 2022
针对 .NET 8 或更高版本的 Blazor Server 项目

安装 IronQR

请通过 Visual Studio 中的 NuGet 包管理器控制台安装 IronQR 库。导航到Tools > NuGet Package Manager > Package Manager Console并运行：

PM > Install-Package IronQR

Install-Package IronQR

或者，在NuGet上搜索IronQR并安装最新版本。

Blazor 组件布局

扫描器UI使用Blazor内置的InputFile组件进行浏览器原生文件选择，按钮用于触发扫描，并使用段落显示解码结果。无需 JavaScript 互操作。

添加一个新的Razor组件Scanner.razor，并使用以下标记：

@page "/scanner"
@using IronQr
@using IronSoftware.Drawing

<h3>QR Code Scanner</h3>

<InputFile OnChange="OnFileSelected" accept="image/*" />

<br /><br />

<button @onclick="ScanQRCode" disabled="@(qrImageSrc == null)">Scan QR Code</button>

<p>Result: @scannedText</p>

@page "/scanner"
@using IronQr
@using IronSoftware.Drawing

<h3>QR Code Scanner</h3>

<InputFile OnChange="OnFileSelected" accept="image/*" />

<br /><br />

<button @onclick="ScanQRCode" disabled="@(qrImageSrc == null)">Scan QR Code</button>

<p>Result: @scannedText</p>

Text

示例输入

请使用下方的二维码作为测试图片。将其保存到设备中，通过应用内的文件选择器上传，然后点击**"扫描二维码**"。解码值应显示为https://ironsoftware.com。

编码 https://ironsoftware.com 的示例二维码，用于测试 Blazor 二维码扫描器

示例二维码 — 编码地址：https://ironsoftware.com

使用 IronQR 扫描二维码

当文件被选择后，OnFileSelected将浏览器上传的文件流传输到服务器的临时文件。当点击扫描按钮时，scannedText，Blazor会自动在组件中渲染。

将以下Scanner.razor：

using IronQr;
using IronSoftware.Drawing;

private string? qrImageSrc;
private string scannedText = string.Empty;

private async Task OnFileSelected(InputFileChangeEventArgs e)
{
    var file = e.File;
    var tempPath = Path.Combine(Path.GetTempPath(), file.Name);
    await using var stream = file.OpenReadStream(maxAllowedSize: 10_000_000);
    await using var fs = File.Create(tempPath);
    await stream.CopyToAsync(fs);
    qrImageSrc = tempPath;
}

private async Task ScanQRCode()
{
    // Load the scanned QR code
    var inputBmp = AnyBitmap.FromFile(qrImageSrc!);
    var imageInput = new QrImageInput(inputBmp);
    var reader = new QrReader();

    // Read the scanned QR code
    var results = reader.Read(imageInput);

    // Check if a result was found
    var firstResult = results.FirstOrDefault();
    if (firstResult != null)
    {
        // Save the QR code value as a string
        scannedText = firstResult.Value;
    }
    else
    {
        scannedText = "No QR code found in the selected image.";
    }
}

using IronQr;
using IronSoftware.Drawing;

private string? qrImageSrc;
private string scannedText = string.Empty;

private async Task OnFileSelected(InputFileChangeEventArgs e)
{
    var file = e.File;
    var tempPath = Path.Combine(Path.GetTempPath(), file.Name);
    await using var stream = file.OpenReadStream(maxAllowedSize: 10_000_000);
    await using var fs = File.Create(tempPath);
    await stream.CopyToAsync(fs);
    qrImageSrc = tempPath;
}

private async Task ScanQRCode()
{
    // Load the scanned QR code
    var inputBmp = AnyBitmap.FromFile(qrImageSrc!);
    var imageInput = new QrImageInput(inputBmp);
    var reader = new QrReader();

    // Read the scanned QR code
    var results = reader.Read(imageInput);

    // Check if a result was found
    var firstResult = results.FirstOrDefault();
    if (firstResult != null)
    {
        // Save the QR code value as a string
        scannedText = firstResult.Value;
    }
    else
    {
        scannedText = "No QR code found in the selected image.";
    }
}

Imports IronQr
Imports IronSoftware.Drawing

Private qrImageSrc As String
Private scannedText As String = String.Empty

Private Async Function OnFileSelected(e As InputFileChangeEventArgs) As Task
    Dim file = e.File
    Dim tempPath = Path.Combine(Path.GetTempPath(), file.Name)
    Await Using stream = file.OpenReadStream(maxAllowedSize:=10000000)
        Await Using fs = File.Create(tempPath)
            Await stream.CopyToAsync(fs)
        End Using
    End Using
    qrImageSrc = tempPath
End Function

Private Async Function ScanQRCode() As Task
    ' Load the scanned QR code
    Dim inputBmp = AnyBitmap.FromFile(qrImageSrc)
    Dim imageInput = New QrImageInput(inputBmp)
    Dim reader = New QrReader()

    ' Read the scanned QR code
    Dim results = reader.Read(imageInput)

    ' Check if a result was found
    Dim firstResult = results.FirstOrDefault()
    If firstResult IsNot Nothing Then
        ' Save the QR code value as a string
        scannedText = firstResult.Value
    Else
        scannedText = "No QR code found in the selected image."
    End If
End Function

Imports IronQr
Imports IronSoftware.Drawing

Private qrImageSrc As String
Private scannedText As String = String.Empty

Private Async Function OnFileSelected(e As InputFileChangeEventArgs) As Task
    Dim file = e.File
    Dim tempPath = Path.Combine(Path.GetTempPath(), file.Name)
    Await Using stream = file.OpenReadStream(maxAllowedSize:=10000000)
        Await Using fs = File.Create(tempPath)
            Await stream.CopyToAsync(fs)
        End Using
    End Using
    qrImageSrc = tempPath
End Function

Private Async Function ScanQRCode() As Task
    ' Load the scanned QR code
    Dim inputBmp = AnyBitmap.FromFile(qrImageSrc)
    Dim imageInput = New QrImageInput(inputBmp)
    Dim reader = New QrReader()

    ' Read the scanned QR code
    Dim results = reader.Read(imageInput)

    ' Check if a result was found
    Dim firstResult = results.FirstOrDefault()
    If firstResult IsNot Nothing Then
        ' Save the QR code value as a string
        scannedText = firstResult.Value
    Else
        scannedText = "No QR code found in the selected image."
    End If
End Function

IEnumerable<QrResult>，其中每个找到的QR码都有一个条目。 FirstOrDefault安全处理没有QR码的图像且不抛出异常。