PDF417 条码广泛用于各种行业,如运输、物流和身份管理,因为其高数据容量和强大的错误纠正能力。

引入

PDF417 是一个可编码到 1 850 位元的数据符号的 2D 条码,这使得它适合需要大量信息的应用程序。

建立你的环境

在沉浸在代码示例之前,确保您的发展环境正确设置:

原則

  • Visual Studio 2019 或以后
  • .NET 6.0 或更高版本(或 .NET Framework 4.6.2+)
  • Aspose.BarCode for .NET 通过 NuGet 安装

在您的包管理器控制台中使用下列命令安装包:

PM> Install-Package Aspose.BarCode

步骤实施

步骤1:创建和设置条码发电机

首先,建立一个例子。 BarcodeGenerator 并指定类型为PDF417.

BarcodeGenerator barcodeGenerator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");

步骤2:自定义 PDF417 设置

调整各种属性,如行、列、错误纠正级别和颜色设置,以适应您的需求。

// Set number of rows and columns
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
// Set error correction level (0-8, higher is stronger)
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
// Optional: Set XDimension (pixel size)
barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 4;
// Optional: Set foreground and background color
barcodeGenerator.Parameters.Barcode.BarColor = Color.Black;
barcodeGenerator.Parameters.Barcode.BackColor = Color.White;

步骤3:创建和保存条形码图像

最后,将创建的条形码图像存储到文件或流。

barcodeGenerator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);

完整的例子

下面是完整的例子,把一切都结合在一起:

使用案例和应用程序

  • 航班通行: 航空和运输机票
  • 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
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417CompactionMode = Pdf417CompactionMode.Text;
// Enable macro PDF417 for segmented/barcoded documents
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 12345;

结论

Aspose.BarCode for .NET 允许您创建 PDF417 条码,用于运输、ID 和存储应用程序,具有先进的格式和安全控制。 Aspose.BarCode API 参考.

More in this category