如何使用NuGet套件在C#中生成QR代碼

如何安裝二維碼NuGet套件？

透過NuGet套件管理器安裝IronQR只需幾秒鐘。 在 Visual Studio 中開啟NuGet套件管理器控制台並執行以下命令，或在 CLI 環境中使用 dotnet add package 命令：

Install-Package IronQR

NuGet套件會自動處理所有依賴項，確保與目標框架相容。 IronQR支援.NET Framework 4.6.2+、. .NET Core 2.0+ 和.NET 5-10，使其成為任何 Visual Studio 專案的多功能函式庫。

在編寫任何程式碼之前，您需要一個免費試用許可證金鑰。 在應用程式啟動時儘早設置，以便所有後續呼叫都經過身份驗證：

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

有了許可證金鑰，您的應用程式就可以產生、讀取和自訂二維碼，而不會在輸出影像上添加浮水印。

如何產生你的第一個二維碼？

創建你的第一個二維碼只需要極少的程式碼。 QrWriter 類別處理二維碼生成，其預設值合理，適用於大多數使用情境：

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

如何選擇合適的糾錯等級？

二維碼支援ISO/IEC 18004 二維碼標準中定義的四個糾錯級別，這些級別決定了二維碼在保持可掃描性的同時可以承受多大的損壞。 IronQR透過 QrOptions 類別支援所有四個層級：

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrection等級.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrection等級.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

如何自訂二維碼外觀？

IronQR透過 QrStyleOptions 提供豐富的樣式選項，支援自訂顏色、尺寸、邊距和標誌嵌入。 品牌二維碼在行銷環境中表現更佳，因為它們在視覺上將二維碼與已知的身份聯繫起來：

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

如何將二維碼儲存為不同的輸出格式？

IronQR支援多種輸出格式，包括 PNG、JPEG、GIF、TIFF、BMP 和 SVG。 SaveAs 方法會自動根據檔案副檔名偵測檔案格式：

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

如何比較IronQR NuGet套件和 QR 圖碼？

[QR 圖碼 函式庫](https://www.nuget.org/packages/QR 圖碼/)是.NET中用來產生二維碼的流行開源選項。 使用過 QR 圖碼 的開發者都熟悉它的多步驟 API，其中涉及 QRCodeData 以及單獨的渲染類，例如 PngByteQRCode。 IronQR將其簡化為單一 QrWriter.Write() 呼叫。

QR 圖碼 在 Windows 環境下可以很好地用於基本二維碼產生。 IronQR 的機器學習模型能夠從任何角度提供卓越的二維碼讀取性能——這對於處理用戶提交的圖像(輸入品質無法控制)的應用程式至關重要。 單方法 API 還減少了交付可用功能所需的程式碼行數。

對於從 QR 圖碼 遷移的團隊，請參閱QR 圖碼 到IronQR遷移指南，以取得並排 API 對應。

如何在二維碼中編碼二進位資料？

除了文字之外， IronQR還支援對二進位二維碼有效載荷進行位元組數組編碼。 這對於無法用 UTF-8 字串表示的加密令牌、序列化物件或原始二進位標識符非常有用：

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

如何在C#中讀取二維碼？

IronQR同時處理寫入和讀取操作。 QrReader 類別接受影像檔案、點陣圖和相機幀，使其既適用於批次處理也適用於即時掃描場景：

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

這款由機器學習驅動的讀取引擎可以處理任意方向的影像，並能處理誤差校正閾值範圍內的部分損壞。 對於生產環境中的讀取場景，請查看二維碼讀取教學課程，以取得處理低品質輸入、多碼影像和掃描模式配置的指導。

如何在ASP.NET Core應用程式中使用IronQR ？

Web 應用程式經常需要按需產生二維碼——用於使用者帳戶連結、一次性登入代碼或付款請求。 以下範例展示如何透過ASP.NET Core最小 API 端點直接提供二維碼影像：

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

這種模式既適用於ASP.NET Core 的極簡 API，也適用於標準的 MVC 控制器。 ExportBytes() 呼叫避免了將臨時檔案寫入磁碟，這在檔案系統可能是唯讀或臨時的容器化部署中非常重要。

完整的ASP.NET Core整合演練，請參閱ASP.NET Core二維碼產生器教學。 Blazor二維碼產生器教學中也提供了 Blazor 專用指南。

如何為二維碼圖片添加邊距並調整大小？

控制尺寸和靜區對於確保列印品質至關重要。 IronQR透過 QrStyleOptions 公開了這兩種方式，並且有專門的操作指南詳細介紹了每一種方式：

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

有關不同輸出媒體的尺寸和邊距要求的完整指南，請參閱有關調整二維碼影像大小和為二維碼添加邊距的操作指南文章。 建立二維碼圖像指南涵蓋了從許可證啟動到文件輸出的完整圖像創建工作流程。

針對特定的二維碼使用場景(包括 為名片生成二維碼、 構建動態二維碼生成器以及從圖像中讀取二維碼) ，專門的文章涵蓋了每種場景，並提供了完整的代碼示例。

下一步計劃是什麼？

IronQR將二維碼產生從多步驟流程簡化為簡單的NuGet整合。 安裝軟體包，呼叫 QrWriter.Write()，然後儲存結果－這三個操作涵蓋了大多數現實世界的場景。 同一個庫提供糾錯等級、自訂樣式、PDF 標記和機器學習驅動的閱讀功能。

IronQR文件提供了完整的 API 參考，包括進階主題，例如使用掃描模式讀取二維碼、批次處理和特定於平台的部署說明。 IronQR教學部分包含.NET MAUI、VB .NET和控制台應用程式的逐步指南。

開始免費試用，即可不受限制地探索所有功能，或購買許可證進行生產部署，並享有 24/5 全天候工程支援。