1. IronBarcode
  2. 操作指南
  3. .NET 创建自定义 QR 代码
How to Customize and Add Logos to QR Codes in C#

如何在 C# 中自定义二维码并为其添加徽标

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 码，从而创建品牌化、专业的 QR 码，用于营销和商业应用。

由于较高的数据容量和便于扫描，二维码比传统条形码更受欢迎。 它们尤其在营销中受到重视，因为其可定制性，包括添加徽标、更改颜色和融入其他品牌元素的选项。 现代企业利用自定义 QR 代码开展各种营销活动和客户参与战略。

为了满足这一需求，IronBarcode 提供了一套用于自定义二维码的功能。 用户可以创建带有徽标的 QR 代码、更改配色方案并添加注释。 这些功能由IronDrawing 提供支持，它是一个免费且开源的库。 该库支持多种条形码格式，包括标准 BarCode、Micro QR 和最新的 rMQR 格式。

快速入门：一行创建品牌二维码

通过创建带有徽标、定制颜色和注释的二维码立即开始——所有这些都只需最小的设置和一行 IronBarcode 代码。 非常适合希望快速建立专业品牌的开发人员。

  1. 使用 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. 下载用于定制二维码的 C# 库。
  2. 使用 `CreateQrCodeWithLogo` 创建带有徽标的 QR 代码
  3. 使用 `ChangeBarCodeColor` 应用自定义颜色
  4. 使用 `AddAnnotationTextAboveBarcode` 添加注释
  5. 使用 `AddBarcodeValueTextBelowBarcode` 显示 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 码的可扫描性，又要增加品牌识别性。

哪些参数控制徽标外观？

要自定义徽标，请在创建新的 QRCodeLogo 对象时填写特定字段。 以下是必填字段：

  • Importing Image: Import images from AnyBitmap, Stream, Byte Array, relative filepath, or URI. 为达到最佳效果，请使用 PNG、JPEG 或 WebP 等常用格式的高分辨率图片。
  • 图像尺寸：以像素为单位指定所需的宽度和高度。 如果图片过大，二维码无法保持可读性，则会出现异常。 使用 0 自动确定最大可行大小。
  • 图像边角：设置圆角半径。 方角用 0 表示。 圆角设计能营造出更专业的外观和更好的视觉整合效果。

如何导出生成的 QR 代码？

要导出生成的 QR 代码，请调用保存方法。 导出选项包括图像文件、流、HTML 和 PDF。 请在我们的综合指南中了解更多有关以不同格式导出条形码的信息。对于网络应用，您还可以将条形码导出为 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 代码的示例。 It demonstrates changing QR code color using the ChangeBarCodeColor method, which takes an IronSoftware.Drawing.Color object as input. 使用 RGB 值、十六进制代码或预定义枚举创建该对象。 访问我们的"Create Color"代码示例以了解更多信息。 颜色定制功能可与所有支持的条形码格式无缝兼容。

何时应使用自定义颜色？

自定义颜色尤其适用于

  • 品牌一致性：将 QR 代码与公司的视觉识别相匹配
  • 活动主题：为特殊活动和事件创建主题 QR 代码
  • 视觉层次：在印刷材料中使用颜色突出重要的 QR 代码
  • 易读性：确保足够的对比度，以便在各种条件下更好地进行扫描

在选择颜色时，QR 码图案和背景之间要保持足够的对比度，以确保扫描的可靠性。 浅色背景上的深色通常效果最佳。

如何为 QR 代码添加注释？

定制 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 提供了设置注释的位置(在二维码上方或下方)及其字体系列和颜色的方法。 可用的方法包括

  • 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 代码生成器教程 和 API 参考，了解所有可用方法和属性的完整文档。

常见问题解答

如何在 C# 中为二维码添加徽标？

您可以使用 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 代码徽标可以使用哪些图像格式？

IronBarcode 的 QRCodeLogo 功能支持常见的图片格式，如 PNG、JPG 和其他标准格式。该库可自动处理并嵌入您的徽标图像，同时保持 QR 码的最佳可读性。

徽标集成如何影响 QR 代码的可扫描性？

IronBarcode 可自动将徽标置于 QR 码的中心位置，并提供适当的尺寸和填充，以保持可扫描性。该库可确保徽标不会干扰 QR 码的纠错功能，从而保持标准 QR 码扫描仪的可读性。

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
  立即与工程团队聊天
软件工程师
如所有伟大的工程师一般，Hairil 是个热心的学习者。他正在提高对 C#、Python 和 Java 的知识，并利用这些知识为 Iron Software 团队成员增值。Hairil 从马来西亚的玛拉工业大学加入 Iron Software 团队，获得化学与工艺工程学士学位。
准备开始了吗？
Nuget 下载 2,167,753 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package BarCode
运行示例 观看您的字符串变成 BarCode。