Hur man genererar PDF417 Barkoder med Aspose.BarCode för .NET
Den här artikeln visar hur man genererar PDF417 barkoder med hjälp av Aspose.BarCode för .NET i C#. PDF317 är en stackad, högdensitet 2D-barkod som används allmänt för transportbiljetter, boarding pass, ID-kort och lagerhantering.
Realvärldsproblem
PDF417 barkoder krävs av flygbolag, logistikleverantörer och statliga byråer för att kryptera stora volymer av data i ett säkert, maskinläsbart format. Att generera PDF 417 manuellt är felfria, och få barkoden verktyg stöder batch, automatisering, eller .NET arbetsflöden.
Översikt över lösningen
Aspose.BarCode för .NET tillåter dig att generera PDF417 barkoder programmatiskt med full kontroll över rader, kolumner, felkorrigering och exportformat – perfekt för digitala pass, sändningsetiketter eller bekräftelser.
förutsättningar
Innan du börjar, se till att du har:
- Visual Studio 2019 eller senare
- .NET 6.0 eller senare (eller .Net Framework 4.6.2+)
- Aspose.BarCode för .NET installerat via NuGet
- Grundläggande kunskap om C#
PM> Install-Package Aspose.BarCode
Steg för steg genomförande
Steg 1: Installera och importera Aspose.BarCode
Installera NuGet-paketet och importera de nödvändiga namngräntorna:
using Aspose.BarCode.Generation;
Steg 2: Skapa PDF417 Barcode Generator
Installera generatorn för PDF417:
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
Steg 3: Anpassa PDF417 inställningar
Anpassa rader, kolumner, ECC eller stil som behövs:
// 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;
Steg 4: Generera och spara PDF417 Barkoden
Exportera barkoden till PNG, JPEG eller något stöds format:
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
Steg 5: Ett fullständigt exempel
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
}
}
Använd fall och applikationer
- **Boarding pass: ** Flyg och transportbiljetter
- ID-kort och certifikat: maskinläsbar identitet, licenser
- Logistik och inventering: Shipment och lager etiketter
Gemensamma utmaningar och lösningar
**Challenge 1: PDF417 inte skannar?**Lösningen är: Använd tillräcklig felkorrigering, matcha rader/kolumner till data storlek, verifiera modulstorlek för skannrar.
Utmaning 2: För stora data?Lösningen är: Öka barkoden storlek, ton rader/kolumner eller split data.
**Challenge 3: Blurry eller låg-res bild?**Lösningen är: Export vid högre pixelstorlek eller DPI för utskriftsbruk.
Prestanda överväganden
- Använd rätt felkorrigering för applikationskritik
- Batch genererar PDF417 för passagerarlistor eller sändningsmanifest
- Använd minnesströmmar för in-memory barcode export
Bästa praxis
- Tune rader och kolumner för data och etikettstorlek
- Test med certifierade PDF417-skannrar/enheter
- Export till PNG för utskrift, JPEG för digital display
- Håll datateksten strukturerad och kortfattad
Avancerade scenarier
1.Batch Generate PDF417 Barkoder
foreach (var ticket in tickets)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}
Ställ in PDF417 Compaction och Macro-lägen
// 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;
slutsatser
Aspose.BarCode för .NET tillåter dig att skapa PDF417 barkoder för transport, ID och inventeringsprogram, med avancerad kontroll över format och säkerhet. Aspose.BarCode API Referens .