如何在C#中自定義和添加標志到QR碼

如何在 C# 中自訂及新增 Logo 至 QR 碼</#35;。

This article was translated from English: Does it need improvement?
Translated
View the article in English

使用 IronBarcode 的 CreateQrCodeWithLogo 方法和造型功能,在 C# 中自訂 QR 代碼,添加標誌、變更顏色並包含註釋,為市場營銷和商業應用創建品牌化的專業 QR 代碼。

由於二維碼具有更高的資料容量和易於掃描的優點,因此比傳統條碼更受歡迎。 它們在行銷領域尤其受到重視,因為它們具有可自訂性,包括添加徽標、更改顏色和融入其他品牌元素等選項。 現代企業利用自訂 QR 代碼進行各種行銷活動和客戶參與策略。

為了滿足這項需求,IronBarcode 提供了一系列用於客製化二維碼的功能。 使用者可以建立具有標誌的 QR 碼、變更配色方案以及新增註解。 這些功能由IronDrawing提供支持,IronDrawing 是一個免費開源的函式庫。 該函式庫支援 多種條碼格式,包括標準的 BarCode、Micro QR 以及最新的 rMQR 格式。

快速入門:一行創作品牌二維碼

立即開始建立帶有您的徽標、自訂顏色和註釋的二維碼——只需極少的設定和一行 IronBarcode 代碼。 非常適合想要快速建立專業品牌的開發人員。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronBarcode

    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


如何使用標誌建立 QR 碼?

產生二維碼時,需要使用QRCodeLogo物件來嵌入標誌圖像。 The CreateQrCodeWithLogo method generates a QR code with a logo. 此方法是 IronBarcode 全面QR代碼生成功能的一部分,為開發人員提供了廣泛的定制選項。

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

AnyBitmap qrlogo = AnyBitmap.FromFile("ironbarcode_top.webp");

QRCodeLogo logo = new QRCodeLogo(qrlogo, 0, 0, 20f);

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

QrCodeWithLogo.SaveAsPng("QrCodeWLogo2.png");
Imports IronBarCode
Imports IronSoftware.Drawing

Private qrlogo As AnyBitmap = AnyBitmap.FromFile("ironbarcode_top.webp")

Private logo As New QRCodeLogo(qrlogo, 0, 0, 20F)

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

QrCodeWithLogo.SaveAsPng("QrCodeWLogo2.png")
$vbLabelText   $csharpLabel
二維碼中心嵌入彩色方形徽標,展示了徽標整合範例。

讓我們檢視上面的程式碼所產生的輸出 QR 碼。 QR 代碼的特色是中央有圓角邊緣的標誌。 標誌整合可維持 QR 代碼的可掃描性,同時增加品牌辨識度。

哪些參數控制標誌外觀?

若要自訂標誌,請在建立新的 QRCodeLogo 物件時填入特定欄位。 以下是必填欄位:

  • Importing Image: Import images from AnyBitmap, Stream, Byte Array, relative filepath, or URI. 為達到最佳效果,請使用 PNG、JPEG 或 WebP 等常用格式的高解析度圖片。
  • 圖片尺寸:以像素為單位指定所需的寬度和高度。 如果圖片太大,QR 代碼無法保持可讀性,則會產生異常。 使用 0 自動決定最大可行大小。
  • Image Corners:設定圓角的半徑。 使用 0 表示方角。 圓角設計可創造更專業的外觀和更好的視覺整合。

如何匯出產生的 QR Code?

若要匯出已產生的 QR 代碼,請調用儲存方法。 輸出選項包括影像檔、Streams、HTML 及 PDF。 在我們的綜合指南中,瞭解更多關於 將 BarCode 匯出為不同格式的資訊。對於網頁應用程式,您也可以 將條碼匯出為 HTML 以直接嵌入網頁中。

如何變更 QR Code 的顏色?

除了新增標誌之外,IronBarcode 還能讓使用者透過改變顏色自訂 QR 代碼。 透過 IronDrawing,使用者可以使用 RGB 值或 Hex 色碼定義顏色,並將其套用至 QR 代碼。 此功能對於在行銷材料中維持品牌一致性特別有用。 讓我們來看看示範此功能的程式碼片段以及產生的 QR 代碼。

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

AnyBitmap qrlogo = AnyBitmap.FromFile("ironbarcode_top.webp");

QRCodeLogo logo = new QRCodeLogo(qrlogo, 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

Private qrlogo As AnyBitmap = AnyBitmap.FromFile("ironbarcode_top.webp")

Private logo As New QRCodeLogo(qrlogo, 0, 0, 20F)

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

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

支援哪些顏色格式?

上面的程式碼延伸了之前以 Logo 建立 QR code 的範例。 It demonstrates changing QR code color using the ChangeBarCodeColor method, which takes an IronSoftware.Drawing.Color object as input. 使用 RGB 值、十六進位碼或預定義枚举建立此物件。 請造訪我們的"建立顏色"程式碼範例以了解更多資訊。 顏色自訂功能可與所有支援的 BarCode 格式無縫配合。

何時應該使用自訂顏色?

自訂顏色特別適用於

  • 品牌一致性:將 QR 代碼與您公司的視覺形象相匹配
  • 活動主題:為特殊活動和事件建立主題 QR 代碼
  • 視覺層級:在印刷材料中使用顏色突出重要的 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;

AnyBitmap qrlogo = AnyBitmap.FromFile("ironbarcode_top.webp");

QRCodeLogo logo = new QRCodeLogo(qrlogo, 0, 0, 20f);

Color colorForBarcode = new Color(51, 51, 153); // color from RGB
Color annotationAboveBarcodeColor = new Color("#176feb");  // color from Hex
Font annotationAboveBarcodeFont = new Font("Candara", FontStyle.Bold, 15);
Color barcodeValueBelowBarcodeColor = new Color("#6e53bb");
Font barcodeValueBelowBarcodeFont = new Font("Cambria", FontStyle.Regular, 15);

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

Private qrlogo As AnyBitmap = AnyBitmap.FromFile("ironbarcode_top.webp")

Private logo As New QRCodeLogo(qrlogo, 0, 0, 20F)

Private colorForBarcode As New Color(51, 51, 153) ' color from RGB
Private annotationAboveBarcodeColor As New Color("#176feb") ' color from Hex
Private annotationAboveBarcodeFont As New Font("Candara", FontStyle.Bold, 15)
Private barcodeValueBelowBarcodeColor As New Color("#6e53bb")
Private barcodeValueBelowBarcodeFont As New Font("Cambria", FontStyle.Regular, 15)

Private qrCodeWithLogo As GeneratedBarcode = QRCodeWriter.CreateQrCodeWithLogo("https://ironsoftware.com/csharp/barcode/", logo, 250)
Private qrCodeWithLogoAndColor As GeneratedBarcode = qrCodeWithLogo.ChangeBarCodeColor(colorForBarcode)
Private qrCodeWithAnnotation As GeneratedBarcode = qrCodeWithLogoAndColor.AddAnnotationTextAboveBarcode("IronBarcodeRocks!", annotationAboveBarcodeFont, annotationAboveBarcodeColor, 2).AddBarcodeValueTextBelowBarcode(barcodeValueBelowBarcodeFont, barcodeValueBelowBarcodeColor, 2)
qrCodeWithAnnotation.SaveAsPng("QRCodeWithAnnotation.png")
$vbLabelText   $csharpLabel
QR碼,中央有IronBarcode標誌註釋,展示自定義品牌功能

有哪些註解方法可用?

IronBarcode 提供了設定註解位置(二維碼上方或下方)以及字型和顏色的方法。 可用的方法包括

  • AddAnnotationTextAboveBarcode: Adds annotation text above the QR code
  • AddAnnotationTextBelowBarcode: Adds annotation text below the QR code
  • AddBarcodeValueTextAboveBarcode: Adds barcode value text above the QR code
  • AddBarcodeValueTextBelowBarcode: Adds barcode value text below the QR code

這些方法可以串連起來進行多重註解。 如需更多進階的樣式選項,請參閱我們的 完整條碼樣式指南

如何自訂註解外觀?

所有四種方法都接受自訂字型為 IronSoftware.Drawing.Font物件、顏色為 IronSoftware.Drawing.Color物件,以及以像素為單位指定上下間距的整數。 這些參數是可選的; 如果未指定,將使用預設字型、顏色和間距。 字型物件支援各種字系、樣式 (粗體、斜體、正規) 及大小,以符合您的品牌需求。

為什麼要在 QR 碼上使用註解?

註解通過以下方式增強 QR 代碼

  • 提供上下文:像"掃瞄選單"或"訪問我們的網站"這樣的標籤可以闡明目的
  • 提高參與度:清晰的行動呼籲可提高掃瞄率
  • 建立信任:顯示 URL 或公司名稱有助於讓使用者感到安全
  • 增強可讀性:文字註解可協助使用者在不掃描的情況下理解內容

IronBarcode 是創建和定制 QR 代碼的理想工具。 除了直接的客製化方法之外,IronBarcode 使用 IronDrawing 作為圖像處理的輔助函式庫,提供比依賴外部函式庫更高的穩定性。 如需其他範例和進階技術,請探索我們的 C# QR Code Generator tutorialAPI Reference 以取得所有可用方法和屬性的完整說明文件。

常見問題解答

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

您可以使用 IronBarcode 的 CreateQrCodeWithLogo 方法在 QR 代碼中加入標誌。只需用您的圖像文件路徑創建一個 QRCodeLogo 物件,並將它與您的 QR 代碼數據一起傳給該方法。標誌將被嵌入 QR 代碼的中心,同時保持可掃描性。

我可以變更 QR 代碼的顏色嗎?

是的,IronBarcode 提供 ChangeBarCodeColor 方法,可讓您自訂 QR 代碼顏色。您可以應用 IronSoftware.Drawing.Color 調色板中的任何顏色,以匹配您的品牌形象,同時確保 QR 代碼仍可掃描。

如何在 QR 代碼中加入文字註解?

IronBarcode 提供 AddAnnotationTextAboveBarcode 和 AddBarcodeValueTextBelowBarcode 等方法來新增文字註解。您可以自訂文字的字型、大小、顏色和位置,以在 QR 代碼上建立資訊性的標籤或行動呼叫。

自訂支援哪些 BarCode 格式?

IronBarcode 支援多種條碼格式的客製化,包括標準 QR 條碼、Micro QR 條碼和最新的 rMQR 格式。每種格式都可以自訂標誌、顏色和註釋,以滿足您的特定要求。

我可以只用一行代碼就建立品牌 QR 代碼嗎?

是的,IronBarcode 允許您在一行中透過鏈結方法創建一個完全品牌化的 QR 代碼。您可以結合 CreateQrCodeWithLogo、ChangeBarCodeColor 和 AddAnnotationTextAboveBarcode 方法,一次產生包含標誌、顏色和文字的自訂 QR 代碼。

QR 代碼標誌可以使用哪些影像格式?

IronBarcode 的 QRCodeLogo 功能支援常見的圖像格式,如 PNG、JPG 和其他標準格式。該圖庫可自動處理並嵌入您的標誌圖片,同時保持最佳的 QR 代碼可讀性。

標誌整合如何影響 QR 碼的可掃描性?

IronBarcode 可將標誌自動定位在 QR 代碼的中央,並提供適當的大小和襯墊,以保持可掃描性。該程式庫可確保標誌不會干擾 QR 代碼的錯誤修正功能,保持標準 QR 代碼掃描器的可讀性。

Hairil Hasyimi Bin Omar
軟體工程師
就像所有優秀的工程師一樣,Hairil 也是一位狂熱的學習者。他不斷精進 C#、Python 和 Java 的知識,利用這些知識為整個 Iron Software 的團隊成員增加價值。Hairil 從馬來西亞的 Universiti Teknologi MARA 大學加入 Iron Software 團隊,畢業於該校的化學與流程工程學系,並取得學士學位。
準備好開始了嗎?
Nuget 下載 2,070,733 | 版本: 2026.2 剛剛發布