2D Штрихкод Писатель
Как генерировать PDF417 баркоды с помощью Aspose.BarCode для .NET

Как генерировать PDF417 баркоды с помощью Aspose.BarCode для .NET

Эта статья показывает, как генерировать PDF417 баркоды с помощью Aspose.BarCode для .NET в C#. PDF317 является запечатанным, высокой плотностью 2D-баркодом, который широко используется для транспортировки билетов, проездов, идентификационных карт и управления запасами.

Реальные мировые проблемы

Баровые коды PDF417 требуются авиакомпаниями, логистическими поставщиками и правительственными агентствами для кодирования больших объемов данных в безопасном, машинно-читаемом формате. генерирование печатных кодов PDF317 вручную является причиной ошибок, и немногие инструменты барового кода поддерживают пакет, автоматизацию или рабочие потоки .NET.

Решение обзор

Aspose.BarCode для .NET позволяет генерировать PDF417 баркоды программатически с полным контролем над строками, колоннами, исправлением ошибок и экспортным форматом — идеально подходит для цифровых проходов, этикетов отправки или аккредитаций.

Предупреждения

Прежде чем начать, убедитесь, что у вас есть:

  • Visual Studio 2019 или позднее
  • .NET 6.0 или более поздний (или .Net Framework 4.6.2+)
  • Aspose.BarCode для .NET установлен через NuGet
  • Основное знание C#
PM> Install-Package Aspose.BarCode

Step-by-Step реализация

Шаг 1: Инсталляция и импорт Aspose.BarCode

Установите пакет NuGet и импортируйте необходимые названия:

using Aspose.BarCode.Generation;

Шаг 2: Создание PDF417 Barcode Generator

Настройка генератора для 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
    }
}

Используйте случаи и приложения

  • Пассы на борт: Авиабилеты и транспортные билеты
  • Идентификационные карты и удостоверения: машиночитаемая идентификация, лицензии
  • Логистика и инвентарь: Этикетки судов и складов

Общие вызовы и решения

**Проблема 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
generator.Parameters.Barcode.Pdf417.Pdf417CompactionMode = Pdf417CompactionMode.Text;
// Enable macro PDF417 for segmented/barcoded documents
generator.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 12345;

Заключение

Aspose.BarCode для .NET позволяет создавать баркоды PDF417 для транспорта, идентификационных и инвентарных приложений, с передовым контролем над форматом и безопасностью. Aspose.BarCode API ссылка .

 Русский