如何使用不同的扫描模式读取二维码

Ahmad Sohail

Updated: 2026年6月29日

到 2025 年，随着越来越多的产品走向数字化和始终在线访问，读取二维码将成为一项常规任务。将必要数据存储在紧凑的只读映像中已成为标准做法，开发人员需要有效的方法在不同的环境中提取这些信息。

IronQR 为二维码提供 3 种读取选项，每种选项都针对特定的使用场景而设计。

本操作指南将通过清晰的示例解释这三种方法。如果您还没有看过，请查看之前关于从图像中读取二维码或编写自己的二维码的指南。

如何使用不同的扫描模式读取二维码

下载 C# 库，即可使用高级扫描选项读取二维码
加载目标图像文件
初始化QrImageInput ，传入图像和所需的QrScanMode参数。
实例化QrReader类并将输入对象传递给Read方法。
检索结果以访问解码后的Value文本，或遍历Points数组以获取坐标数据。

了解二维码扫描模式

IronQR 通过 QrScanMode 枚举提供三种强大的扫描模式：

自动模式 (QrScanMode.Auto)：结合机器学习检测和基础扫描算法，以实现最大精度和可靠性
仅基础扫描模式 (QrScanMode.OnlyBasicScan)：在QR码清晰可见时，使用传统图像处理技术进行快速、可靠的扫描
检测模型模式 (QrScanMode.OnlyDetectionModel)：利用机器学习检测QR码位置，适合提取坐标数据

让我们详细了解一下每种扫描方法。

仅基本扫描模式

只有基本扫描模式使用传统的图像处理算法，而没有使用机器学习。当二维码清晰可见且位置恰当时，这种方法快速高效；但是，如果三个角上的方块清晰可见，即使二维码损坏，它仍然可以正常工作。

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.IO;
using System.Linq;

// Load the image
var bmp = AnyBitmap.FromFile("damaged-qr.png");

// Create scan input using Only Basic Scan mode
var input = new QrImageInput(bmp, QrScanMode.OnlyBasicScan);

// Get the result
var result = new QrReader().Read(input).FirstOrDefault();

// Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value);

using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.IO;
using System.Linq;

// Load the image
var bmp = AnyBitmap.FromFile("damaged-qr.png");

// Create scan input using Only Basic Scan mode
var input = new QrImageInput(bmp, QrScanMode.OnlyBasicScan);

// Get the result
var result = new QrReader().Read(input).FirstOrDefault();

// Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value);

Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.IO
Imports System.Linq

' Load the image
Dim bmp = AnyBitmap.FromFile("damaged-qr.png")

' Create scan input using Only Basic Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyBasicScan)

' Get the result
Dim result = (New QrReader()).Read(input).FirstOrDefault()

' Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value)

Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.IO
Imports System.Linq

' Load the image
Dim bmp = AnyBitmap.FromFile("damaged-qr.png")

' Create scan input using Only Basic Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyBasicScan)

' Get the result
Dim result = (New QrReader()).Read(input).FirstOrDefault()

' Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value)

扫描输入

已保存的文本文件

自动扫描模式

自动扫描模式是默认模式（用于 QrScanMode）并且是最通用的可用选项。它自动将机器学习检测与传统扫描算法相结合，从而在各种图像条件下提供最佳结果。

示例显示了加载的图像并激活 Auto 模式。然后它扫描图像并将找到的每个QR码收集到列表中。最后，它遍历 results 集合，并在控制台中打印每个值的文本（在本例中，仅打印URL）。

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

// Load the image file
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Auto Scan mode
var input = new QrImageInput(bmp, QrScanMode.Auto);

// Scan and read all QR codes
var results = new QrReader().Read(input);

// Initialize a counter to track the number of QR codes
int count = 1;

// Loop through each discovered QR code
foreach (var result in results)
{
    Console.WriteLine($"QR {count}: {result.Value}");
    count++;
}

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

// Load the image file
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Auto Scan mode
var input = new QrImageInput(bmp, QrScanMode.Auto);

// Scan and read all QR codes
var results = new QrReader().Read(input);

// Initialize a counter to track the number of QR codes
int count = 1;

// Loop through each discovered QR code
foreach (var result in results)
{
    Console.WriteLine($"QR {count}: {result.Value}");
    count++;
}

Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing

' Load the image file
Dim bmp = AnyBitmap.FromFile("cup.png")

' Create scan input using Auto Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.Auto)

' Scan and read all QR codes
Dim results = New QrReader().Read(input)

' Initialize a counter to track the number of QR codes
Dim count As Integer = 1

' Loop through each discovered QR code
For Each result In results
    Console.WriteLine($"QR {count}: {result.Value}")
    count += 1
Next

Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing

' Load the image file
Dim bmp = AnyBitmap.FromFile("cup.png")

' Create scan input using Auto Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.Auto)

' Scan and read all QR codes
Dim results = New QrReader().Read(input)

' Initialize a counter to track the number of QR codes
Dim count As Integer = 1

' Loop through each discovered QR code
For Each result In results
    Console.WriteLine($"QR {count}: {result.Value}")
    count += 1
Next

扫描输入

控制台显示

通过 IronQR 扫描照片后，咖啡馆网站的 URL 会被记录下来。

检测模型模式

检测模型模式专门利用机器学习技术来检测图像中的二维码位置。这一特性使其在空间分析和计算机视觉应用中具有不可估量的价值。它使用的坐标系原点位于 (0, 0)。

通常，QR扫描仪使用标准解码算法依赖三个查找模式，这个模型捕捉ID的所有四个顶点。 result 对象包含一个 Points 集合，您可以遍历该集合以检索位置信息。

该代码重用了上一个示例中的杯子照片，以演示如何检测图像中的位置值。

请注意: 此函数返回的坐标以严格的"之字形"顺序存储：左上，右上，左下，最终右下

using System;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Linq;

// Load the image
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Detection Model mode
var input = new QrImageInput(bmp, QrScanMode.OnlyDetectionModel);

// Read QR code
var result = new QrReader().Read(input).FirstOrDefault();

// Print position data
if (result != null)
{
    if (result.Points != null)
    {
        foreach (var point in result.Points)
        {
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}");
        }
    }
}

using System;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Linq;

// Load the image
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Detection Model mode
var input = new QrImageInput(bmp, QrScanMode.OnlyDetectionModel);

// Read QR code
var result = new QrReader().Read(input).FirstOrDefault();

// Print position data
if (result != null)
{
    if (result.Points != null)
    {
        foreach (var point in result.Points)
        {
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}");
        }
    }
}

Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.Linq

' Load the image
Dim bmp = AnyBitmap.FromFile("cup.png")

' Create scan input using Detection Model mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyDetectionModel)

' Read QR code
Dim result = (New QrReader()).Read(input).FirstOrDefault()

' Print position data
If result IsNot Nothing Then
    If result.Points IsNot Nothing Then
        For Each point In result.Points
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}")
        Next
    End If
End If

Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.Linq

' Load the image
Dim bmp = AnyBitmap.FromFile("cup.png")

' Create scan input using Detection Model mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyDetectionModel)

' Read QR code
Dim result = (New QrReader()).Read(input).FirstOrDefault()

' Print position data
If result IsNot Nothing Then
    If result.Points IsNot Nothing Then
        For Each point In result.Points
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}")
        Next
    End If
End If

带标签的杯子图片

带标签的控制台

扫描方法比较

功能（ `QRScanMode` ）	基本扫描（ `OnlyBasicScan`扫描）	自动扫描（ `Auto` ）	检测模型（ `OnlyDetectionModel`检测模型）
输出	解码后的文本（值）	解码后的文本（值）	坐标（点）
算法	仅限传统方式	混合型（机器学习+传统）	仅限机器学习
重点	速度	可读性/检索	定位/计算机视觉