如何在 C# 中使用异步和多线程进行二维码操作

Curtis Chau

Updated: 2026年3月6日

单线程二维码扫描会在每次图像解码期间阻塞调用线程。

在 WPF 按钮处理程序中，这将冻结 UI，直到解码完成。在批量处理数百张图像时，CPU 核心会闲置，而它们本可以并行工作。 IronQR的Task.WhenAll一起工作以提高批量吞吐量。

本指南演示了如何异步处理二维码、将批量读取任务分配到 CPU 内核上，以及如何将这两种模式结合起来以实现高容量流水线。

快速入门：异步处理二维码

加载图像并等待解码结果，而不阻塞调用线程。

1Install IronQR with NuGet Package Manager
PM > Install-Package IronQR
```
Install-Package IronQR
```

2复制并运行这段代码。

using IronQr;
using IronSoftware.Drawing;

var input = new QrImageInput(AnyBitmap.FromFile("ticket.png"));
IEnumerable<QrResult> results = await new QrReader().ReadAsync(input);
Console.WriteLine(results.First().Value);

using IronQr;
using IronSoftware.Drawing;

var input = new QrImageInput(AnyBitmap.FromFile("ticket.png"));
IEnumerable<QrResult> results = await new QrReader().ReadAsync(input);
Console.WriteLine(results.First().Value);

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronQR

最小工作流程（5 个步骤）

下载 IronQR C# 库，实现异步二维码处理
使用ReadAsync进行非阻塞式单次读取
使用 Parallel.ForEach 进行 CPU 密集型批处理
与 SemaphoreSlim 结合使用，构建有界并发管道
从IEnumerable<QrResult>中收集结果并打印解码后的值

异步读取二维码

ReadAsync返回一个可等待的任务，使其与WPF/MAUI事件处理程序、ASP.NET控制器操作或任何异步方法兼容。输入必须由图像位图构成；不支持文件路径重载。

写入端是同步的，没有异步变体。为了避免在文件I/O期间阻塞线程，请在File.WriteAllBytesAsync()中使用从位图导出的原始字节包裹保存步骤。

输入

扫描并重新生成二维码活动徽章，以演示异步读写模式。

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// --- Async read: non-blocking QR decode ---
var inputBmp = AnyBitmap.FromFile("event-badge.png");
var imageInput = new QrImageInput(inputBmp, QrScanMode.Auto);

var reader = new QrReader();
IEnumerable<QrResult> results = await reader.ReadAsync(imageInput);

foreach (QrResult result in results)
{
    Console.WriteLine($"[{result.QrType}] {result.Value}");
}

// --- Async-wrapped save: QrWriter.Write() and QrCode.Save() are synchronous ---
QrCode qrCode = QrWriter.Write("https://ironsoftware.com");
AnyBitmap qrImage = qrCode.Save();

// Save the bitmap bytes asynchronously (not an IronQR API — standard .NET async I/O)
byte[] pngBytes = qrImage.ExportBytes();
await File.WriteAllBytesAsync("output-qr.png", pngBytes);

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// --- Async read: non-blocking QR decode ---
var inputBmp = AnyBitmap.FromFile("event-badge.png");
var imageInput = new QrImageInput(inputBmp, QrScanMode.Auto);

var reader = new QrReader();
IEnumerable<QrResult> results = await reader.ReadAsync(imageInput);

foreach (QrResult result in results)
{
    Console.WriteLine($"[{result.QrType}] {result.Value}");
}

// --- Async-wrapped save: QrWriter.Write() and QrCode.Save() are synchronous ---
QrCode qrCode = QrWriter.Write("https://ironsoftware.com");
AnyBitmap qrImage = qrCode.Save();

// Save the bitmap bytes asynchronously (not an IronQR API — standard .NET async I/O)
byte[] pngBytes = qrImage.ExportBytes();
await File.WriteAllBytesAsync("output-qr.png", pngBytes);

输出

终端显示经过解码的QR类型和值，格式为output-qr.png已保存。

QrScanMode.Auto同时运行ML检测和基本扫描，填充每个结果中的解码值和QR类型。 OnlyDetectionModel速度更快，但仅返回边界框坐标，值字段保持为空。每当需要编码内容时使用Auto。

使用多线程处理二维码

对于可以独立解码的图像，Parallel.ForEach会将工作分配给可用的CPU核心。每次迭代使用一个单独的QrReader实例是安全的默认设置，因为IronQR对共享读取器实例没有明确的线程安全保证。

输入

并行批量扫描中使用的十个二维码测试图像中有四个。每个图像编码一个URL，并在运行时从qr-images/文件夹中读取。

图片 1（第 1 批，共 10 批）

批量二维码输入图像 2/10，编码 https://ironsoftware.com/batch-2

图片 2（第 2 批，共 10 张）

批量二维码输入图像 3/10，编码 https://ironsoftware.com/batch-3

图片 3（第 3 批，共 10 批）

批量二维码输入图像 4/10，编码 https://ironsoftware.com/batch-4

图片 4（共 10 张，第 4 张）

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Collections.Concurrent;
using System.Diagnostics;

string[] files = Directory.GetFiles("qr-images/", "*.png");
var allResults = new ConcurrentBag<(string File, string Value)>();
int failCount = 0;
var sw = Stopwatch.StartNew();

Parallel.ForEach(files, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, file =>
{
    try
    {
        var input = new QrImageInput(
            AnyBitmap.FromFile(file),
            QrScanMode.Auto);

        // Per-thread QrReader instance — safe default
        var results = new QrReader().Read(input);

        foreach (QrResult result in results)
        {
            allResults.Add((Path.GetFileName(file), result.Value));
        }
    }
    catch (Exception ex)
    {
        Interlocked.Increment(ref failCount);
        Console.Error.WriteLine($"[ERROR] {Path.GetFileName(file)}: {ex.Message}");
    }
});

sw.Stop();

Console.WriteLine($"Processed {files.Length} files in {sw.Elapsed.TotalSeconds:F1}s");
Console.WriteLine($"QR codes found: {allResults.Count} | Failures: {failCount}");
Console.WriteLine($"Throughput: {files.Length / sw.Elapsed.TotalSeconds:F1} files/sec");

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Collections.Concurrent;
using System.Diagnostics;

string[] files = Directory.GetFiles("qr-images/", "*.png");
var allResults = new ConcurrentBag<(string File, string Value)>();
int failCount = 0;
var sw = Stopwatch.StartNew();

Parallel.ForEach(files, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, file =>
{
    try
    {
        var input = new QrImageInput(
            AnyBitmap.FromFile(file),
            QrScanMode.Auto);

        // Per-thread QrReader instance — safe default
        var results = new QrReader().Read(input);

        foreach (QrResult result in results)
        {
            allResults.Add((Path.GetFileName(file), result.Value));
        }
    }
    catch (Exception ex)
    {
        Interlocked.Increment(ref failCount);
        Console.Error.WriteLine($"[ERROR] {Path.GetFileName(file)}: {ex.Message}");
    }
});

sw.Stop();

Console.WriteLine($"Processed {files.Length} files in {sw.Elapsed.TotalSeconds:F1}s");
Console.WriteLine($"QR codes found: {allResults.Count} | Failures: {failCount}");
Console.WriteLine($"Throughput: {files.Length / sw.Elapsed.TotalSeconds:F1} files/sec");

输出

控制台显示批处理摘要，包括已处理的文件数、处理时间、找到的二维码、任何故障和吞吐量。然后它会列出每个文件名及其解码后的 URL。

下载全部 10 个测试批次的二维码输入图像（batch-qr-images.zip）。

ConcurrentBag<t>收集所有线程的结果，而不需要锁定。线程安全的计数器会跟踪故障，并且对每个文件使用 try-catch 可以确保一个错误的图像不会中断整个批次。这种方法遵循错误处理指南中描述的错误隔离模式。

将Environment.ProcessorCount，以与CPU核心数量对齐。使用额外的线程会增加开销，并且不会提高性能，特别是对于 CPU 密集型机器学习模型而言。

结合异步和并行处理

对于大批量流水线，将Task.WhenAll配对使用，以限制并发。与Parallel.ForEach不同，此模式保持I/O非阻塞，同时控制同时运行的解码数量，防止在大工作负载下线程池饱和。

输入

并发管道处理的二十张QR码测试图像中的四张。每个图像编码一个URL，并通过SemaphoreSlim使用有限的并发方式并行解码。

图 1（共 20 道流程中的第 1 道）

图 2（20 个流程中的第 2 个）

图 3（共 20 道流程中的第 3 道）

图 4（共 20 道流程中的第 4 道）

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Collections.Concurrent;
using System.Diagnostics;

string[] files = Directory.GetFiles("high-volume/", "*.png");
var results = new ConcurrentBag<(string File, string Value)>();
int maxConcurrency = Environment.ProcessorCount;
using var semaphore = new SemaphoreSlim(maxConcurrency);
var sw = Stopwatch.StartNew();

var tasks = files.Select(async file =>
{
    await semaphore.WaitAsync();
    try
    {
        var bmp = AnyBitmap.FromFile(file);
        // Auto: runs ML detection plus a basic scan so result.Value is populated
        var input = new QrImageInput(bmp, QrScanMode.Auto);
        var qrResults = await new QrReader().ReadAsync(input);

        foreach (var qr in qrResults)
        {
            results.Add((Path.GetFileName(file), qr.Value));
        }
    }
    catch (Exception ex)
    {
        Console.Error.WriteLine($"{{\"file\":\"{Path.GetFileName(file)}\",\"error\":\"{ex.Message}\"}}");
    }
    finally
    {
        semaphore.Release();
    }
});

await Task.WhenAll(tasks);
sw.Stop();

Console.WriteLine($"Pipeline complete: {results.Count} QR codes from {files.Length} files in {sw.Elapsed.TotalSeconds:F1}s");

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Collections.Concurrent;
using System.Diagnostics;

string[] files = Directory.GetFiles("high-volume/", "*.png");
var results = new ConcurrentBag<(string File, string Value)>();
int maxConcurrency = Environment.ProcessorCount;
using var semaphore = new SemaphoreSlim(maxConcurrency);
var sw = Stopwatch.StartNew();

var tasks = files.Select(async file =>
{
    await semaphore.WaitAsync();
    try
    {
        var bmp = AnyBitmap.FromFile(file);
        // Auto: runs ML detection plus a basic scan so result.Value is populated
        var input = new QrImageInput(bmp, QrScanMode.Auto);
        var qrResults = await new QrReader().ReadAsync(input);

        foreach (var qr in qrResults)
        {
            results.Add((Path.GetFileName(file), qr.Value));
        }
    }
    catch (Exception ex)
    {
        Console.Error.WriteLine($"{{\"file\":\"{Path.GetFileName(file)}\",\"error\":\"{ex.Message}\"}}");
    }
    finally
    {
        semaphore.Release();
    }
});

await Task.WhenAll(tasks);
sw.Stop();

Console.WriteLine($"Pipeline complete: {results.Count} QR codes from {files.Length} files in {sw.Elapsed.TotalSeconds:F1}s");