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

Updated: 2026年5月9日

通过使用IronBarcode的CreateQrCodeWithLogo方法和样式功能，在C#中自定义二维码，添加标志、更改颜色和包括注释，以创建品牌化、专业的二维码用于市场和商务应用。

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

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

快速入门：一行构建品牌 QR 码

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

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
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");

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

最小工作流程（5 个步骤）

下载用于定制二维码的 C# 库。
使用 CreateQrCodeWithLogo 创建带有徽标的 QR 代码
使用 ChangeBarCodeColor 应用自定义颜色
使用 AddAnnotationTextAboveBarcode 添加注释
使用 AddBarcodeValueTextBelowBarcode 显示 QR 代码值

如何创建带有徽标的 QR 代码？

生成二维码时需要一个QRCodeLogo对象来嵌入标志图像。 CreateQrCodeWithLogo方法生成带有标志的二维码。该方法是 IronBarcode 全面的 QR 代码生成功能的一部分，为开发人员提供了广泛的定制选项。

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");

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")

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")

让我们来看看上述代码生成的输出 QR 代码。二维码的中心是一个徽标，边缘呈圆形。徽标整合既要保持 QR 码的可扫描性，又要增加品牌识别性。

哪些参数控制徽标外观？

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

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

如何导出生成的 QR 代码？

要导出生成的 QR 代码，请调用保存方法。导出选项包括图像文件、流、HTML 和 PDF。请在我们的综合指南中了解更多有关以不同格式导出条形码的信息。对于网络应用，您还可以将条形码导出为 HTML 以直接嵌入网页。

如何更改 QR 代码的颜色？

除了添加徽标，IronBarcode 还能让用户通过改变颜色来定制 QR 码。通过 IronDrawing，用户可以使用 RGB 值或十六进制颜色代码定义颜色，并将其应用到 QR 代码中。这一功能对于在营销材料中保持品牌一致性尤为有用。让我们来看看演示此功能的代码片段和生成的 QR 代码。

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");

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")

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")

支持哪些颜色格式？

上面的代码扩展了之前创建带有徽标的 QR 代码的示例。它演示了使用IronSoftware.Drawing.Color对象为输入。使用 RGB 值、十六进制代码或预定义枚举创建该对象。访问我们的"Create Color"代码示例以了解更多信息。颜色定制功能可与所有支持的条形码格式无缝兼容。

何时应使用自定义颜色？

自定义颜色尤其适用于

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

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

如何为 QR 代码添加注释？

定制 QR 代码的另一个重要方面是在 QR 代码图像中添加注释。这些注释可以是条形码值本身，也可以是用于促销目的的自定义文本。注释可帮助用户在扫描前了解二维码的内容，从而改善用户体验并提高参与率。

让我们来看看这些方法的实现和生成的二维码图像。

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");

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")

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")

有哪些注释方法？

IronBarcode 提供了设置注释的位置（在二维码上方或下方）及其字体系列和颜色的方法。可用的方法包括

AddAnnotationTextAboveBarcode：在二维码上方添加注释文本
AddAnnotationTextBelowBarcode：在二维码下方添加注释文本
AddBarcodeValueTextAboveBarcode：在二维码上方添加条码值文本
AddBarcodeValueTextBelowBarcode：在二维码下方添加条码值文本

这些方法可以串联起来，用于多个注释。有关更多高级样式选项，请参阅我们的综合条形码样式指南。

如何自定义注释外观？

这四种方法都接受自定义字体作为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 码扫描仪的可读性。

How can I match QR codes to my brand's visual identity?

You can match QR codes to your brand's visual identity by using IronBarcode's color customization features, allowing you to define your brand's colors through RGB values or Hex codes for consistent branding.

Why might I want to use annotations on QR codes?

Annotations on QR codes provide context, improve user engagement with clear calls-to-action, build trust by displaying URLs or company names, and enhance accessibility by describing content without requiring a scan.

What library does IronBarcode use for image processing?

IronBarcode uses IronDrawing for image processing, which is a free open-source library provided by IronSoftware, offering stable image manipulation capabilities.