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

輸出

QrWriter.Write() 方法將資料處理成 QrCodeData，其中包含 QR 符號的原始模組（黑白方塊）。 IronQR 使用內部有效負載產生器，以確保輸入的文字能有效地編碼為數值資料、字母數字文字串或位元組陣列。

來自 IronSoftware.Drawing 的 AnyBitmap 類別提供了跨平台映像保存功能，因此相同的程式碼無需修改即可在 Windows、macOS 和 Linux 上運行。 您可以根據使用情境，將輸出結果儲存為 PNG、JPEG 或其他受支援的格式。

如需實際操作示範，請參閱"產生 QR 碼"範例頁面，該頁面除展示基本產生流程外，亦提供其他配置選項。

什麼是錯誤修正等級？

錯誤修正決定了 QR 符號在保持可掃描性的同時可承受的損害程度。 這是其中一項可選擇的進階功能，可讓您建立品牌形象並保持持久性。 QR 碼標準（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");

Imports IronQr
Imports IronSoftware.Drawing

' Configure with high error correction level
Dim options As New QrOptions(QrErrorCorrection難度等級.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 輸出。

。

第二個參數指定允許的最大版本號，控制 QR 代碼的大小和資料容量。 在加入標誌圖片或實體穿著情境時，較高的錯誤修正是必要的。

若計劃在 QR 碼上疊加標誌，請務必使用 H 級。 額外的冗餘設計可彌補被標誌遮擋的模組，確保程式碼易於閱讀。 IronQR 錯誤校正文件說明了版本選擇如何與資料容量及校正等級相互作用。

如何使用標誌和顏色自訂 QR 碼的外觀？

IronQR 的 QrStyleOptions 功能可根據品牌風格生成 QR 碼，支援自訂顏色、尺寸及嵌入商標。 這對於視覺一致性至關重要的行銷材料、產品包裝及活動門票而言，尤為實用。

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

樣式化 QR 碼

。

Dimensions 屬性設定輸出影像的像素大小。 Margins 屬性控制靜默區－二維碼周圍的空白邊框，掃描器需要正確辨識符號邊界。 QR 碼自訂指南涵蓋了額外的樣式屬性，包括背景顏色和模組形狀選項。

嵌入標誌時，其佔 QR 碼總面積的比例請控制在 30% 以下。 若超過此閾值，即使在 H 級校正下，仍可能影響可讀性。 在完成客製化後，建議使用多種 QR 碼掃描應用程式進行測試。

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

將 QR 碼產生整合至 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");
        }
    }
}

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 碼資料作為參數，並直接回傳產生的 PNG 影像。 此方法同樣適用於 ASP.NET Core Web API 專案及 Razor 檢視。

對於生產環境的 ASP.NET Core 應用程序，可以考慮使用 IMemoryCache 或 IDistributedCache 快取頻繁產生的二維碼，以減少 CPU 開銷。 靜態網址、產品識別碼或活動連結的 QR 碼在不同請求間不會改變，因此非常適合進行快取。

您亦可將 IronQR 整合至 Minimal API 端點中。 ASP.NET Core 整合教學提供了一個完整的範例，內容涵蓋依賴注入模式，以及如何從 Blazor 元件提供 QR 碼圖像。

使用頂級語句模式在 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 支援透過漢字模式編碼日文 Unicode 文字，此模式能以比標準編碼更少的資料區段，高效地編碼日文 Unicode 字元。 這能減少相同內容下 QR 碼的版本（大小），產生結構更簡單的符號，從而加快掃描速度。

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 碼的資料容量。 這對於針對日語使用者設計的應用程式至關重要，例如電子商務平台、餐廳菜單或旅遊資訊資訊站。

漢字模式會編碼 Shift JIS 字元集中的字元。 若您的應用程式在同一字串中同時處理日文與拉丁文字，IronQR 會於內部處理模式切換，並為每個區段選擇最有效的編碼方式。 關於 .NET 的國際化最佳實踐，Microsoft 的全球化文件提供了有關字元編碼的有用背景資訊。

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

IronQR 憑藉其基於機器學習的 QR 碼讀取器脫穎而出。 該機器學習模型即使在從不同角度讀取 QR 碼或處理部分遮蔽的圖像時，仍能達到高準確度——這相較於許多開源替代方案中採用的傳統閾值檢測演算法，具有顯著優勢。

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

QR 程式碼讀取輸出

。

QrResult 物件包含解碼值以及位置元數據，您可以使用它在 UI 疊加層或文件處理管道中突出顯示檢測到的二維碼區域。 這項功能使 IronQR 成為文件處理與庫存管理系統的理想選擇。

該機器學習模型完全在裝置端運行，無需呼叫雲端 API，因此適用於氣隙環境及離線應用程式。 傳統的基於 CV 的偵測器（如 ZXing.NET）對於乾淨、正面朝上的條碼表現良好，但在面對眩光、旋轉或損壞等真實世界狀況時，往往難以應對。 IronQR 的機器學習方法能可靠地處理這些情境。

針對批次文件處理，您可以依序將多張圖片傳送至閱讀器，並彙整所有處理結果。 QR 碼讀取文件說明涵蓋從 PDF 頁面、相機串流以及靜態圖像檔案中讀取 QR 碼。

跨平台支援如何運作？

與依賴 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 Standard 執行環境映像檔外，無需額外的系統套件。 與需要原生 GDI+ 依賴項的程式庫相比，這簡化了您的 Dockerfile。 《IronQR 部署指南》涵蓋了容器化及雲端環境的配置說明。

IronQR 與其他 .NET QR 程式庫相比如何？

目前有多種 .NET QR 碼函式庫，各具不同的取捨。 了解這些差異有助於您為專案選擇合適的工具。

QRCoder 是一個採用 MIT 授權的開源函式庫。 它適用於簡單的 QR 碼生成，但不包含 QR 碼讀取功能或基於機器學習的偵測功能。 相較於 IronQR 對樣式化輸出的支援，其輸出選項較為有限。

ZXing.NET 是 Java ZXing 函式庫的 C# 移植版本。 它支援讀寫功能，但依賴傳統的電腦視覺技術，因此難以處理受損或旋轉的條碼。 跨平台影像處理需進行額外設定。

IronQR 提供整合生成與讀取功能的單一套件，其 Enterprise授權方案包含專屬技術支援。 ML 驅動的閱讀器、樣式化的輸出以及 IronSoftware.Drawing 整合使其成為生產應用程式更完整的解決方案。

如需詳細的功能比較，請參閱《IronQR 與 QRCoder 比較》及《IronQR 與 ZXing 比較》文章。

下一步計劃是什麼？

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

若要繼續使用 IronQR 進行開發，請參考以下資源：

• IronQR NuGet 套件 -- 安裝最新穩定版本
• IronQR API 參考手冊 -- 完整的類別與方法文件
• QR 碼範例 -- 適用於常見情境的即用型程式碼
• IronQR 教學指南 -- 針對特定使用情境的逐步操作指南
• 授權方案 -- 為您的專案選擇合適的方案

立即開始免費試用，無需任何前期承諾，即可充分發揮 IronQR 的全部潛力。