1. IronBarcode
  2. 操作指南
  3. .NET 建立自訂 QR 碼
如何在 C# 中自訂並將標誌加入 QR 碼

如何在 C# 中自訂並將標誌加入 QR 碼

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

透過 IronBarcode 的 CreateQrCodeWithLogo 方法與樣式設定功能，在 C# 中自訂 QR 碼，包括添加標誌、更改顏色及加入註解，以建立品牌化且 Professional 的 QR 碼，應用於行銷與商業用途。

由於 QR 碼具備更高的資料容量且掃描更為便捷，因此已逐漸取代傳統 BarCode 而廣受歡迎。 這些工具在行銷領域備受重視，因其具備高度客製化能力，包含添加標誌、變更顏色以及整合其他品牌元素等選項。 現代企業運用客製化 QR 碼來執行各種行銷活動與客戶互動策略。

為滿足此需求，IronBarcode 提供了一套用於自訂 QR 碼的 Suite。 使用者可以建立帶有標誌的 QR 碼、變更配色方案，並添加註解。 這些功能由 IronDrawing 驅動，這是一個免費且開源的函式庫。 此函式庫支援多種 BarCode 格式，包括標準 QR 碼、Micro QR 以及最新的 rMQR 格式。

快速入門：一行代碼建立品牌專屬 QR 碼

立即開始使用：只需透過 IronBarcode 的程式碼，即可輕鬆建立包含您的標誌、自訂顏色和註解的 QR 碼，設定步驟極為簡便。 非常適合希望快速建立專業品牌形象的開發者。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/BarCode

    PM > Install-Package BarCode

  2. 請複製並執行此程式碼片段。

    IronBarCode.QRCodeWriter.CreateQrCodeWithLogo("https://example.com", new IronBarCode.QRCodeLogo("logo.png"), 300).ChangeBarCodeColor(IronSoftware.Drawing.Color.DeepSkyBlue).AddAnnotationTextAboveBarcode("Scan Me", new IronSoftware.Drawing.Font("Verdana",12), IronSoftware.Drawing.Color.White, 5).SaveAsPng("customQR.png");

  3. 部署至您的生產環境進行測試

    立即透過免費試用，在您的專案中開始使用 IronBarcode

    arrow pointer

簡化工作流程（5 個步驟）

  1. 下載用於自訂 QR 碼的 C# 函式庫
  2. 使用 CreateQrCodeWithLogo 來建立帶有標誌的 QR 碼
  3. 使用 ChangeBarCodeColor 套用自訂顏色
  4. 使用 AddAnnotationTextAboveBarcode 功能添加註解
  5. 使用 AddBarcodeValueTextBelowBarcode 顯示 QR 碼值

如何製作帶有商標的 QR 碼？

生成 QR 碼時，需使用 QRCodeLogo 物件來嵌入標誌圖片。 CreateQrCodeWithLogo 方法會產生一個帶有標誌的 QR 碼。 此方法是 IronBarcode 全面 QR 碼生成功能的一部分，為開發人員提供廣泛的自訂選項。

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

GeneratedBarcode QrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);

QrCodeWithLogo.SaveAsPng("QrCodeWLogo2.png");

Imports IronBarCode
Imports IronSoftware.Drawing

' Create QR code logo from file path
Dim logo As New QRCodeLogo("ironbarcode_top.webp", 0, 0, 20.0F)

Dim QrCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250)

QrCodeWithLogo.SaveAsPng("QrCodeWLogo2.png")
$vbLabelText   $csharpLabel
中心嵌有彩色方形標誌的 QR 碼，展示標誌整合範例

讓我們來檢視上述程式碼所產生的 QR 碼。 該 QR 碼中央印有邊角圓潤的標誌。 標誌整合在維持 QR 碼可掃描性的同時，也增添了品牌識別度。

哪些參數會影響標誌的外觀？

若要自訂標誌，請在建立新的 QRCodeLogo 物件時填寫特定欄位。 以下為必填欄位：

  • 匯入圖片：從 Byte Array、相對路徑 filepath 或 URI 匯入圖片。 為獲得最佳效果，請使用 PNG、JPEG 或 WebP 等常見格式的高解析度圖片。
  • 圖片尺寸：請以像素為單位指定所需的寬度和高度。 若圖片過大導致 QR 碼無法辨識，系統將拋出例外狀況。 使用 0 將自動決定最大可行尺寸。
  • 圖像圓角：設定圓角的半徑。 若需方角樣式，請輸入 0。 圓角設計能營造更專業的外觀，並提升視覺整合效果。

如何匯出生成的 QR 碼？

若要匯出生成的 QR 碼，請呼叫儲存方法。 匯出選項包含圖像檔案、串流、HTML 及 PDF。 請參閱我們的完整指南，進一步了解如何將 BARCODE 匯出為不同格式。針對網頁應用程式，您亦可將 BARCODE 匯出為 HTML 格式，以便直接嵌入網頁中。

如何變更我的 QR 碼顏色？

除了添加標誌外，IronBarcode 還允許使用者透過更改顏色來自訂 QR 碼。 透過 IronDrawing，使用者可以使用 RGB 值或十六進位色碼定義顏色，並將其套用至 QR 碼。 此功能對於在行銷素材中維持品牌一致性特別有用。 讓我們透過一段展示此功能的程式碼片段，以及生成的 QR 碼來了解其運作。

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo-color.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

IronSoftware.Drawing.Color ColorFromRgb = new IronSoftware.Drawing.Color(51, 51, 153);

GeneratedBarcode QrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);
GeneratedBarcode QrCodeWithLogoAndColor = QrCodeWithLogo.ChangeBarCodeColor(ColorFromRgb);
QrCodeWithLogoAndColor.SaveAsPng("ColorQrCodeWithLogo.png");
Imports IronBarCode
Imports IronSoftware.Drawing

' Create QR code logo from file path
Dim logo As New QRCodeLogo("ironbarcode_top.webp", 0, 0, 20.0F)

Dim ColorFromRgb As New IronSoftware.Drawing.Color(51, 51, 153)

Dim QrCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250)
Dim QrCodeWithLogoAndColor As GeneratedBarcode = QrCodeWithLogo.ChangeBarCodeColor(ColorFromRgb)
QrCodeWithLogoAndColor.SaveAsPng("ColorQrCodeWithLogo.png")
$vbLabelText   $csharpLabel
藍色 QR 碼，中央顯示自訂的彩色標誌，展示成功的色彩與標誌自訂效果

支援哪些色彩格式？

上述程式碼延續了先前關於建立帶有標誌的 QR 碼的範例。 此範例展示如何使用 ChangeBarCodeColor 方法變更 QR 碼顏色，該方法以 IronSoftware.Drawing.Color 物件作為輸入參數。 請使用 RGB 值、十六進位碼或預定義枚舉來建立此物件。 請參閱我們的"Create Color"程式碼範例以了解更多資訊。 色彩自訂功能可與所有受支援的BARCODE格式無縫整合。

何時該使用自訂顏色？

自訂顏色特別適用於：

  • 品牌一致性：讓 QR 碼與貴公司的視覺識別系統相符
  • 活動主題：為特別活動與企劃製作主題式 QR 碼
  • 視覺層級：運用色彩在 PRINT 品中突顯重要的 QR 碼
  • 無障礙設計：確保足夠的對比度，以便在各種環境下更輕鬆地瀏覽內容

選擇顏色時，請確保 QR 碼圖案與背景之間具有足夠的對比度，以確保掃描的可靠性。 深色文字搭配淺色背景通常效果最佳。

如何在 QR 碼中添加註解？

自訂 QR 碼的另一個重要方面，是在 QR 碼圖像中加入註解。 這些註解可以是BarCode的原始值，也可以是為宣傳目的而設定的自訂文字。 註解有助於使用者在掃描前了解 QR 碼的內容，從而提升使用者體驗與參與率。

讓我們來檢視這些方法的實作方式，以及生成的 QR 碼圖像。

:path=/static-assets/barcode/content-code-examples/how-to/customize-qr-code-style-logo-color-annotation.cs
using IronBarCode;
using IronSoftware.Drawing;

// Create QR code logo from file path
QRCodeLogo logo = new QRCodeLogo("ironbarcode_top.webp", 0, 0, 20f);

// Define color from RGB
Color colorForBarcode = new Color(51, 51, 153);

GeneratedBarcode qrCodeWithLogo = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250);
GeneratedBarcode qrCodeWithLogoAndColor = qrCodeWithLogo.ChangeBarCodeColor(colorForBarcode);
GeneratedBarcode qrCodeWithAnnotation = qrCodeWithLogoAndColor.AddAnnotationTextAboveBarcode("IronBarcodeRocks!", 2).AddBarcodeValueTextBelowBarcode(2);
qrCodeWithAnnotation.SaveAsPng("QRCodeWithAnnotation.png");
Imports IronBarCode
Imports IronSoftware.Drawing

' Create QR code logo from file path
Dim logo As New QRCodeLogo("ironbarcode_top.webp", 0, 0, 20.0F)

' Define color from RGB
Dim colorForBarcode As New Color(51, 51, 153)

Dim qrCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250)
Dim qrCodeWithLogoAndColor As GeneratedBarcode = qrCodeWithLogo.ChangeBarCodeColor(colorForBarcode)
Dim qrCodeWithAnnotation As GeneratedBarcode = qrCodeWithLogoAndColor.AddAnnotationTextAboveBarcode("IronBarcodeRocks!", 2).AddBarcodeValueTextBelowBarcode(2)
qrCodeWithAnnotation.SaveAsPng("QRCodeWithAnnotation.png")
$vbLabelText   $csharpLabel
中央標註有 IronBarcode 標誌的 QR 碼，展示自訂品牌標識功能

有哪些註解方法可用？

IronBarcode 提供方法，用於設定註解的位置（QR 碼上方或下方），以及其字型家族和顏色。 可用的方法包括：

  • AddAnnotationTextAboveBarcode：在 QR 碼上方添加註解文字
  • AddAnnotationTextBelowBarcode：在 QR 碼下方新增註解文字
  • AddBarcodeValueTextAboveBarcode：在 QR 碼上方添加 BARCODE 值文字
  • AddBarcodeValueTextBelowBarcode：在 QR 碼下方新增 BARCODE 值文字

這些方法可串接使用，以進行多重註解。 如需更進階的樣式設定選項，請參閱我們的完整BARCODE樣式指南。

如何自訂註解的外觀？

這四種方法皆接受自訂字型作為 IronSoftware.Drawing.Font 物件、顏色作為 IronSoftware.Drawing.Color 物件，以及一個整數來指定頂部與底部的間距（單位為像素）。 這些參數為可選項目； 若未特別指定，將使用預設的字型、顏色及間距。 Font 物件支援多種字型家族、樣式（粗體、斜體、常體）及大小，以符合您的品牌需求。

為何要在 QR 碼上使用註解？

註解可透過以下方式增強 QR 碼的功能：

  • 提供上下文：如"掃描選單"或"造訪我們的網站"等標籤可闡明用途
  • 提升參與度：清晰的行動呼籲可提高瀏覽率
  • 建立信任：顯示網址或公司名稱有助於讓使用者感到安心
  • 提升可讀性：文字註解有助於使用者在不逐字掃描的情況下理解內容

IronBarcode 是建立和自訂 QR 碼的理想工具。 除了直接的自訂方法外，IronBarcode 還將 IronDrawing 作為影像處理的輔助函式庫，其穩定性優於依賴外部函式庫。 如需更多範例與進階技巧，請參閱我們的 C# QR 碼產生器教學指南，並查閱 API 參考文件以獲取所有可用方法與屬性的完整說明。

常見問題

如何在 C# 中將標誌加入 QR 碼？

您可以使用 IronBarcode 的 CreateQrCodeWithLogo 方法，在 QR 碼中加入標誌。只需建立一個包含您的圖片檔案路徑的 QRCodeLogo 物件，並將其連同 QR 碼資料一併傳遞給該方法。標誌將嵌入 QR 碼的中心位置，同時維持 QR 碼的可掃描性。

我可以更改 QR 碼的顏色嗎？

是的，IronBarcode 提供了 ChangeBarCodeColor 方法，讓您能夠自訂 QR 碼的顏色。您可以套用 IronSoftware.Drawing.Co/lor 色盤中的任何顏色，以符合您的品牌識別，同時確保 QR 碼仍可被掃描。

如何在 QR 碼中添加文字註解？

IronBarcode 提供 AddAnnotationTextAboveBarcode 和 AddBarcodeValueTextBelowBarcode 等方法，用於添加文字註解。您可以自訂文字的字型、大小、顏色和位置，在 QR 碼上建立資訊性標籤或行動呼籲。

支援哪些BarCode格式進行客製化？

IronBarcode 支援多種 BARCODE 格式的自訂功能，包括標準 QR BARCODE、Micro QR BARCODE 以及最新的 rMQR 格式。每種格式均可透過自訂標誌、顏色及註解，以滿足您的特定需求。

我能否僅用一行程式碼就建立一個品牌專屬的 QR 碼？

是的，IronBarcode 允許您透過方法鏈接，僅需一行程式碼即可建立完全符合品牌風格的 QR 碼。您可以結合 CreateQrCodeWithLogo、ChangeBarCodeColor 以及 AddAnnotationTextAboveBarcode 方法，一次生成包含商標、顏色和文字的自訂 QR 碼。

QR 碼標誌可以使用哪些圖像格式？

IronBarcode 的 QRCodeLogo 功能支援 PNG、JPG 及其他標準格式等常見圖像格式。IronBarcode程式庫會自動處理並嵌入您的標誌圖像，同時確保 QR 碼具備最佳的讀取清晰度。

標誌整合會如何影響 QR 碼的掃描效果？

IronBarcode 會自動將標誌置於 QR 碼中央，並調整適當的大小與間距以確保可掃描性。此 IronBarcode程式庫確保標誌不會干擾 QR 碼的錯誤校正能力，使其能被標準 QR 碼掃描器正確讀取。

IronBarcode如何幫助改善業務流程效率？

IronBarcode通過使條碼生成和讀取快速且準確來提高業務流程效率，減少手動數據輸入錯誤，並改善庫存和資產追蹤。

將IronBarcode實現於專案中需要什麼程式設計技能？

基本的C#程式設計知識足以將IronBarcode實現於專案中，因為它提供了簡單的方法和全面的文檔來指導開發者。

IronBarcode適合於小型專案和大型企業應用嗎？

IronBarcode設計為可擴展且多功能，使其適合小型專案和需要強大條碼解決方案的大型企業應用。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  立即與工程團隊聯繫
軟體工程師
如同所有傑出的工程師，Hairil 是一位熱衷學習的人。他正不斷精進自己在 C#、Python 和 Java 方面的知識，並運用這些知識為 Iron Software 的團隊成員創造價值。Hairil 從馬來西亞馬拉科技大學（Universiti Teknologi MARA）加入 Iron Software 團隊，他在該校取得化學與製程工程學士學位。
準備好開始了嗎？
Nuget 下載 2,240,258 | 版本： 2026.5 just released
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package BarCode
執行範例 看您的字串變成 BarCode。