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

如何在.NET Core安裝二維碼庫？

首先，開啟 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 開發和多平台專案的理想選擇。

安裝完成後，IronQR在檔案頂部新增所需的 using 指令。 IronQR 與 IronSoftware.Drawing 整合以實現跨平台映像處理，因此無需使用平台特定的依賴項，例如 System.Drawing.Common(此依賴項在.NET 6 及更高版本中已棄用，無法用於跨平台)。

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

如何產生二維碼？

QrWriter 類別通常與便捷的擴展方法一起使用，使生成二維碼變得簡單。 以下是使用頂級語句產生二維碼的完整範例的原始程式碼，只需幾行程式碼即可完成：

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");

什麼是糾錯級別？為什麼糾錯級別很重要？

糾錯機制決定了二維碼在保持可掃描性的同時能夠承受多大的損壞。 這是可選的高級功能之一，可實現品牌推廣和提高耐用性。 二維碼標準(ISO/IEC 18004)定義了四個等級的糾錯，每個等級都以資料容量作為彈性。

使用QrOptions配置糾錯：

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrection等級.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(QrErrorCorrection等級.High, 20);

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

如何使用徽標和顏色自訂二維碼外觀？

IronQR 的QrStyleOptions功能支援產生與品牌一致的二維碼，支援自訂顏色、尺寸和嵌入式徽標。 這對於注重視覺一致性的行銷資料、產品包裝和活動門票尤其有用。

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");

如何在ASP.NET Core中產生二維碼？

將二維碼產生功能整合到ASP.NET Core中遵循模型-視圖-控制器模式。 以下是一個 HomeController 類別的實現，它直接從操作方法返回二維碼映像：

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");
        }
    }
}

此介面接受二維碼資料作為參數，並直接傳回產生的 PNG 影像。 此方法同樣適用於ASP.NET Core Web API 專案和Razor視圖。

對於生產環境的ASP.NET Core應用程序，可以考慮使用 IMemoryCache 或 IDistributedCache 快取頻繁產生的二維碼，以減少 CPU 開銷。 用於靜態 URL、產品識別碼或活動連結的二維碼在請求之間不會改變，是快取的理想選擇。

您也可以將IronQR整合到 Minimal API 端點中。 ASP.NET Core整合教學提供了一個完整的範例，包括依賴注入模式以及如何從Blazor元件提供二維碼圖像。

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

using IronQr;

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

using IronQr;

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

在呼叫任何IronQR方法之前，請設定許可證密鑰。 在開發過程中，您可以套用從IronQR授權頁面取得的免費試用金鑰。

如何對日文Unicode文本進行編碼？

IronQR支援透過 Kanji 模式對日文 Unicode 文字進行編碼，該模式使用比標準編碼更少的資料段來有效地對日文 Unicode 字元進行編碼。 這樣可以減少相同內容的二維碼版本(大小)，產生更簡單的符號，從而加快掃描速度。

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");

如何使用機器學習讀取二維碼？

IronQR 的獨特之處在於其機器學習驅動的二維碼閱讀器。 即使從某個角度或部分遮蔽的圖像中讀取二維碼，ML 模型也能達到很高的準確率——這比許多開源替代方案中使用的基於閾值的傳統檢測演算法具有顯著優勢。

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}");
}

跨平台支援是如何運作的？

與依賴 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運行時映像之外，不需要任何其他系統軟體包。 與需要原生 GDI+ 依賴項的程式庫相比，這簡化了您的 Dockerfile。 IronQR部署指南涵蓋了容器化和雲端環境的配置。

IronQR與其他.NET二維碼庫相比如何？

目前有多種.NET二維碼庫，各有優缺點。 了解這些差異有助於您為專案選擇合適的工具。

QRCoder是一個採用 MIT 授權的開源函式庫。 它在產生二維碼方面表現良好，但不具備二維碼讀取功能或機器學習檢測功能。 與 IronQR 的樣式化輸出支援相比，其輸出選項較為有限。

ZXing .NET是 Java ZXing 函式庫的 C# 移植版。 它支援讀寫操作，但依賴傳統的電腦視覺技術，而這些技術難以處理損壞或旋轉的程式碼。 跨平台影像處理需要額外的設定。

IronQR提供產生和讀取功能，企業授權包含專門的支援服務。 ML 驅動的閱讀器、樣式化的輸出以及 IronSoftware.Drawing 整合使其成為生產應用程式更完整的解決方案。

有關詳細功能比較，請參閱IronQR與 QRCoder 的比較文章和IronQR與 ZXing 的比較文章。

下一步計劃是什麼？

IronQR為.NET Core中的二維碼產生和讀取提供了完整的解決方案。 透過自動處理複雜的酬載產生器和原始模組及資料的組裝，簡化了開發週期。 無論您需要一個簡單的開源程式庫替代方案，還是一個具有可選高級功能的系統，IronQR 的跨平台架構都能確保可靠運作。

要繼續使用IronQR進行構建，請探索以下資源：

• IronQR NuGet套件-- 安裝最新穩定版本 IronQR API 參考文件－完整的類別和方法文檔 -二維碼範例-- 適用於常見場景的可直接複製貼上程式碼
• IronQR教程－針對特定用例的逐步指南 -授權選項－選擇適合您專案的方案

立即開始免費試用，無需任何前期投入即可解鎖 IronQR 的全部功能。