如何使用IronBarcode在 C# 中生成条形码

如何使用NuGet包管理器安装条码生成库？

打开 Visual Studio，在软件包管理器控制台中使用此命令安装 NuGet 软件包：

Install-Package BarCode

NuGet包支持.NET 10、.NET 8、.NET 6、.NET Core、.NET Standard和.NET Framework，使其兼容Windows应用程序和跨平台.NET应用程序。 IronBarcode 支持部署到 Docker 容器、Azure 和 Linux 服务器。 在IronBarcode文档页面和Iron Software GitHub项目上查找更多详细信息和参考文档。

安装后，您将在项目中看到IronBarCode命名空间。 该库在Windows上不需要其他运行时依赖项——在Linux上，您可能需要按照IronBarcode Linux部署指南中所述安装一些系统库。

如何在C#中生成一个简单的条码图像文件？

只需几行代码即可创建 BarCode 图像。 下面的示例显示了保存 PNG 图像文件的 BarCode 生成：

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

BarcodeWriterEncoding的条码格式。 返回的GeneratedBarcode引用提供样式方法和导出选项，可以保存为PNG、JPEG、BMP、TIFF、PDF或HTML。

如何创建QR码和其他2D条码类型？

IronBarcode 支持所有主流条形码格式，包括 QR 码和数据矩阵等二维条形码类型。 生成具有类似语法的 QR 代码：

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

QR 码 BarCode 类型擅长存储 URL 和较大的数据有效载荷。 该库可自动处理纠错，确保条形码即使在部分损坏的情况下仍可扫描。 默认情况下，IronBarcode使用错误更正级别M(中)，可从约15%的数据丢失中恢复——您可以将其提升到H级以用于可能被刮伤或部分遮挡的打印条码。

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

如何创建具有高级造型选项的风格化QR码？

专业条形码生成通常需要高级样式选项来调整颜色和添加注释。 GeneratedBarcode类提供流畅的API和样式方法：

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

流畅的 API 可让您在一条语句中使用链式样式方法来调整颜色、设置页边距和添加文本。 Verify()方法指示您的条码是否仍可被机器读取——确保在应用非标准颜色或调整到小尺寸后能在生产中正确扫描。

将条形颜色更改为非常浅的阴影或低对比度的蓝色背景可能会导致条码无法扫描。 在任何颜色更改后始终调用Verify()。 如果验证失败，或者增加对比度或恢复到黑条。 条码样式和自定义指南详细介绍了所有可用的样式方法。

要为整个目录生成具有一致风格的多个条码，请构建一个帮助方法，将您的标准样式链应用于每个GeneratedBarcode实例。 这种方法确保在生成的成千上万张图像中保持统一的边距、字体大小和颜色。

如何将条码导出为不同的图像格式？

针对不同用例生成多种格式的 BarCode 图像。 该库可保存为 PNG、JPEG、BMP、TIFF、PDF 和 HTML 格式：

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

ToStream()方法返回与ASP.NET Core Web API和Blazor应用程序兼容的条码数据。 System.Drawing.Bitmap引用以进一步图像处理。 想要在现有PDF文档上加盖条码，请参阅IronBarcode PDF条码教程。

IronBarcode支持哪些跨平台.NET环境？

IronBarcode支持在所有主要.NET平台上生成条码。 部署到

IronBarcode Docker设置指南提供了有关容器化部署所需系统库的详细信息。 在Linux上运行时，通常需要在Docker镜像中安装libc6-dev。 在Alpine Linux上，所需的软件包略有不同——指南涵盖了Ubuntu/Debian和Alpine Dockerfile。

对于AWS Lambda部署，AWS Lambda部署操作指南解释了如何在部署包中捆绑本地依赖项，并配置内存限制以处理条码渲染工作负载。

如何在.NET中遵循条码生成的最佳实践？

在C#应用程序中生成条码图像时遵循一套一致的实践，可区分在现场可靠扫描的条码与在销售点或仓库地板失败的条码。 以下准则适用于您选择的任何条码格式。

选择适合您的用例的条码格式。选择与您的扫描环境和数据需求相匹配的格式。 对于超过80个字符的URL和数据负载，使用QR码。 在需要将字母数字数据装入紧凑线性符号的库存和物流中使用Code 128。 对于需要在GS1系统中注册的零售产品，使用EAN-13或UPC-A。 IronBarcode的条码格式比较页面提供了所有支持类型以及其容量限制和推荐用例的并列参考。

始终包含足够的安静区。条码周围的空白——称为安静区——与条码本身一样重要。 扫描仪使用它来检测符号的开始和结束位置。 使用SetMargins()方法在每一边至少添加10像素的填充显示，打印输出时至少加2.5毫米。 削减安静区是生产中扫描失败最常见的原因之一。

在任何样式更改后进行验证。在调整颜色、应用渐变、或调整到非标准尺寸后，调用GeneratedBarcode对象。 如果返回false，您的条码将无法在标准硬件上可靠扫描。 要么增加对比度，要么减少样式更改的复杂性。

使用批量生成模式进行高容量输出。如果您的应用程序生成数千个条码——例如产品标签或运输清单——在循环中处理并重用相同的样式配置。 避免在循环内加载字体资产或配置对象，因为这会产生不必要的开销。 IronBarcode批量条码生成示例展示了具有一致输出的高效循环模式。

在多个扫描仪模型和光照条件下测试。条码扫描仪在低对比度颜色、小尺寸模块和打印质量的耐受力上各不相同。 在部署之前，至少使用两种不同的扫描仪类型测试打印条码。 对于屏幕显示的QR码，用手机摄像头在明亮和昏暗光线下测试。 GS1条码验证标准页面提供有关零售条码符号质量分级的权威指导。

尊重数据容量限制。每种条码格式都有最大数据容量。 Code 128在符号变得过于宽而无法在标准标签尺寸上打印之前，可以编码最多约48个字符。 QR码容量取决于错误更正级别——在H级别，最大约为1,273个字母数字字符。 超出容量会迫使库抛出异常或静默地降低质量。 检查Wikipedia上的QR码数据容量参考获取快速容量表。

遵循.NET的dispose模式。IDisposable。 将它们包裹在using语句中以迅速释放非托管资源，尤其是在高吞吐量的网络应用程序中，其中条码生成随着每个请求发生。

了解常见的失败模式也有助于您构建更具抵抗力的生成代码。 扫描失败的三个最常见原因是：安静区不足，条形颜色过于接近背景色，以及条码缩放到低于所选格式的最小模块尺寸。 IronBarcode的Verify()方法在运行时捕捉到所有这三种情况。

要从生成的图像中读取条码——用于往返测试或扫描上传的文件——请参阅IronBarcode条码读取指南。 读取器API在简单性上与写入器API相映，并支持同样广泛的格式范围。

Code 128的ISO/IEC 15417标准和QR码的ISO/IEC 18004标准定义了IronBarcode遵循的技术规范。 查看目标条码类型的相关标准有助于您了解库必须在其中工作的约束。

您的下一步是什么？

本指南涵盖了使用IronBarcode在C#中生成条码图像——从NuGet安装到Code 128、QR码和EAN-13生成，包含流畅API的高级样式，多格式导出，跨平台部署和生产最佳实践。

要进一步了解，请探索这些资源：

• IronBarcode完整API参考——GeneratedBarcode和所有枚举的完整方法文档
• IronBarcode条码读取教程——从图像、PDF和流中读取和解码条码
• 批量条码生成示例——用于标签打印和运输工作流程的大量生成模式
• IronBarcode许可和定价——选项起价为$799

下载IronBarcode以在您的.NET应用程序中添加条码功能，或开始免费30天试用，在不需要许可证密钥的情况下，在您的环境中生成条码图像。