如何在 QR code 生成時實作自訂顏色

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

QR 碼已從簡單的黑白圖案演變為強大的品牌推廣工具。 到了 2025 年,企業已意識到,一個設計精良的 QR 碼不僅能強化品牌識別度,同時也能確保其具備完整的可掃描性。 自訂 QR 碼的前景與背景顏色,可讓您打造視覺上引人注目的設計。

IronQR 透過 QrStyleOptions 類別,讓修改 QR 碼顏色變得輕而易舉。 您可以變更前景色(深色模組)、背景色,或兩者皆變,以符合您的品牌規範。

在這份操作指南中,我們將逐步介紹如何使用 IronQR 在 C# 中自訂 QR 碼的顏色。

快速入門:自訂 QR 碼顏色

透過 QrStyleOptions 設定前景色與背景色,並儲存已格式化的 QR 碼。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronQR

    PM > Install-Package IronQR
  2. 複製並運行這段程式碼。

    var qrCode = QrWriter.Write("https://example.com");
    var style = new QrStyleOptions { Color = Color.DarkBlue, BackgroundColor = Color.LightYellow };
    qrCode.Save(style).SaveAs("colored-qr.png");
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronQR

    arrow pointer

變更背景顏色

QR 碼的背景色是指環繞深色模組周圍的淺色區域。 預設顏色為白色,但您可以將其更改為任何與前景形成足夠對比的顏色。

設定自訂背景顏色在將 QR 碼放置於彩色表面時,或當您希望與品牌色系相匹配時,會非常有用。 請確保字體對比度足夠,以便掃描器能可靠地讀取程式碼。

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-background.cs
using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    BackgroundColor = Color.LightBlue
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");
Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .BackgroundColor = Color.LightBlue
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")
$vbLabelText   $csharpLabel
自訂背景色的 QR 碼

變更前景色

前景色代表 QR 碼中的深色模組——即掃描器實際讀取的數據圖案。 雖然黑色是標準選擇,但您也可以使用任何與背景形成良好對比的深色。

變更前景色可讓您將品牌的主色調融入 QR 碼設計中。 深藍色、深綠色或濃郁的酒紅色都是黑色之外的良好替代色選。

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-foreground.cs
using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    Color = Color.PaleVioletRed
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");
Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .Color = Color.PaleVioletRed
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")
$vbLabelText   $csharpLabel
自訂前景色的 QR 碼

結論

透過 IronQR 自訂 QR 碼顏色,不僅能激發創意,更能確保您的 QR 碼完全正常運作:

  • 背景顏色:使用 BackgroundColor 來變更 QR 碼圖案後方的淺色區域
  • 前景色:使用 Color 來修改用於編碼資料的深色模組
  • 整合樣式:同時設定這兩項屬性,以實現完整的品牌一致性

請務必保持前景與背景色彩之間的適當對比度,以確保在不同裝置及光線條件下皆能清晰辨識。

如需更多樣式選項(包括標誌、邊距及尺寸),請參閱 IronQR 文件,或於 GitHub 上探索更多程式碼範例

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 18

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 18
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'title'

Filename: sections/author_component.php

Line Number: 38

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 38
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'comment'

Filename: sections/author_component.php

Line Number: 48

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 48
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

準備好開始了嗎?
Nuget 下載 63,625 | 版本: 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎?

想要快速證明? PM > Install-Package IronQR
執行範例 觀看您的 URL 變成 QR code。