PDF417-barkoder används ofta i olika branscher som transport, logistik och identitetshantering på grund av deras höga dataförmåga och robusta felkorrigeringskapacitet.
Introduktion
PDF417 är en stackad 2D-barkod som kan kryptera upp till 1 850 bytes data per symbol, vilket gör det idealiskt för applikationer som kräver stora mängder information.
Ställ upp din miljö
Innan du dyker in i kodexempler, se till att din utvecklingsmiljö är korrekt inställd:
förutsättningar
- Visual Studio 2019 eller senare
- .NET 6.0 eller senare (eller .NET Framework 4.6.2+)
- Aspose.BarCode för .NET installerat via NuGet
Installera paketet med följande kommando i din Package Manager Console:
PM> Install-Package Aspose.BarCode
Steg för steg genomförande
Steg 1: Skapa och konfigurera BarcodeGenerator
Först och främst, skapa en instans av BarcodeGenerator
och anger typen som PDF417.
BarcodeGenerator barcodeGenerator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
Steg 2: Anpassa PDF417 inställningar
Anpassa olika egenskaper som rader, kolumner, fel korrigeringsnivå och färginställningar för att passa dina krav.
// Set number of rows and columns
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
// Set error correction level (0-8, higher is stronger)
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
// Optional: Set XDimension (pixel size)
barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 4;
// Optional: Set foreground and background color
barcodeGenerator.Parameters.Barcode.BarColor = Color.Black;
barcodeGenerator.Parameters.Barcode.BackColor = Color.White;
Steg 3: Skapa och spara barkoden
Slutligen spara den genererade barkodbilden till en fil eller ström.
barcodeGenerator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
Fullständigt exempel
Här är det kompletta exemplet som binder allt samman:
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
barcodeGenerator.Parameters.Barcode.Pdf417.Pdf417CompactionMode = Pdf417CompactionMode.Text;
// Enable macro PDF417 for segmented/barcoded documents
barcodeGenerator.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.