Барокоды PDF417 широко используются в различных отраслях, таких как транспорт, логистика и управление идентичностью из-за их высокой мощности данных и мощных возможностей по исправлению ошибок.
Введение
PDF417 является запечатанным 2D баркодом, который может кодировать до 1,850 байтов данных по символу, что делает его идеальным для приложений, требующих большого количества информации.
Установите свое окружение
Перед тем, как погрузиться в кодовые примеры, убедитесь, что ваша среда развития правильно установлена:
Предупреждения
- Visual Studio 2019 или позднее
- .NET 6.0 или более поздний (или .NET Framework 4.6.2+)
- Aspose.BarCode для .NET установлен через NuGet
Инсталлировать пакет, используя следующую команду в консоле Package Manager:
PM> Install-Package Aspose.BarCode
Step-by-Step реализация
Шаг 1: Создание и настройка BarcodeGenerator
Во-первых, создание инстанции для 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);
Полный пример
Вот полный пример, который связывает все вместе:
Используйте случаи и приложения
- Пассы на борт: Авиабилеты и транспортные билеты
- Идентификационные карты и удостоверения: машиночитаемая идентификация, лицензии
- Логистика и инвентарь: Этикетки судов и складов
Общие вызовы и решения
**Проблема 1: PDF417 не сканируется?**Решение → Используйте достаточную коррекцию ошибок, соответствие строк/колонов размерам данных, проверка размеров модуля для сканеров.
Проблема 2: Даты слишком большие?Решение → Увеличьте размер баркода, тонусы/колонны или разделить данные.
Проблема 3: блестящий или низкий образ?.Решение → Экспорт по размерам пикселей или DPI для печати.
Рассмотрим производительность
- Используйте правильную коррекцию ошибок для критичности приложения
- Батч генерирует PDF417 для пассажирских списков или манифестов доставки
- Используйте потоки памяти для экспорта в память баркода
Лучшие практики
- Тонные ряды и колонны для размеров данных и этикетки
- Тест с сертифицированными PDF417 сканерами/устройствами
- Экспорт в PNG для печати, JPEG для цифрового дисплея
- Сохраняйте структурированный и узкий текст данных
Развитые сценарии
Батч генерирует 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 Modes
// 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 для .NET позволяет создавать баркоды PDF417 для транспорта, идентификационных и инвентарных приложений, с передовым контролем над форматом и безопасностью. Aspose.BarCode API ссылка.
