如何在 C# 中读取二维码值

Updated: 2026年6月29日

即时从任何二维码图像中提取解码后的文本。获取原始字符串值，以便在您的应用程序中进行显示、存储或处理。

读取二维码的值是任何扫描工作流的第一步。支付终端需要将交易 ID 嵌入到二维码中。仓库系统需要在标签上标注产品编号。票务验证器需要活动通行证上印有的预订代码。 IronQR 使这一过程简单明了：加载图像，将其传递给 QrReader，然后直接从结果中读取解码后的字符串。

本指南演示了如何使用 IronQR库从图像中提取二维码值。尚未生成二维码的开发者，请先参阅《将二维码生成图片》指南。

快速入门：读取二维码值

加载图像，使用 QrReader 扫描它，并提取解码后的字符串。

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

2复制并运行这段代码。

var input = new QrImageInput("qr-code.png");
var results = new QrReader().Read(input);
Console.WriteLine(results.First().Value);

var input = new QrImageInput("qr-code.png");
var results = new QrReader().Read(input);
Console.WriteLine(results.First().Value);

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

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

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

下载 IronQR C# 库以读取二维码值
加载图片并将其封装在 QrImageInput 中
创建一个 QrReader 实例，并使用输入调用 Read 方法
通过 QrResult.Value 访问解码后的字符串
在调用 .First() 之前，请使用 Any() 进行结果检查。

如何从图像中读取二维码的值？

要提取嵌入在 QR 码中的值，请将图像加载到 QrImageInput 中，传递给 QrReader.Read()，然后访问返回的 QrResult 上的 Value 属性。该方法返回一个集合，其中包含图像中每个被识别的二维码对应的结果。

输入

下方的二维码编码了 **https://ironsoftware.com**，扫描后将提取其值。

using IronQr;
using System.Drawing;

// Import image
var inputImage = Image.FromFile("sample.jpg");

// Load the asset into QrImageInput
QrImageInput imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
QrReader reader = new QrReader();

// Read the input and get all embedded QR codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}");

using IronQr;
using System.Drawing;

// Import image
var inputImage = Image.FromFile("sample.jpg");

// Load the asset into QrImageInput
QrImageInput imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
QrReader reader = new QrReader();

// Read the input and get all embedded QR codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}");

Imports IronQr
Imports System.Drawing
Imports System.Linq

' Import image
Dim inputImage As Image = Image.FromFile("sample.jpg")

' Load the asset into QrImageInput
Dim imageInput As New QrImageInput(inputImage)

' Create a QR Reader object
Dim reader As New QrReader()

' Read the input and get all embedded QR codes
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

' Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}")

Imports IronQr
Imports System.Drawing
Imports System.Linq

' Import image
Dim inputImage As Image = Image.FromFile("sample.jpg")

' Load the asset into QrImageInput
Dim imageInput As New QrImageInput(inputImage)

' Create a QR Reader object
Dim reader As New QrReader()

' Read the input and get all embedded QR codes
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

' Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}")

Value 属性返回原始解码后的字符串，内容与编码时完全相同：可以是 URL、数字、自由文本或其他任何数据。 Read() 方法始终返回一个 IEnumerable<QrResult>，即使只存在一个 QR 码。如果图像包含多个 QR 码，请循环使用 foreach (var result in results) 处理每个 QR 码。在调用 .First() 之前，用 results.Any() 进行保护，以处理未找到 QR 码的图像。

输出

如何读取所有二维码属性？

每个 QrResult 暴露三个属性，这三个属性共同给出扫描到的内容的全貌以及在图像中的位置。使用上文中的同一张输入二维码：

using IronQr;
using IronSoftware.Drawing;

AnyBitmap inputImage = AnyBitmap.FromFile("sample.jpg");

QrImageInput imageInput = new QrImageInput(inputImage);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

QrResult result = results.First();

// Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}");

// Parsed URL — populated when Value is a valid URL, null otherwise
Console.WriteLine($"Url:   {result.Url}");

// Corner coordinates of the QR code in the image [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };
for (int i = 0; i < result.Points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: ({result.Points[i].X}, {result.Points[i].Y})");
}

using IronQr;
using IronSoftware.Drawing;

AnyBitmap inputImage = AnyBitmap.FromFile("sample.jpg");

QrImageInput imageInput = new QrImageInput(inputImage);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

QrResult result = results.First();

// Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}");

// Parsed URL — populated when Value is a valid URL, null otherwise
Console.WriteLine($"Url:   {result.Url}");

// Corner coordinates of the QR code in the image [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };
for (int i = 0; i < result.Points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: ({result.Points[i].X}, {result.Points[i].Y})");
}

Imports IronQr
Imports IronSoftware.Drawing

Dim inputImage As AnyBitmap = AnyBitmap.FromFile("sample.jpg")

Dim imageInput As New QrImageInput(inputImage)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

Dim result As QrResult = results.First()

' Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}")

' Parsed URL — populated when Value is a valid URL, Nothing otherwise
Console.WriteLine($"Url:   {result.Url}")

' Corner coordinates of the QR code in the image [TL, TR, BL, BR]
Dim labels As String() = {"Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right"}
For i As Integer = 0 To result.Points.Length - 1
    Console.WriteLine($"{labels(i)}: ({result.Points(i).X}, {result.Points(i).Y})")
Next i

Imports IronQr
Imports IronSoftware.Drawing

Dim inputImage As AnyBitmap = AnyBitmap.FromFile("sample.jpg")

Dim imageInput As New QrImageInput(inputImage)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

Dim result As QrResult = results.First()

' Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}")

' Parsed URL — populated when Value is a valid URL, Nothing otherwise
Console.WriteLine($"Url:   {result.Url}")

' Corner coordinates of the QR code in the image [TL, TR, BL, BR]
Dim labels As String() = {"Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right"}
For i As Integer = 0 To result.Points.Length - 1
    Console.WriteLine($"{labels(i)}: ({result.Points(i).X}, {result.Points(i).Y})")
Next i

输出

`QrResult` 公开哪些属性？

QrResult 在成功扫描后会暴露以下属性：

属性	类型	说明
`Value`	`string`	原始解码字符串与编码内容完全一致。可包含 URL、纯文本、数字 ID、JSON 或任何其他数据。这是大多数应用程序的主要属性。
`Url`	`Uri`	当 `Value` 为有效的绝对 URL 时，会填充一个解析的 `Uri` 对象。可用于打开链接、验证域名或提取 URL 组件。如果值不是 URL，则返回 `null`。
`Points`	`PointF[]`	标记 QR 码在源图像中位置的四个角坐标，按照 `[Top-Left, Top-Right, Bottom-Left, Bottom-Right]` 排序。使用它来绘制边界框、裁剪区域或计算扫描面积。