如何使用 Aspose.BarCode 为 .NET 创建 PDF417 条形码
此文章展示了如何使用 Aspose.BarCode 为 .NET 在 C# 创建 PDF417 条码。PDF418 是用于运输门票、航班通道、身份证和库存管理的集成、高密度 2D 字符号。
现实世界问题
PDF417条码由航空公司、物流提供商和政府机构要求在安全、机上可读的格式编码大量数据。 手动创建PDF417,是错误的,并且少数条代码工具支持包、自动化或 .NET 工作流。
解决方案概述
Aspose.BarCode for .NET 允许您编程创建 PDF417 条码,完全控制行、列、错误纠正和出口格式,适合数字通道、发货标签或认证。
原則
在你开始之前,请确保你有:
- Visual Studio 2019 或以后
- .NET 6.0 或更高版本(或 .Net Framework 4.6.2+)
- Aspose.BarCode for .NET 通过 NuGet 安装
- 关于C#的基本知识
PM> Install-Package Aspose.BarCode
步骤实施
步骤 1: 安装和进口 Aspose.BarCode
安装 NuGet 包并进口所需的名称空间:
using Aspose.BarCode.Generation;
步骤2:创建 PDF417 条码发明器
安装 PDF417 发明器:
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
步骤3:自定义 PDF417 设置
按需要调整行、列、ECC或风格:
// Set number of rows and columns
generator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
generator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
// Set error correction level (0-8, higher is stronger)
generator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
// Optional: Set XDimension (pixel size)
generator.Parameters.Barcode.XDimension.Pixels = 4;
// Optional: Set foreground and background color
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.Barcode.BackColor = Color.White;
步骤4:创建和保存 PDF417 条形码
将条码导出到 PNG、JPEG 或任何支持的格式:
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
步骤5:完整的例子
using Aspose.BarCode.Generation;
using System.Drawing; // Required for Color
class Program
{
static void Main()
{
// Create PDF417 generator for transport data
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
generator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
generator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
generator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
generator.Parameters.Barcode.XDimension.Pixels = 4;
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.Barcode.BackColor = Color.White;
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
// Test with a PDF417 scanner
}
}
使用案例和应用程序
- 航班通行: 航空和运输机票
- ID 卡和身份证: 机上可读的身份,许可证
- 物流和存储: 运输和仓库标签
共同挑战与解决方案
**挑战1: PDF417 不扫描?**解决方案: 使用足够的错误纠正,匹配行/列到数据大小,验证模块大小的扫描仪。
挑战2:数据太大了吗?解决方案: 增加条码大小、列/列或分割数据。
挑战3:混乱或低放图像?解决方案: 以更高的像素大小或印刷用 DPI 出口。
绩效考虑
- 使用正确的错误纠正应用的关键性
- Batch 生成 PDF417 乘客列表或发送示文稿
- 使用記憶體流來輸出内記憶線代碼
最佳实践
- Tune 列和列为数据和标签大小
- 使用认证的 PDF417 扫描仪/设备进行测试
- 出口到 PNG 为打印, JPEG 为数字显示
- 保持数据文本结构化和简化
先进的场景
1. Batch 生成 PDF417 条形码
foreach (var ticket in tickets)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}
设置 PDF417 Compaction 和 Macro 模式
// Set compaction mode for numeric, text, or binary data
generator.Parameters.Barcode.Pdf417.Pdf417CompactionMode = Pdf417CompactionMode.Text;
// Enable macro PDF417 for segmented/barcoded documents
generator.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 12345;
结论
Aspose.BarCode for .NET 允许您创建 PDF417 条码,用于运输、ID 和存储应用程序,具有先进的格式和安全控制。 Aspose.BarCode API 参考 .