PDF417 بارکدها به طور گسترده ای در صنایع مختلف مانند حمل و نقل، تدارکات و مدیریت هویت به دلیل ظرفیت داده های بالا و توانایی های اصلاح خطا قوی استفاده می شود.این مقاله شما را از طریق فرآیند تولید کدها با استفاده از Aspose.BarCode برای .NET هدایت می کند.
معرفی
PDF417 یک کد نوار 2D است که می تواند تا 1.850 بایت از داده ها را در هر نماد رمزگذاری کند، بنابراین برای برنامه هایی که نیاز به مقدار زیادی از اطلاعات دارند، ایده آل است.این راهنمای شما را از طریق فرآیند تولید بارکد های PDF 417 به طور برنامه نویسی با استفاده از Aspose.BarCode برای .NET هدایت می کند.
ایجاد محیط زیست خود را
قبل از غوطه ور شدن در نمونه های کد، اطمینان حاصل کنید که محیط توسعه شما به درستی تنظیم شده است:
پیش شرط
- Visual Studio 2019 یا بالاتر
- .NET 6.0 یا بالاتر (یا .NET Framework 4.6.2+)
- Aspose.BarCode برای .NET نصب شده از طریق NuGet
بسته را با استفاده از دستور زیر در کنسول مدیریت بسته خود نصب کنید:
PM> Install-Package Aspose.BarCode
پیاده سازی گام به گام
مرحله 1: ایجاد و تنظیم BarcodeGenerator
اول از همه، یک نمونه از BarcodeGenerator
و نوع را به عنوان PDF417 مشخص کنید.
BarcodeGenerator barcodeGenerator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
مرحله دوم: تنظیمات PDF417 را سفارشی کنید
ویژگی های مختلفی مانند خطوط، ستون ها، سطح اصلاح خطا و تنظیمات رنگی را برای مطابقت با نیازهای شما تنظیم کنید.
// 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;
مرحله 3: ایجاد و ذخیره تصویر بارکد
در نهایت، تصویر بارکد تولید شده را به یک فایل یا جریان ذخیره کنید.
barcodeGenerator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
نمونه کامل
در اینجا مثال کامل است که همه چیز را به هم متصل می کند:
استفاده از موارد و برنامه ها
- گذرگاه های کشتی: بلیط هواپیمایی و حمل و نقل
- کارت شناسایی و اعتبارات: هویت قابل خواندن ماشین، مجوزها
- لجستیک و ذخیره سازی: برچسب های حمل و نقل و انبار
چالش ها و راه حل های مشترک
**چالش 1: PDF417 بدون اسکن?**راه حل: از اصلاح خطای کافی استفاده کنید، ردیف ها / ستون ها را با اندازه داده ها مطابقت دهید، اندازه ماژول برای اسکنرها را بررسی کنید.
**تحدی ۲: آیا داده ها زیاد است?**راه حل: اندازه کد نوار، ردیف ها / ستون ها یا داده های تقسیم شده را افزایش دهید.
**چالش سوم: تصویر خشمگین یا ضعیف?**راه حل: صادرات در اندازه پیکسل بالاتر یا DPI برای استفاده در چاپ.
بررسی عملکرد
- استفاده از اصلاح خطای صحیح برای انتقادات کاربردی
- پاتچ PDF417 را برای لیست های مسافر یا مانیفست های حمل و نقل تولید می کند
- استفاده از جریان های حافظه برای صادرات کد نوار در حفاری
بهترین شیوهها
- خطوط و ستون ها برای داده ها و اندازه برچسب
- آزمایش با اسکنر PDF417 گواهی شده
- صادرات به PNG برای چاپ، JPEG برای نمایش دیجیتال
- حفظ متن داده های ساختار یافته و مختصر
سناریوهای پیشرفته
دانلود نرم افزار PDF417 Barcodes
foreach (var ticket in tickets)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}
تنظیم PDF417 Compaction و حالت های ماکرو
// 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;
نتیجه گیری
Aspose.BarCode برای .NET به شما اجازه می دهد تا کدهای نوار PDF417 را برای حمل و نقل، شناسه و برنامه های ذخیره سازی با کنترل پیشرفته فرمت و امنیت ایجاد کنید Aspose.BarCode API ارجاع.