Scrittore di codici a barre 2D
Comment générer des codes de barre PDF417 à l'aide d'Aspose.BarCode pour .NET

Comment générer des codes de barre PDF417 à l'aide d'Aspose.BarCode pour .NET

Cet article montre comment gérer des codes de barre PDF417 à l’aide d’Aspose.BarCode pour .NET en C#. PDF317 est un barcode 2D de haute densité largement utilisé pour les billets de transport, les passes à bord, la carte d’identité et la gestion des enregistrements.

Problème du monde réel

Les codes de barre PDF417 sont nécessaires par les compagnies aériennes, les fournisseurs de logistique et les agences gouvernementales pour coder de grands volumes de données dans un format sécurisé et lisible par machine. Gérer manuellement le code PDF317 est sans erreur, et peu d’outils de code à barre soutiennent les flux de travail de l’automatisation ou .NET.

Vue de la solution

Aspose.BarCode pour .NET vous permet de générer des codes-barres PDF417 de manière programmatique avec un contrôle complet sur les rangs, les colonnes, la correction des erreurs et le format d’exportation - idéal pour les passes numériques, l’étiquette de livraison ou les créances.

Principaux

Avant de commencer, assurez-vous que vous avez :

  • Visual Studio 2019 ou ultérieur
  • .NET 6.0 ou ultérieur (ou .Net Framework 4.6.2+)
  • Aspose.BarCode pour .NET installé via NuGet
  • Les connaissances de base de C#
PM> Install-Package Aspose.BarCode

La mise en œuvre étape par étape

Étape 1 : Installer et Importer Aspose.BarCode

Installez le paquet NuGet et importez les espaces de nom requis :

using Aspose.BarCode.Generation;

Étape 2 : Créer le générateur de code bar PDF417

Installez le générateur pour PDF417 :

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

Étape 3 : personnaliser les paramètres PDF417

Ajuster les rangs, les colonnes, ECC, ou le style selon le besoin:

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

Étape 4 : Gérer et sauvegarder le code de barre PDF417

Exporter le code bar à PNG, JPEG ou tout format supporté :

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

Étape 5 : Exemple complet 

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

Utiliser les cas et les applications

  • **Passes de bateau: ** Billets d’aéroport et de transport
  • Cards d’identité et certificats: Identité lisible en machine, licences
  • Logistique et enregistrement: Étiquettes de livraison et de stockage

Défis communs et solutions

**Défi 1 : PDF417 ne scanne pas ?**La solution : Utilisez une correction d’erreur suffisante, correspondez les rangs/columnes à la taille des données, vérifiez la grandeur du module pour les scanners.

Défi 2 : les données sont-elles trop grandes ?La solution : Augmentez la taille du code bar, les lignes / colonnes ou les données divisées.

Défi 3 : Blurry ou image faible ?La solution : Exportation à haute taille de pixels ou DPI pour utilisation imprimée.

Considérations de performance

  • Utilisez la correction d’erreur correcte pour la critique de l’application
  • Batch génère PDF417 pour les listes de passagers ou les manifestations d’expédition
  • Utilisez les flux de mémoire pour l’exportation d’un code barreau in-memory

Migliori pratiche

  • Tune les lignes et les colonnes pour les données et la taille d’étiquette
  • Test avec des scanners / appareils certifiés PDF417
  • Exportation à PNG pour imprimer, JPEG pour afficher numérique
  • Maintenez le texte de données structuré et concis

Scénarios avancés

1.Batch Générer PDF417 Codes Barres 

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

Configurer PDF417 Compaction et modes 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;

Conclusion

Aspose.BarCode pour .NET vous permet de créer des codes-barres PDF417 pour les applications de transport, d’identification et de stockage, avec un contrôle avancé sur le format et la sécurité. Aspose.BarCode API de référence .

 Français