QR代碼.NET Core：在C#中讀取和生成QR代碼

如何安裝二維碼庫？

透過NuGet安裝IronQR只需幾秒鐘。 開啟 Visual Studio，前往"工具"> "NuGet套件管理員">"管理解決方案的NuGet套件" ，搜尋 IronQR，然後按一下"安裝" 。 此軟體套件依賴項極少，開箱即用，支援 Windows、macOS 和 Linux 系統。

Install-Package IronQR

IronQR 的目標平台為.NET Core 6、7、8、9 和 10，以及.NET Framework 4.6.2 及更高版本。 對於跨平台項目，SkiaSharp 整合可以處理非 Windows 運行時上的映像處理。 此程式庫無需額外的執行時間配置即可與ASP.NET Core Web 應用程式、控制台應用程式和桌面解決方案搭配使用。 安裝完成後，所有必要的擴充方法和類型均可立即使用。

如何從影像中讀取基本二維碼？

從圖像檔案中讀取二維碼資料只需要幾行程式碼。 QrReader 類別使用先進的機器學習模型來評估影像品質並自動選擇正確的分割模式，即使輸入影像不理想，也能提供準確的結果。

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

如何提取高級二維碼資料？

除了基本的數值解碼之外， IronQR還公開了每個掃描符號的座標、原始資料段和模組級資訊。 這對於需要確切知道二維碼在頁面上位置的文件處理工作流程，或者對於必須在單一影像中處理多個二維碼的應用程式至關重要。

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

糾錯等級如何影響二維碼品質？

糾錯機制允許二維碼掃描器即使在部分程式碼被遮蔽、印刷不良或物理損壞的情況下也能恢復原始資料。 二維碼標準定義了四個等級——低(L)、中(M)、四分位數(Q)和高(H)——每個等級都以儲存容量換取損壞容忍度。

產生二維碼時，指定更高的糾錯等級可確保輸出在實際掃描條件下保持穩定：

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

如何產生包含國際字元的二維碼？

IronQR支援所有類型的 QR 編碼模式：數字、字母數字、位元組和漢字。 對於日文文字和其他Unicode內容，該函式庫會自動選擇最節省空間的編碼方式：

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

如何使用有效載荷產生器產生結構化二維碼資料？

編碼純 URL 的二維碼適用於簡單的連結共享，但許多應用程式需要編碼結構化資料——WiFi 憑證、 vCard 格式的聯絡人卡片或事件資料。 手動格式化這些有效載荷容易出錯； 缺少分號或欄位順序錯誤會導致掃描器錯誤解讀資料。

IronQR提供了有效負載輔助函數，可以正確建構這些結構化字串：

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

如何自訂二維碼外觀？

IronQR讓您可以控制產生的二維碼的視覺外觀，同時又不影響其可掃描性。 您可以變更前景和背景顏色，套用自訂品牌標識，或將徽標嵌入到中心的靜默區。

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

嵌入徽標會減少有效資料區域，因此當提供徽標時，庫需要 H 級糾錯。 中心預留的安靜區域約佔代碼表面積的 30%，這在 H 級的恢復能力範圍內。 該程式庫會自動強制執行此約束——如果您在徽標旁邊設置較低的糾錯級別， IronQR將引發帶有描述性訊息的異常，而不是產生掃描不可靠的程式碼。

對於ASP.NET Core應用程序， ASP.NET Core二維碼產生器教學課程展示如何從控制器操作提供產生的二維碼作為影像回應。 輸出流直接寫入回應，無需中間檔案 I/O，從而保持高流量端點的低延遲。

如何在ASP.NET Core應用程式中讀取二維碼？

從上傳的影像、文件處理流程或自動偵測系統中掃描伺服器端的二維碼是讀取 API 的常見用例。 ASP.NET二維碼掃描器指南涵蓋了完整的控制器和服務設置，但其核心讀取模式與控制台應用程式相同：

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

AnyBitmap.FromStream() 方法接受任何可讀流，因此相同的程式碼路徑適用於透過表單上傳的檔案、從 Blob 儲存中取得的影像或從視訊管道中提取的訊框。控制器不會將任何臨時檔案寫入磁碟，這對於檔案系統可能為唯讀的容器化部署至關重要。

對於高吞吐量場景，請將 QrReader 作為單例在每個應用程式生命週期內實例化一次，因為 ML 模型載入成本是在首次建構時支付的。 對同一實例的後續 Read() 呼叫是線程安全的，並且共享已載入的模型。

如何在.NET MAUI應用程式中產生二維碼？

.NET MAUI QR 碼教學演示了在 iOS、Android、macOS 和 Windows 上的完整跨平台生成過程。 IronQR在非 Windows 平台上運行時使用SkiaSharp渲染後端，從而在所有 MAUI 目標上提供一致的輸出。

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

在移動目標上，ExportBytes() 傳回 PNG 位元組數組，您可以將其直接輸入到 StreamImageSource 或寫入到 ImageButton。 MAUI 鷹架不需要特定於平台的程式碼路徑——相同的生成邏輯在所有四個 MAUI 目標上運行完全相同。

對於.NET項目， API介面是相同的； 只有語法不同。 該庫以單一NuGet套件的形式提供，無需單獨的 VB .NET組件。

下一步計劃是什麼？

IronQR涵蓋了.NET中完整的二維碼生命週期——從基本生成和結構化有效載荷編碼到利用機器學習讀取損壞或品牌化的二維碼。 該庫處理漢字編碼、糾錯配置和跨平台影像輸出，讓您可以專注於應用程式特有的邏輯。

將所學付諸實踐：

• 查看C# 二維碼閱讀器教學課程，深入了解讀取 API 和結果處理。
• 完成C# 二維碼產生器應用程式教學課程，以獲得完整的專案示範。
• 瀏覽程式碼範例，查看更多生成和讀取模式。 -購買IronQR許可證即可解鎖所有功能以進行生產部署，或者如果您需要更多評估時間，可以延長免費試用期。