C# QR码读取器（逐步教程）

按需生成新的各种条形码是许多商业 .NET 应用程序的一个重要方面。 与其他第三方方案相比，IronBarcode 库使这项工作变得非常快速、方便和简单。 本教程旨在说明如何做到这一点。

1.创建新项目

打开 Visual Studio，进入文件菜单。 选择新建项目，然后选择控制台应用程序/Windows 窗体/WPF 应用程序。 BarCode 也可用于各类应用程序。 此外，您还可以在 Webform/MVC/MVC Core 等应用程序中使用它们。

配置您的新项目

在 Visual Studio 的相应文本框中输入项目名称并选择文件路径。 接下来，点击创建按钮，同时选择所需的.NET Framework。 现在，项目将为所选应用程序生成结构。 如果您选择了 控制台应用程序，它现在将打开 program.cs 文件，您可以在其中输入代码并构建/运行应用程序。

2.安装 IronBarcode NuGet 软件包

现在，进入 Visual Studio 中的解决方案资源管理器，然后左键单击项目。 从弹出菜单中选择NuGet 包管理器，然后搜索关键字“Barcode”。 在 NuGet 软件包对话框中选择第一个结果，然后单击安装选项。

从NuGet包管理器安装IronBarcode库

或者，在 Visual Studio 中按照以下说明操作：转到 工具 > NuGet 包管理器 > 程序包管理器控制台

打开包管理器控制台选项卡。 请键入以下一行：

Install-Package IronQR

NuGet 包管理器控制台

请转至以下链接，了解有关 BarCode Reader SDK 最新版本的更多信息。

https://www.nuget.org/packages/barcode

接下来，软件包将下载所有 DLL 文件，并在当前项目中添加 DLL 文件的引用作为 .NET 项目引用。

Visual Studio 项目现在可以在代码中使用了。

3.添加参考资料

将IronBarCode引用添加到代码中，如下所示，以便在 .NET Core 中使用 IronBarcode 库中可用的函数。 要了解更多关于条形码读取控件、读取QR码、组件、对QR码类型的支持以及条形码读取SDK兼容性的相关信息，请参考此链接：https://ironsoftware.com/csharp/barcode/

using IronBarcode;

4.创建 BarCode 实例

BarcodeReader 是用于读取/创建二维码的静态类。 它可以在不创建任何对象实例的情况下用于静态类BarcodeReader。 条码读取控件提供了使用单一函数扫描15种条码的能力，函数为Read或ReadAsync。 IronBarcode 库可以读取各种来源的 QR 码/条形码：

• 字符串
• 流
• 图像
• 位图

5. 使用String读取条形码

使用 .NET 条码阅读器库可以轻松读取 QR 码和条码图像。 Read 方法是一个静态函数，它将扫描 QR 码图像并将 QR 码和条形码解码为文本。 它接受各种类型的图像文件，如位图、PNG 文件、JPEG、TIFF 等。

此Read函数从图像中提取QR码/条形码数据，并将结果作为BarcodeResult对象检索。 如果代码无法识别图像文件，将返回空值。

BarcodeResult 具有以下值：

• 条形码类型
• 价值
• 文本

• 二进制值

  BarcodeType 是一个枚举数据类型，它返回给定输入图像的条形码类型。 IronBarcode 支持 22 种条码类型。 它将返回适用于给定输入图像的条形码类型。

  值和值也是BarcodeResult上可用的对象类型值。 值和文本都是字符串数据类型。这将返回 BarCode 的字符串值。 Read 方法将读取二维码和条形码，并将给定条形码图像的字符串值获取到数值/文本中。 二进制值是字节数据类型，返回给定图像的字节数。 以下是快速反应代码，可以复制编码到任何 .NET Windows Forms 或 .NET Standard 应用程序中。

BarcodeResult result = BarcodeReader.Read("test.bmp");
// Assert that IronBarCode Works :-)
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

BarcodeResult result = BarcodeReader.Read("test.bmp");
// Assert that IronBarCode Works :-)
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

Dim result As BarcodeResult = BarcodeReader.Read("test.bmp")
' Assert that IronBarCode Works :-)
If result IsNot Nothing AndAlso result.Text = "https://ironsoftware.com/csharp/barcode" Then
	System.Console.WriteLine("Success")
End If

上面的代码演示了如何使用 .NET 条码阅读器库读取 QR 码和条码。 代码简单易用，可将系统中的文件映射到 Bitmap 对象。 它还能从图像中解码 QR 码/Barcode，并将结果显示在对象中。 以下是代码中提供的 QR 码/Barcode，扫描即可获得编码数据。

条形码输入

6.从 TIFF 图像中读取多个 BarCode

.NET 条码阅读器控制允许使用相同的Read方法从图像文件中读取多个二维码/条形码，该方法非常易于使用。

以下是从图片中读取多个二维码的示例代码：

// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

BarcodeResult [] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

BarcodeResult [] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

' Configure options
Dim options As New BarcodeReaderOptions() With {
	.ExpectBarcodeTypes = BarcodeEncoding.Code128,
	.ExpectMultipleBarcodes = True
}

Dim multiFrameResults() As BarcodeResult = BarcodeReader.Read("Multiframe.tiff", options)

在上述代码中，二维码是从 TIFF 二维码图像中提取的。 .NET条形码阅读器可扫描系统图像中的二维码，并将结果以数组形式返回。 在上述代码中，仅扫描了Code128类型的条形码。 如果图像上有任何其他 BarCode，它们将被忽略。

7.从 PDF 阅读 QR 码和 BarCode

本节演示如何从 PDF 文档中读取 QR 码。 QR 代码库将扫描所有可用页面和文件中的所有可用 QR 代码，或者专注于一种特定类型的 BarCode。 使用 IronBarcode 时，该库提供了标准条码阅读器所需的所有相关 DLL，因此无需包含任何其他 DLL 作为 .NET 项目参考。

以下是复制代码示例，可用于从 PDF 中读取 QR 码/Barcode。

PagedBarcodeResult [] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Work with the results
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte [] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

PagedBarcodeResult [] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Work with the results
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte [] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

Dim pagedResults() As PagedBarcodeResult = BarcodeReader.ReadPdf("MultipleBarcodes.pdf")
' Work with the results
For Each pageRes As PagedBarcodeResult In pagedResults
	Dim pageNumber As Integer = pageRes.PageNumber
	Dim value As String = pageRes.Value
	Dim img As Bitmap = pageRes.BarcodeImage
	Dim barcodeType As BarcodeEncoding = pageRes.BarcodeType
	Dim binary() As Byte = pageRes.BinaryValue
	Console.WriteLine(pageRes.Value)
Next pageRes

上面是从一个简单的ReadPdf方法中读取PDF文件中的QR码/条形码的示例代码。 还可以提供每个 BarCode 及其类型的详细结果。

结论

.NET BarCode 阅读器提供了一种简单易行的方法，可通过简单的步骤读取 QR 码或解码/创建 QR 码和 BarCode。 IronBarcode DLL 可用于各种环境，如 .NET Windows 窗体应用程序、移动应用程序、Web 应用程序、MAUI 和 Blazor，使用 .NET Framework 或 .NET Standard。 此外，IronBarcode 提供了多种自定义选项来提高条形码读取速度，例如裁剪区域或多线程，以及ML 模型的准确性。 IronBarcode 提供免费试用密钥，或者您目前只需花两个月的价格就可以从 Iron Software 购买五个产品。

请访问许可页面以获取更多信息。

您还可以下载一个zip 文件项目。