C# QR碼讀取器（逐步教學）

隨需生成新的多樣化條碼是許多商業 .NET 應用程式的重要方面。 與其他第三方選項相比，IronBarcode 庫使這一操作變得既快速又方便和容易。 本教程旨在說明這一點。

1. 創建新專案

打開 Visual Studio，然後轉到「文件」選單。 選擇新專案，然後選擇控制台應用程式/Windows Forms/WPF 應用程式。 條碼也可以用於所有類型的應用程式。 此外，您可以將它們與 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 套件管理主控台

請訪問以下連結以瞭解有關條碼讀取器 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. 建立條碼實例

BarcodeReader 是用於讀取/創建 QR 碼的靜態類別。 它可以用於靜態類別BarcodeReader而不需建立任何物件實例。 條碼讀取控制提供了使用單個函數Read或ReadAsync掃描 15 種條碼的能力。 IronBarcode 庫可從各種來源讀取 QR 碼/條碼：

• 字串
• 資料流
• 圖片
• 位圖

5. 使用String讀取條形碼

可以使用 .NET 條碼讀取庫輕鬆讀取 QR 碼和條碼圖片。 Read 方法是靜態函數，將掃描 QR 碼圖像並將 QR 碼和條形碼解碼為文本。 它接受各種類型的圖像文件，如位圖、PNG 文件、JPEG、TIFF 等。

此Read 函數從圖像中提取 QR 碼/條碼數據，並將結果以BarcodeResult 對象的形式檢索。 如果程式碼無法識別影像檔案，將會返回 null。

BarcodeResult 具有以下值：

• BarcodeType
• 價值
• 文本

• 二進位值

  BarcodeType 是一個枚舉數據類型，它返回給定輸入圖像的條碼類型。 IronBarcode 支援二十二種條碼類型。 它將返回應用於給定輸入圖像的條碼類型。

  Value 和 text 也是 BarcodeResult 可用的物件類型值。 兩者的值和文字都是字串資料類型。這會返回條碼的字串值。 Read 方法將讀取 QR 碼和條碼，並將給定條碼圖像的字串值獲取為 value/text。 二進位值是位元資料類型，並返回給定影像的位元。 以下是可以複製編碼到任何 .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 碼/條碼，並在物件中顯示結果。 以下是代碼中提供的用於掃描編碼數據的QR碼/條碼。

條碼輸入

6. 從 TIFF 圖像讀取多個條碼

.NET 條碼讀取控制允許使用相同的Read方法從圖像文件中讀取多個 QR 碼/條碼，非常易於使用。

以下是從圖像讀取多個 QR 碼的範例代碼：

// 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)

在上述代碼中，QR碼是從TIFF QR碼影像中提取的。 .NET 條碼讀取器從系統中的影像掃描 QR 碼，並將結果作為陣列返回。 在上述代碼中，只掃描了Code128的條碼。 如果圖像上存在任何其他條碼，將會被忽略。

7. 從 PDF 讀取 QR Code 和條碼

本節演示如何從 PDF 文件中讀取 QR 碼。 QR碼庫將掃描所有可用頁面和檔案中的所有可用QR碼，或專注於一種特定類型的條碼。 使用IronBarcode時，該庫提供了所有標準條碼讀取器所需的相關DLL，因此無需將任何其他DLL作為.NET專案引用。

以下是可用於從 PDF 讀取 QR 碼/條形碼的示例代碼。

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碼/條碼的示例代碼。 它還可以提供每個條碼及其類型的詳細結果。

結論

.NET 條碼讀取器提供了一種簡單易用的方法，可通過簡單的步驟讀取 QR 碼或解碼/創建 QR 碼和條碼。 IronBarcode DLL 可以用於各種環境，例如 .NET Windows Forms 應用程式、行動應用程式、網頁應用程式、MAUI，以及使用 .NET Framework 或 .NET Standard 的Blazor。 此外，IronBarcode 提供了多種自訂選項來提高條碼讀取速度，例如裁剪區域或多執行緒，以及機器學習模型的準確性。 IronBarcode 提供免費試用金鑰，或者您可以以只需兩個產品的價格購買來自 Iron Software 的五個產品。

請造訪授權頁面以獲取更多資訊。

您也可以下載zip 文件專案。