QR Code .NET Core Generator & Reader | IronQR for .NET

如何在 .NET Core 中安裝 QR Code 程式庫？

首先，打開 Visual Studio 並點擊建立按鈕開始一個新專案。 一旦您指定了專案名稱，通過 NuGet 套件管理器安裝程式庫只需幾秒鐘。 雖然一些開發人員可能會搜尋 QRCoder NuGet 套件，但您可以通過在套件管理器控制台中運行以下命令來安裝 IronQR 框架：

Install-Package IronQR

或者，使用 NuGet 套件管理器 UI，搜尋 "IronQR" 並點擊安裝按鈕。 程式庫提供與 .NET Core 3.x、.NET 5、6、7、8、9 和 10 相容的 .NET 實現，非常適合現代 Web 開發和多平台專案。

安裝後，在文件頂部新增所需的 using 指令。IronQR 與 IronSoftware.Drawing 整合以進行跨平台圖像處理，消除了對於跨平台使用而在 .NET 6 及更高版本中被棄用的特定平台依賴如 System.Drawing.Common 的需求。

您可以通過檢查專案的包引用中的 .csproj 文件或通過確認 NuGet 套件出現在套件管理器控制台輸出中來驗證安裝是否成功。 一旦安裝完畢， IronQR API 參考 立即可用。

如何生成 QR Code？

QrWriter 類，通常與便捷的擴展方法一起使用，使得生成 QR Code 變得簡單。 這裡是一個完整範例的源程式碼，使用頂級語句在幾行程式碼內生成 QR Code：

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate a QR code from input text
Dim qrcode As QrCode = QrWriter.Write("https://ironsoftware.com")

' Save as PNG image
Dim qrImage As AnyBitmap = qrcode.Save()
qrImage.SaveAs("website-qr.png")

什麼是錯誤修正等級及其重要性？

錯誤修正決定了在保持可掃描的情況下，QR 符號可以承受多少損壞。 這是一個可選的高級功能，允許進行品牌化和耐用性。 QR Code 標準（ISO/IEC 18004） 定義了四個等級的錯誤修正，每個等級均在資料容量和韌性之間做出平衡。

using QrOptions 配置錯誤修正：

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionLevel.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionLevel.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Configure with high error correction level
Dim options As New QrOptions(QrErrorCorrectionLevel.High, 20)

' Generate QR code with options
Dim qrcode As QrCode = QrWriter.Write("Product-12345", options)
Dim qrImage As AnyBitmap = qrcode.Save()
qrImage.SaveAs("product-qr.png")

如何自定義 QR Code 外觀與徽標和顏色？

IronQR 的 QrStyleOptions 允許與品牌一致的 QR Code 生成，具有自定義顏色、尺寸和嵌入徽標。 這在營銷材料、產品包裝和活動票券中非常有用，在此時視覺一致性很重要。

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim styleOptions As New QrStyleOptions With {
    .Dimensions = 300,
    .Margins = 10,
    .Color = Color.DarkBlue,
    .Logo = New QrLogo With {.Bitmap = AnyBitmap.FromFile("company-logo.png")}
}

Dim qrcode As QrCode = QrWriter.Write("https://yourcompany.com")
Dim qrImage As AnyBitmap = qrcode.Save(styleOptions)
qrImage.SaveAs("branded-qr.png")

如何在 ASP.NET Core 中生成 QR Code？

將 QR Code 生成整合到 ASP.NET Core 遵循模型視圖控制器模式。 這是一個 HomeController 類的實現，從動作方法直接返回 QR Code 圖像：

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

Namespace Examples
    Public Class HomeController
        Inherits Controller

        Public Function GenerateQR(content As String) As IActionResult
            Dim myQr As QrCode = QrWriter.Write(content)
            Dim qrImage As AnyBitmap = myQr.Save()
            Dim imageBytes As Byte() = qrImage.ExportBytes()
            Return File(imageBytes, "image/png")
        End Function
    End Class
End Namespace

此端點接受 QR Code 資料作為參數並直接返回生成的 PNG 圖像。 此方法可在 ASP.NET Core Web API 專案和 Razor 視圖中同樣有效。

對於生產 ASP.NET Core 應用，考慮使用 IMemoryCache 或 IDistributedCache 快取經常生成的 QR Code 以減少CPU開銷。 靜態URL、產品標識符或事件連結的 QR Code 在請求之間不會改變，是快取的理想候選者。

您還可以將 IronQR 整合到 Minimal API 端點中。 ASP.NET Core 整合教程 提供了一個完整的範例，包括依賴注入模式和如何從 Blazor 組件服務 QR Code 圖像。

使用頂級語句模式在 Program.cs 中註冊 IronQR 的許可金鑰，保持啟動配置清晰：

using IronQr;

IronQr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronQr;

IronQr.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronQr

IronQr.License.LicenseKey = "YOUR-LICENSE-KEY"

在調用任何 IronQR 方法之前設置許可金鑰。 在開發中，您可以使用從 IronQR 許可頁面 獲得的免費試用金鑰。

如何編碼日文 Unicode 文字？

IronQR 支持通過 Kanji 模式編碼日文 Unicode 文字，這種模式使用比標準編碼更少的資料段來高效地編碼日文 Unicode 字元。 這減少了相同內容的 QR Code 版本（大小），生成一個更不複雜的符號，掃描更快。

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
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("こんにちは世界");
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate QR that encodes Japanese Unicode text
Dim japaneseQr As QrCode = QrWriter.Write("こんにちは世界")
Dim qrImage As AnyBitmap = japaneseQr.Save()
qrImage.SaveAs("japanese-qr.png")

如何使用機器學習讀取 QR Code？

IronQR 藉由其 機器學習驅動的 QR 讀取器 而與眾不同。 ML 模型即使在角度或部分模糊的圖片中讀取 QR Code 也能達到高精確度，這是優於許多開源替代方案中使用的傳統閾值式檢測算法的重大優勢。

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

Imports IronQr
Imports IronSoftware.Drawing

' Load image containing QR code
Dim inputBmp As AnyBitmap = AnyBitmap.FromFile("scanned-document.png")
Dim imageInput As New QrImageInput(inputBmp)

' Read with ML-powered detection
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

For Each result In results
    Console.WriteLine($"Found: {result.Value}")
Next

跨平台支持如何運作？

與依賴於 System.Drawing.Common 的解決方案（在 .NET 6+ 中被棄用的跨平台使用）不同，IronQR 使用 IronSoftware.Drawing 支持真正的多平台專案。 您的程式碼在 Windows、macOS、Linux、iOS 和 Android 上一致運行。 對於多平台專案，SkiaSharp 替代品是不必要的 —— IronQR 在內部處理平台抽象。

.NET 跨平台文件 解釋了 .NET 10 的更廣泛平台相容性故事。IronQR 遵循這些原則，完全避免使用特定平台的 API。

IronQR 支持以下部署目標：

• .NET 10、9、8、7、6 -- 所有現代 .NET 版本
• .NET Core 3.x -- 適用於尚未遷移到現代 .NET 的應用程式
• Xamarin 和 MAUI -- 適用於行動應用開發
• Azure Functions 和 AWS Lambda -- 適用於無伺服器工作負荷

在 Docker 容器中運行時，除了標準的 .NET 執行時映像外不需要額外的系統套件。 這簡化了您的 Dockerfile，相比需要本地 GDI+ 依賴的程式庫。 IronQR 部署指南 涵蓋了容器化和雲環境的配置。

如何比較 IronQR 和其他 .NET QR 程式庫？

幾個 .NET QR Code 程式庫存在，每個都有不同的取捨。 了解這些差異有助於您為您的專案選擇合適的工具。

QRCoder 是一個具有 MIT 許可證的開源程式庫。 它在生成對於簡單 QR Code 時工作良好，但不包含 QR Code 讀取能力或機器學習驅動的檢測。 與 IronQR 的樣式化輸出支持相比，輸出選項更有限。

ZXing.NET 是 Java ZXing 程式庫的 C# 移植版本。 它支持讀寫，但依賴於傳統電腦視覺技術，在處理損壞或旋轉的程式碼時表現欠佳。 跨平台圖像處理需要額外設置。

IronQR 提供生成和讀取於一個包內，擁有 企業授權，包含專用支持。 ML 驅動的讀取器、樣式化輸出和 IronSoftware.Drawing 整合使其成為生產應用的更完整解決方案。

欲了解詳細的功能比較，請參閱 IronQR 與 QRCoder 比較 和 IronQR 與 ZXing 比較 文章。

您的下一步是什麼？

IronQR 提供了一個完整的解決方案，用於在 .NET Core 中生成和讀取 QR Code。 通過自動處理複雜的有效載荷生成器和原始模塊及 QrCodeData 資料的組裝，簡化了開發週期。 無論您需要一個簡單的開源程式庫替代品還是具有可選高級功能的系統，IronQR 的跨平台架構確保了可靠的操作。

要繼續使用 IronQR 開發，請探索這些資源：

• IronQR NuGet 套件 -- 安裝最新的穩定版本
• IronQR API 參考 -- 完整類別和方法文件
• QR Code 範例 -- 可直接複製粘貼的常見場景程式碼
• IronQR 教程 -- 針對特定用例的逐步指南
• 許可選項 -- 為您的專案選擇恰當的計劃

開始您的免費試用，在不需要任何前期承諾的情況下解鎖 IronQR 的全部潛力。