How to Generate Barcode Images in C# .NET Applications
需要在您的 .NET 应用程序中快速生成专业的 BarCode 图像吗? 本教程将详细展示如何使用 IronBarcode 创建、自定义和导出 BARCODE——从简单的单行代码实现,到可完全掌控 BARCODE 外观的高级样式设计技巧。
快速入门:即时创建并保存BarCode图像
借助 IronBarcode,您只需一次简单的调用即可生成并导出 BarCode 图像。 在文本中使用 CreateBarcode 方法,选择格式和大小,然后调用 SaveAsPng ——无需复杂配置。
简易工作流程(5个步骤)
- 通过 NuGet 包管理器安装 IronBarcode
- 仅需一行代码即可生成简单BarCode
- 为BarCode应用自定义样式和注释
- 将 BarCode 导出为图像、PDF 或 HTML 格式
- 使用 Fluent API 高效生成 BarCode
How Do I Install a Barcode Generator Library in C#?
using NuGet 包管理器安装 IronBarcode 仅需几秒钟。 您可以通过包管理器控制台直接安装,或手动下载 DLL 文件。
Install-Package BarCode
IronBarcode for .NET 为开发人员提供了全面的 BarCode 生成功能
How Can I Generate a Simple Barcode Using C#?
只需两行代码,即可生成您的第一个BARCODE。 下面的示例演示了如何生成标准的 Code128 BARCODE并将其保存为图像文件。
using IronBarCode;
// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Co/de128);
// Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png");
// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });
using IronBarCode;
// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Co/de128);
// Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png");
// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });
Imports IronBarCode
Imports System.Diagnostics
' Create a barcode with your desired content and encoding type
Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128)
' Save the barcode as a PNG image file
myBarcode.SaveAsPng("myBarcode.png")
' Optional: Open the generated image in your default viewer
Process.Start(New ProcessStartInfo("myBarcode.png") With {.UseShellExecute = True})
BarcodeWriter.CreateBarcode() 方法是生成 BARCODE 的入口点。 它接受两个参数:您要编码的数据以及来自 BarcodeWriterEncoding 枚举的 BARCODE 格式。 IronBarcode 支持所有主流 BarCode 格式,包括 DataMatrix 以及 QRCode 条码。
生成后,GeneratedBarcode 对象提供多种导出选项。 您可以将其保存为多种图像格式(PNG、JPEG、GIF、TIFF),导出为 PDF,甚至将其作为 System.Drawing.Bitmap 获取,以便在您的应用程序中进行进一步处理。
*A Code128 barcode generated with IronBarcode displaying a URL*
我可以自定义生成的BarCode外观吗?
IronBarcode 提供了丰富的自定义选项,其功能远不止于基本的 BarCode 生成。 您可以添加注释、调整颜色、设置边距,并控制BarCode外观的各个方面。
using IronBarCode;
using IronSoftware.Drawing;
// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
"https://ironsoftware.com/csharp/barcode",
BarcodeWriterEncoding.QRCode
);
// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");
// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();
// Set consistent margins around the barcode
myBarCode.SetMargins(100);
// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);
// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");
using IronBarCode;
using IronSoftware.Drawing;
// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
"https://ironsoftware.com/csharp/barcode",
BarcodeWriterEncoding.QRCode
);
// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");
// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();
// Set consistent margins around the barcode
myBarCode.SetMargins(100);
// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);
// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");
Imports IronBarCode
Imports IronSoftware.Drawing
' Create a QR code with advanced styling options
Private myBarCode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.QRCode)
' Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:")
' Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode()
' Set consistent margins around the barcode
myBarCode.SetMargins(100)
' Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple)
' Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html")
GeneratedBarcode 类提供了一套丰富的自定义方法:
- 注释:使用
AddAnnotationTextAboveBarcode()和AddAnnotationTextBelowBarcode()在 BARCODE 周围添加自定义标签或说明 - 值显示:
AddBarcodeValueTextBelowBarcode()方法会自动将编码数据以人类可读的格式显示出来 - 空格:使用
SetMargins()控制空白,以确保正确扫描和视觉美观 - 颜色:使用
ChangeBarCodeColor()和ChangeBackgroundColor()更改前景色和背景色 - 导出选项:保存为图像文件、PDF 或自包含的 HTML 文档
*一个带有自定义颜色和注释文本的样式化QR码*如需了解详细的自定义选项,请查阅 GeneratedBarcode 类文档,其中涵盖了所有可用的样式方法和属性。
如何用一行代码创建并导出BarCode?
IronBarcode 实现了流畅的 API 设计模式,支持方法链,从而使代码更加简洁易读。 当对BARCODE应用多种转换时,此方法尤为有用。
using IronBarCode;
using IronSoftware.Drawing;
// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";
// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
.CreateBarcode(value, BarcodeWriterEncoding.PDF417) // Create PDF417 barcode
.ResizeTo(300, 200) // Set specific dimensions
.SetMargins(10) // Add 10px margins
.ToBitmap(); // Convert to bitmap
// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;
using IronBarCode;
using IronSoftware.Drawing;
// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";
// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
.CreateBarcode(value, BarcodeWriterEncoding.PDF417) // Create PDF417 barcode
.ResizeTo(300, 200) // Set specific dimensions
.SetMargins(10) // Add 10px margins
.ToBitmap(); // Convert to bitmap
// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;
Imports IronBarCode
Imports IronSoftware.Drawing
' Generate, style, and convert a barcode in a single statement
Private value As String = "https://ironsoftware.com/csharp/barcode"
' Create PDF417 barcode with chained operations
Private barcodeBitmap As AnyBitmap = BarcodeWriter.CreateBarcode(value, BarcodeWriterEncoding.PDF417).ResizeTo(300, 200).SetMargins(10).ToBitmap() ' Convert to bitmap
' Convert to System.Drawing.Bitmap for legacy compatibility
Private legacyBitmap As System.Drawing.Bitmap = barcodeBitmap
流畅的 API 模式具有以下优势:
- 可读性:按逻辑顺序串联操作,使译文读起来如同自然语言
- 效率:减少变量声明和中间步骤
- 灵活性:无需重构代码即可轻松添加或移除操作
常见的流畅操作包括:
ResizeTo(): 控制精确的BARCODE尺寸SetMargins(): 添加统一的空格ChangeBarCodeColor(): 修改外观AddAnnotationTextAboveBarcode(): 包含说明性文本ToBitmap(),SaveAsPng(),SaveAsPdf():导出为多种格式
*A PDF417 barcode generated using fluent method chaining*
IronBarcode 支持哪些 BarCode 格式?
IronBarcode 通过 BarcodeWriterEncoding 枚举支持全面的 BarCode 格式生成。 支持的格式包括:
一维BarCode:Code128, Code39, Code93, Codabar, ITF, MSI, Plessey, UPCA, UPCE, EAN8, EAN13
2D BarCode:MaxiCode
专用格式:DataBarExpanded 以及各种 GS1 标准
每种格式都有其特定的特点和适用场景。 例如,QRCode 擅长存储 URL 和海量数据,而 EAN13 则是零售产品的标准选择。 了解如何为您的应用选择合适的BarCode格式。
如何验证生成的BarCode是否可读?
质量保证对于BarCode的实施至关重要。 IronBarcode 包含内置验证功能,以确保生成的 BarCode 始终可被扫描:
// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
.CreateBarcode("TEST123", BarcodeWriterEncoding.Co/de128)
.ResizeTo(200, 100)
.ChangeBarCodeColor(Color.DarkBlue);
// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
.CreateBarcode("TEST123", BarcodeWriterEncoding.Co/de128)
.ResizeTo(200, 100)
.ChangeBarCodeColor(Color.DarkBlue);
// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
Imports System.Drawing
' Generate and verify a barcode
Dim myBarcode As GeneratedBarcode = BarcodeWriter _
.CreateBarcode("TEST123", BarcodeWriterEncoding.Code128) _
.ResizeTo(200, 100) _
.ChangeBarCodeColor(Color.DarkBlue)
' Verify the barcode is still readable after modifications
Dim isReadable As Boolean = myBarcode.Verify()
Console.WriteLine($"Barcode verification: {(If(isReadable, "PASS", "FAIL"))}")
Verify() 方法用于检查在进行调整大小或更改颜色等变换后,BarCode是否仍可被机器识别。 在使用非标准颜色或极小字号时,这一点尤为重要。
哪里可以找到更多BarCode生成示例?
若需扩展BarCode生成功能,请参考以下资源:
源代码和示例
下载本教程的完整源代码:
高级主题
- 生成带徽标的QR码 - 为您的QR码添加品牌标识
- BarCode样式指南 - 掌握高级自定义技巧
- 从图像中读取 BarCode - 通过 BarCode 扫描完成整个流程
- 批量生成BarCode - 高效生成多个BarCode
API 文档
BarcodeWriter类参考 - 完整的方法文档GeneratedBarcode类参考 - 所有自定义选项BarcodeWriterEncoding枚举 - 支持的 BarCode 格式
准备好在您的应用程序中生成Professional BARCODE 了吗?
IronBarcode 使 BarCode 生成变得简单直观,同时为 Professional 应用提供了所需的灵活性。 无论您需要简单的产品代码,还是具有自定义样式的复杂二维BarCode,IronBarcode 都能通过极少的代码轻松处理。
立即下载 IronBarcode,几分钟内即可开始生成 BarCode。 需要帮助选择合适的许可证吗? 查看我们的许可方案,或申请免费试用许可证,在您的生产环境中测试 IronBarcode。
常见问题解答
我如何在 C# 中创建条形码图像?
要在 C# 中创建条形码图像,可以使用 IronBarcode 的 BarcodeWriter.CreateBarcode() 方法。这允许您指定数据和条形码格式,然后使用 SaveAsPng() 等方法以 PNG 或 JPEG 格式保存图像。
在 .NET 项目中安装 IronBarcode 的步骤是什么?
您可以通过 Visual Studio 中的 NuGet 包管理器在您的 .NET 项目中安装 IronBarcode。或者,您可以从 IronBarcode 网站下载 DLL 并将其添加到项目引用中。
我如何在 C# 中将条形码导出为 PDF?
IronBarcode 允许使用 GeneratedBarcode 类中的 SaveAsPdf() 方法将条形码导出为 PDF,这是一种以 PDF 格式保存条形码的简便方法。
在 C# 中,条形码有哪些自定义选项?
IronBarcode 提供广泛的自定义选项,例如使用 ChangeBarCodeColor() 更改条形码颜色、使用 AddAnnotationTextAboveBarcode() 添加文本注释,以及使用 SetMargins() 设置边距。
我如何快速在一行代码中创建和样式化条形码?
使用 IronBarcode 的流畅 API,您可以通过方法链在一行代码中创建和样式化条形码:BarcodeWriter.CreateBarcode(data, encoding).ResizeTo(300, 200).SetMargins(10).SaveAsPng(path).
我如何确保修改后的条形码可扫描?
要验证样式或调整大小后的条形码的可扫描性,使用 GeneratedBarcode 对象上的 Verify() 方法以检查其机器可读性。
我可以在 C# 中生成带有徽标的二维码吗?
是的,IronBarcode 支持使用 QRCodeWriter 类生成带有嵌入徽标的二维码,该类包含徽标插入和增强错误更正级别的功能。
在 C# 中高效生成多个条形码的过程是什么?
您可以使用 IronBarcode 高效地在 C# 中生成多个条形码,该工具支持批处理,并允许使用循环或并行处理来处理大批量条形码生成。
在 C# 中,我可以使用哪些文件格式导出条形码?
IronBarcode 支持以多种格式导出条形码,包括 PNG、JPEG、GIF、TIFF、BMP、PDF 和 HTML,为不同的应用程序需求提供了灵活性。
我如何在 C# 中在条形码下方添加人类可读的文本?
要在 C# 中在条形码下方添加人类可读的文本,使用 AddBarcodeValueTextBelowBarcode() 方法,该方法会自动显示编码值为文本格式并置于条形码图像下方。

