Tác giả Barcode 2D
Làm thế nào để tạo PDF417 Barcodes bằng cách sử dụng Aspose.BarCode cho .NET

Làm thế nào để tạo PDF417 Barcodes bằng cách sử dụng Aspose.BarCode cho .NET

Bài viết này cho thấy làm thế nào để tạo mã thanh PDF417 bằng cách sử dụng Aspose.BarCode cho .NET trong C#. PDF317 là một mã mật độ cao 2D được dùng rộng rãi cho vé vận chuyển, hộ chiếu, thẻ ID và quản lý hồ sơ.

Vấn đề thế giới thực

Mã thanh PDF417 được yêu cầu bởi các hãng hàng không, nhà cung cấp logistics, và các cơ quan chính phủ để mã hóa khối lượng lớn dữ liệu trong một định dạng an toàn, có thể đọc bằng máy. Tạo hình dạng thủ công của PDF317 là sai lầm và rất ít công cụ mã thanh hỗ trợ bộ, tự động hóa, hoặc dòng công việc .NET.

Giải pháp Overview

Aspose.BarCode cho .NET cho phép bạn tạo mã thanh PDF417 một cách lập trình với sự kiểm soát đầy đủ về hàng, cột, sửa lỗi và định dạng xuất khẩu – lý tưởng cho các hộ chiếu kỹ thuật số, nhãn vận chuyển, hoặc chứng nhận.

Nguyên tắc

Trước khi bắt đầu, hãy chắc chắn rằng bạn có:

  • Visual Studio 2019 hoặc hơn
  • .NET 6.0 hoặc mới hơn (hoặc .Net Framework 4.6.2+)
  • Aspose.BarCode cho .NET cài đặt qua NuGet
  • kiến thức cơ bản về C#
PM> Install-Package Aspose.BarCode

Chế độ thực hiện từng bước

Bước 1: Cài đặt và nhập Aspose.BarCode

Cài đặt gói NuGet và nhập các không gian tên cần thiết:

using Aspose.BarCode.Generation;

Bước 2: Tạo PDF417 Barcode Generator

Cài đặt máy phát điện cho PDF417:

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

Bước 3: Tùy chỉnh cài đặt PDF417

Thay đổi hàng, cột, ECC, hoặc phong cách nếu cần thiết:

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

Bước 4: Tạo và lưu mã thanh PDF417

Xuất mã thanh sang PNG, JPEG, hoặc bất kỳ định dạng hỗ trợ nào:

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

Bước 5: Một ví dụ đầy đủ 

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

Sử dụng trường hợp và ứng dụng

  • **Hành trình hàng hải: ** Chuyến bay và vé vận chuyển
  • thẻ ID và chứng nhận: danh tính có thể đọc bằng máy, giấy phép
  • Logistics and inventory: Thương hiệu vận chuyển và kho

Những thách thức và giải pháp chung

**Thách thức 1: PDF417 không quét?**Giải pháp : Sử dụng sửa lỗi đủ, phù hợp hàng / cột với kích thước dữ liệu, xác minh kích cỡ mô-đun cho máy quét.

Thách thức 2: Dữ liệu quá lớn?Giải pháp : Tăng kích cỡ mã thanh, chuỗi / cột, hoặc chia dữ liệu.

Thách thức 3: hình ảnh nhầm lẫn hay thấp?Giải pháp : Xuất khẩu với kích thước pixel cao hơn hoặc DPI để sử dụng in.

Các tính toán hiệu suất

  • Sử dụng sự sửa chữa sai lầm đúng cho sự quan trọng của ứng dụng
  • Batch tạo PDF417 cho danh sách hành khách hoặc biểu thức vận chuyển
  • Sử dụng dòng bộ nhớ để xuất mã thanh in-memory

Thực hành tốt nhất

  • Tune hàng và cột cho dữ liệu và kích thước nhãn
  • Kiểm tra với máy quét / thiết bị PDF417 được chứng nhận
  • Xuất sang PNG cho in, JPEG cho hiển thị kỹ thuật số
  • Giữ văn bản dữ liệu có cấu trúc và mỏng manh

kịch bản tiên tiến

1.Batch Generate PDF417 Barcodes 

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

Thiết lập PDF417 Compaction và Macro Modes 

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

Kết luận

Aspose.BarCode cho .NET cho phép bạn tạo các mã thanh PDF417 cho các ứng dụng vận chuyển, ID và lưu trữ, với sự kiểm soát nâng cao về định dạng và bảo mật. Hướng dẫn sử dụng Aspose.BarCode API .

 Tiếng Việt