Jak generować kod barowy PDF417 za pomocą Aspose.BarCode dla .NET
W tym artykule przedstawiono, jak generować kod barowy PDF417 przy użyciu Aspose.BarCode dla .NET w C#. PDF317 jest stacjonarnym, wysokiej gęstości kodem barowym 2D, który jest szeroko stosowany do biletów transportowych, pasów na pokładzie, kart identyfikacyjnych i zarządzania zapasami.
Problem świata rzeczywistego
Kod barowy PDF417 jest wymagany przez linie lotnicze, dostawców logistycznych i agencje rządowe do kodowania dużych ilości danych w bezpiecznym, czytelnym formatie maszynowym. generowanie ręcznego pliku PDF317 wynika z błędu, a niewielu narzędzi kodów barowych obsługuje pakiet, automatyzację lub przepływy robocze .NET.
Przegląd rozwiązania
Aspose.BarCode dla .NET pozwala na programowanie kodów rzęs PDF417 z pełną kontrolą linii, kolumn, korekcji błędów i formatu eksportu – idealnie nadaje się do cyfrowych pasów, etykiet wysyłki lub certyfikatów.
Warunki
Zanim zaczniesz, upewnij się, że masz:
- Visual Studio 2019 lub później
- .NET 6.0 lub nowszy (lub .Net Framework 4.6.2+)
- Aspose.BarCode dla .NET zainstalowany za pośrednictwem NuGet
- Podstawowe informacje o C#
PM> Install-Package Aspose.BarCode
Wdrażanie krok po kroku
Krok 1: Instalacja i import Aspose.BarCode
Zainstaluj pakiet NuGet i importuj wymagane przestrzenie nazwowe:
using Aspose.BarCode.Generation;
Krok 2: Tworzenie generatora kodów barowych PDF417
Zainstaluj generator dla PDF417:
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
Krok 3: Dostosuj ustawienia PDF417
Dostosuj rzędy, kolumny, ECC lub styl w razie potrzeby:
// 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;
Krok 4: Generuj i przechowuj kod paska PDF417
Eksportuj kod paska do PNG, JPEG lub jakiegokolwiek obsługiwanego formatu:
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
Krok 5: Pełny przykład
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
}
}
Korzystanie z przypadków i aplikacji
- **Przejazdy łodziowe: ** Bilety lotnicze i loty
- Karty identyfikacyjne i dowody: Identyfikacja czytelna automatycznie, licencje
- Logistyka i zapas: Etykiety wysyłki i magazynu
Wspólne wyzwania i rozwiązania
**Wyzwanie 1: PDF417 nie skanuje?**Rozwiązanie : Wykorzystaj wystarczającą korektę błędu, dopasuj rzędy / kolumny do rozmiaru danych, sprawdź rozmiar modułu dla skanera.
Wyzwanie 2: Czy dane są zbyt duże?Rozwiązanie : Zwiększ rozmiar kodu paska, rzędy / kolumny lub podzielone dane.
Wyzwanie 3: Blurry czy niski obraz?Rozwiązanie : Eksport w wyższym rozmiarze piksela lub DPI do użytku drukowanego.
uwzględnienie wydajności
- Wykorzystaj poprawkę błędu dla krytyczności aplikacji
- Batch generuje PDF417 dla list pasażerów lub manifestu wysyłki
- Użyj strumieni pamięci do eksportu kodu paska in-memory
Najlepsze praktyki
- Rzędy i kolumny dla danych i rozmiar etykiety
- Test z certyfikowanymi skanerami / urządzeniami PDF417
- Eksport do PNG do drukowania, JPEG do cyfrowego wyświetlania
- Utrzymanie tekstu danych strukturalnego i skoncentrowanego
Zaawansowane scenariusze
1.Batch Generate PDF417 kody rzęs
foreach (var ticket in tickets)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}
Zestaw plików PDF417 i trybów makro
// 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;
konkluzja
Aspose.BarCode dla .NET umożliwia tworzenie kodów barowych PDF417 do transportu, identyfikatorów i aplikacji zapasowych, z zaawansowaną kontrolą nad formatem i bezpieczeństwem. Aspose.BarCode API Referencje .