Escritor de código de barras 2D
Como gerar códigos de barras PDF417 usando Aspose.BarCode para .NET

Como gerar códigos de barras PDF417 usando Aspose.BarCode para .NET

Este artigo demonstra como gerar códigos de barras PDF417 usando o Aspose.BarCode para .NET em C#. o PDF317 é um código de barra 2D de alta densidade amplamente utilizado para bilhetes de transporte, passagens de embarque, cartões de identificação e gerenciamento de inventário.

Problemas do mundo real

Os códigos de barras PDF417 são necessários pelas companhias aéreas, fornecedores de logística e agências governamentais para codificar grandes volumes de dados em um formato seguro e de leitura por máquina. Gerar manualmente o PDF317 é errado, e poucas ferramentas de código-barre suportam batch, automação ou fluxos de trabalho .NET.

Solução Overview

Aspose.BarCode para .NET permite que você gerar códigos de barras PDF417 de forma programática com controle completo sobre linhas, colunas, correção de erros e formato de exportação – ideal para passes digitais, etiquetas de envio ou credenciais.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Visual Studio 2019 ou posterior
  • .NET 6.0 ou posterior (ou .Net Framework 4.6.2+)
  • Aspose.BarCode para .NET instalado através de NuGet
  • Conhecimento básico do C#
PM> Install-Package Aspose.BarCode

Implementação passo a passo

Passo 1: Instalar e importar Aspose.BarCode

Instale o pacote NuGet e importa os espaços de nomes necessários:

using Aspose.BarCode.Generation;

Passo 2: Crie o PDF417 Barcode Generator

Instale o gerador para PDF417:

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

Passo 3: Personalizar as configurações do PDF417

Ajustar linhas, colunas, ECC, ou estilo conforme necessário:

// 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;

Passo 4: Gerar e salvar o código de barras PDF417

Exportar o código de barras para PNG, JPEG ou qualquer formato suportado:

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

Passo 5: Exemplo completo 

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
    }
}

Use Casos e Aplicações

  • **Passos de embarque: ** Bilhetes de avião e transporte
  • Cartões de identificação e credenciais: Identidade de máquina lida, licenças
  • Logística e inventário: Etiquetas de envio e armazenamento

Desafios comuns e soluções

**Desejo 1: PDF417 não escanear?**Solução : Use a correção de erro suficiente, ajuste as linhas/colunas para o tamanho dos dados, verifica o Tamanho do módulo para os scanners.

Desejo 2: Dados muito grandes? Solução : Aumentar o tamanho do código de barras, linhas / colunas ou dados divididos.

Challenge 3: Blurry ou baixa imagem?Solução : Exportação em tamanho pixel superior ou DPI para uso de impressão.

Considerações de desempenho

  • Use a correção de erro correta para a crítica da aplicação
  • Batch gera PDF417 para listas de passageiros ou manifestos de envio
  • Use fluxos de memória para a exportação de código de barras em Memória

Melhores Práticas

  • Linhas e colunas para dados e tamanho de rótulo
  • Testes com scanners/dispositivos PDF417 certificados
  • Exportação para PNG para impressão, JPEG para exibição digital
  • Mantenha o texto de dados estruturado e conciso

Os cenários avançados

Batch Genere PDF417 Código de Barras 

foreach (var ticket in tickets)
{
    BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
    g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}

Configurar PDF417 Compacção e Macro Modos 

// 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;

Conclusão

Aspose.BarCode para .NET permite que você crie códigos de barras PDF417 para aplicações de transporte, ID e inventário, com controle avançado sobre formato e segurança. Aspose.BarCode API Referência .

 Português