Scrittore di codici a barre 2D
Come generare i codici a barre PDF417 utilizzando Aspose.BarCode per .NET

Come generare i codici a barre PDF417 utilizzando Aspose.BarCode per .NET

Questo articolo dimostra come generare i codici a bar PDF417 utilizzando Aspose.BarCode per .NET in C#. PDF317 è un codice a bando 2D di alta densità ampiamente utilizzato per i biglietti di trasporto, i pass d’imbarco, le carte ID e la gestione degli inventari.

Il problema del mondo reale

I codici a bar PDF417 sono richiesti dalle compagnie aeree, dai fornitori di logistica e dalle agenzie governative per codificare grandi volumi di dati in un formato sicuro e leggibile da macchina. La generazione manuale di PDF 417 è proibita di errore, e pochi strumenti di codice a braccio supportano batch, automazione o flussi di lavoro .NET.

Soluzione Overview

Aspose.BarCode per .NET consente di generare i codici a barre PDF417 in modo programmatico con il pieno controllo delle righe, delle colonne, della correzione degli errori e del formato di esportazione – ideale per pass digitali, etichette di spedizione o credenziali.

Prerequisiti

Prima di iniziare, assicurati di avere:

  • Visual Studio 2019 o successivo
  • .NET 6.0 o successivo (o .Net Framework 4.6.2+)
  • Aspose.BarCode per .NET installato tramite NuGet
  • Conoscenza di base di C#
PM> Install-Package Aspose.BarCode

Implementazione passo dopo passo

Passo 1: Installare e importare Aspose.BarCode

Installare il pacchetto NuGet e importare gli spazi di nome richiesti:

using Aspose.BarCode.Generation;

Passo 2: Creare il generatore di codice a barre PDF417

Installa il generatore per PDF417:

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

Passo 3: personalizzare le impostazioni PDF417

Aggiungere righe, colonne, ECC o stile come necessario:

// 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: Generare e salvare il codice bar PDF417

Esportare il codice bar in PNG, JPEG o qualsiasi formato supportato:

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

Passo 5: Un esempio 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
    }
}

Utilizzare casi e applicazioni

  • **Passaggi a bordo: ** Biglietti aerei e trasporti
  • Carte di identità e credenziali: Identità leggibile in macchina, licenze
  • Logistica e inventario: Etichette di spedizione e magazzino

Sfide e soluzioni comuni

**Divisione 1: PDF417 non scansione?**La soluzione: Utilizzare correzioni di errore sufficienti, corrispondere le righe/colonne a dimensioni dei dati, verificare la dimensione del modulo per gli scanner.

**Dio 2: i dati sono troppo grandi?**La soluzione: Aumentare la dimensione del codice bar, le righe/colonne di tune o i dati divisi.

Divisione 3: immagine di blurry o low-res?La soluzione: Esportazione a dimensioni pixel superiori o DPI per l’uso della stampa.

Considerazioni di prestazioni

  • Utilizzare il corretto errore per la critica dell’applicazione
  • Batch genera PDF417 per elenchi di passeggeri o manifesti di spedizione
  • Utilizzare i flussi di memoria per l’esportazione di codice bar in-memory

Migliori pratiche

  • Tune righe e colonne per dati e dimensioni di etichetta
  • Test con scanner/attrezzature PDF417 certificati
  • Esportazione a PNG per stampa, JPEG per visualizzazione digitale
  • Mantenere il testo dei dati strutturato e conciso

Scenari avanzati

Batch Generate PDF417 Codice Bar 

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

Set PDF417 Modi di compazione e 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;

conclusione

Aspose.BarCode per .NET consente di creare i codici a barre PDF417 per le applicazioni di trasporto, ID e inventario, con il controllo avanzato del formato e della sicurezza. Aspose.BarCode API di riferimento .

 Italiano