如何在 C# 中讀取影像中的二維碼

主要特點

• 輕鬆讀取和產生二維碼。
• 支援 JPEG、PNG、BMP 等影像格式。
• 高速效能和精準偵測，方便擷取二維碼資料。
• 適用於 .NET Framework、.NET Core、.NET Standard (2.0+) 和 .NET 6/7+ 專案。
• 提供跨平台支持，因此您可以在您喜歡的應用程式環境和作業系統中工作，無論是 Windows、Linux 還是任何其他受支援的環境。

與開源替代方案不同，IronQR 專注於企業級穩定性、商業許可和專業支援——這使其成為業務關鍵型應用程式的絕佳選擇。

透過 NuGet 安裝

您可以直接從 NuGet 套件管理器控制台安裝 IronQR：

Install-Package IronQR

Install-Package IronQR

或者，您也可以在 Visual Studio 中使用 NuGet GUI，搜尋IronQR ，然後按一下"安裝"：

如何在 C# 中讀取映像中的二維碼：圖 2 - IronQR NuGet 套件管理器螢幕

新增命名空間和基本設置

安裝完成後，請在 C# 檔案中包含以下命名空間：

using IronSoftware.Drawing;
using IronQR;

using IronSoftware.Drawing;
using IronQR;

注意： IronSoftware.Drawing 用於以跨平台的方式處理影像格式。

支援的圖像格式

IronQR 支援多種影像格式，包括：

• PNG
• JPG/JPEG
• BMP
• GIF
• 多倫多國際電影節

這種靈活性使您可以處理幾乎任何影像來源，從相機快照到掃描文件。

基本程式碼範例

讓我們仔細看看如何使用這個函式庫輕鬆解碼二維碼。 以下是一個簡單的範例，它使用 Bitmap 類別和檔案流從圖像檔案中讀取文字值為"Hello World!"的單一二維碼：

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

控制台輸出

如何在 C# 中讀取影像中的二維碼：圖 3 - 二維碼值控制台輸出

這段程式碼載入二維碼圖像，讀取偵測到的第一個二維碼，並列印解碼後的內容。 簡單有效。您可以在這裡保存二維碼的值，以備後續使用。

處理多個二維碼

如果您的圖像包含多個二維碼（例如，一張產品標籤），您可以提取所有二維碼。 在這個例子中，我們將透過程式運行以下二維碼圖像：

如何在 C# 中讀取影像中的二維碼：圖 4 - 包含多個二維碼的影像

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

輸出

如何在 C# 中讀取影像中的二維碼：圖 5 - 二維碼值輸出

影像品質差

模糊或低解析度的影像會使二維碼難以偵測。 盡可能使用高品質的原料。

未偵測到二維碼

確保影像不要太暗，對比度要強，且二維碼沒有被遮蔽。 嘗試裁切影像，使二維碼區域突出顯示。

例外處理

務必將讀取二維碼的邏輯放在 try-catch 區塊中，以便優雅地處理損壞的檔案或意外的格式：

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}