diff --git a/barcode/arabic/net/compact-pdf417-encoding/_index.md b/barcode/arabic/net/compact-pdf417-encoding/_index.md index c04422a76..3c79d71a8 100644 --- a/barcode/arabic/net/compact-pdf417-encoding/_index.md +++ b/barcode/arabic/net/compact-pdf417-encoding/_index.md @@ -172,6 +172,11 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); - [كيفية إنشاء باركود – Compact PDF417 باستخدام Aspose.BarCode](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [دروس شاملة وأمثلة على Aspose.BarCode for .NET](/barcode/net/) - [كيفية إنشاء باركود Aztec مع تصحيح الأخطاء في .NET](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) +- [كيفية إنشاء باركود PDF417 في C# وتحديد حجم الباركود](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +- [كيفية إنشاء باركود PDF417 في C# وحفظه كملف PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +- [كيفية إنشاء باركود micro PDF417 في C# – دليل خطوة بخطوة](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +- [كيفية استخدام مولد الباركود C# لتنسيق Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [كيفية قراءة باركود PDF417 في C# – دليل كامل](./how-to-read-pdf417-barcodes-in-c-complete-guide/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/arabic/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/arabic/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..a41e964f4 --- /dev/null +++ b/barcode/arabic/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-08-22 +description: تعلم كيفية إنشاء رمز شريطي micro PDF417 في C# وتوليد صورة PNG للرمز الشريطي. + يتضمن ضبط أبعاد الرمز الشريطي وحفظ الملف. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: ar +lastmod: 2026-08-22 +og_description: إنشاء رمز شريطي micro PDF417 بلغة C# وتصديره كملف PNG. اتبع هذا الدليل + لتحديد أبعاد الرمز الشريطي وإنشاء صورة الرمز الشريطي بسرعة. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: إنشاء باركود Micro PDF417 في C# – دليل برمجة كامل +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: كيفية إنشاء باركود micro PDF417 في C# – دليل خطوة بخطوة +url: /ar/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية إنشاء شيفرة باركود micro PDF417 في C# – دليل خطوة بخطوة + +إذا كنت بحاجة إلى **إنشاء شيفرة باركود micro PDF417** لنظام التذاكر، أو ملصق المخزون، أو المسح عبر الهاتف المحمول، فإن هذا الدرس يوضح لك بالضبط كيفية القيام بذلك. ستشاهد برنامج C# الكامل الذي يولد صورة باركود بصيغة PNG، وتتعلم كيفية ضبط أبعاد الباركود، وتفهم كل خيار من خيارات التكوين. + +بنهاية هذا الدليل ستكون قادرًا على توليد صورة باركود عالية الدقة، تخصيص بُعد X، اختيار عدد الأعمدة، وحفظ النتيجة كملف PNG — كل ذلك ببضع أسطر من الشيفرة. + +## ما ستحتاجه + +- .NET 6.0 SDK أو أحدث (الكود يعمل مع .NET Core و .NET Framework) +- Visual Studio 2022 أو أي بيئة تطوير متوافقة مع C# +- حزمة **Aspose.BarCode for .NET** من NuGet (أو أي مكتبة تدعم `EncodeTypes.MicroPdf417`) +- إلمام أساسي بصياغة C# + +> **نصيحة احترافية:** نسخة المجتمع المجانية من Aspose.BarCode كافية للتطوير والاختبار. للإنتاج، احصل على ترخيص لإزالة العلامات المائية التجريبية. + +## الخطوة 1: تثبيت مكتبة الباركود + +افتح طرفية (Terminal) في مجلد المشروع وشغّل: + +```bash +dotnet add package Aspose.BarCode +``` + +هذا يضيف تجميع `Aspose.BarCode`، الذي يوفر الفئة `BarcodeGenerator` المستخدمة في **إنشاء تطبيقات صورة باركود C#**. + +## الخطوة 2: تهيئة المُولد – إنشاء شيفرة باركود micro PDF417 + +السطر القابل للتنفيذ الأول ينشئ كائن `BarcodeGenerator` مُكوَّن للرمز المرمّز Micro PDF417 ويزود البيانات التي تريد ترميزها. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*لماذا هذا مهم*: تعداد `EncodeTypes.MicroPdf417` يُخبر المكتبة باستخدام النسخة المدمجة من PDF417، وهي مثالية للملصقات الصغيرة وشاشات الهواتف المحمولة. + +## الخطوة 3: كيفية ضبط أبعاد الباركود في C# + +ضبط عرض الوحدة (بعد X) بدقة يتحكم في كثافة الباركود البصرية. قيمة أصغر تنتج صورة أكثر وضوحًا، بينما قيمة أكبر تجعل الباركود أسهل في المسح من مسافة. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **لماذا يجب ضبط الأبعاد**: بدون تعديل بعد X، قد ينتج القيمة الافتراضية باركودًا يبدو ضبابيًا عند العرض بدقة DPI عالية. ضبطه إلى 2 بكسل يُعد توازنًا جيدًا لمعظم عمليات المسح عبر الشاشات. + +## الخطوة 4: اختيار عدد الأعمدة – التحكم في عرض الباركود + +Micro PDF417 يسمح بين 1 و 4 أعمدة. المزيد من الأعمدة يضغط البيانات أفقيًا، مما يقلل عرض الصورة الكلي. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*حالة حافة*: إذا طلبت 5 أعمدة ستطرح المكتبة استثناء `ArgumentOutOfRangeException`. احرص دائمًا على البقاء ضمن النطاق الموثق. + +## الخطوة 5: كيفية توليد باركود PNG – حفظ الصورة + +الآن يمكنك تصدير الباركود المُولد إلى ملف PNG. PNG يحافظ على جودة غير فقدانية، وهو أمر أساسي للمسح الموثوق. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +عند تشغيل البرنامج، سترى رسالة في وحدة التحكم تؤكد موقع الملف. ملف `MicroPdf417.png` الناتج يبدو هكذا: + +![لقطة شاشة تُظهر شيفرة باركود micro PDF417 مُولدة تم إنشاؤها باستخدام C#](micro-pdf417-example.png "باركود micro PDF417 المُولد") + +*نص بديل للصورة*: **باركود micro PDF417 تم توليده في C#** – يوضح النتيجة النهائية بعد تطبيق الأبعاد وإعدادات الأعمدة. + +## الخطوة 6: تشغيل والتحقق من النتيجة + +1. بناء المشروع: `dotnet build`. +2. تشغيل: `dotnet run`. +3. افتح `MicroPdf417.png` على سطح المكتب الخاص بك وامسحه باستخدام تطبيق ماسح باركود على الهاتف المحمول. + +يجب أن ترى النص **“Sample text”** مُفككًا. إذا أبلغ الماسح عن خطأ، تحقق مرة أخرى من بعد X وعدد الأعمدة – القيم المتطرفة قد تجعل الباركود كثيفًا جدًا لبعض الأجهزة. + +## الاختلافات الشائعة وحلول المشكلات + +| الحالة | التعديل | +|-----------|------------| +| **الحاجة إلى باركود أكبر للطابعات منخفضة الدقة** | زيادة `XDimension.Pixels` إلى 3 أو 4. | +| **الرغبة في باركود أطول دون تغيير العرض** | ضبط `generator.Parameters.Barcode.Pdf417.Rows` (نطاق الصفوف 3‑90). | +| **إنشاء عدة باركودات في حلقة** | إعادة استخدام نفس كائن `BarcodeGenerator` وتغيير `CodeText` فقط قبل كل عملية `Save`. | +| **الحفظ كـ JPEG بدلاً من PNG** | استبدال `BarCodeImageFormat.Png` بـ `BarCodeImageFormat.Jpeg`. | +| **التشغيل على .NET Framework 4.7** | الكود نفسه يعمل؛ فقط قم بالإشارة إلى `Aspose.BarCode.dll` المناسب. | + +## القائمة الكاملة للمصدر (قابلة للتنفيذ) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**الناتج المتوقع** – ملف PNG بحجم 200 × 100 بكسل يحتوي على باركود Micro PDF417 واضح يُفكك إلى “Sample text”. + +## الخلاصة + +أنت الآن تعرف كيف **إنشاء شيفرة باركود micro PDF417** في C#، **ضبط أبعاد الباركود**، و**توليد صورة باركود PNG**. المثال الكامل يوضح كل خطوة مطلوبة — من تثبيت المكتبة إلى حفظ الملف النهائي — بحيث يمكنك دمج توليد الباركود مباشرةً في تطبيقاتك. + +بعد ذلك، استكشف المواضيع ذات الصلة مثل **إنشاء رموز QR باستخدام Aspose.BarCode**، **تخصيص الألوان**، أو **دمج الباركود في مستندات PDF**. كل منها يبني على أساسيات `BarcodeGenerator` نفسها التي تم تغطيتها هنا. + +لا تتردد في تجربة سلاسل بيانات مختلفة، وعدد الأعمدة، وقيم بعد X لتناسب بيئة المسح الخاصة بك. ترميز سعيد! + +## ما الذي يجب أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مصدر يتضمن أمثلة شيفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء باركود – PDF417 المدمج باستخدام Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [كيفية توليد باركود PDF417 – ترميز PDF417 المدمج](/barcode/english/net/compact-pdf417-encoding/) +- [كيفية إنشاء باركود Aztec باستخدام Aspose.BarCode لـ .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/arabic/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/arabic/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..a649f370a --- /dev/null +++ b/barcode/arabic/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-08-22 +description: تعلم كيفية إنشاء باركود PDF417 في C# باستخدام مولد الباركود، وضبط التخطيط، + وحفظه كملف PNG. يتضمن الكود الكامل ونصائح لمشاريع مولد الباركود بلغة C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: ar +lastmod: 2026-08-22 +og_description: إنشاء رمز شريطي PDF417 في C# باستخدام مولد الرموز الشريطية، تخصيص + التخطيط، وتعلم كيفية حفظ PNG. اتبع هذا الدليل خطوة بخطوة. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: إنشاء رمز شريطي PDF417 في C# – دليل كامل لتوليد وحفظ PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: كيفية إنشاء رمز شريطي PDF417 في C# وحفظه كملف PNG +url: /ar/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية إنشاء باركود PDF417 في C# وحفظه كملف PNG + +إذا كنت بحاجة إلى **إنشاء باركود PDF417** في تطبيق C#، فإن هذا الدليل يوضح لك الخطوات الدقيقة. سترى كيف يمكن لمكتبة مولد الباركود C# تحويل أي سلسلة نصية إلى صورة PDF417 قابلة للمسح الضوئي وكيفية حفظ ملفات PNG دون أدوات إضافية. + +إنشاء الباركود شائع في اللوجستيات، وإصدار التذاكر، وإدارة المستندات. بنهاية هذا الدليل ستحصل على برنامج كونسول قابل للتنفيذ ينتج ملف PNG باسم `Pdf417Layout.png` في المجلد الذي تختاره. + +## المتطلبات المسبقة + +- .NET 6.0 SDK أو أحدث مثبت (الكود يعمل أيضًا مع .NET Framework 4.7+). +- Visual Studio 2022 أو أي محرر يمكنه بناء مشاريع C#. +- حزمة NuGet **Aspose.BarCode for .NET** (أو أي مكتبة مولد باركود C# متوافقة). + قم بتثبيتها باستخدام: + +```bash +dotnet add package Aspose.BarCode +``` + +لا توجد حاجة لمكتبات معالجة صور إضافية لأن المولد يمكنه كتابة PNG مباشرة. + +## الخطوة 1: إعداد مشروع كونسول جديد + +أنشئ مشروع كونسول جديد حتى يبقى المثال مستقلاً. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +المجلد `Pdf417Demo` يحتوي الآن على ملف `Program.cs` حيث سنكتب كود الباركود. + +## الخطوة 2: استيراد مساحة اسم الباركود + +افتح `Program.cs` وأضف توجيه `using` المطلوب في الأعلى: + +```csharp +using Aspose.BarCode.Generation; +``` + +تمنحك مساحة الاسم هذه إمكانية الوصول إلى `BarcodeGenerator` و `EncodeTypes` وتعداد تنسيق الصورة المطلوب لـ **كيفية حفظ PNG**. + +## الخطوة 3: إنشاء مولد باركود PDF417 + +جوهر **كيفية إنشاء PDF417** هو الفئة `BarcodeGenerator`. مرّر نوع الترميز `EncodeTypes.Pdf417` والنص الذي تريد ترميزه. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` الآن يحتوي على جميع إعدادات الباركود. التخطيط الافتراضي يعمل، لكننا سنقوم بتخصيصه في الخطوة التالية. + +## الخطوة 4: تعريف تخطيط الباركود (الأعمدة والصفوف) + +يتيح لك PDF417 التحكم في عدد الأعمدة (2‑30) والصفوف (1‑90). تعديل هذه القيم يمكن أن يحسن قابلية القراءة لأجهزة المسح المحددة. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **نصيحة احترافية:** إذا تجاهلت هذه الإعدادات، تختار المكتبة القيم المثلى تلقائيًا. ومع ذلك، تثبيت الأعمدة والصفوف يمنحك أبعاد صورة متوقعة، وهو مفيد عندما تدمج PNG في ملف PDF أو تخطيط واجهة المستخدم. + +## الخطوة 5: حفظ الباركود المُولد كصورة PNG + +الآن أجب على **كيفية حفظ PNG** عن طريق استدعاء `Save`. الطريقة تقبل مسار الهدف وتعداد تنسيق الصورة. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +يظهر الملف `Pdf417Layout.png` في مجلد المشروع `bin/Debug/net6.0` بعد تشغيل البرنامج. + +## مثال كامل قابل للتنفيذ + +فيما يلي ملف `Program.cs` الكامل. انسخه إلى المشروع الذي تم إنشاؤه في **الخطوة 1** وشغّل `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### النتيجة المتوقعة + +عند تشغيل البرنامج، يطبع الكونسول المسار المطلق لملف PNG، ويحتوي الملف على باركود PDF417 واضح يشبه الصورة أدناه. + +![مثال إنشاء باركود PDF417](image-placeholder.png "باركود PDF417 محفوظ كملف PNG") + +يمكنك مسح PNG بأي ماسح يدعم PDF417 (تطبيقات الهاتف، القارئات المادية) للتحقق من أن النص المشفر هو `"Sample"`. + +## معالجة الحالات الحدية والمشكلات الشائعة + +| الحالة | ما الذي يجب مراقبته | الإصلاح الموصى به | +|-----------|-------------------|-----------------| +| **قيم أعمدة/صفوف غير صالحة** | القيم خارج النطاق 2‑30 (الأعمدة) أو 1‑90 (الصفوف) تتسبب في حدوث `ArgumentException`. | تحقق من صحة إدخال المستخدم قبل التعيين، أو دع المكتبة تختار القيم الافتراضية. | +| **سلاسل إدخال طويلة** | يمكن لـ PDF417 ترميز ما يصل إلى 1,850 حرفًا، لكن السلاسل الطويلة جدًا تزيد عدد الصفوف المطلوبة بشكل كبير. | قسم البيانات إلى عدة باركودات أو استخدم مستوى تصحيح أخطاء أعلى إذا لزم الأمر. | +| **أذونات نظام الملفات** | الحفظ في مجلد للقراءة فقط يسبب `UnauthorizedAccessException`. | احفظ في `Environment.CurrentDirectory` أو مسار يمكن للمستخدم الكتابة فيه، وتعامل مع الاستثناءات باستخدام try/catch. | +| **حزمة NuGet مفقودة** | فشل التجميع مع الرسالة “type or namespace name could not be found”. | تأكد من تثبيت `Aspose.BarCode` (`dotnet add package Aspose.BarCode`). | + +## توسيع المثال + +الآن بعد أن عرفت **كيفية إنشاء باركود PDF417** و **كيفية حفظ PNG**، يمكنك استكشاف المواضيع ذات الصلة التالية: + +- **مولد باركود C#**: غيّر `EncodeTypes` إلى `Code128` أو `QR` أو أي رموز أخرى. +- **ألوان مخصصة**: استخدم `generator.Parameters.Barcode.ForegroundColor` و `BackgroundColor` لتتناسب مع العلامة التجارية. +- **دمج في ملفات PDF**: اجمع PNG مع مكتبة PDF (مثل iText7) لإنشاء مستندات قابلة للطباعة. +- **بيانات ديناميكية**: استخرج النص من قاعدة بيانات أو إدخال المستخدم لإنشاء باركودات في الوقت الفعلي. + +## الخلاصة + +أصبح لديك الآن حل كامل وجاهز للإنتاج لـ **إنشاء باركود PDF417** في C# وحفظ النتيجة كملف PNG. يغطي الدليل كل خطوة من إعداد المشروع إلى تخصيص التخطيط، ويبرز كيفية تجنب الأخطاء الشائعة عند استخدام مكتبة مولد باركود C#. + +لا تتردد في تجربة إعدادات أعمدة/صفوف مختلفة، أو ألوان، أو حتى صيغ باركود أخرى. إذا واجهت أي مشاكل، عد إلى قسم **كيفية إنشاء PDF417** أو استكشف وثائق المكتبة للحصول على ميزات متقدمة. برمجة سعيدة! + +## ما الذي يجب أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مورد يتضمن أمثلة شفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء باركود – PDF417 مضغوط باستخدام Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [كيفية إنشاء باركود PDF417 – ترميز PDF417 مضغوط](/barcode/english/net/compact-pdf417-encoding/) +- [كيفية إنشاء منطقة هادئة للباركود ITF-14 باستخدام Aspose.BarCode لـ .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/arabic/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/arabic/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..89ba855ff --- /dev/null +++ b/barcode/arabic/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: تعلم كيفية إنشاء باركود PDF417 في C# باستخدام Aspose.BarCode، وضبط حجم + الباركود، وتعديل الأعمدة، وتفعيل وضع الضغط. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: ar +lastmod: 2026-08-22 +og_description: إنشاء رمز شريطي PDF417 في C# باستخدام Aspose.BarCode. يوضح هذا الدليل + كيفية ضبط حجم الرمز الشريطي، التحكم في الأعمدة، وتفعيل وضع الضغط للحصول على صورة + أصغر. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: إنشاء باركود PDF417 في C# – ضبط الحجم، الأعمدة، ووضع الضغط +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: كيفية إنشاء باركود PDF417 في C# وتحديد حجم الباركود +url: /ar/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية إنشاء رمز شريطي PDF417 في C# وتحديد حجم الرمز الشريطي + +إذا كنت بحاجة إلى **إنشاء رمز شريطي PDF417** في تطبيق .NET، فإن هذا الدليل يشرح لك العملية بالكامل. سترى بالضبط **كيفية إنشاء PDF417** باستخدام Aspose.BarCode، وضبط **حجم الرمز الشريطي**، وإنتاج صورة PNG مضغوطة يمكن تضمينها في التقارير أو التطبيقات المحمولة. + +إنشاء رمز شريطي لا يتطلب محرر رسومات منفصل. بنهاية هذا الدرس ستحصل على طريقة C# كاملة الوظيفة تنتج صورة PDF417 بالأبعاد الدقيقة التي تحتاجها، جاهزة للمعالجة اللاحقة. + +## ما ستتعلمه + +* تثبيت وإضافة مرجع لمكتبة Aspose.BarCode. +* إنشاء مولد رمز شريطي PDF417 وتحديد النص المشفر. +* **تحديد حجم الرمز الشريطي** عن طريق ضبط X‑dimension وعدد الأعمدة. +* تمكين الوضع المضغوط (المختصر) لتقليل حجم الرمز. +* حفظ النتيجة كملف PNG. +* استكشاف الأخطاء الشائعة مثل الرموز غير القابلة للقراءة والصور ذات الحجم الكبير. + +### المتطلبات المسبقة + +* .NET 6.0 أو أحدث (تعمل الواجهة البرمجية مع .NET Framework 4.6+ أيضًا). +* إلمام أساسي بـ C# و Visual Studio (أو أي بيئة تطوير C#). +* ترخيص Aspose.BarCode صالح (التقييم المجاني يعمل للاختبار). + +> **نصيحة احترافية:** إذا كنت تخطط لإنشاء العديد من الرموز الشريطية داخل حلقة، أعد استخدام كائن `BarcodeGenerator` واحد فقط وقم بتغيير خاصية `CodeText` فقط. هذا يقلل من تخصيص الذاكرة. + +## إنشاء رمز شريطي PDF417 باستخدام Aspose.BarCode + +الخطوة الأولى هي إنشاء كائن `BarcodeGenerator` للرمز الشريطي PDF417. هذا الكائن هو نقطة الدخول لجميع عمليات الرموز الشريطية. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*لماذا هذا مهم*: `EncodeTypes.Pdf417` يخبر المكتبة باستخدام معيار PDF417، الذي يدعم كميات كبيرة من البيانات وتصحيح الأخطاء. كما أن المُنشئ يقبل البيانات التي تريد ترميزها، مما يلغي الحاجة لتعيين `CodeText` منفصل لاحقًا. + +## ضبط حجم الرمز الشريطي وعدد الأعمدة + +رموز PDF417 تتكون من صفوف وأعمدة من وحدات مستطيلة صغيرة. التحكم في عرض الوحدة (X‑dimension) وعدد الأعمدة يتيح لك ضبط الأبعاد الكلية بدقة. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*شرح*: +* **X‑dimension** (`Pixels`) يحدد عرض كل وحدة. القيم الأصغر تنتج رمزًا شريطيًا أكثر تماسكًا، بينما القيم الأكبر تزيد من قابلية القراءة على الماسحات ذات الدقة المنخفضة. +* **Columns** تتحكم في التخطيط الأفقي. عدد أقل من الأعمدة يجعل الرمز الشريطي أطول؛ وعدد أكبر يجعل الرمز أوسع. اضبط هذين الإعدادين معًا لتحقيق **حجم الرمز الشريطي** الدقيق الذي تحتاجه. + +## تمكين الوضع المضغوط للحصول على رمز شريطي أصغر + +PDF417 يتضمن وضعًا “مضغوطًا” (أو مختصرًا) يزيل الحشو غير الضروري ويقلل من البصمة الكلية. هذا مفيد بشكل خاص عندما تكون مساحة الشاشة محدودة. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*لماذا تمكين الاختصار؟* +عندما تكون `Truncate` مساوية لـ `true`، يتجاهل المولد نمط الإيقاف وبعض كلمات تصحيح الأخطاء التي لا تحتاجها معظم سيناريوهات المسح. الصورة الناتجة أصغر بنحو 15‑20 % دون التضحية بسلامة البيانات في الاستخدامات العادية. + +## حفظ الرمز الشريطي كصورة PNG + +بعد ضبط الحجم والوضع، احفظ الرمز الشريطي على القرص. PNG هو تنسيق غير فقدان، مما يضمن بقاء حواف الوحدات حادة. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +الملف `CompactPdf417.png` سيحتوي على رمز PDF417 واضح يطابق الأبعاد التي ضبطتها في الخطوات السابقة. + +### النتيجة المتوقعة + +فتح ملف PNG المحفوظ يجب أن يعرض رمز PDF417 موجهًا عموديًا يتكون من ثلاثة أعمدة، كل وحدة بعرض 2 بكسل، وبحجم إجمالي تقريبًا **120 × 240 بكسل** (العرض × الارتفاع). مسح الصورة بأي قارئ PDF417 قياسي يعيد النص الأصلي “Sample text for PDF417”. + +## المشكلات الشائعة وكيفية تجنبها + +| العَرَض | السبب المحتمل | الحل | +|---------|--------------|-----| +| الرمز غير قابل للقراءة | X‑dimension صغير جدًا بالنسبة للماسح | زيادة `XDimension.Pixels` إلى 3 أو 4 | +| الصورة عريضة جدًا بالنسبة للواجهة | تم ضبط عدد أعمدة كبير جدًا | تقليل `Pdf417.Columns` أو تمكين `Truncate` | +| استثناء `ArgumentOutOfRangeException` | عدد الأعمدة سالب أو صفر | تأكد من أن `Columns` عدد صحيح موجب (الحد الأدنى 1) | +| ملف PNG فارغ | مسار الإخراج غير موجود أو لا يملك صلاحية كتابة | تحقق من وجود الدليل وأن التطبيق لديه صلاحيات كتابة | + +> **نصيحة احترافية:** استخدم `barcodeGenerator.ValidateParameters()` قبل استدعاء `Save()` لاكتشاف أخطاء التكوين مبكرًا. + +## مثال كامل قابل للتنفيذ + +فيما يلي برنامج وحدة تحكم مستقل يدمج جميع الخطوات السابقة. انسخه في مشروع C# جديد، استعد حزمة Aspose.BarCode عبر NuGet، وشغله لرؤية النتيجة. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**تشغيل البرنامج** ينتج `CompactPdf417.png` في دليل العمل للتنفيذ. امسح الصورة باستخدام تطبيق هاتف محمول (مثل “Barcode Scanner”) للتحقق من أن النص المشفر يطابق السلسلة الأصلية. + +## الخطوات التالية والمواضيع ذات الصلة + +* **زيادة مستوى تصحيح الأخطاء** – اضبط `Pdf417.ErrorLevel` للبيئات التي تحتوي على مسحات ضوضائية. +* **تغيير الاتجاه** – اضبط `Pdf417.Rotate` إلى `RotationAngle.Rotate90` إذا كنت تحتاج إلى تخطيط أفقي. +* **إدراج الرمز الشريطي في ملف PDF** – اجمع بين Aspose.PDF و Aspose.BarCode لوضع الصورة مباشرةً في المستند. +* **إنشاء رموز شريطية ثنائية الأبعاد أخرى** – فئة `BarcodeGenerator` نفسها تدعم DataMatrix و QR و Aztec؛ فقط استبدل `EncodeTypes.Pdf417` بالرمز الشريطي المطلوب. + +من خلال إتقان تقنيات **إنشاء رمز شريطي PDF417**، يمكنك أتمتة إصدار التذاكر، وضع علامات المخزون، ونقل البيانات بأمان عبر مجموعة واسعة من تطبيقات .NET. + +## الخلاصة + +أنت الآن تعرف كيفية **إنشاء رمز شريطي PDF417** في C#، وتحديد **حجم الرمز الشريطي** بدقة، وضبط الأعمدة، وتمكين الوضع المضغوط، وحفظ النتيجة كملف PNG. استخدم هذه الإعدادات لتناسب أي قيود واجهة مستخدم أو متطلبات مسح، ووسع النهج لتطبيقات رموز شريطية أخرى حسب الحاجة. برمجة سعيدة! + +## ماذا يجب أن تتعلم بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مورد يتضمن أمثلة شفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء رمز شريطي PDF417 – ترميز PDF417 مضغوط](/barcode/english/net/compact-pdf417-encoding/) +- [كيفية إنشاء رمز شريطي – PDF417 مضغوط باستخدام Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [كيفية إنشاء رموز DataMatrix باستخدام Aspose.BarCode لـ .NET – دليل خطوة بخطوة](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/arabic/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/arabic/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..d61445680 --- /dev/null +++ b/barcode/arabic/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: كيفية قراءة رموز PDF417 الشريطية في C# مع دليل خطوة بخطوة، يغطي كيفية + قراءة عدة رموز من صورة واستخراج تفاصيل MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: ar +lastmod: 2026-08-22 +og_description: كيفية قراءة رموز PDF417 الشريطية في C# بسرعة. يوضح لك هذا الدرس كيفية + قراءة عدة رموز شريطية من صورة واسترجاع المعلومات الموسعة لـ MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: كيفية قراءة باركود PDF417 في C# – دليل برمجي كامل +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: كيفية قراءة رموز PDF417 الشريطية في C# – دليل كامل +url: /ar/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية قراءة باركود PDF417 في C# – دليل كامل + +إذا كنت بحاجة إلى **كيفية قراءة PDF417** في تطبيق .NET، فإن هذا الدرس يقدّم لك حلاً جاهزًا للتنفيذ. ستتعلم كيفية قراءة عدة باركودات من صورة واحدة، استخراج مجموعة بيانات MacroPdf417 الكاملة، وعرضها في وحدة التحكم. يعمل النهج مع مكتبة Aspose.BarCode for .NET ويتطلب فقط بضع أسطر من الشيفرة. + +قراءة الباركودات من صورة هي مهمة شائعة في أنظمة الجرد، التحقق من التذاكر، وإدارة المستندات. بنهاية هذا الدليل ستكون قادرًا على فك تشفير أي باركود PDF417 أو MacroPdf417، ومعالجة عدة رموز في صورة واحدة، وفهم الحقول الموسعة التي يوفرها MacroPdf417. + +## المتطلبات المسبقة + +- .NET 6.0 SDK أو أحدث (الشيفرة تُجمّع أيضًا مع .NET Framework 4.7+) +- Visual Studio 2022 أو أي محرر C# تفضله +- حزمة NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- صورة نموذجية تحتوي على باركود MacroPdf417 (مثال: `MacroPdf417.png`) + +لا توجد إعدادات إضافية مطلوبة؛ المكتبة تتعامل مع تحميل الصورة وفك الترميز داخليًا. + +## كيفية قراءة باركود PDF417 من صورة في C# + +جوهر الحل هو الفئة `BarCodeReader`. تقوم بفتح الصورة، اكتشاف جميع الباركودات من النوع المحدد، وإرجاع مجموعة من كائنات `BarCodeResult`. الشيفرة التالية تُظهر برنامجًا كاملاً لوحدة التحكم. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### لماذا كل سطر مهم + +| الخطوة | الغرض | +|------|---------| +| **1️⃣ Initialize** | ينشئ كائن `BarCodeReader` مرتبط بملف الصورة ويقصر الاكتشاف على رموز MacroPdf417، مما يسرّع المعالجة. | +| **2️⃣ Iterate** | `ReadBarCodes()` تُعيد **جميع** الباركودات التي تطابق النوع المطلوب، مما يتيح لك **قراءة عدة باركودات** دون حلقات إضافية. | +| **3️⃣ Basic output** | يعرض `CodeTypeName` العام والنص القابل للقراءة `CodeText`. هذا مفيد للتسجيل أو التحقق السريع. | +| **4️⃣ Extended data** | يحمل MacroPdf417 بيانات تعريفية إضافية (معرف الملف، عدد القطاعات، الطوابع الزمنية، إلخ). كائن `Extended.Pdf417` يُظهر كل حقل مباشرة، بحيث يمكنك تخزين أو التحقق من حزمة البيانات الكاملة. | + +تشغيل البرنامج ضد صورة MacroPdf417 صالحة ينتج مخرجات وحدة تحكم مشابهة لما يلي: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +تؤكد المخرجات أن المكتبة نجحت في قراءة الباركود، استخراج النص، وتوفير كل حقل من حقول MacroPdf417. + +## قراءة عدة باركودات من صورة واحدة + +تضع العديد من السيناريوهات الواقعية عدة رموز PDF417 على ملصق واحد—مثل بيان شحن يحتوي على رمز الناقل، رقم تتبع، وإقرار جمركي. كتلة الشيفرة السابقة بالفعل **تقرأ عدة باركودات** لأن `ReadBarCodes()` تُعيد مجموعة من جميع التطابقات. لا حاجة لإعدادات إضافية؛ عليك فقط التكرار عبر النتائج كما هو موضح. + +إذا رغبت في قصر القارئ على PDF417 القياسي (بدون ماكرو) مع الاستمرار في معالجة عدة رموز، استبدل `DecodeType.MacroPdf417` بـ `DecodeType.Pdf417`. يبقى باقي المنطق دون تغيير. + +## فهم البيانات الموسعة في MacroPdf417 + +MacroPdf417 هو امتداد لمواصفات PDF417 العادية. يقسّم الأحمال الكبيرة إلى عدة قطاعات ويضيف رأسًا صغيرًا يصف الملف بالكامل. أهم الحقول هي: + +- **MacroPdf417FileID** – معرف فريد يُشارك بين جميع قطاعات نفس الملف. +- **MacroPdf417SegmentID** – رقم تسلسل القطاع الحالي. +- **MacroPdf417SegmentsCount** – إجمالي عدد القطاعات المتوقعة. +- **MacroPdf417FileName** – اسم ملف اختياري يُنقل مع الباركود. +- **MacroPdf417Checksum** – قيمة فحص الأخطاء للملف الكامل. +- **MacroPdf417FileSize** – حجم الحمولة الثنائية الأصلية. +- **MacroPdf417TimeStamp** – طابع زمني بصيغة ISO‑8601 عند توليد الباركود. +- **MacroPdf417Addressee / Sender** – حقول نصية اختيارية للتوجيه. +- **MacroPdf417Terminator** – يحدد ما إذا كان هذا القطاع هو الأخير. + +عند استلام جميع القطاعات، يمكنك إعادة بناء الملف الأصلي بترتيبها حسب `MacroPdf417SegmentID` وربط قيم `CodeText`. هذا المنطق سهل التنفيذ بمجرد توفر الحقول. + +## الأخطاء الشائعة ونصائح الخبراء + +- **جودة الصورة مهمة** – ملفات PNG/JPEG منخفضة الدقة أو مضغوطة بشدة قد تتسبب في فقدان الاكتشاف. استخدم DPI لا يقل عن 300 dpi للباركودات المطبوعة. +- **الرموز المختلطة** – إذا احتوت الصورة على كل من MacroPdf417 و PDF417 العادي، أنشئ قارئين (واحد لكل `DecodeType`) أو استخدم `DecodeType.AllSupported` وصفّ النتائج حسب `result.CodeTypeName`. +- **استهلاك الذاكرة** – جملة `using` تُفرغ كائن `BarCodeReader` فورًا، مما يمنع بقاء مخازن الصور الكبيرة في الذاكرة. +- **سلامة الخيوط** – `BarCodeReader` غير آمن للاستخدام المتعدد الخيوط. أنشئ نسخة منفصلة لكل خيط إذا كنت تفكّ شفرة صورًا بشكل متوازي. +- **معالجة الأخطاء** – غلف استدعاء `ReadBarCodes()` بكتلة try/catch لالتقاط `BarCodeException` في حال كانت الصور تالفة. + +## ملخص المثال الكامل العامل + +فيما يلي البرنامج الكامل الذي يمكنك نسخه إلى مشروع وحدة تحكم جديد. يتضمن جميع توجيهات `using`، ثابت لمسار الصورة، ونمط التخلص من الموارد. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +ابنِ المشروع باستخدام `dotnet build` وشغّله بـ `dotnet run`. ستطبع وحدة التحكم البيانات الأساسية لكل باركود والحمولة الكاملة لـ MacroPdf417. + +## الخطوات التالية + +- **إعادة بناء الملفات المتعددة الأجزاء** – جمع جميع القطاعات، ترتيبها حسب `MacroPdf417SegmentID`، وربط `CodeText` لتكوين الملف الأصلي. + +## ما الذي يجب أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات التي تم توضيحها في هذا الدليل. كل مصدر يتضمن أمثلة شيفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء باركود PDF417 – ترميز PDF417 المدمج](/barcode/english/net/compact-pdf417-encoding/) +- [كيفية قراءة باركود PDF417 مع أحرف تركية في Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [كيفية استخدام Aspose لباركود PDF417 (الصينية) في Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/arabic/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/arabic/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..e32d2872c --- /dev/null +++ b/barcode/arabic/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,223 @@ +--- +category: general +date: 2026-08-22 +description: يُظهر دليل إنشاء الباركود بلغة C# كيفية إنشاء باركود Macro PDF417 مع + البيانات الوصفية وحفظه كملف PNG باستخدام Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: ar +lastmod: 2026-08-22 +og_description: مُولِّد الباركود C# يتيح لك إنشاء باركود Macro PDF417 مع بيانات تعريفية + كاملة على مستوى الملف وتصديره كصورة PNG. اتبع هذا الدليل لتنفيذ الحل. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: مولد الباركود C# – إنشاء باركودات Macro PDF417 خطوة بخطوة +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: كيفية استخدام مولد الباركود C# لـ Macro PDF417 +url: /ar/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية استخدام مولد الباركود C# لتقنية Macro PDF417 + +إذا كنت بحاجة إلى **barcode generator C#** يمكنه إنشاء رمز Macro PDF417 مع بيانات وصفية على مستوى الملف، فإن هذا الدليل يوفر حلاً كاملاً وجاهزًا للتنفيذ. ستتعرف على كيفية تكوين مظهر الباركود، وإدراج معلومات الماكرو مثل معرف الملف وعدد القطع، وأخيرًا حفظ النتيجة كصورة PNG. + +يستخدم المثال مكتبة Aspose.BarCode، وهي **C# barcode library** معتمدة على نطاق واسع تدعم مجموعة ميزات PDF417 الكاملة. لا توجد خدمات خارجية مطلوبة، ويعمل الكود مع .NET 6 أو أحدث. + +## المتطلبات المسبقة + +* .NET 6 SDK (أو أي إصدار لاحق) مثبت. +* Visual Studio 2022، VS Code، أو أي بيئة تطوير متكاملة C# أخرى. +* إشارة NuGet إلى **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +فهم أساسيات صياغة C# ومفهوم باركودات PDF417 سيساعدك على متابعة الخطوات، لكن الدليل يشرح كل خيار تكوين بالتفصيل. + +## ما يغطيه الدليل + +* تهيئة كائن **barcode generator C#** لتنسيق Macro PDF417. +* ضبط المعلمات البصرية مثل X‑dimension وعدد الأعمدة. +* توفير حقول مستوى الملف لـ Macro PDF417: file ID، segment ID، segment count، file name، checksum، file size، timestamp، addressee، sender، و terminator. +* حفظ الرمز المُولد كملف PNG. +* نصائح للتعامل مع الحالات الحدية مثل أحجام الملفات الكبيرة أو الطوابع الزمنية المخصصة. + +بنهاية هذا المقال ستحصل على برنامج مستقل ينتج باركود Macro PDF417 متوافق بالكامل. + +## الخطوة 1: إنشاء كائن barcode generator C# instance + +العملية الأولى هي إنشاء كائن `BarcodeGenerator` باستخدام قيمة التعداد `EncodeTypes.MacroPdf417` والنص الذي تريد ترميزه. القالب (constructor) يقبل أيضًا سلسلة الحمولة، التي تصبح جزء البيانات من الباركود الماكرو. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**لماذا هذا مهم** – علم `EncodeTypes.MacroPdf417` يخبر Aspose.BarCode بمعاملة الرمز كباركود ماكرو، مما يتيح الحقول الإضافية التي تليه. بدون هذا العلم، ستولد المكتبة باركود PDF417 عادي يفتقر إلى البيانات الوصفية على مستوى الملف. + +## الخطوة 2: ضبط مظهر الباركود الأساسي (إعدادات بصرية لـ PDF417) + +الوضوح البصري أمر حاسم للمسح الموثوق. معلمتان شائعتان هما عرض الوحدة (`XDimension`) وعدد الأعمدة. ضبط هذه القيم يوازن بين الحجم وقابلية القراءة. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +- `XDimension.Pixels` يتحكم في عرض كل شريط أسود/أبيض. قيمة **2** تعمل جيدًا لمعظم طابعات الملصقات. +- `Pdf417.Columns` يحدد عدد الأعمدة التي سيستخدمها الباركود. خمسة أعمدة تنتج رمزًا مدمجًا دون التضحية بسعة البيانات. + +## الخطوة 3: تعريف معلومات مستوى الملف لـ Macro PDF417 + +Macro PDF417 يوسع تنسيق PDF417 القياسي بإضافة حقول تصف كيفية تقسيم ملف كبير إلى عدة قطاعات باركود. توفير هذه الحقول يضمن أن الماسحات اللاحقة يمكنها إعادة بناء الملف الأصلي. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +- `MacroPdf417FileID` يجب أن يكون نفسه لكل قطاع ينتمي إلى نفس الملف المنطقي. +- `MacroPdf417SegmentID` يزداد من **0** إلى `SegmentsCount‑1`. +- `MacroPdf417SegmentsCount` يخبر المُفكك بعدد القطع المتوقعة. +- `MacroPdf417FileName` اختياري لكنه مفيد لتحديد قابل للقراءة البشرية. + +## الخطوة 4: تعيين بيانات ماكرو إضافية + +إلى جانب معلومات الملف الأساسية، تسمح المواصفة بحقول إضافية مثل checksum، file size، timestamp، addressee، sender، وعلم terminator. تعبئة هذه الحقول تحسن من سلامة البيانات وتتبعها. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +- `MacroPdf417Checksum` يوفر checksum من نوع CCITT 16‑bit للملف بأكمله؛ يمكن للمفكك التحقق من السلامة بعد إعادة البناء. +- `MacroPdf417FileSize` يجب أن يعكس العدد الدقيق للبايتات في الملف الأصلي؛ القيم الأكبر من `2^31‑1` تتطلب حقلًا 64‑bit، والذي تتعامل معه Aspose تلقائيًا. +- `MacroPdf417TimeStamp` يسجل وقت إنشاء الباركود. استخدم UTC لتجنب غموض المنطقة الزمنية. +- `MacroPdf417Addressee` و `MacroPdf417Sender` هما سلاسل نصية حرة يمكنها تخزين معلومات التوجيه. +- `MacroPdf417Terminator` يشير إلى أن هذا هو القطاع النهائي؛ اضبطه إلى `Set` للقطعة الأخيرة، وإلا اترك القيمة الافتراضية (`NotSet`). + +**نصيحة للحالات الحدية** – إذا تجاوز حجم ملفك 4 GB، قسّم المحتوى إلى عدة قطاعات ماكرو واضبط `SegmentsCount` وفقًا لذلك. ستدير المكتبة حقل الحجم الكبير دون حدوث تجاوز. + +## الخطوة 5: حفظ الباركود كصورة PNG + +الخطوة الأخيرة تكتب الرمز المُولد إلى القرص. PNG يحافظ على أبعاد البكسل الدقيقة وهو مدعوم على نطاق واسع من قبل أجهزة المسح. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +استبدل `YOUR_DIRECTORY` بمسار مطلق أو نسبي يمكن للعملية المنفذة الكتابة إليه. التعداد `BarCodeImageFormat.Png` يضمن إخراجًا بدون فقد. + +**لماذا PNG؟** – تنسيقات الرسوم النقطية مثل PNG تحافظ على حواف الوحدات حادة، وهو أمر أساسي للماسحات التي تعتمد على حواف عالية التباين. إذا كنت بحاجة إلى تنسيق متجه، تدعم Aspose أيضًا `Pdf` و `Svg`. + +## مثال كامل قابل للتنفيذ + +فيما يلي البرنامج الكامل الذي يمكنك نسخه إلى تطبيق كونسول. يتضمن توجيهات `using` اللازمة وطريقة `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### النتيجة المتوقعة + +تشغيل البرنامج ينشئ ملفًا باسم **MacroPdf417.png** في دليل العمل الخاص بالمشروع. فتح الصورة يظهر باركود PDF417 مدمج مع الحقول الماكرو المضمنة. مسح الصورة باستخدام قارئ متوافق مع PDF417 (مثل ZXing أو Aspose.BarCode decoder) يُعيد الحمولة الأصلية `"Sample text"` مع بيانات الماكرو الوصفية. + +## أسئلة شائعة وحلول المشكلات + +| السؤال | الجواب | +|----------|--------| +| *ماذا لو كان الباركود كبيرًا جدًا بالنسبة للملصق المستهدف؟* | قلل `XDimension.Pixels` أو زد `Pdf417.Columns`. كلا المعاملين يؤثران على الحجم الكلي. | +| *هل يمكنني إنشاء صورة متجهة بدلاً من PNG؟* | نعم. استدعِ `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` للحصول على إخراج قابل للتوسيع. | +| *كيف يمكنني التحقق من checksum بعد المسح؟* | يقوم محلل Aspose.BarCode تلقائيًا بالتحقق من `MacroPdf417Checksum` ويبلغ عن الاختلافات في كائن `MacroPdf417Result`. | +| *هل المكتبة متوافقة مع .NET Core؟* | حزمة NuGet تدعم .NET Standard 2.0+، والتي تغطي .NET Core، .NET 5، .NET 6، وما بعده. | +| *ماذا لو احتجت إلى تضمين بيانات ثنائية بدلاً من نص؟* | حوّل الحمولة الثنائية إلى Base64 أو استخدم التحميل الزائد `EncodeTypes.MacroPdf417` الذي يقبل مصفوفة بايت. | + +## نصائح احترافية للاستخدام في الإنتاج + +* **Cache the generator** – + +## ما الذي يجب أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مورد يتضمن أمثلة شفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء باركود – PDF417 مدمج باستخدام Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [كيفية قراءة باركود من PDF في Java باستخدام Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [إنشاء باركود Codabar باستخدام Aspose.Barcode – واجهة المولد والقارئ](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/net/compact-pdf417-encoding/_index.md b/barcode/chinese/net/compact-pdf417-encoding/_index.md index af7bfe348..4e9ca6507 100644 --- a/barcode/chinese/net/compact-pdf417-encoding/_index.md +++ b/barcode/chinese/net/compact-pdf417-encoding/_index.md @@ -142,6 +142,12 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); ### [创建紧凑型 PDF417 条形码](./compact-pdf417-basic-configuration/) 了解如何使用 Aspose.BarCode for .NET 生成紧凑型 PDF417 条形码。提供完整的分步指南和代码示例。 +### [如何在 C# 中生成 PDF417 条形码并设置条形码大小](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +演示在 C# 使用 Aspose.BarCode 生成 PDF417 条形码并自定义尺寸。 + +### [如何在 C# 中创建微型 PDF417 条形码 – 步骤指南](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +提供在 C# 使用 Aspose.BarCode 生成微型 PDF417 条形码的完整步骤和代码示例。 + ## 常见问题解答 **问：在紧凑型 PDF417 条形码中，我可以存储的最大数据量是多少？** @@ -170,6 +176,9 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); - [如何使用 Aspose.BarCode 创建紧凑型 PDF417 条形码](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [Aspose.BarCode for .NET 的综合教程和示例](/barcode/net/) - [如何在 .NET 中创建带错误纠正的 Aztec 条形码](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) +- [如何使用 C# 条形码生成器生成宏 PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [如何在 C# 中读取 PDF417 条形码 – 完整指南](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +- [如何在 C# 中创建 PDF417 条形码并保存为 PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/chinese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/chinese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..da4bb6833 --- /dev/null +++ b/barcode/chinese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,211 @@ +--- +category: general +date: 2026-08-22 +description: 学习如何在 C# 中创建微型 PDF417 条码并生成条码 PNG 图像。包括设置条码尺寸和保存文件。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: zh +lastmod: 2026-08-22 +og_description: 在 C# 中创建微型 PDF417 条码并导出为 PNG。按照本指南设置条码尺寸，快速生成条码图像。 +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: 在 C# 中创建微型 PDF417 条码 – 完整编码教程 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: 如何在 C# 中创建微型 PDF417 条码 – 步骤指南 +url: /zh/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中创建微型 PDF417 条码 – 步骤指南 + +如果您需要为票务系统、库存标签或移动扫描 **创建微型 PDF417 条码**，本教程将为您详细演示。您将看到完整的 C# 程序生成条码 PNG，学习如何设置条码尺寸，并了解每个配置选项。 + +阅读完本指南后，您将能够生成高分辨率的条码图像，自定义 X 维度，选择列数，并将结果保存为 PNG 文件——只需几行代码。 + +## 您需要的条件 + +- .NET 6.0 SDK 或更高版本（代码兼容 .NET Core 和 .NET Framework） +- Visual Studio 2022 或任何支持 C# 的 IDE +- **Aspose.BarCode for .NET** NuGet 包（或任何支持 `EncodeTypes.MicroPdf417` 的库） +- 对 C# 语法的基本了解 + +> **专业提示：** Aspose.BarCode 的免费社区版已足以用于开发和测试。生产环境请获取许可证以去除评估水印。 + +## 第一步：安装条码库 + +在项目文件夹中打开终端并运行： + +```bash +dotnet add package Aspose.BarCode +``` + +此操作会添加 `Aspose.BarCode` 程序集，提供用于 **创建条码图像 C#** 应用的 `BarcodeGenerator` 类。 + +## 第二步：初始化生成器 – 创建微型 PDF417 条码 + +第一行可执行代码会创建一个针对 Micro PDF417 符号的 `BarcodeGenerator` 实例，并提供要编码的数据。 + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*为何重要*：`EncodeTypes.MicroPdf417` 枚举指示库使用 PDF417 的紧凑版本，非常适合小标签和移动屏幕。 + +## 第三步：如何在 C# 中设置条码尺寸 + +微调模块宽度（X 维度）可控制条码的视觉密度。较小的数值会产生更清晰的图像，而较大的数值则使条码在远距离下更易于扫描。 + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **为何需要设置尺寸**：如果不调整 X 维度，默认值在高 DPI 渲染时可能导致条码模糊。将其设为 2 像素是大多数基于屏幕的扫描的良好平衡。 + +## 第四步：选择列数 – 控制条码宽度 + +Micro PDF417 支持 1 到 4 列。列数越多，数据在水平方向上压缩越多，从而减小整体图像宽度。 + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*边缘情况*：如果请求 5 列，库会抛出 `ArgumentOutOfRangeException`。请始终保持在文档规定的范围内。 + +## 第五步：如何生成条码 PNG – 保存图像 + +现在您可以将生成的条码导出为 PNG 文件。PNG 保持无损质量，这对可靠扫描至关重要。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +运行程序后，您会在控制台看到确认文件位置的消息。生成的 `MicroPdf417.png` 如下所示： + +![显示使用 C# 创建的生成的微型 PDF417 条码的截图](micro-pdf417-example.png "生成的微型 PDF417 条码") + +*图片替代文字*：**使用 C# 生成的微型 PDF417 条码** – 展示了应用尺寸和列设置后的最终输出。 + +## 第六步：运行并验证输出 + +1. 构建项目：`dotnet build`。 +2. 执行：`dotnet run`。 +3. 在桌面上打开 `MicroPdf417.png` 并使用移动条码扫描应用进行扫描。 + +您应该看到解码后的文本 **“Sample text”**。如果扫描器报错，请再次检查 X 维度和列数——极端值可能导致条码对某些设备过于密集。 + +## 常见变体和故障排除 + +| 情况 | 调整 | +|-----------|------------| +| **需要更大的条码以适配低分辨率打印机** | 将 `XDimension.Pixels` 增加到 3 或 4。 | +| **希望在不改变宽度的情况下获得更高的条码** | 设置 `generator.Parameters.Barcode.Pdf417.Rows`（行范围 3‑90）。 | +| **在循环中生成多个条码** | 重复使用同一个 `BarcodeGenerator` 实例，并在每次 `Save` 前仅更改 `CodeText`。 | +| **保存为 JPEG 而非 PNG** | 将 `BarCodeImageFormat.Png` 替换为 `BarCodeImageFormat.Jpeg`。 | +| **在 .NET Framework 4.7 上运行** | 相同代码可工作；只需引用相应的 `Aspose.BarCode.dll`。 | + +## 完整源码列表（可运行） + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**预期输出** – 一个 200 × 100 像素的 PNG 文件，包含清晰的 Micro PDF417 条码，解码后为 “Sample text”。 + +## 结论 + +您现在已经了解如何在 C# 中 **创建微型 PDF417 条码**、**设置条码尺寸**，以及 **生成条码 PNG** 图像。完整示例演示了从库安装到保存最终文件的每一步，帮助您将条码生成直接嵌入自己的应用程序中。 + +接下来，您可以探索相关主题，例如 **使用 Aspose.BarCode 创建 QR 码**、**自定义颜色**，或 **在 PDF 文档中嵌入条码**。这些都基于本文中介绍的相同 `BarcodeGenerator` 基础。 + +欢迎尝试不同的数据字符串、列数和 X 维度值，以适配您的特定扫描环境。祝编码愉快！ + +## 接下来您应该学习什么？ + +以下教程涵盖与本指南紧密相关的主题，基于本教程演示的技术。每个资源都包含完整的可运行代码示例和逐步说明，帮助您掌握更多 API 功能并在项目中探索替代实现方案。 + +- [如何使用 Aspose.BarCode 创建条码 – 紧凑型 PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何生成 PDF417 条码 – 紧凑型 PDF417 编码](/barcode/english/net/compact-pdf417-encoding/) +- [如何使用 Aspose.BarCode for .NET 创建 Aztec 条码](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/chinese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..93598fcf0 --- /dev/null +++ b/barcode/chinese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,196 @@ +--- +category: general +date: 2026-08-22 +description: 学习如何使用条码生成器在 C# 中创建 PDF417 条码，设置布局并保存为 PNG。包括完整代码和条码生成器 C# 项目的技巧。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: zh +lastmod: 2026-08-22 +og_description: 使用条码生成器在 C# 中创建 PDF417 条码，自定义布局，并学习如何保存 PNG。请按照此分步教程操作。 +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: 在 C# 中创建 PDF417 条码 – 生成并保存 PNG 的完整指南 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: 如何在 C# 中创建 PDF417 条形码并保存为 PNG +url: /zh/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中创建 PDF417 条形码并保存为 PNG + +如果您需要在 C# 应用程序中**创建 PDF417 条形码**，本教程将向您展示具体步骤。您将看到条形码生成器 C# 库如何将任意字符串转换为可扫描的 PDF417 图像，以及如何在无需额外工具的情况下保存 PNG 文件。 + +在物流、票务和文档管理等领域，生成条形码非常常见。阅读完本指南后，您将拥有一个可运行的控制台程序，它会在您指定的文件夹中生成名为 `Pdf417Layout.png` 的 PNG 文件。 + +## 前提条件 + +- .NET 6.0 SDK 或更高版本已安装（代码同样适用于 .NET Framework 4.7+）。 +- Visual Studio 2022 或任何能够构建 C# 项目的编辑器。 +- **Aspose.BarCode for .NET** NuGet 包（或任何兼容的条形码生成器 C# 库）。 + 使用以下方式安装： + +```bash +dotnet add package Aspose.BarCode +``` + +不需要额外的图像处理库，因为生成器可以直接写入 PNG。 + +## 第一步：创建新的控制台项目 + +创建一个全新的控制台项目，以确保示例是自包含的。 + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` 文件夹现在包含一个 `Program.cs` 文件，我们将在其中编写条形码代码。 + +## 第二步：导入条形码命名空间 + +打开 `Program.cs` 并在顶部添加所需的 `using` 指令： + +```csharp +using Aspose.BarCode.Generation; +``` + +此命名空间让您能够访问 `BarcodeGenerator`、`EncodeTypes` 以及用于**如何保存 PNG**的图像格式枚举。 + +## 第三步：创建 PDF417 条形码生成器 + +**如何生成 PDF417** 的核心是 `BarcodeGenerator` 类。传入编码类型 `EncodeTypes.Pdf417` 和您想要编码的文本。 + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` 现在保存了条形码的所有设置。默认布局可以工作，但我们将在下一步进行自定义。 + +## 第四步：定义条形码布局（列和行） + +PDF417 允许您控制列数（2‑30）和行数（1‑90）。调整这些数值可以提升特定扫描仪的可读性。 + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **技巧提示：** 如果省略这些设置，库会自动选择最佳值。不过，固定列数和行数可以让图像尺寸可预测，这在将 PNG 嵌入 PDF 或 UI 布局时非常有用。 + +## 第五步：将生成的条形码保存为 PNG 图像 + +现在通过调用 `Save` 来实现**如何保存 PNG**。该方法接受目标路径和图像格式枚举。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +运行程序后，文件 `Pdf417Layout.png` 会出现在项目的 `bin/Debug/net6.0` 文件夹中。 + +## 完整可运行示例 + +下面是完整的 `Program.cs` 文件。将其复制到 **第 1 步** 创建的项目中，然后运行 `dotnet run`。 + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### 预期输出 + +运行程序后，控制台会打印 PNG 文件的绝对路径，文件中包含一个清晰的 PDF417 条形码，外观类似下图。 + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +您可以使用任何兼容 PDF417 的扫描器（移动应用、硬件阅读器）扫描该 PNG，以验证编码文本为 `"Sample"`。 + +## 处理边缘情况和常见陷阱 + +| 情况 | 需要注意的点 | 推荐的解决方案 | +|-----------|-------------------|-----------------| +| **列/行值无效** | 超出 2‑30（列）或 1‑90（行）范围的值会导致 `ArgumentException`。 | 在赋值前验证用户输入，或让库自行选择默认值。 | +| **输入字符串过长** | PDF417 最多可编码 1,850 个字符，但过长的字符串会显著增加所需的行数。 | 将数据拆分为多个条形码，或在需要时使用更高的错误纠正级别。 | +| **文件系统权限** | 保存到只读文件夹会抛出 `UnauthorizedAccessException`。 | 写入 `Environment.CurrentDirectory` 或用户可写路径，并使用 try/catch 处理异常。 | +| **缺少 NuGet 包** | 编译时出现 “type or namespace name could not be found” 错误。 | 确保已安装 `Aspose.BarCode`（`dotnet add package Aspose.BarCode`）。 | + +## 扩展示例 + +既然您已经了解了**如何创建 PDF417 条形码**和**如何保存 PNG**，可以进一步探索以下相关主题： + +- **Barcode generator C#**：将 `EncodeTypes` 更改为 `Code128`、`QR` 或其他符号集。 +- **自定义颜色**：使用 `generator.Parameters.Barcode.ForegroundColor` 和 `BackgroundColor` 来匹配品牌颜色。 +- **嵌入 PDF**：将 PNG 与 PDF 库（例如 iText7）结合，生成可打印的文档。 +- **动态数据**：从数据库或用户输入获取文本，实时生成条形码。 + +## 结论 + +现在，您已经拥有一个完整的、可投入生产的解决方案，可在 C# 中**创建 PDF417 条形码**并将结果保存为 PNG 文件。教程涵盖了从项目设置到布局自定义的每一步，并强调了使用条形码生成器 C# 库时如何避免常见错误。 + +欢迎尝试不同的列/行设置、颜色，甚至其他条形码格式。如果遇到任何问题，请重新查看**如何生成 PDF417**章节或查阅库的文档以了解高级功能。祝编码愉快！ + +## 接下来您应该学习什么？ + +以下教程涵盖与本指南紧密相关的主题，基于本教程展示的技术。每个资源都包含完整的可运行代码示例和逐步说明，帮助您掌握更多 API 功能并在项目中探索替代实现方案。 + +- [如何使用 Aspose.BarCode 创建条形码 – 紧凑型 PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何生成 PDF417 条形码 – 紧凑型 PDF417 编码](/barcode/english/net/compact-pdf417-encoding/) +- [如何使用 Aspose.BarCode for .NET 为 ITF-14 创建条形码安静区](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/chinese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..334afa3f0 --- /dev/null +++ b/barcode/chinese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-08-22 +description: 学习如何使用 Aspose.BarCode 在 C# 中生成 PDF417 条形码，设置条形码尺寸，调整列数，并启用紧凑模式。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: zh +lastmod: 2026-08-22 +og_description: 使用 Aspose.BarCode 在 C# 中生成 PDF417 条码。本指南展示如何设置条码尺寸、控制列数以及启用紧凑模式以获得更小的图像。 +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: 在 C# 中生成 PDF417 条码 – 设置尺寸、列数和紧凑模式 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: 如何在 C# 中生成 PDF417 条码并设置条码尺寸 +url: /zh/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中生成 PDF417 条码并设置条码尺寸 + +如果您需要在 .NET 应用程序中 **生成 PDF417 条码**，本指南将带您完成整个过程。您将看到如何使用 Aspose.BarCode **生成 PDF417**，调整 **设置条码尺寸**，并生成可嵌入报告或移动应用的紧凑 PNG。 + +创建条码不需要单独的图形编辑器。完成本教程后，您将拥有一个完整的 C# 方法，能够生成具有精确尺寸的 PDF417 图像，随时用于后续处理。 + +## 您将学习 + +* 安装并引用 Aspose.BarCode 库。 +* 创建 PDF417 条码生成器并指定要编码的文本。 +* **设置条码尺寸**，通过配置 X‑dimension 和列数。 +* 启用紧凑（截断）模式以缩小符号。 +* 将结果保存为 PNG 文件。 +* 排查常见问题，例如代码不可读和图像过大。 + +### 前置条件 + +* .NET 6.0 或更高版本（该 API 也支持 .NET Framework 4.6+）。 +* 具备 C# 和 Visual Studio（或任何 C# IDE）的基本使用经验。 +* 有效的 Aspose.BarCode 许可证（免费评估版可用于测试）。 + +> **专业提示：** 如果您计划在循环中生成大量条码，请复用同一个 `BarcodeGenerator` 实例，仅更改 `CodeText` 属性。这可以减少内存分配。 + +## 使用 Aspose.BarCode 生成 PDF417 条码 + +第一步是实例化用于 PDF417 符号的 `BarcodeGenerator`。该对象是所有条码操作的入口。 + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*这点为何重要*：`EncodeTypes.Pdf417` 告诉库使用 PDF417 标准，它支持大容量数据和错误纠正。构造函数还接受要编码的数据，省去了后续单独设置 `CodeText` 的步骤。 + +## 设置条码尺寸和列数 + +PDF417 符号由行和列组成，每个小矩形模块。控制模块宽度（X‑dimension）和列数可以微调整体尺寸。 + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*说明*： +* **X‑dimension**（`Pixels`）决定每个模块的宽度。较小的值会生成更紧凑的条码，而较大的值在低分辨率扫描仪上提升可读性。 +* **Columns** 控制水平布局。列数少时条码更高，列数多时条码更宽。将这两个设置一起调整，以实现您需要的精确 **设置条码尺寸**。 + +## 启用紧凑模式以获得更小的条码 + +PDF417 包含一种 “紧凑”（或截断）模式，可去除不必要的填充并降低整体占用空间。这在屏幕空间受限时尤为有用。 + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*为何启用截断？* +当 `Truncate` 为 `true` 时，生成器会省略停止模式和一些在大多数扫描场景中不必需的错误纠正码字。生成的图像大约缩小 15‑20 %，且在典型使用情况下不影响数据完整性。 + +## 将条码保存为 PNG 图像 + +在配置尺寸和模式后，将条码写入磁盘。PNG 为无损格式，确保模块边缘保持清晰。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +文件 `CompactPdf417.png` 将包含一个清晰的 PDF417 符号，其尺寸与前面步骤中设置的相匹配。 + +### 预期输出 + +打开保存的 PNG 应显示一个垂直方向的 PDF417 条码，包含三列，每个模块宽度为 2 px，总尺寸约为 **120 × 240 px**（宽 × 高）。使用任何标准 PDF417 读取器扫描该图像会返回原始文本 “Sample text for PDF417”。 + +## 常见陷阱及避免方法 + +| 症状 | 可能原因 | 解决方案 | +|------|----------|----------| +| 条码不可读 | X‑dimension 对扫描仪来说太小 | 将 `XDimension.Pixels` 增加到 3 或 4 | +| 图像宽度超出 UI | 列数设置过多 | 减少 `Pdf417.Columns` 或启用 `Truncate` | +| 异常 `ArgumentOutOfRangeException` | 列数为负或零 | 确保 `Columns` 为正整数（最小 1） | +| PNG 文件为空 | 输出路径不存在或没有写入权限 | 验证目录是否存在且应用具有写入权限 | + +> **专业提示：** 在调用 `Save()` 之前使用 `barcodeGenerator.ValidateParameters()`，可提前捕获配置错误。 + +## 完整、可运行的示例 + +下面是一个独立的控制台程序，包含上述所有步骤。将其复制到新的 C# 项目中，恢复 Aspose.BarCode NuGet 包，然后运行即可看到结果。 + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**运行程序** 会在可执行文件的工作目录生成 `CompactPdf417.png`。使用移动应用（例如 “Barcode Scanner”）扫描该图像，以验证编码文本与源字符串匹配。 + +## 后续步骤及相关主题 + +* **提升错误纠正级别** – 为噪声较大的扫描环境调整 `Pdf417.ErrorLevel`。 +* **更改方向** – 如需水平布局，将 `Pdf417.Rotate` 设置为 `RotationAngle.Rotate90`。 +* **在 PDF 中嵌入条码** – 将 Aspose.PDF 与 Aspose.BarCode 结合，将图像直接放入文档。 +* **生成其他 2‑D 条码** – 同一 `BarcodeGenerator` 类支持 DataMatrix、QR 和 Aztec 码；只需将 `EncodeTypes.Pdf417` 替换为所需的符号。 + +通过掌握 **生成 PDF417 条码** 技巧，您可以在各种 .NET 应用中实现票务自动化、库存标签以及安全的数据传输。 + +## 结论 + +您现在已经了解如何在 C# 中 **生成 PDF417 条码**，精确 **设置条码尺寸**，配置列数，启用紧凑模式，并将结果保存为 PNG。将这些设置应用于任何 UI 限制或扫描需求，并根据需要将方法扩展到其他条码格式。祝编码愉快！ + +## 接下来您应该学习什么？ + +以下教程涵盖与本指南技术密切相关的主题。每个资源都包含完整的可运行代码示例和逐步说明，帮助您掌握更多 API 功能并在项目中探索替代实现方法。 + +- [如何生成 PDF417 条码 – 紧凑 PDF417 编码](/barcode/english/net/compact-pdf417-encoding/) +- [如何创建条码 – 使用 Aspose.BarCode 的紧凑 PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何使用 Aspose.BarCode for .NET 生成 DataMatrix 条码 – 步骤指南](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/chinese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..09c088989 --- /dev/null +++ b/barcode/chinese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,230 @@ +--- +category: general +date: 2026-08-22 +description: 如何在 C# 中读取 PDF417 条码的分步指南，包括如何从图像中读取多个条码并提取 MacroPdf417 详细信息。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: zh +lastmod: 2026-08-22 +og_description: 如何在 C# 中快速读取 PDF417 条码。本教程展示了如何从图像中读取多个条码并获取 MacroPdf417 扩展信息。 +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: 如何在 C# 中读取 PDF417 条码 – 完整编程演练 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: 如何在 C# 中读取 PDF417 条形码 – 完整指南 +url: /zh/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中读取 PDF417 条形码 – 完整指南 + +如果您需要在 .NET 应用程序中 **how to read PDF417** 条码，本教程提供了一个可直接运行的解决方案。您将学习如何从单个图像读取多个条码，提取完整的 MacroPdf417 数据集，并在控制台中显示。该方法使用 Aspose.BarCode for .NET 库，仅需几行代码。 + +从图像读取条码是库存系统、票据验证和文档管理中的常见任务。通过本指南，您将能够解码任何 PDF417 或 MacroPdf417 条码，在一张图片中处理多个代码，并了解 MacroPdf417 提供的扩展字段。 + +## Prerequisites + +- .NET 6.0 SDK 或更高版本（代码同样可以在 .NET Framework 4.7+ 上编译） +- Visual Studio 2022 或您喜欢的任何 C# 编辑器 +- Aspose.BarCode for .NET NuGet 包（`Install-Package Aspose.BarCode`） +- 包含 MacroPdf417 条码的示例图像（例如 `MacroPdf417.png`） + +无需额外配置；库内部已处理图像加载和解码。 + +## 如何在 C# 中从图像读取 PDF417 条码 + +解决方案的核心是 `BarCodeReader` 类。它打开图像，检测指定类型的所有条码，并返回 `BarCodeResult` 对象的集合。下面的代码展示了一个完整的控制台程序。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### 为什么每行代码都很重要 + +| 步骤 | 目的 | +|------|------| +| **1️⃣ Initialize** | 创建一个绑定到图像文件的 `BarCodeReader`，并将检测限制在 MacroPdf417 符号上，从而加快处理速度。 | +| **2️⃣ Iterate** | `ReadBarCodes()` 返回 **所有** 与请求类型匹配的条码，使您能够 **read multiple barcodes** 而无需额外循环。 | +| **3️⃣ Basic output** | 显示通用的 `CodeTypeName` 和可读的 `CodeText`。这对于日志记录或快速验证非常有用。 | +| **4️⃣ Extended data** | MacroPdf417 包含额外的元数据（文件 ID、段计数、时间戳等）。`Extended.Pdf417` 对象直接公开每个字段，便于存储或验证完整的数据包。 | + +将程序运行在有效的 MacroPdf417 图像上会产生类似以下的控制台输出： + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +输出确认库成功读取了条码，提取了文本，并提供了每个 MacroPdf417 字段。 + +## 从单张图像读取多个条码 + +许多实际场景会在同一标签上放置多个 PDF417 符号——比如包含承运人代码、跟踪号码和海关申报的装运清单。上面的代码块已经 **read multiple barcodes**，因为 `ReadBarCodes()` 返回所有匹配项的可枚举集合。无需额外配置；只需像示例中那样遍历结果即可。 + +如果希望将读取器限制为标准 PDF417（非宏）同时仍处理多个代码，只需将 `DecodeType.MacroPdf417` 替换为 `DecodeType.Pdf417`。其余逻辑保持不变。 + +## 理解 MacroPdf417 扩展数据 + +MacroPdf417 是常规 PDF417 规范的扩展。它将大负载拆分为多个段，并添加一个小标题来描述整个文件。最相关的字段包括： + +- **MacroPdf417FileID** – 所有同一文件段共享的唯一标识符。 +- **MacroPdf417SegmentID** – 当前段的序号。 +- **MacroPdf417SegmentsCount** – 预期的总段数。 +- **MacroPdf417FileName** – 随条码传输的可选文件名。 +- **MacroPdf417Checksum** – 整个文件的错误检查值。 +- **MacroPdf417FileSize** – 原始二进制负载的大小。 +- **MacroPdf417TimeStamp** – 条码生成时的 ISO‑8601 时间戳。 +- **MacroPdf417Addressee / Sender** – 用于路由的可选文本字段。 +- **MacroPdf417Terminator** – 指示该段是否为最后一段。 + +当收到所有段后，您可以通过 `MacroPdf417SegmentID` 对段进行排序，并将 `CodeText` 值拼接起来，以重建原始文件。只要拥有这些字段，实现逻辑相当直接。 + +## 常见陷阱与专业技巧 + +- **图像质量很重要** – 低分辨率或高度压缩的 PNG/JPEG 文件可能导致检测遗漏。打印条码时请使用至少 300 dpi 的分辨率。 +- **混合符号** – 如果图像同时包含 MacroPdf417 和普通 PDF417，可实例化两个读取器（分别对应各自的 `DecodeType`），或使用 `DecodeType.AllSupported` 并通过 `result.CodeTypeName` 过滤结果。 +- **内存使用** – `using` 语句会及时释放 `BarCodeReader`，防止大型图像缓冲区长时间占用内存。 +- **线程安全** – `BarCodeReader` 不是线程安全的。如果并行解码图像，请为每个线程创建单独实例。 +- **错误处理** – 将 `ReadBarCodes()` 调用包装在 try/catch 块中，以捕获 `BarCodeException`，处理损坏的图像。 + +## 完整工作示例回顾 + +下面是完整的程序代码，您可以复制到新的控制台项目中。它包含所有 `using` 指令、图像路径常量以及释放模式。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +使用 `dotnet build` 编译，使用 `dotnet run` 运行。控制台会打印每个条码的基本数据以及完整的 MacroPdf417 负载。 + +## 下一步 + +- **Reconstruct multipart files** – collect all segments, sort by `MacroPdf417SegmentID`, and concatenate `CodeText` to + + +## 接下来应该学习什么？ + +以下教程涵盖与本指南技术紧密相关的主题，帮助您进一步掌握 API 功能并在项目中探索替代实现方案。每个资源都提供完整的可运行代码示例和逐步解释。 + +- [如何生成 PDF417 条码 – 紧凑 PDF417 编码](/barcode/english/net/compact-pdf417-encoding/) +- [如何在 Java 中读取带有土耳其字符的 PDF417 条码](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [如何在 Java 中使用 Aspose 读取 PDF417 条码（中文）](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/chinese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..429a1d01e --- /dev/null +++ b/barcode/chinese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,224 @@ +--- +category: general +date: 2026-08-22 +description: 条形码生成器 C# 教程展示了如何使用 Aspose.BarCode 创建带元数据的 Macro PDF417 条码并将其保存为 PNG。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: zh +lastmod: 2026-08-22 +og_description: barcode generator C# 让您生成带有完整文件级元数据的 Macro PDF417 条码，并将其导出为 PNG。请按照本指南实现该解决方案。 +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: 条码生成器 C# – 逐步创建 Macro PDF417 条码 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: 如何在 C# 中使用条码生成器生成 Macro PDF417 +url: /zh/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中使用条码生成器生成 Macro PDF417 + +如果您需要一个 **barcode generator C#** 能够生成带有文件级元数据的 Macro PDF417 符号，本指南提供了完整、可直接运行的解决方案。您将看到如何配置条码外观、嵌入文件 ID、段计数等宏信息，最后将结果保存为 PNG 图像。 + +示例使用 Aspose.BarCode 库，这是一款广泛采用的 **C# barcode library**，支持完整的 PDF417 功能集。无需外部服务，代码可在 .NET 6 或更高版本上运行。 + +## 前置条件 + +开始之前，请确保您拥有： + +* 已安装 .NET 6 SDK（或更高版本）。 +* Visual Studio 2022、VS Code 或其他 C# IDE。 +* 对 **Aspose.BarCode** 的 NuGet 引用（`dotnet add package Aspose.BarCode`）。 + +了解基本的 C# 语法以及 PDF417 条码的概念会帮助您更好地跟随步骤，但本教程会详细解释每个配置选项。 + +## 本教程涵盖内容 + +* 为 Macro PDF417 格式初始化 **barcode generator C#** 实例。 +* 调整视觉参数，如 X‑dimension 和列数。 +* 提供 Macro PDF417 文件级字段：文件 ID、段 ID、段计数、文件名、校验和、文件大小、时间戳、收件人、发送人以及终止符。 +* 将生成的符号保存为 PNG 文件。 +* 处理大文件尺寸或自定义时间戳等边缘情况的技巧。 + +阅读完本文后，您将拥有一个独立的程序，能够生成完全符合规范的 Macro PDF417 条码。 + +## 步骤 1：创建 barcode generator C# 实例 + +第一步是使用 `EncodeTypes.MacroPdf417` 枚举值和要编码的文本实例化 `BarcodeGenerator`。构造函数同样接受负载字符串，该字符串将成为宏条码的数据部分。 + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**为什么重要** – `EncodeTypes.MacroPdf417` 标志告诉 Aspose.BarCode 将符号视为宏条码，从而启用后续的额外字段。如果没有此标志，库将只生成普通的 PDF417 条码，缺少文件级元数据。 + +## 步骤 2：调整基本条码外观（PDF417 可视设置） + +视觉清晰度对可靠扫描至关重要。两个常用参数是模块宽度（`XDimension`）和列数。设置这些值可以在尺寸和可读性之间取得平衡。 + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` 控制每根黑/白条的宽度。**2** 的取值在大多数标签打印机上表现良好。 +* `Pdf417.Columns` 定义条码使用的列数。五列可以在不牺牲数据容量的前提下生成紧凑的符号。 + +## 步骤 3：定义 Macro PDF417 文件级信息 + +Macro PDF417 在标准 PDF417 基础上增加了描述大文件如何在多个条码段中拆分的字段。提供这些字段可确保下游扫描器能够重建原始文件。 + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` 必须在同一逻辑文件的所有段中保持相同。 +* `MacroPdf417SegmentID` 从 **0** 开始递增至 `SegmentsCount‑1`。 +* `MacroPdf417SegmentsCount` 告诉解码器期望的段数。 +* `MacroPdf417FileName` 为可选项，但有助于人工识别。 + +## 步骤 4：设置额外的宏元数据 + +除了核心文件信息外，规范还允许添加校验和、文件大小、时间戳、收件人、发送人以及终止符等字段。填充这些字段可以提升数据完整性和可追溯性。 + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` 为整个文件提供 16 位 CCITT 校验和；解码器在重建后可验证完整性。 +* `MacroPdf417FileSize` 应反映原始文件的精确字节数；超过 `2^31‑1` 的值需要 64 位字段，Aspose 会自动处理。 +* `MacroPdf417TimeStamp` 记录条码生成的时间。使用 UTC 可避免时区歧义。 +* `MacroPdf417Addressee` 与 `MacroPdf417Sender` 为自由格式字符串，可存储路由信息。 +* `MacroPdf417Terminator` 表示这是最后一个段；在最后一段时设为 `Set`，否则保持默认 (`NotSet`)。 + +**边缘情况提示** – 如果文件大小超过 4 GB，请将内容拆分为多个宏段，并相应调整 `SegmentsCount`。库会在不溢出的情况下管理大尺寸字段。 + +## 步骤 5：将条码保存为 PNG 图像 + +最后一步将生成的符号写入磁盘。PNG 能保留精确的像素尺寸，并被扫描硬件广泛支持。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +将 `YOUR_DIRECTORY` 替换为执行进程有写入权限的绝对或相对路径。`BarCodeImageFormat.Png` 枚举确保无损输出。 + +**为什么选 PNG？** – PNG 等光栅格式能够保持模块边缘的锐利，这对依赖高对比度边缘的扫描仪至关重要。如果需要矢量格式，Aspose 也支持 `Pdf` 与 `Svg`。 + +## 完整可运行示例 + +下面是可以直接复制到控制台应用程序中的完整程序。它包含必要的 `using` 指令和 `Main` 方法。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### 预期输出 + +运行程序后会在项目工作目录生成名为 **MacroPdf417.png** 的文件。打开该图像可看到一个带有嵌入宏字段的紧凑 PDF417 条码。使用兼容 PDF417 的读取器（如 ZXing、Aspose.BarCode 解码器）扫描图像，可返回原始的 `"Sample text"` 负载以及宏元数据。 + +## 常见问题与故障排除 + +| Question | Answer | +|----------|--------| +| *What if the barcode is too large for the target label?* | Reduce `XDimension.Pixels` or increase `Pdf417.Columns`. Both parameters affect overall size. | +| *Can I generate a vector image instead of PNG?* | Yes. Call `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` for scalable output. | +| *How do I verify the checksum after scanning?* | The Aspose.BarCode decoder automatically validates `MacroPdf417Checksum` and reports mismatches in the `MacroPdf417Result` object. | +| *Is the library compatible with .NET Core?* | The NuGet package supports .NET Standard 2.0+, which covers .NET Core, .NET 5, .NET 6, and later. | +| *What if I need to embed binary data instead of text?* | Convert the binary payload to Base64 or use the `EncodeTypes.MacroPdf417` overload that accepts a byte array. | + +## 生产环境使用的专业技巧 + +* **Cache the generator** – + + +## 接下来该学习什么？ + +以下教程涵盖与本指南技术紧密相关的主题，帮助您在项目中进一步掌握 API 功能并探索替代实现方式。每个资源均提供完整的可运行代码示例和逐步说明。 + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/net/compact-pdf417-encoding/_index.md b/barcode/czech/net/compact-pdf417-encoding/_index.md index 3df513359..e1007b4c6 100644 --- a/barcode/czech/net/compact-pdf417-encoding/_index.md +++ b/barcode/czech/net/compact-pdf417-encoding/_index.md @@ -142,6 +142,21 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); ### [Vytváření Compact PDF417 čárových kódů](./compact-pdf417-basic-configuration/) Learn how to generate Compact PDF417 barcodes using Aspose.BarCode for .NET. Comprehensive guide with step‑by‑step instructions and code examples. +### [Jak generovat PDF417 čárový kód v C# a nastavit velikost čárového kódu](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +Naučte se generovat PDF417 čárový kód v C# a upravit jeho velikost pomocí Aspose.BarCode. + +### [Jak vytvořit PDF417 čárový kód v C# a uložit jej jako PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Naučte se generovat PDF417 čárový kód v C# a uložit jej jako PNG soubor pomocí Aspose.BarCode. + +### [Jak vytvořit micro PDF417 čárový kód v C# – krok za krokem](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Podrobný průvodce vytvářením micro PDF417 čárových kódů v C# pomocí Aspose.BarCode. + +### [Jak použít generátor čárových kódů v C# pro Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Naučte se, jak pomocí Aspose.BarCode v C# generovat Macro PDF417 čárové kódy. + +### [Jak číst PDF417 čárové kódy v C# – kompletní průvodce](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Kompletní návod, jak pomocí Aspose.BarCode v C# načíst a dekódovat PDF417 čárové kódy. + ## Často kladené otázky **Q: Jaké je maximální množství dat, která mohu uložit do Compact PDF417 čárového kódu?** diff --git a/barcode/czech/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/czech/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..25704e5e3 --- /dev/null +++ b/barcode/czech/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-08-22 +description: Naučte se, jak vytvořit mikro PDF417 čárový kód v C# a vygenerovat PNG + obrázek čárového kódu. Zahrnuje nastavení rozměrů čárového kódu a uložení souboru. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: cs +lastmod: 2026-08-22 +og_description: Vytvořte mikro PDF417 čárový kód v C# a exportujte jej jako PNG. Postupujte + podle tohoto návodu, abyste nastavili rozměry čárového kódu a rychle vygenerovali + obrázek čárového kódu. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Vytvořte mikro PDF417 čárový kód v C# – kompletní programovací tutoriál +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Jak vytvořit mikro PDF417 čárový kód v C# – krok za krokem průvodce +url: /cs/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak vytvořit mikro PDF417 čárový kód v C# – krok za krokem + +Pokud potřebujete **vytvořit mikro PDF417 čárový kód** pro tiketovací systém, štítek zásob nebo mobilní skenování, tento tutoriál vám ukáže přesně jak. Uvidíte kompletní C# program, který generuje PNG čárového kódu, naučíte se nastavit rozměry kódu a pochopíte každou konfigurační volbu. + +Na konci tohoto průvodce budete schopni vygenerovat vysoce rozlišený obrázek čárového kódu, přizpůsobit X‑rozměr, zvolit počet sloupců a uložit výsledek jako PNG soubor – vše pomocí několika řádků kódu. + +## Co budete potřebovat + +- .NET 6.0 SDK nebo novější (kód funguje s .NET Core i .NET Framework) +- Visual Studio 2022 nebo jakékoli IDE podporující C# +- NuGet balíček **Aspose.BarCode for .NET** (nebo libovolná knihovna, která podporuje `EncodeTypes.MicroPdf417`) +- Základní znalost syntaxe C# + +> **Tip:** Bezplatná komunitní edice Aspose.BarCode stačí pro vývoj a testování. Pro produkční nasazení si pořiďte licenci, která odstraní evaluační vodoznaky. + +## Krok 1: Instalace knihovny pro čárové kódy + +Otevřete terminál ve složce projektu a spusťte: + +```bash +dotnet add package Aspose.BarCode +``` + +Tím se přidá sestavení `Aspose.BarCode`, které poskytuje třídu `BarcodeGenerator` používanou k **vytvoření čárového kódu v C#** aplikacích. + +## Krok 2: Inicializace generátoru – vytvoření mikro PDF417 čárového kódu + +První akční řádek vytvoří instanci `BarcodeGenerator` nakonfigurovanou pro symbologii Micro PDF417 a předá data, která chcete kódovat. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Proč je to důležité*: Výčtový typ `EncodeTypes.MicroPdf417` říká knihovně, aby použila kompaktní verzi PDF417, což je ideální pro malé štítky a mobilní obrazovky. + +## Krok 3: Jak nastavit rozměry čárového kódu v C# + +Doladění šířky modulu (X‑rozměr) řídí vizuální hustotu čárového kódu. Menší hodnota dává ostřejší obrázek, větší hodnota usnadňuje skenování z větší vzdálenosti. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Proč nastavit rozměry**: Bez úpravy X‑rozměru může výchozí hodnota vytvořit čárový kód, který vypadá rozmazaně při vykreslení na vysokém DPI. Hodnota 2 pixely je dobrá rovnováha pro většinu skenování na obrazovce. + +## Krok 4: Výběr počtu sloupců – řízení šířky čárového kódu + +Micro PDF417 umožňuje od 1 do 4 sloupců. Více sloupců data horizontálně komprimuje a snižuje celkovou šířku obrázku. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Hraniční případ*: Pokud požádáte o 5 sloupců, knihovna vyhodí `ArgumentOutOfRangeException`. Vždy se držte dokumentovaného rozsahu. + +## Krok 5: Jak vygenerovat PNG čárového kódu – uložení obrázku + +Nyní můžete exportovat vygenerovaný čárový kód do PNG souboru. PNG zachovává bezztrátovou kvalitu, což je nezbytné pro spolehlivé skenování. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Po spuštění programu uvidíte zprávu v konzoli potvrzující umístění souboru. Výsledný `MicroPdf417.png` vypadá takto: + +![Screenshot showing a generated micro PDF417 barcode created with C#](micro-pdf417-example.png "Generated micro PDF417 barcode") + +*Alternativní text obrázku*: **micro PDF417 barcode generated in C#** – ukazuje finální výstup po aplikaci rozměrů a nastavení sloupců. + +## Krok 6: Spusťte a ověřte výstup + +1. Sestavte projekt: `dotnet build`. +2. Spusťte: `dotnet run`. +3. Otevřete `MicroPdf417.png` na ploše a naskenujte jej pomocí mobilní aplikace pro čtení čárových kódů. + +Měli byste vidět dekódovaný text **„Sample text“**. Pokud skener hlásí chybu, zkontrolujte X‑rozměr a počet sloupců – extrémní hodnoty mohou učinit čárový kód příliš hustým pro některá zařízení. + +## Běžné varianty a řešení problémů + +| Situace | Úprava | +|-----------|------------| +| **Potřeba většího čárového kódu pro nízké rozlišení tiskáren** | Zvyšte `XDimension.Pixels` na 3 nebo 4. | +| **Chcete vyšší čárový kód bez změny šířky** | Nastavte `generator.Parameters.Barcode.Pdf417.Rows` (rozsah řádků 3‑90). | +| **Generování více čárových kódů ve smyčce** | Znovu použijte stejnou instanci `BarcodeGenerator` a před každým `Save` změňte pouze `CodeText`. | +| **Ukládání jako JPEG místo PNG** | Nahraďte `BarCodeImageFormat.Png` za `BarCodeImageFormat.Jpeg`. | +| **Běh na .NET Framework 4.7** | Stejný kód funguje; stačí odkazovat na odpovídající `Aspose.BarCode.dll`. | + +## Kompletní zdrojový kód (spustitelný) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Očekávaný výstup** – PNG soubor o rozměrech 200 × 100 pixelů obsahující ostrý Micro PDF417 čárový kód, který dekóduje „Sample text“. + +## Závěr + +Nyní víte, jak **vytvořit mikro PDF417 čárový kód** v C#, **nastavit rozměry čárového kódu** a **vygenerovat PNG obrázek** čárového kódu. Kompletní příklad demonstruje každý potřebný krok – od instalace knihovny po uložení finálního souboru – takže můžete generování čárových kódů přímo začlenit do svých aplikací. + +Dále prozkoumejte související témata, jako je **vytváření QR kódů s Aspose.BarCode**, **přizpůsobení barev** nebo **vkládání čárových kódů do PDF dokumentů**. Všechna tato témata staví na stejných základech `BarcodeGenerator`, které jsou zde popsány. + +Nebojte se experimentovat s různými řetězci dat, počty sloupců a hodnotami X‑rozměru, aby vyhovovaly vašemu konkrétnímu skenovacímu prostředí. Šťastné programování! + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, aby vám pomohl zvládnout další funkce API a prozkoumat alternativní přístupy ve vlastních projektech. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/czech/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..64e71b281 --- /dev/null +++ b/barcode/czech/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Naučte se, jak vytvořit čárový kód PDF417 v C# pomocí generátoru čárových + kódů, nastavit rozvržení a uložit PNG. Obsahuje kompletní kód a tipy pro projekty + generátoru čárových kódů v C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: cs +lastmod: 2026-08-22 +og_description: Vytvořte čárový kód PDF417 v C# pomocí generátoru čárových kódů, přizpůsobte + rozvržení a naučte se, jak uložit PNG. Postupujte podle tohoto krok‑za‑krokem tutoriálu. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Vytvořte čárový kód PDF417 v C# – kompletní průvodce generováním a ukládáním + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Jak vytvořit čárový kód PDF417 v C# a uložit jej jako PNG +url: /cs/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak vytvořit PDF417 čárový kód v C# a uložit jej jako PNG + +Pokud potřebujete **vytvořit PDF417 čárový kód** v aplikaci C#, tento tutoriál vám ukáže přesné kroky. Uvidíte, jak knihovna pro generování čárových kódů v C# může převést libovolný řetězec na skenovatelný PDF417 obrázek a jak uložit PNG soubory bez dalších nástrojů. + +Generování čárových kódů je běžné v logistice, prodeji vstupenek a správě dokumentů. Na konci tohoto průvodce budete mít spustitelný konzolový program, který vytvoří PNG soubor pojmenovaný `Pdf417Layout.png` ve vámi zvoleném adresáři. + +## Požadavky + +- .NET 6.0 SDK nebo novější nainstalovaný (kód také funguje s .NET Framework 4.7+). +- Visual Studio 2022 nebo jakýkoli editor, který umí sestavit projekty C#. +- Balíček NuGet **Aspose.BarCode for .NET** (nebo jakákoli kompatibilní knihovna pro generování čárových kódů v C#). + Nainstalujte jej pomocí: + +```bash +dotnet add package Aspose.BarCode +``` + +Žádné další knihovny pro zpracování obrázků nejsou potřeba, protože generátor dokáže přímo zapisovat PNG. + +## Krok 1: Vytvořte nový konzolový projekt + +Vytvořte nový konzolový projekt, aby byl příklad samostatný. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Složka `Pdf417Demo` nyní obsahuje soubor `Program.cs`, do kterého napíšeme kód čárového kódu. + +## Krok 2: Naimportujte jmenný prostor čárového kódu + +Otevřete `Program.cs` a přidejte požadovanou direktivu `using` na začátek: + +```csharp +using Aspose.BarCode.Generation; +``` + +Tento jmenný prostor vám poskytuje přístup k `BarcodeGenerator`, `EncodeTypes` a výčtu formátu obrázku potřebnému pro **jak uložit PNG**. + +## Krok 3: Vytvořte generátor PDF417 čárového kódu + +Jádrem **jak generovat PDF417** je třída `BarcodeGenerator`. Předáte typ kódování `EncodeTypes.Pdf417` a text, který chcete zakódovat. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` nyní obsahuje všechna nastavení čárového kódu. Výchozí rozvržení funguje, ale v dalším kroku jej upravíme. + +## Krok 4: Definujte rozvržení čárového kódu (sloupce a řádky) + +PDF417 vám umožňuje řídit počet sloupců (2‑30) a řádků (1‑90). Úprava těchto hodnot může zlepšit čitelnost pro konkrétní skenery. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Tip:** Pokud tyto nastavení vynecháte, knihovna automaticky zvolí optimální hodnoty. Nicméně pevné nastavení sloupců a řádků vám poskytne předvídatelné rozměry obrázku, což je užitečné, když vkládáte PNG do PDF nebo UI rozvržení. + +## Krok 5: Uložte vygenerovaný čárový kód jako PNG obrázek + +Nyní odpovězte na **jak uložit PNG** voláním `Save`. Metoda přijímá cílovou cestu a výčet formátu obrázku. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Soubor `Pdf417Layout.png` se objeví ve složce projektu `bin/Debug/net6.0` po spuštění programu. + +## Kompletní spustitelný příklad + +Níže je kompletní soubor `Program.cs`. Zkopírujte jej do projektu vytvořeného v **Kroku 1** a spusťte `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Očekávaný výstup + +Když spustíte program, konzole vypíše absolutní cestu k PNG souboru a soubor bude obsahovat čistý PDF417 čárový kód, který vypadá podobně jako obrázek níže. + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +PNG můžete naskenovat libovolným PDF417‑kompatibilním skenerem (mobilní aplikace, hardwarové čtečky), abyste ověřili, že zakódovaný text je `"Sample"`. + +## Řešení okrajových případů a běžných úskalí + +| Situace | Na co si dát pozor | Doporučené řešení | +|-----------|-------------------|-----------------| +| **Neplatné hodnoty sloupců/řádků** | Hodnoty mimo rozsah 2‑30 (sloupce) nebo 1‑90 (řádky) způsobí `ArgumentException`. | Ověřte vstup uživatele před přiřazením, nebo nechte knihovnu zvolit výchozí hodnoty. | +| **Dlouhé vstupní řetězce** | PDF417 může kódovat až 1 850 znaků, ale velmi dlouhé řetězce dramaticky zvyšují požadovaný počet řádků. | Rozdělte data do více čárových kódů nebo použijte vyšší úroveň korekce chyb, pokud je to potřeba. | +| **Oprávnění souborového systému** | Ukládání do složky jen pro čtení vyvolá `UnauthorizedAccessException`. | Zapisujte do `Environment.CurrentDirectory` nebo do cesty, do které má uživatel právo zápisu, a ošetřete výjimky pomocí try/catch. | +| **Chybějící NuGet balíček** | Kompilace selže s chybou “type or namespace name could not be found”. | Ujistěte se, že je nainstalován `Aspose.BarCode` (`dotnet add package Aspose.BarCode`). | + +## Rozšíření příkladu + +Nyní, když víte **jak vytvořit PDF417 čárový kód** a **jak uložit PNG**, můžete prozkoumat následující související témata: + +- **Barcode generator C#**: Změňte `EncodeTypes` na `Code128`, `QR` nebo jiné symbologie. +- **Vlastní barvy**: Použijte `generator.Parameters.Barcode.ForegroundColor` a `BackgroundColor` pro sladění s brandingem. +- **Vkládání do PDF**: Kombinujte PNG s PDF knihovnou (např. iText7) pro vytvoření tisknutelných dokumentů. +- **Dynamická data**: Načtěte text z databáze nebo vstupu uživatele pro generování čárových kódů za běhu. + +## Závěr + +Nyní máte kompletní, připravené řešení pro **vytvoření PDF417 čárového kódu** v C# a uložení výsledku jako PNG soubor. Tutoriál pokryl každý krok od nastavení projektu po úpravu rozvržení a zdůraznil, jak se vyhnout běžným chybám při používání knihovny pro generování čárových kódů v C#. + +Neváhejte experimentovat s různými nastaveními sloupců/řádků, barvami nebo i s jinými formáty čárových kódů. Pokud narazíte na problémy, vraťte se k sekci **jak generovat PDF417** nebo prozkoumejte dokumentaci knihovny pro pokročilé funkce. Šťastné programování! + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, které vám pomohou zvládnout další funkce API a prozkoumat alternativní přístupy k implementaci ve vašich projektech. + +- [Jak vytvořit čárový kód – Kompaktní PDF417 s Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Jak generovat PDF417 čárový kód – Kompaktní PDF417 kódování](/barcode/english/net/compact-pdf417-encoding/) +- [Jak vytvořit tichou zónu čárového kódu pro ITF-14 pomocí Aspose.BarCode pro .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/czech/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..af715883d --- /dev/null +++ b/barcode/czech/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Naučte se, jak v C# generovat čárový kód PDF417 pomocí Aspose.BarCode, + nastavit velikost čárového kódu, upravit sloupce a povolit kompaktní režim. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: cs +lastmod: 2026-08-22 +og_description: Generujte čárový kód PDF417 v C# pomocí Aspose.BarCode. Tento průvodce + ukazuje, jak nastavit velikost čárového kódu, ovládat sloupce a povolit kompaktní + režim pro menší obrázek. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Generování čárového kódu PDF417 v C# – nastavení velikosti, sloupců a kompaktního + režimu +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Jak vygenerovat čárový kód PDF417 v C# a nastavit jeho velikost +url: /cs/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak generovat PDF417 čárový kód v C# a nastavit velikost čárového kódu + +Pokud potřebujete **generovat PDF417 čárový kód** v .NET aplikaci, tento průvodce vás provede celým procesem. Uvidíte přesně **jak generovat PDF417** s Aspose.BarCode, upravit **nastavení velikosti čárového kódu** a vytvořit kompaktní PNG, který lze vložit do reportů nebo mobilních aplikací. + +Vytvoření čárového kódu nevyžaduje samostatný grafický editor. Na konci tohoto tutoriálu budete mít plně funkční C# metodu, která vytváří PDF417 obrázek s přesnými rozměry, které potřebujete, připravený pro další zpracování. + +## Co se naučíte + +* Nainstalujte a odkažte knihovnu Aspose.BarCode. +* Vytvořte generátor PDF417 čárového kódu a zadejte kódovaný text. +* **Nastavte velikost čárového kódu** konfigurací X‑dimenze a počtu sloupců. +* Povolte kompaktní (zkrácený) režim pro zmenšení symbolu. +* Uložte výsledek jako PNG soubor. +* Řešte běžné problémy, jako jsou nečitelné kódy a příliš velké obrázky. + +### Požadavky + +* .NET 6.0 nebo novější (API funguje také s .NET Framework 4.6+). +* Základní znalost C# a Visual Studio (nebo jakéhokoli C# IDE). +* Platná licence Aspose.BarCode (bezplatná zkušební verze funguje pro testování). + +> **Tip:** Pokud plánujete generovat mnoho čárových kódů ve smyčce, znovu použijte jedinou instanci `BarcodeGenerator` a měňte pouze vlastnost `CodeText`. Tím se sníží alokace paměti. + +## Generování PDF417 čárového kódu s Aspose.BarCode + +Prvním krokem je vytvořit instanci `BarcodeGenerator` pro symbologii PDF417. Tento objekt je vstupním bodem pro všechny operace s čárovými kódy. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Proč je to důležité*: `EncodeTypes.Pdf417` říká knihovně, aby použila standard PDF417, který podporuje velké objemy dat a korekci chyb. Konstruktor také přijímá data, která chcete kódovat, čímž eliminuje potřebu samostatného přiřazení `CodeText` později. + +## Nastavení velikosti čárového kódu a počtu sloupců + +Symboly PDF417 se skládají z řad a sloupců malých obdélníkových modulů. Ovládáním šířky modulu (X‑dimenze) a počtu sloupců můžete jemně doladit celkové rozměry. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Vysvětlení*: +* **X‑dimenze** (`Pixels`) určuje, jak široký je každý modul. Menší hodnoty vytvářejí kompaktnější čárový kód, zatímco větší hodnoty zvyšují čitelnost na nízkorozlišovacích skenerech. +* **Sloupce** řídí horizontální rozložení. Méně sloupců dělá čárový kód vyšší; více sloupců ho rozšiřuje. Nastavte tato dvě nastavení společně, abyste dosáhli přesné **nastavené velikosti čárového kódu**, kterou potřebujete. + +## Povolení kompaktního režimu pro menší čárový kód + +PDF417 obsahuje „kompaktní“ (nebo zkrácený) režim, který odstraňuje zbytečné odsazení a snižuje celkovou velikost. To je zvláště užitečné, když máte omezený prostor na obrazovce. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Proč povolit zkrácení?* +Když je `Truncate` nastaven na `true`, generátor vynechá stop pattern a některá kódová slova pro korekci chyb, která nejsou vyžadována ve většině skenovacích scénářů. Výsledný obrázek je přibližně o 15‑20 % menší, aniž by to ohrozilo integritu dat pro typické případy použití. + +## Uložení čárového kódu jako PNG obrázku + +Po nastavení velikosti a režimu zapište čárový kód na disk. PNG je bezztrátový formát, který zajišťuje, že hrany modulů zůstanou ostré. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Soubor `CompactPdf417.png` bude obsahovat ostrý PDF417 symbol, který odpovídá rozměrům nastaveným v předchozích krocích. + +### Očekávaný výstup + +Otevření uloženého PNG by mělo zobrazit svisle orientovaný PDF417 čárový kód sestávající ze tří sloupců, každý modul široký 2 px, a celkovou velikost přibližně **120 × 240 px** (šířka × výška). Skenování obrázku jakýmkoli standardním PDF417 čtečkou vrátí původní text „Sample text for PDF417“. + +## Běžné úskalí a jak se jim vyhnout + +| Symptom | Likely cause | Fix | +|---------|--------------|-----| +| Čárový kód je nečitelný | X‑dimenze je příliš malá pro skener | Zvyšte `XDimension.Pixels` na 3 nebo 4 | +| Obrázek je příliš široký pro UI | Nastaveno příliš mnoho sloupců | Snižte `Pdf417.Columns` nebo povolte `Truncate` | +| Výjimka `ArgumentOutOfRangeException` | Negativní nebo nulový počet sloupců | Ujistěte se, že `Columns` je kladné celé číslo (minimum 1) | +| PNG soubor je prázdný | Cesta k výstupu neexistuje nebo chybí oprávnění k zápisu | Ověřte, že adresář existuje a aplikace má práva k zápisu | + +> **Tip:** Použijte `barcodeGenerator.ValidateParameters()` před voláním `Save()`, abyste včas zachytili chyby konfigurace. + +## Kompletní, spustitelný příklad + +Níže je samostatný konzolový program, který zahrnuje všechny výše uvedené kroky. Zkopírujte jej do nového C# projektu, obnovte NuGet balíček Aspose.BarCode a spusťte jej, abyste viděli výsledek. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Spuštění programu** vytvoří `CompactPdf417.png` v pracovním adresáři spustitelného souboru. Naskenujte obrázek mobilní aplikací (např. „Barcode Scanner“), abyste ověřili, že kódovaný text odpovídá zdrojovému řetězci. + +## Další kroky a související témata + +* **Zvyšte úroveň korekce chyb** – upravte `Pdf417.ErrorLevel` pro prostředí s šumivým skenováním. +* **Změňte orientaci** – nastavte `Pdf417.Rotate` na `RotationAngle.Rotate90`, pokud potřebujete horizontální rozložení. +* **Vložte čárový kód do PDF** – kombinujte Aspose.PDF s Aspose.BarCode, abyste obrázek umístili přímo do dokumentu. +* **Generujte jiné 2‑D čárové kódy** – třída `BarcodeGenerator` podporuje DataMatrix, QR a Aztec kódy; stačí vyměnit `EncodeTypes.Pdf417` za požadovanou symbologii. + +Ovládnutím technik **generování PDF417 čárového kódu** můžete automatizovat vydávání vstupenek, označování zásob a bezpečný přenos dat napříč širokou škálou .NET aplikací. + +## Závěr + +Nyní víte, jak **generovat PDF417 čárový kód** v C#, přesně **nastavit velikost čárového kódu**, konfigurovat sloupce, povolit kompaktní režim a uložit výsledek jako PNG. Použijte tato nastavení k přizpůsobení jakémukoli omezení UI nebo požadavku na skenování a rozšiřte přístup i na další formáty čárových kódů podle potřeby. Šťastné programování! + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, které vám pomohou zvládnout další funkce API a prozkoumat alternativní přístupy k implementaci ve vašich projektech. + +- [Jak generovat PDF417 čárový kód – Kompaktní kódování PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Jak vytvořit čárový kód – Kompaktní PDF417 s Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Jak generovat DataMatrix čárové kódy pomocí Aspose.BarCode pro .NET – Průvodce krok za krokem](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/czech/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..cf6f89fe7 --- /dev/null +++ b/barcode/czech/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: Jak číst PDF417 čárové kódy v C# pomocí průvodce krok po kroku, zahrnujícího + čtení více čárových kódů z obrázku a extrakci detailů MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: cs +lastmod: 2026-08-22 +og_description: Jak rychle číst PDF417 čárové kódy v C#. Tento tutoriál vám ukáže, + jak načíst více čárových kódů z obrázku a získat rozšířené informace MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Jak číst čárové kódy PDF417 v C# – kompletní programovací průvodce +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Jak číst čárové kódy PDF417 v C# – kompletní průvodce +url: /cs/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak číst PDF417 čárové kódy v C# – kompletní průvodce + +Pokud potřebujete **jak číst PDF417** čárové kódy v .NET aplikaci, tento tutoriál vám poskytne připravené řešení. Naučíte se, jak načíst více čárových kódů z jedné obrázku, extrahovat kompletní sadu dat MacroPdf417 a zobrazit je v konzoli. Přístup funguje s knihovnou Aspose.BarCode pro .NET a vyžaduje jen několik řádků kódu. + +Čtení čárových kódů z obrázku je běžný úkol v inventárních systémech, validaci vstupenek a správě dokumentů. Na konci tohoto průvodce budete schopni dekódovat jakýkoli PDF417 nebo MacroPdf417 čárový kód, zpracovat několik kódů na jedné fotografii a pochopit rozšířená pole, která MacroPdf417 poskytuje. + +## Požadavky + +- .NET 6.0 SDK nebo novější (kód také kompiluje s .NET Framework 4.7+) +- Visual Studio 2022 nebo jakýkoli C# editor, který preferujete +- Aspose.BarCode pro .NET NuGet balíček (`Install-Package Aspose.BarCode`) +- Vzorek obrázku, který obsahuje MacroPdf417 čárový kód (např. `MacroPdf417.png`) + +Žádná další konfigurace není vyžadována; knihovna interně zajišťuje načítání obrázku a dekódování. + +## Jak číst PDF417 čárové kódy z obrázku v C# + +Jádrem řešení je třída `BarCodeReader`. Otevře obrázek, detekuje všechny čárové kódy zadaného typu a vrátí kolekci objektů `BarCodeResult`. Následující kód ukazuje kompletní konzolový program. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Proč je každý řádek důležitý + +| Krok | Účel | +|------|------| +| **1️⃣ Inicializace** | Vytvoří `BarCodeReader` svázaný s obrázkovým souborem a omezuje detekci na symbologii MacroPdf417, což urychluje zpracování. | +| **2️⃣ Iterace** | `ReadBarCodes()` vrací **všechny** čárové kódy, které odpovídají požadovanému typu, což vám umožní **číst více čárových kódů** bez dalších smyček. | +| **3️⃣ Základní výstup** | Zobrazuje obecný `CodeTypeName` a lidsky čitelný `CodeText`. To je užitečné pro logování nebo rychlou validaci. | +| **4️⃣ Rozšířená data** | MacroPdf417 nese další metadata (ID souboru, počet segmentů, časová razítka atd.). Objekt `Extended.Pdf417` přímo vystavuje každé pole, takže můžete uložit nebo ověřit celý datový paket. | + +Spuštěním programu na platném MacroPdf417 obrázku získáte výstup v konzoli podobný následujícímu: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Výstup potvrzuje, že knihovna úspěšně načetla čárový kód, extrahovala text a poskytla všechna pole MacroPdf417. + +## Čtení více čárových kódů z jednoho obrázku + +Mnoho reálných scénářů umisťuje několik PDF417 symbolů na jeden štítek – představte si přepravní manifest, který obsahuje kód dopravce, sledovací číslo a celní deklaraci. Výše uvedený kód již **čte více čárových kódů**, protože `ReadBarCodes()` vrací výčtový typ se všemi shodami. Žádná další konfigurace není potřeba; stačí projít výsledky ve smyčce, jak je ukázáno. + +Pokud chcete omezit čtečku na standardní PDF417 (ne‑macro), zatímco stále zpracováváte několik kódů, nahraďte `DecodeType.MacroPdf417` za `DecodeType.Pdf417`. Zbytek logiky zůstane beze změny. + +## Porozumění rozšířeným datům MacroPdf417 + +MacroPdf417 je rozšířením běžné specifikace PDF417. Rozděluje velké payloady do více segmentů a přidává malou hlavičku, která popisuje celý soubor. Nejrelevantnější pole jsou: + +- **MacroPdf417FileID** – jedinečný identifikátor sdílený všemi segmenty stejného souboru. +- **MacroPdf417SegmentID** – pořadové číslo aktuálního segmentu. +- **MacroPdf417SegmentsCount** – celkový očekávaný počet segmentů. +- **MacroPdf417FileName** – volitelný název souboru přenášený s čárovým kódem. +- **MacroPdf417Checksum** – kontrolní hodnota pro celý soubor. +- **MacroPdf417FileSize** – velikost původního binárního payloadu. +- **MacroPdf417TimeStamp** – ISO‑8601 časové razítko, kdy byl čárový kód vygenerován. +- **MacroPdf417Addressee / Sender** – volitelná textová pole pro směrování. +- **MacroPdf417Terminator** – označuje, zda je tento segment poslední. + +Když obdržíte všechny segmenty, můžete rekonstruovat původní soubor seřazením podle `MacroPdf417SegmentID` a spojováním hodnot `CodeText`. Tato logika je jednoduchá na implementaci, jakmile máte pole k dispozici. + +## Časté úskalí a tipy + +- **Kvalita obrázku má význam** – nízké rozlišení nebo silně komprimované PNG/JPEG soubory mohou způsobit neúspěšné detekce. Používejte DPI alespoň 300 dpi pro tištěné čárové kódy. +- **Smíšené symbologie** – pokud obrázek obsahuje jak MacroPdf417, tak běžný PDF417, vytvořte dvě čtečky (jednu pro každý `DecodeType`) nebo použijte `DecodeType.AllSupported` a filtrujte výsledky podle `result.CodeTypeName`. +- **Spotřeba paměti** – příkaz `using` okamžitě uvolní `BarCodeReader`, čímž zabrání tomu, aby velké obrazové buffery zůstaly v paměti. +- **Bezpečnost vlákna** – `BarCodeReader` není thread‑safe. Vytvořte samostatnou instanci pro každé vlákno, pokud dekódujete obrázky paralelně. +- **Zpracování chyb** – obalte volání `ReadBarCodes()` do try/catch bloku a zachyťte `BarCodeException` pro poškozené obrázky. + +## Přehled kompletního funkčního příkladu + +Níže je kompletní program, který můžete zkopírovat do nového konzolového projektu. Obsahuje všechny `using` direktivy, konstantu pro cestu k obrázku a vzor pro uvolnění prostředků. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Zkompilujte pomocí `dotnet build` a spusťte pomocí `dotnet run`. Konzole vypíše základní data každého čárového kódu a celý payload MacroPdf417. + +## Další kroky + +- **Rekonstruovat multipart soubory** – shromáždit všechny segmenty, seřadit podle `MacroPdf417SegmentID` a spojit `CodeText` do + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, která vám pomohou zvládnout další funkce API a prozkoumat alternativní implementační přístupy ve vašich projektech. + +- [Jak generovat PDF417 čárový kód – Kompaktní PDF417 kódování](/barcode/english/net/compact-pdf417-encoding/) +- [Jak číst PDF417 čárové kódy s tureckými znaky v Javě](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Jak používat Aspose pro PDF417 čárový kód (čínština) v Javě](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/czech/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..9bbd11551 --- /dev/null +++ b/barcode/czech/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: Návod na generátor čárových kódů v C# ukazuje, jak vytvořit makro PDF417 + čárový kód s metadaty a uložit jej jako PNG pomocí Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: cs +lastmod: 2026-08-22 +og_description: Generátor čárových kódů C# vám umožní vytvořit makro PDF417 čárový + kód s kompletními metadaty na úrovni souboru a exportovat jej jako PNG. Postupujte + podle tohoto návodu k implementaci řešení. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: generátor čárových kódů C# – vytvářejte makro PDF417 čárové kódy krok po + kroku +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Jak použít generátor čárových kódů v C# pro Macro PDF417 +url: /cs/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak použít generátor čárových kódů C# pro Macro PDF417 + +Pokud potřebujete **barcode generator C#**, který dokáže vytvořit symbol Macro PDF417 s metadaty na úrovni souboru, tento průvodce poskytuje kompletní, připravené řešení. Uvidíte, jak nastavit vzhled čárového kódu, vložit makro informace jako ID souboru a počet segmentů a nakonec výsledek uložit jako PNG obrázek. + +Příklad používá knihovnu Aspose.BarCode, široce používanou **C# barcode library**, která podporuje kompletní sadu funkcí PDF417. Nevyžaduje žádné externí služby a kód funguje s .NET 6 nebo novějším. + +## Požadavky + +* .NET 6 SDK (nebo jakákoli novější verze) nainstalována. +* Visual Studio 2022, VS Code nebo jiné C# IDE. +* Odkaz na NuGet balíček **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Znalost základní syntaxe C# a konceptu čárových kódů PDF417 vám pomůže sledovat kroky, ale tutoriál podrobně vysvětluje každou konfigurační možnost. + +## Co tutoriál pokrývá + +* Inicializace instance **barcode generator C#** pro formát Macro PDF417. +* Úprava vizuálních parametrů, jako je X‑dimenze a počet sloupců. +* Poskytnutí polí na úrovni souboru Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender a terminator. +* Uložení vygenerovaného symbolu jako PNG soubor. +* Tipy pro řešení okrajových případů, jako jsou velké velikosti souborů nebo vlastní časové značky. + +Na konci tohoto článku budete mít samostatný program, který vytváří plně kompatibilní Macro PDF417 čárový kód. + +## Krok 1: Vytvořte instanci barcode generator C# + +Prvním krokem je vytvořit instanci `BarcodeGenerator` s hodnotou výčtu `EncodeTypes.MacroPdf417` a textem, který chcete zakódovat. Konstruktor také přijímá řetězec payload, který se stane datovou částí makro čárového kódu. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Proč je to důležité** – Příznak `EncodeTypes.MacroPdf417` říká Aspose.BarCode, aby symbol považoval za makro čárový kód, což umožňuje následná extra pole. Bez tohoto příznaku by knihovna generovala běžný PDF417 čárový kód bez metadat na úrovni souboru. + +## Krok 2: Upravit základní vzhled čárového kódu (vizuální nastavení PDF417) + +Vizální jasnost je klíčová pro spolehlivé skenování. Dva běžné parametry jsou šířka modulu (`XDimension`) a počet sloupců. Nastavením těchto hodnot se vyvažuje velikost a čitelnost. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` řídí šířku každého černého/bílého pruhu. Hodnota **2** funguje dobře pro většinu tiskáren štítků. +* `Pdf417.Columns` určuje, kolik sloupců čárový kód použije. Pět sloupců vytváří kompaktní symbol bez ztráty kapacity dat. + +## Krok 3: Definujte informace na úrovni souboru Macro PDF417 + +Macro PDF417 rozšiřuje standardní formát PDF417 o pole, která popisují, jak je velký soubor rozdělen do více segmentů čárových kódů. Poskytnutí těchto polí zajišťuje, že následné skenery dokážou rekonstruovat původní soubor. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` musí být stejný pro každý segment patřící ke stejnému logickému souboru. +* `MacroPdf417SegmentID` se zvyšuje od **0** do `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` informuje dekodér, kolik částí má očekávat. +* `MacroPdf417FileName` je volitelný, ale užitečný pro lidsky čitelnou identifikaci. + +## Krok 4: Nastavte další makro metadata + +Kromě základních informací o souboru specifikace umožňuje extra pole jako checksum, file size, timestamp, addressee, sender a terminátor. Vyplnění těchto polí zvyšuje integritu dat a sledovatelnost. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` poskytuje 16‑bitový CCITT checksum pro celý soubor; dekodér může po rekonstrukci ověřit integritu. +* `MacroPdf417FileSize` by měl odrážet přesný počet bajtů původního souboru; hodnoty větší než `2^31‑1` vyžadují 64‑bitové pole, které Aspose zpracuje automaticky. +* `MacroPdf417TimeStamp` zaznamenává, kdy byl čárový kód vygenerován. Použijte UTC, aby nedošlo k nejasnostem časových pásem. +* `MacroPdf417Addressee` a `MacroPdf417Sender` jsou volně formátované řetězce, které mohou uchovávat informace o směrování. +* `MacroPdf417Terminator` signalizuje, že se jedná o poslední segment; nastavte na `Set` pro poslední část, jinak ponechte výchozí (`NotSet`). + +**Tip pro okrajové případy** – Pokud velikost souboru překročí 4 GB, rozdělte obsah do více makro segmentů a upravte `SegmentsCount` podle toho. Knihovna zvládne pole velké velikosti bez přetečení. + +## Krok 5: Uložte čárový kód jako PNG obrázek + +Poslední krok zapíše vygenerovaný symbol na disk. PNG zachovává přesné rozměry pixelů a je široce podporován skenovacím hardwarem. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Nahraďte `YOUR_DIRECTORY` absolutní nebo relativní cestou, do které může běžící proces zapisovat. Výčet `BarCodeImageFormat.Png` zajišťuje bezztrátový výstup. + +**Proč PNG?** – Rasterové formáty jako PNG udržují hrany modulů ostré, což je nezbytné pro skenery, které spoléhají na vysoký kontrast hran. Pokud potřebujete vektorový formát, Aspose také podporuje `Pdf` a `Svg`. + +## Kompletní spustitelný příklad + +Níže je kompletní program, který můžete zkopírovat do konzolové aplikace. Obsahuje potřebné `using` direktivy a metodu `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Očekávaný výstup + +Spuštěním programu se vytvoří soubor s názvem **MacroPdf417.png** v pracovním adresáři projektu. Otevření obrázku zobrazí kompaktní PDF417 čárový kód s vloženými makro poli. Skenováním obrázku čtečkou kompatibilní s PDF417 (např. ZXing, Aspose.BarCode decoder) se vrátí původní payload `"Sample text"` spolu s makro metadaty. + +## Časté otázky a řešení problémů + +| Otázka | Odpověď | +|----------|--------| +| *Co když je čárový kód příliš velký pro cílový štítek?* | Snižte `XDimension.Pixels` nebo zvyšte `Pdf417.Columns`. Oba parametry ovlivňují celkovou velikost. | +| *Mohu generovat vektorový obrázek místo PNG?* | Ano. Zavolejte `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` pro škálovatelný výstup. | +| *Jak ověřím kontrolní součet po skenování?* | Dekodér Aspose.BarCode automaticky ověřuje `MacroPdf417Checksum` a hlásí nesrovnalosti v objektu `MacroPdf417Result`. | +| *Je knihovna kompatibilní s .NET Core?* | NuGet balíček podporuje .NET Standard 2.0+, což zahrnuje .NET Core, .NET 5, .NET 6 a novější. | +| *Co když potřebuji vložit binární data místo textu?* | Převěďte binární payload na Base64 nebo použijte přetížení `EncodeTypes.MacroPdf417`, které přijímá pole bajtů. | + +## Profesionální tipy pro produkční použití + +* **Cache generátoru** – + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, které vám pomohou zvládnout další funkce API a prozkoumat alternativní přístupy k implementaci ve vašich projektech. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/net/compact-pdf417-encoding/_index.md b/barcode/dutch/net/compact-pdf417-encoding/_index.md index 9db822996..fdd7a49e8 100644 --- a/barcode/dutch/net/compact-pdf417-encoding/_index.md +++ b/barcode/dutch/net/compact-pdf417-encoding/_index.md @@ -58,7 +58,7 @@ weight: 29 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Hoe PDF417-barcode te genereren – Compact PDF417-codering +# Hoe PDF417-barcode te genereren – Compacte PDF417-codering ## Inleiding @@ -142,6 +142,16 @@ De hoge gegevensdichtheid en robuuste foutcorrectie van Compact PDF417 maken het ## Compact PDF417-coderingstutorials ### [Compact PDF417-barcode maken](./compact-pdf417-basic-configuration/) Leer hoe je Compact PDF417 barcodes genereert met Aspose.BarCode voor .NET. Uitgebreide gids met stap‑voor‑stap instructies en code‑voorbeelden. +### [Hoe PDF417-barcode genereren in C# en de barcodegrootte instellen](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +Leer hoe je een PDF417-barcode maakt in C# en de grootte ervan aanpast met Aspose.BarCode. +### [Hoe micro PDF417 barcode te maken in C# – stap‑voor‑stap gids](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Leer hoe je een micro PDF417 barcode genereert in C# met Aspose.BarCode, inclusief configuratie en opslaan. +### [Hoe een barcodegenerator C# te gebruiken voor Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Leer hoe je met Aspose.BarCode een Macro PDF417 barcode genereert in C#. +### [Hoe PDF417-barcodes te lezen in C# – volledige gids](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Leer hoe je PDF417-barcodes kunt scannen en decoderen in C# met Aspose.BarCode, inclusief voorbeeldcode en foutafhandeling. +### [Hoe PDF417-barcode te maken in C# en op te slaan als PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Leer hoe je een PDF417-barcode genereert in C# en opslaat als PNG-afbeelding met Aspose.BarCode. ## Veelgestelde vragen diff --git a/barcode/dutch/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/dutch/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..e4779b791 --- /dev/null +++ b/barcode/dutch/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Leer hoe je een micro‑PDF417‑barcode maakt in C# en een barcode‑PNG‑afbeelding + genereert. Inclusief het instellen van de barcode‑afmetingen en het opslaan van + het bestand. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: nl +lastmod: 2026-08-22 +og_description: Maak een micro‑PDF417‑barcode in C# en exporteer deze als PNG. Volg + deze gids om de afmetingen van de barcode in te stellen en snel een barcode‑afbeelding + te genereren. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Creëer micro‑PDF417‑barcode in C# – volledige programmeertutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Hoe maak je een micro PDF417‑barcode in C# – stapsgewijze handleiding +url: /nl/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe maak je een micro PDF417 barcode in C# – stap‑voor‑stap gids + +Als je een **micro PDF417 barcode** moet maken voor een ticketsysteem, inventarislabel of mobiele scan, laat deze tutorial je precies zien hoe. Je ziet het volledige C#‑programma dat een barcode‑PNG genereert, leert hoe je de barcode‑dimensies instelt en begrijpt elke configuratie‑optie. + +Aan het einde van deze gids kun je een hoge‑resolutie barcode‑afbeelding genereren, de X‑dimensie aanpassen, het aantal kolommen kiezen en het resultaat opslaan als een PNG‑bestand — allemaal met een paar regels code. + +## Wat je nodig hebt + +- .NET 6.0 SDK of later (de code werkt met .NET Core en .NET Framework) +- Visual Studio 2022 of een andere C#‑compatibele IDE +- Het **Aspose.BarCode for .NET** NuGet‑pakket (of een bibliotheek die `EncodeTypes.MicroPdf417` ondersteunt) +- Basiskennis van C#‑syntaxis + +> **Pro tip:** De gratis community‑editie van Aspose.BarCode is voldoende voor ontwikkeling en testen. Voor productie moet je een licentie aanschaffen om evaluatiewatermerken te verwijderen. + +## Stap 1: Installeer de barcode‑bibliotheek + +Open een terminal in je projectmap en voer uit: + +```bash +dotnet add package Aspose.BarCode +``` + +Dit voegt de `Aspose.BarCode`‑assembly toe, die de `BarcodeGenerator`‑klasse levert die wordt gebruikt om **barcode‑afbeeldingen in C#** te maken. + +## Stap 2: Initialiseert de generator – maak micro PDF417 barcode + +De eerste uitvoerbare regel maakt een `BarcodeGenerator`‑instantie aan die is geconfigureerd voor de Micro PDF417‑symbologie en levert de gegevens die je wilt coderen. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Waarom dit belangrijk is*: De `EncodeTypes.MicroPdf417`‑enum vertelt de bibliotheek om de compacte versie van PDF417 te gebruiken, wat ideaal is voor kleine labels en mobiele schermen. + +## Stap 3: Hoe barcode‑dimensies in C# in te stellen + +Het fijn afstellen van de module‑breedte (X‑dimensie) bepaalt de visuele dichtheid van de barcode. Een kleinere waarde levert een scherper beeld op, terwijl een grotere waarde de barcode makkelijker maakt om op afstand te scannen. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Waarom je dimensies moet instellen**: Zonder de X‑dimensie aan te passen, kan de standaardwaarde een barcode opleveren die er wazig uitziet bij weergave op hoge DPI. Instellen op 2 pixels is een goede balans voor de meeste scherm‑gebaseerde scans. + +## Stap 4: Kies het aantal kolommen – de breedte van de barcode regelen + +Micro PDF417 staat tussen 1 en 4 kolommen toe. Meer kolommen comprimeren de gegevens horizontaal, waardoor de totale afbeeldingsbreedte afneemt. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Randgeval*: Als je 5 kolommen vraagt, gooit de bibliotheek een `ArgumentOutOfRangeException`. Blijf altijd binnen het gedocumenteerde bereik. + +## Stap 5: Hoe een barcode‑PNG te genereren – de afbeelding opslaan + +Nu kun je de gegenereerde barcode exporteren naar een PNG‑bestand. PNG behoudt verliesvrije kwaliteit, wat essentieel is voor betrouwbaar scannen. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Wanneer je het programma uitvoert, zie je een console‑bericht dat de bestandslocatie bevestigt. De resulterende `MicroPdf417.png` ziet er als volgt uit: + +![Schermafbeelding die een gegenereerde micro PDF417 barcode toont, gemaakt met C#](micro-pdf417-example.png "Gegenereerde micro PDF417 barcode") + +*Afbeeldings‑alt‑tekst*: **micro PDF417 barcode gegenereerd in C#** – toont de uiteindelijke output na het toepassen van de dimensies en kolominstellingen. + +## Stap 6: Voer uit en controleer de output + +1. Bouw het project: `dotnet build`. +2. Voer uit: `dotnet run`. +3. Open `MicroPdf417.png` op je bureaublad en scan het met een mobiele barcode‑scanner app. + +Je zou de tekst **“Sample text”** gedecodeerd moeten zien. Als de scanner een fout meldt, controleer dan de X‑dimensie en het aantal kolommen – extreme waarden kunnen de barcode te dicht maken voor sommige apparaten. + +## Veelvoorkomende variaties en probleemoplossing + +| Situatie | Aanpassing | +|-----------|------------| +| **Een grotere barcode nodig voor printers met lage resolutie** | Increase `XDimension.Pixels` to 3 or 4. | +| **Een hogere barcode willen zonder de breedte te wijzigen** | Set `generator.Parameters.Barcode.Pdf417.Rows` (rows range 3‑90). | +| **Meerdere barcodes genereren in een lus** | Re‑use the same `BarcodeGenerator` instance and only change `CodeText` before each `Save`. | +| **Opslaan als JPEG in plaats van PNG** | Replace `BarCodeImageFormat.Png` with `BarCodeImageFormat.Jpeg`. | +| **Uitvoeren op .NET Framework 4.7** | The same code works; just reference the appropriate `Aspose.BarCode.dll`. | + +## Volledige broncode (uitvoerbaar) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Verwachte output** – een PNG‑bestand van 200 × 100 pixels met een scherpe Micro PDF417 barcode die decodeert naar “Sample text”. + +## Conclusie + +Je weet nu hoe je een **micro PDF417 barcode** in C# kunt **maken**, **barcode‑dimensies** kunt **instellen**, en een **barcode‑PNG**‑afbeelding kunt **genereren**. Het volledige voorbeeld toont elke vereiste stap — van bibliotheek‑installatie tot het opslaan van het uiteindelijke bestand — zodat je barcode‑generatie direct in je eigen applicaties kunt integreren. + +Vervolgens kun je gerelateerde onderwerpen verkennen, zoals **het maken van QR‑codes met Aspose.BarCode**, **kleuren aanpassen**, of **barcodes in PDF‑documenten insluiten**. Elk van deze bouwt voort op dezelfde `BarcodeGenerator`‑fundamenten die hier behandeld worden. + +Voel je vrij om te experimenteren met verschillende gegevensreeksen, kolomaantallen en X‑dimensie‑waarden om aan je specifieke scan‑omgeving te voldoen. Veel plezier met coderen! + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden getoond. Elke bron bevat volledige werkende code‑voorbeelden met stap‑voor‑stap uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [Hoe maak je een barcode – Compact PDF417 met Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hoe PDF417 barcode te genereren – Compact PDF417 codering](/barcode/english/net/compact-pdf417-encoding/) +- [Hoe een Aztec barcode te maken met Aspose.BarCode voor .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/dutch/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..e8e6cd07f --- /dev/null +++ b/barcode/dutch/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Leer hoe je een PDF417‑barcode maakt in C# met een barcode‑generator, + de lay‑out instelt en een PNG opslaat. Inclusief volledige code en tips voor barcode‑generator + C#‑projecten. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: nl +lastmod: 2026-08-22 +og_description: Maak een PDF417‑barcode in C# met een barcodegenerator, pas de lay‑out + aan en leer hoe je PNG opslaat. Volg deze stap‑voor‑stap‑tutorial. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: PDF417-barcode maken in C# – volledige gids voor het genereren en opslaan + van PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hoe PDF417-barcode te maken in C# en op te slaan als PNG +url: /nl/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe PDF417 barcode te maken in C# en op te slaan als PNG + +Als je een **PDF417 barcode moet maken** in een C# applicatie, laat deze tutorial je de exacte stappen zien. Je zult zien hoe een barcode generator C# bibliotheek elke string kan omzetten in een scanbare PDF417 afbeelding en hoe je PNG‑bestanden kunt opslaan zonder extra tools. + +Barcodes genereren is gebruikelijk in logistiek, ticketing en documentbeheer. Aan het einde van deze gids heb je een uitvoerbaar console‑programma dat een PNG‑bestand genaamd `Pdf417Layout.png` produceert in de map die je kiest. + +## Vereisten + +- .NET 6.0 SDK of later geïnstalleerd (de code werkt ook met .NET Framework 4.7+). +- Visual Studio 2022 of een andere editor die C#‑projecten kan bouwen. +- Het **Aspose.BarCode for .NET** NuGet‑pakket (of een andere compatibele barcode generator C# bibliotheek). + Installeer het met: + +```bash +dotnet add package Aspose.BarCode +``` + +Er zijn geen extra beeldverwerkingsbibliotheken nodig omdat de generator PNG direct kan schrijven. + +## Stap 1: Een nieuw console‑project opzetten + +Maak een nieuw console‑project zodat het voorbeeld zelfstandig blijft. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +De map `Pdf417Demo` bevat nu een `Program.cs`‑bestand waarin we de barcode‑code zullen schrijven. + +## Stap 2: De barcode‑namespace importeren + +Open `Program.cs` en voeg de vereiste `using`‑directive toe aan de bovenkant: + +```csharp +using Aspose.BarCode.Generation; +``` + +Deze namespace geeft je toegang tot `BarcodeGenerator`, `EncodeTypes` en de afbeelding‑formaat enum die nodig is voor **hoe PNG op te slaan**. + +## Stap 3: De PDF417 barcode‑generator maken + +De kern van **hoe PDF417 te genereren** is de `BarcodeGenerator`‑klasse. Geef het encode‑type `EncodeTypes.Pdf417` en de tekst die je wilt coderen. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` bevat nu alle instellingen voor de barcode. De standaardindeling werkt, maar we zullen deze in de volgende stap aanpassen. + +## Stap 4: De barcode‑indeling definiëren (kolommen en rijen) + +PDF417 stelt je in staat het aantal kolommen (2‑30) en rijen (1‑90) te regelen. Het aanpassen van deze waarden kan de leesbaarheid voor specifieke scanners verbeteren. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tip:** Als je deze instellingen weglaten, kiest de bibliotheek automatisch optimale waarden. Het vastzetten van kolommen en rijen geeft je echter voorspelbare afbeeldingsafmetingen, wat handig is wanneer je de PNG in een PDF of een UI‑lay-out embed. + +## Stap 5: De gegenereerde barcode opslaan als PNG‑afbeelding + +Beantwoord nu **hoe PNG op te slaan** door `Save` aan te roepen. De methode accepteert het doelpad en de afbeelding‑formaat enum. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Het bestand `Pdf417Layout.png` verschijnt in de `bin/Debug/net6.0`‑map van het project nadat je het programma hebt uitgevoerd. + +## Volledig uitvoerbaar voorbeeld + +Hieronder staat het volledige `Program.cs`‑bestand. Kopieer het naar het project dat je in **Stap 1** hebt aangemaakt en voer `dotnet run` uit. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Verwachte output + +Wanneer je het programma uitvoert, print de console het absolute pad naar het PNG‑bestand, en het bestand bevat een duidelijke PDF417 barcode die lijkt op de afbeelding hieronder. + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +Je kunt de PNG scannen met elke PDF417‑compatibele scanner (mobiele apps, hardware‑lezers) om te verifiëren dat de gecodeerde tekst `"Sample"` is. + +## Omgaan met randgevallen en veelvoorkomende valkuilen + +| Situatie | Waar op te letten | Aanbevolen oplossing | +|-----------|-------------------|-----------------| +| **Ongeldige kolom-/rijwaarden** | Waarden buiten het bereik 2‑30 (kolommen) of 1‑90 (rijen) veroorzaken een `ArgumentException`. | Valideer de gebruikersinvoer voordat je toewijst, of laat de bibliotheek standaardwaarden kiezen. | +| **Grote invoer‑strings** | PDF417 kan tot 1.850 tekens coderen, maar zeer lange strings verhogen het aantal benodigde rijen drastisch. | Splits de data over meerdere barcodes of gebruik een hoger fout‑correctieniveau indien nodig. | +| **Bestandssysteem‑rechten** | Opslaan naar een alleen‑lezen map veroorzaakt een `UnauthorizedAccessException`. | Schrijf naar `Environment.CurrentDirectory` of een map waar de gebruiker schrijfrechten heeft, en behandel uitzonderingen met try/catch. | +| **Ontbrekend NuGet‑pakket** | Compilatie faalt met “type or namespace name could not be found”. | Zorg ervoor dat `Aspose.BarCode` geïnstalleerd is (`dotnet add package Aspose.BarCode`). | + +## Voorbeeld uitbreiden + +Nu je weet **hoe je een PDF417 barcode maakt** en **hoe je PNG opslaat**, kun je deze gerelateerde onderwerpen verkennen: + +- **Barcode generator C#**: Verander de `EncodeTypes` naar `Code128`, `QR`, of andere symbologieën. +- **Aangepaste kleuren**: Gebruik `generator.Parameters.Barcode.ForegroundColor` en `BackgroundColor` om aan de huisstijl te voldoen. +- **Inbedden in PDF’s**: Combineer de PNG met een PDF‑bibliotheek (bijv. iText7) om afdrukbare documenten te maken. +- **Dynamische data**: Haal de tekst uit een database of gebruikersinvoer om barcodes on‑the‑fly te genereren. + +## Conclusie + +Je hebt nu een complete, productie‑klare oplossing voor **het maken van een PDF417 barcode** in C# en het opslaan van het resultaat als een PNG‑bestand. De tutorial besprak elke stap van projectopzet tot lay‑outaanpassing, en benadrukte hoe je veelvoorkomende fouten kunt vermijden bij het gebruik van een barcode generator C# bibliotheek. + +Voel je vrij om te experimenteren met verschillende kolom‑/rijinstellingen, kleuren, of zelfs andere barcode‑formaten. Als je tegen problemen aanloopt, bekijk dan opnieuw de **hoe PDF417 te genereren** sectie of verken de documentatie van de bibliotheek voor geavanceerde functies. Veel programmeerplezier! + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden gedemonstreerd. Elke bron bevat volledige werkende code‑voorbeelden met stap‑voor‑stap uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [Hoe barcode te maken – Compact PDF417 met Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hoe PDF417 barcode te genereren – Compact PDF417 codering](/barcode/english/net/compact-pdf417-encoding/) +- [Hoe barcode-quiet zone te maken voor ITF-14 met Aspose.BarCode voor .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/dutch/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..a11ff4409 --- /dev/null +++ b/barcode/dutch/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Leer hoe je een PDF417‑barcode genereert in C# met Aspose.BarCode, de + barcodegrootte instelt, kolommen aanpast en compacte modus inschakelt. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: nl +lastmod: 2026-08-22 +og_description: Genereer PDF417-barcode in C# met Aspose.BarCode. Deze gids laat zien + hoe u de barcodegrootte instelt, kolommen beheert en compacte modus inschakelt voor + een kleinere afbeelding. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: PDF417-barcode genereren in C# – grootte, kolommen en compacte modus instellen +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Hoe PDF417-barcode te genereren in C# en de barcodegrootte in te stellen +url: /nl/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe PDF417 barcode te genereren in C# en de barcodegrootte in te stellen + +Als je een **PDF417 barcode** moet **genereren** in een .NET‑applicatie, leidt deze gids je door het volledige proces. Je ziet precies **hoe je PDF417 kunt genereren** met Aspose.BarCode, de **barcodegrootte instelt**, en een compacte PNG produceert die in rapporten of mobiele apps kan worden ingebed. + +Het maken van een barcode vereist geen aparte grafische editor. Aan het einde van deze tutorial heb je een volledig functionele C#‑methode die een PDF417‑afbeelding produceert met de exacte afmetingen die je nodig hebt, klaar voor verdere verwerking. + +## Wat je zult leren + +* Installeer en verwijs naar de Aspose.BarCode‑bibliotheek. +* Maak een PDF417 barcode‑generator en specificeer de te coderen tekst. +* **Stel de barcodegrootte in** door X‑dimensie en kolomaantal te configureren. +* Schakel de compacte (afgekorte) modus in om het symbool te verkleinen. +* Sla het resultaat op als een PNG‑bestand. +* Los veelvoorkomende problemen op, zoals onleesbare codes en te grote afbeeldingen. + +### Vereisten + +* .NET 6.0 of hoger (de API werkt ook met .NET Framework 4.6+). +* Basiskennis van C# en Visual Studio (of een andere C#‑IDE). +* Een geldige Aspose.BarCode‑licentie (de gratis evaluatie werkt voor testen). + +> **Pro tip:** Als je van plan bent om veel barcodes in een lus te genereren, hergebruik dan één `BarcodeGenerator`‑instantie en wijzig alleen de `CodeText`‑eigenschap. Dit vermindert geheugenallocaties. + +## PDF417 barcode genereren met Aspose.BarCode + +De eerste stap is het instantieren van de `BarcodeGenerator` voor de PDF417‑symbologie. Dit object is het toegangspunt voor alle barcode‑bewerkingen. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Waarom dit belangrijk is*: `EncodeTypes.Pdf417` vertelt de bibliotheek om de PDF417‑standaard te gebruiken, die grote hoeveelheden data en foutcorrectie ondersteunt. De constructor accepteert ook direct de data die je wilt coderen, waardoor een aparte `CodeText`‑toewijzing later overbodig is. + +## Barcodegrootte en kolomaantal instellen + +PDF417‑symbolen bestaan uit rijen en kolommen van kleine rechthoekige modules. Door de modulebreedte (X‑dimensie) en het aantal kolommen te regelen, kun je de totale afmetingen nauwkeurig afstemmen. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Uitleg*: +* **X‑dimensie** (`Pixels`) bepaalt hoe breed elke module is. Kleinere waarden geven een compactere barcode, terwijl grotere waarden de leesbaarheid op laag‑resolutie scanners vergroten. +* **Kolommen** regelen de horizontale lay-out. Minder kolommen maken de barcode hoger; meer kolommen maken hem breder. Pas deze twee instellingen samen aan om de exacte **barcodegrootte** te bereiken die je nodig hebt. + +## Compacte modus inschakelen voor een kleinere barcode + +PDF417 bevat een “compacte” (of afgekorte) modus die onnodige opvulling verwijdert en de totale voetafdruk verkleint. Dit is vooral handig wanneer je beperkte schermruimte hebt. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Waarom truncatie inschakelen?* +Wanneer `Truncate` `true` is, laat de generator het stop‑patroon en enkele fout‑correctie‑codewoorden weg die niet nodig zijn voor de meeste scansituaties. De resulterende afbeelding is ongeveer 15‑20 % kleiner zonder de gegevensintegriteit voor typische gebruikssituaties op te offeren. + +## De barcode opslaan als PNG‑afbeelding + +Na het configureren van grootte en modus, schrijf je de barcode naar schijf. PNG is verliesvrij, waardoor de module‑randen scherp blijven. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Het bestand `CompactPdf417.png` zal een scherpe PDF417‑symbool bevatten dat overeenkomt met de afmetingen die je in de vorige stappen hebt ingesteld. + +### Verwachte output + +Het openen van de opgeslagen PNG moet een verticaal georiënteerde PDF417‑barcode tonen die bestaat uit drie kolommen, elke module 2 px breed, en een totale grootte van ongeveer **120 × 240 px** (breedte × hoogte). Het scannen van de afbeelding met een standaard PDF417‑lezer geeft de oorspronkelijke tekst “Sample text for PDF417” terug. + +## Veelvoorkomende valkuilen en hoe ze te vermijden + +| Symptom | Likely cause | Fix | +|---------|--------------|-----| +| Barcode is onleesbaar | X‑dimensie te klein voor de scanner | Verhoog `XDimension.Pixels` naar 3 of 4 | +| Afbeelding is te breed voor de UI | Te veel kolommen ingesteld | Verminder `Pdf417.Columns` of schakel `Truncate` in | +| Exception `ArgumentOutOfRangeException` | Negatieve of nul kolomtelling | Zorg ervoor dat `Columns` een positief geheel getal is (minimum 1) | +| PNG‑bestand is leeg | Uitvoerpad bestaat niet of heeft geen schrijfrechten | Controleer of de map bestaat en de applicatie schrijfrechten heeft | + +> **Pro tip:** Gebruik `barcodeGenerator.ValidateParameters()` vóór het aanroepen van `Save()` om configuratiefouten vroegtijdig te detecteren. + +## Volledig, uitvoerbaar voorbeeld + +Hieronder staat een zelfstandige console‑applicatie die alle bovenstaande stappen bevat. Kopieer deze naar een nieuw C#‑project, herstel het Aspose.BarCode‑NuGet‑pakket, en voer het uit om het resultaat te zien. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Het uitvoeren van het programma** genereert `CompactPdf417.png` in de werkmap van het uitvoerbare bestand. Scan de afbeelding met een mobiele app (bijv. “Barcode Scanner”) om te verifiëren dat de gecodeerde tekst overeenkomt met de bronstring. + +## Volgende stappen en gerelateerde onderwerpen + +* **Verhoog foutcorrectieniveau** – pas `Pdf417.ErrorLevel` aan voor omgevingen met ruisvolle scans. +* **Verander oriëntatie** – stel `Pdf417.Rotate` in op `RotationAngle.Rotate90` als je een horizontale lay-out nodig hebt. +* **Barcode in een PDF insluiten** – combineer Aspose.PDF met Aspose.BarCode om de afbeelding direct in een document te plaatsen. +* **Andere 2‑D barcodes genereren** – dezelfde `BarcodeGenerator`‑klasse ondersteunt DataMatrix, QR en Aztec‑codes; vervang gewoon `EncodeTypes.Pdf417` door de gewenste symbologie. + +Door de **PDF417 barcode‑generatietechnieken** onder de knie te krijgen, kun je ticketing, voorraadlabeling en veilige gegevensoverdracht automatiseren in een breed scala aan .NET‑applicaties. + +## Conclusie + +Je weet nu hoe je een **PDF417 barcode** in C# kunt **genereren**, nauwkeurig de **barcodegrootte** kunt **instellen**, kolommen kunt configureren, compacte modus kunt inschakelen en het resultaat als PNG kunt opslaan. Pas deze instellingen toe om aan elke UI‑beperking of scan‑vereiste te voldoen, en breid de aanpak uit naar andere barcode‑formaten indien nodig. Veel programmeerplezier! + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden getoond. Elke bron bevat volledige werkende code‑voorbeelden met stapsgewijze uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [Hoe PDF417 Barcode te genereren – Compacte PDF417‑codering](/barcode/english/net/compact-pdf417-encoding/) +- [Hoe een Barcode te maken – Compacte PDF417 met Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hoe DataMatrix Barcodes te genereren met Aspose.BarCode voor .NET – Stapsgewijze gids](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/dutch/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..5756163f5 --- /dev/null +++ b/barcode/dutch/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-08-22 +description: Hoe PDF417‑barcodes te lezen in C# met een stap‑voor‑stap‑gids, inclusief + hoe meerdere barcodes uit een afbeelding te lezen en MacroPdf417‑details te extraheren. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: nl +lastmod: 2026-08-22 +og_description: Hoe PDF417‑barcodes snel te lezen in C#. Deze tutorial laat zien hoe + je meerdere barcodes uit een afbeelding kunt lezen en MacroPdf417‑uitgebreide informatie + kunt ophalen. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Hoe PDF417-barcodes te lezen in C# – volledige programmeerhandleiding +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Hoe PDF417-barcodes te lezen in C# – volledige gids +url: /nl/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe PDF417 barcodes lezen in C# – volledige gids + +Als je **hoe PDF417 te lezen** bars in een .NET‑applicatie nodig hebt, biedt deze tutorial een kant‑klaar‑te‑gebruiken oplossing. Je leert hoe je meerdere barcodes uit één afbeelding kunt lezen, de volledige MacroPdf417‑dataset kunt extraheren en deze in de console kunt weergeven. De aanpak werkt met de Aspose.BarCode for .NET‑bibliotheek en vereist slechts een paar regels code. + +Barcodes lezen uit een afbeelding is een veelvoorkomende taak in voorraadsystemen, ticketvalidatie en documentbeheer. Aan het einde van deze gids kun je elke PDF417‑ of MacroPdf417‑barcode decoderen, meerdere codes in één afbeelding verwerken en de uitgebreide velden die MacroPdf417 biedt begrijpen. + +## Vereisten + +- .NET 6.0 SDK of later (de code compileert ook met .NET Framework 4.7+) +- Visual Studio 2022 of een andere C#‑editor naar keuze +- Aspose.BarCode for .NET NuGet‑pakket (`Install-Package Aspose.BarCode`) +- Een voorbeeldafbeelding die een MacroPdf417‑barcode bevat (bijv. `MacroPdf417.png`) + +Er is geen extra configuratie nodig; de bibliotheek verwerkt het laden en decoderen van afbeeldingen intern. + +## Hoe PDF417 barcodes lezen uit een afbeelding in C# + +De kern van de oplossing is de `BarCodeReader`‑klasse. Deze opent de afbeelding, detecteert alle barcodes van het opgegeven type en retourneert een collectie van `BarCodeResult`‑objecten. De onderstaande code toont een volledig console‑programma. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Waarom elke regel belangrijk is + +| Stap | Doel | +|------|------| +| **1️⃣ Initialiseren** | Maakt een `BarCodeReader` aan die is gekoppeld aan het afbeeldingsbestand en beperkt de detectie tot de MacroPdf417‑symbologie, wat de verwerking versnelt. | +| **2️⃣ Itereren** | `ReadBarCodes()` retourneert **alle** barcodes die overeenkomen met het gevraagde type, waardoor je **meerdere barcodes kunt lezen** zonder extra lussen. | +| **3️⃣ Basisuitvoer** | Toont de generieke `CodeTypeName` en de mens‑leesbare `CodeText`. Dit is nuttig voor logging of snelle validatie. | +| **4️⃣ Uitgebreide data** | MacroPdf417 bevat extra metadata (bestand‑ID, segment‑aantal, tijdstempels, enz.). Het `Extended.Pdf417`‑object maakt elk veld direct beschikbaar, zodat je het volledige datapakket kunt opslaan of verifiëren. | + +Het uitvoeren van het programma met een geldige MacroPdf417‑afbeelding levert console‑output op die lijkt op het volgende: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +De output bevestigt dat de bibliotheek de barcode succesvol heeft gelezen, de tekst heeft geëxtraheerd en elk MacroPdf417‑veld heeft geleverd. + +## Meerdere barcodes lezen uit één afbeelding + +In veel praktijksituaties worden meerdere PDF417‑symbolen op één label geplaatst — denk aan een verzendmanifest dat een vervoerderscode, een trackingnummer en een douane‑verklaring bevat. Het bovenstaande code‑blok **leest al meerdere barcodes** omdat `ReadBarCodes()` een enumerable van alle overeenkomsten retourneert. Er is geen extra configuratie nodig; je hoeft alleen door de resultaten te itereren, zoals gedemonstreerd. + +Als je de lezer wilt beperken tot standaard PDF417 (niet‑macro) terwijl je toch meerdere codes verwerkt, vervang dan `DecodeType.MacroPdf417` door `DecodeType.Pdf417`. De rest van de logica blijft ongewijzigd. + +## MacroPdf417‑uitgebreide data begrijpen + +MacroPdf417 is een uitbreiding van de reguliere PDF417‑specificatie. Het splitst grote payloads in meerdere segmenten en voegt een kleine header toe die het hele bestand beschrijft. De meest relevante velden zijn: + +- **MacroPdf417FileID** – een unieke identifier die door alle segmenten van hetzelfde bestand wordt gedeeld. +- **MacroPdf417SegmentID** – het volgnummer van het huidige segment. +- **MacroPdf417SegmentsCount** – het totale verwachte aantal segmenten. +- **MacroPdf417FileName** – optionele bestandsnaam die met de barcode wordt verzonden. +- **MacroPdf417Checksum** – fout‑controlewaarde voor het volledige bestand. +- **MacroPdf417FileSize** – grootte van de originele binaire payload. +- **MacroPdf417TimeStamp** – ISO‑8601 tijdstempel wanneer de barcode werd gegenereerd. +- **MacroPdf417Addressee / Sender** – optionele tekstvelden voor routing. +- **MacroPdf417Terminator** – geeft aan of dit segment het laatste is. + +Wanneer je alle segmenten hebt ontvangen, kun je het originele bestand reconstrueren door ze te ordenen op `MacroPdf417SegmentID` en de `CodeText`‑waarden samen te voegen. Deze logica is eenvoudig te implementeren zodra de velden beschikbaar zijn. + +## Veelvoorkomende valkuilen en pro‑tips + +- **Beeldkwaliteit is belangrijk** – lage resolutie of sterk gecomprimeerde PNG/JPEG‑bestanden kunnen gemiste detecties veroorzaken. Gebruik een DPI van minimaal 300 dpi voor afgedrukte barcodes. +- **Gemengde symbologieën** – als de afbeelding zowel MacroPdf417 als reguliere PDF417 bevat, maak dan twee lezers (een voor elke `DecodeType`) of gebruik `DecodeType.AllSupported` en filter de resultaten op `result.CodeTypeName`. +- **Geheugengebruik** – de `using`‑statement verwijdert de `BarCodeReader` direct, waardoor grote afbeeldingsbuffers niet in het geheugen blijven. +- **Thread‑veiligheid** – `BarCodeReader` is niet thread‑safe. Maak een aparte instantie per thread als je afbeeldingen parallel decodeert. +- **Foutafhandeling** – wikkel de `ReadBarCodes()`‑aanroep in een try/catch‑blok om `BarCodeException` op te vangen bij corrupte afbeeldingen. + +## Volledige werkende voorbeeld‑overzicht + +Hieronder staat het volledige programma dat je kunt kopiëren naar een nieuw console‑project. Het bevat alle `using`‑directieven, een constante voor het afbeeldingspad en het disposingspatroon. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compileer met `dotnet build` en voer uit met `dotnet run`. De console drukt de basisgegevens van elke barcode en de volledige MacroPdf417‑payload af. + +## Volgende stappen + +- **Meerdere delen reconstrueren** – verzamel alle segmenten, sorteer op `MacroPdf417SegmentID` en voeg `CodeText` samen tot + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden getoond. Elke bron bevat volledige werkende code‑voorbeelden met stap‑voor‑stap uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [Hoe PDF417 Barcode genereren – Compacte PDF417‑codering](/barcode/english/net/compact-pdf417-encoding/) +- [Hoe PDF417 Barcodes lezen met Turkse tekens in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Hoe Aspose te gebruiken voor PDF417 Barcode (Chinees) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/dutch/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..b1188114b --- /dev/null +++ b/barcode/dutch/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-08-22 +description: De barcodegenerator C#‑tutorial laat zien hoe je een Macro PDF417‑barcode + met metadata maakt en opslaat als PNG met behulp van Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: nl +lastmod: 2026-08-22 +og_description: barcode generator C# laat je een Macro PDF417‑barcode maken met volledige + metadata op bestandsniveau en exporteer deze als PNG. Volg deze gids om de oplossing + te implementeren. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: barcode generator C# – maak Macro PDF417‑barcodes stap voor stap +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hoe een barcodegenerator in C# te gebruiken voor Macro PDF417 +url: /nl/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe een barcode generator C# te gebruiken voor Macro PDF417 + +Als je een **barcode generator C#** nodig hebt die een Macro PDF417‑symbool kan genereren met metadata op bestandsniveau, biedt deze gids een complete, kant‑klaar oplossing. Je ziet hoe je het uiterlijk van de barcode configureert, macro‑informatie zoals bestand‑ID en segment‑aantal toevoegt, en uiteindelijk het resultaat opslaat als een PNG‑afbeelding. + +Het voorbeeld maakt gebruik van de Aspose.BarCode‑bibliotheek, een breed geaccepteerde **C# barcode library** die de volledige PDF417‑functionaliteit ondersteunt. Er zijn geen externe services nodig en de code werkt met .NET 6 of hoger. + +## Voorwaarden + +Zorg ervoor dat je het volgende hebt voordat je begint: + +* .NET 6 SDK (of een latere versie) geïnstalleerd. +* Visual Studio 2022, VS Code, of een andere C#‑IDE. +* Een NuGet‑referentie naar **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Basiskennis van C#‑syntaxis en het concept van PDF417‑barcodes helpt je de stappen te volgen, maar de tutorial legt elke configuratie‑optie in detail uit. + +## Waar de tutorial over gaat + +* Een **barcode generator C#**‑instantie initialiseren voor het Macro PDF417‑formaat. +* Visuele parameters aanpassen zoals X‑dimensie en kolomaantal. +* Macro PDF417‑velden op bestandsniveau leveren: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender en terminator. +* Het gegenereerde symbool opslaan als PNG‑bestand. +* Tips voor het omgaan met randgevallen zoals grote bestandsgroottes of aangepaste timestamps. + +Aan het einde van dit artikel heb je een zelfstandige applicatie die een volledig conforme Macro PDF417‑barcode produceert. + +## Stap 1: Maak de barcode generator C#‑instantie + +De eerste handeling is het aanmaken van `BarcodeGenerator` met de enum‑waarde `EncodeTypes.MacroPdf417` en de tekst die je wilt coderen. De constructor accepteert ook de payload‑string, die het gegevensgedeelte van de macro‑barcode wordt. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Waarom dit belangrijk is** – De `EncodeTypes.MacroPdf417`‑vlag vertelt Aspose.BarCode het symbool als een macro‑barcode te behandelen, waardoor de extra velden die volgen worden ingeschakeld. Zonder deze vlag zou de bibliotheek een gewone PDF417‑barcode genereren zonder metadata op bestandsniveau. + +## Stap 2: Basis‑uiterlijk van de barcode aanpassen (PDF417‑visuele instellingen) + +Visuele duidelijkheid is cruciaal voor betrouwbare scanning. Twee veelvoorkomende parameters zijn de module‑breedte (`XDimension`) en het aantal kolommen. Het instellen van deze waarden balanceert grootte en leesbaarheid. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` bepaalt de breedte van elke zwarte/witte balk. Een waarde van **2** werkt goed voor de meeste labelprinters. +* `Pdf417.Columns` geeft aan hoeveel kolommen de barcode zal gebruiken. Vijf kolommen leveren een compact symbool zonder verlies van datacapaciteit. + +## Stap 3: Definieer Macro PDF417‑informatie op bestandsniveau + +Macro PDF417 breidt het standaard PDF417‑formaat uit met velden die beschrijven hoe een groot bestand over meerdere barcode‑segmenten wordt verdeeld. Het leveren van deze velden zorgt ervoor dat downstream‑scanners het oorspronkelijke bestand kunnen reconstrueren. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` moet voor elk segment dat tot hetzelfde logische bestand behoort gelijk zijn. +* `MacroPdf417SegmentID` loopt van **0** tot `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` geeft de decoder aan hoeveel stukken er verwacht worden. +* `MacroPdf417FileName` is optioneel maar handig voor menselijk leesbare identificatie. + +## Stap 4: Extra macro‑metadata instellen + +Naast de kern‑bestand‑informatie staat de specificatie extra velden toe, zoals checksum, bestandsgrootte, timestamp, addressee, sender en een terminator‑vlag. Het invullen van deze velden verbetert de gegevensintegriteit en traceerbaarheid. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` levert een 16‑bit CCITT‑checksum voor het volledige bestand; de decoder kan de integriteit na reconstructie verifiëren. +* `MacroPdf417FileSize` moet de exacte byte‑telling van het oorspronkelijke bestand weerspiegelen; waarden groter dan `2^31‑1` vereisen een 64‑bit‑veld, wat Aspose automatisch afhandelt. +* `MacroPdf417TimeStamp` registreert wanneer de barcode is gegenereerd. Gebruik UTC om tijdzone‑ambiguïteit te vermijden. +* `MacroPdf417Addressee` en `MacroPdf417Sender` zijn vrije tekstvelden die routing‑informatie kunnen bevatten. +* `MacroPdf417Terminator` geeft aan dat dit het laatste segment is; zet het op `Set` voor het laatste stuk, anders laat je de standaard (`NotSet`) staan. + +**Tip voor randgevallen** – Als je bestandsgrootte groter is dan 4 GB, splits dan de inhoud over meerdere macro‑segmenten en pas `SegmentsCount` dienovereenkomstig aan. De bibliotheek beheert het groot‑formaat‑veld zonder overflow. + +## Stap 5: Sla de barcode op als PNG‑afbeelding + +De laatste stap schrijft het gegenereerde symbool naar schijf. PNG behoudt de exacte pixelafmetingen en wordt breed ondersteund door scanning‑hardware. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Vervang `YOUR_DIRECTORY` door een absoluut of relatief pad waar het uitvoerende proces naar kan schrijven. De `BarCodeImageFormat.Png`‑enum zorgt voor verliesvrije output. + +**Waarom PNG?** – Rasterformaten zoals PNG houden de module‑randen scherp, wat essentieel is voor scanners die vertrouwen op hoog‑contrast randen. Als je een vectorformaat nodig hebt, ondersteunt Aspose ook `Pdf` en `Svg`. + +## Volledig uitvoerbaar voorbeeld + +Hieronder vind je het complete programma dat je kunt kopiëren naar een console‑applicatie. Het bevat de benodigde `using`‑directives en een `Main`‑methode. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Verwachte output + +Het uitvoeren van het programma maakt een bestand genaamd **MacroPdf417.png** aan in de werkmap van het project. Het openen van de afbeelding toont een compact PDF417‑symbool met de ingebedde macro‑velden. Het scannen van de afbeelding met een PDF417‑compatibele lezer (bijv. ZXing, Aspose.BarCode‑decoder) levert de oorspronkelijke `"Sample text"`‑payload terug, samen met de macro‑metadata. + +## Veelgestelde vragen en probleemoplossing + +| Vraag | Antwoord | +|----------|--------| +| *Wat als de barcode te groot is voor het doel‑label?* | Verlaag `XDimension.Pixels` of vergroot `Pdf417.Columns`. Beide parameters beïnvloeden de totale grootte. | +| *Kan ik een vectorafbeelding genereren in plaats van PNG?* | Ja. Roep `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` aan voor schaalbare output. | +| *Hoe verifieer ik de checksum na het scannen?* | De Aspose.BarCode‑decoder valideert automatisch `MacroPdf417Checksum` en meldt afwijkingen in het `MacroPdf417Result`‑object. | +| *Is de bibliotheek compatibel met .NET Core?* | Het NuGet‑pakket ondersteunt .NET Standard 2.0+, wat .NET Core, .NET 5, .NET 6 en later dekt. | +| *Wat als ik binaire data wil embedden in plaats van tekst?* | Converteer de binaire payload naar Base64 of gebruik de `EncodeTypes.MacroPdf417`‑overload die een byte‑array accepteert. | + +## Pro‑tips voor productiegebruik + +* **Cache de generator** – + + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden getoond. Elke bron bevat volledige werkende code‑voorbeelden met stap‑voor‑stap‑uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/_index.md b/barcode/english/net/compact-pdf417-encoding/_index.md index 8353fd099..ba37111e0 100644 --- a/barcode/english/net/compact-pdf417-encoding/_index.md +++ b/barcode/english/net/compact-pdf417-encoding/_index.md @@ -45,8 +45,7 @@ schemas: - question: Can I generate a Compact PDF417 barcode in a .NET Core console app? answer: Yes. Aspose.BarCode for .NET fully supports .NET Core 3.1 and later, as well as .NET 5/6. - - question: Is it possible to customize the barcode’s foreground and background - colors? + - question: Is it possible to customize the barcode’s foreground and background colors? answer: Absolutely. Use the `ForeColor` and `BackColor` properties of the `BarcodeGenerator` to match your UI theme. - question: Do I need to install any additional fonts or resources? @@ -139,9 +138,23 @@ Compact PDF417’s high data density and robust error correction make it suitabl - **License Exceptions:** In a trial environment, the generated barcode may include a watermark. Apply a valid license to remove it. ## Compact PDF417 Encoding Tutorials +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + +### [How to create PDF417 barcode in C# and save it as PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + +Learn how to generate a PDF417 barcode in C# and export it as a PNG image using Aspose.BarCode. + ### [Creating Compact PDF417 Barcodes](./compact-pdf417-basic-configuration/) Learn how to generate Compact PDF417 barcodes using Aspose.BarCode for .NET. Comprehensive guide with step‑by‑step instructions and code examples. +### [How to create micro PDF417 barcode in C# – step‑by‑step guide](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [How to use a barcode generator C# for Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [How to read PDF417 barcodes in C# – complete guide](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Step‑by‑step guide to decode PDF417 barcodes in C# with Aspose.BarCode for .NET. + ## Frequently Asked Questions **Q: What is the maximum amount of data I can store in a Compact PDF417 barcode?** diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..eda603d0f --- /dev/null +++ b/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: en +lastmod: 2026-08-22 +og_description: Create micro PDF417 barcode in C# and export it as a PNG. Follow this + guide to set barcode dimensions and generate a barcode image quickly. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Create micro PDF417 barcode in C# – full coding tutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: How to create micro PDF417 barcode in C# – step‑by‑step guide +url: /net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to create micro PDF417 barcode in C# – step‑by‑step guide + +If you need to **create micro PDF417 barcode** for a ticketing system, inventory label, or mobile scan, this tutorial shows you exactly how. You’ll see the complete C# program that generates a barcode PNG, learn how to set barcode dimensions, and understand each configuration option. + +By the end of this guide you will be able to generate a high‑resolution barcode image, customize the X‑dimension, choose the column count, and save the result as a PNG file—all with a few lines of code. + +## What you’ll need + +- .NET 6.0 SDK or later (the code works with .NET Core and .NET Framework) +- Visual Studio 2022 or any C#‑compatible IDE +- The **Aspose.BarCode for .NET** NuGet package (or any library that supports `EncodeTypes.MicroPdf417`) +- Basic familiarity with C# syntax + +> **Pro tip:** The free community edition of Aspose.BarCode is sufficient for development and testing. For production, obtain a license to remove evaluation watermarks. + +## Step 1: Install the barcode library + +Open a terminal in your project folder and run: + +```bash +dotnet add package Aspose.BarCode +``` + +This adds the `Aspose.BarCode` assembly, which provides the `BarcodeGenerator` class used to **create barcode image C#** applications. + +## Step 2: Initialize the generator – create micro PDF417 barcode + +The first actionable line creates a `BarcodeGenerator` instance configured for the Micro PDF417 symbology and supplies the data you want to encode. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Why this matters*: The `EncodeTypes.MicroPdf417` enum tells the library to use the compact version of PDF417, which is ideal for small labels and mobile screens. + +## Step 3: How to set barcode dimensions in C# + +Fine‑tuning the module width (X‑dimension) controls the visual density of the barcode. A smaller value yields a sharper image, while a larger value makes the barcode easier to scan at a distance. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Why you should set dimensions**: Without adjusting the X‑dimension, the default value may produce a barcode that looks blurry when rendered at high DPI. Setting it to 2 pixels is a good balance for most screen‑based scans. + +## Step 4: Choose the number of columns – controlling barcode width + +Micro PDF417 allows between 1 and 4 columns. More columns compress the data horizontally, reducing the overall image width. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Edge case*: If you request 5 columns the library throws an `ArgumentOutOfRangeException`. Always stay within the documented range. + +## Step 5: How to generate barcode PNG – saving the image + +Now you can export the generated barcode to a PNG file. PNG preserves lossless quality, which is essential for reliable scanning. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +When you run the program, you’ll see a console message confirming the file location. The resulting `MicroPdf417.png` looks like this: + +![Screenshot showing a generated micro PDF417 barcode created with C#](micro-pdf417-example.png "Generated micro PDF417 barcode") + +*Image alt text*: **micro PDF417 barcode generated in C#** – demonstrates the final output after applying the dimensions and column settings. + +## Step 6: Run and verify the output + +1. Build the project: `dotnet build`. +2. Execute: `dotnet run`. +3. Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode scanner app. + +You should see the text **“Sample text”** decoded. If the scanner reports an error, double‑check the X‑dimension and column count – extreme values can make the barcode too dense for some devices. + +## Common variations and troubleshooting + +| Situation | Adjustment | +|-----------|------------| +| **Need a larger barcode for low‑resolution printers** | Increase `XDimension.Pixels` to 3 or 4. | +| **Want a taller barcode without changing width** | Set `generator.Parameters.Barcode.Pdf417.Rows` (rows range 3‑90). | +| **Generating multiple barcodes in a loop** | Re‑use the same `BarcodeGenerator` instance and only change `CodeText` before each `Save`. | +| **Saving as JPEG instead of PNG** | Replace `BarCodeImageFormat.Png` with `BarCodeImageFormat.Jpeg`. | +| **Running on .NET Framework 4.7** | The same code works; just reference the appropriate `Aspose.BarCode.dll`. | + +## Full source listing (runnable) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Expected output** – a 200 × 100‑pixel PNG file containing a crisp Micro PDF417 barcode that decodes to “Sample text”. + +## Conclusion + +You now know how to **create micro PDF417 barcode** in C#, **set barcode dimensions**, and **generate a barcode PNG** image. The complete example demonstrates every required step—from library installation to saving the final file—so you can embed barcode generation directly into your own applications. + +Next, explore related topics such as **creating QR codes with Aspose.BarCode**, **customizing colors**, or **embedding barcodes in PDF documents**. Each of those builds on the same `BarcodeGenerator` fundamentals covered here. + +Feel free to experiment with different data strings, column counts, and X‑dimension values to suit your specific scanning environment. Happy coding! + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/og-image.png b/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/og-image.png new file mode 100644 index 000000000..97af39d40 Binary files /dev/null and b/barcode/english/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/og-image.png differ diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..6e9ca6625 --- /dev/null +++ b/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Learn how to create PDF417 barcode in C# with a barcode generator, set + layout, and save PNG. Includes full code and tips for barcode generator C# projects. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: en +lastmod: 2026-08-22 +og_description: Create PDF417 barcode in C# using a barcode generator, customize layout, + and learn how to save PNG. Follow this step‑by‑step tutorial. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Create PDF417 barcode in C# – full guide to generating and saving PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: How to create PDF417 barcode in C# and save it as PNG +url: /net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to create PDF417 barcode in C# and save it as PNG + +If you need to **create PDF417 barcode** in a C# application, this tutorial shows you the exact steps. You’ll see how a barcode generator C# library can turn any string into a scannable PDF417 image and how to save PNG files without extra tools. + +Generating barcodes is common in logistics, ticketing, and document management. By the end of this guide you will have a runnable console program that produces a PNG file named `Pdf417Layout.png` in the folder you choose. + +## Prerequisites + +Before you start, make sure you have: + +- .NET 6.0 SDK or later installed (the code also works with .NET Framework 4.7+). +- Visual Studio 2022 or any editor that can build C# projects. +- The **Aspose.BarCode for .NET** NuGet package (or any compatible barcode generator C# library). + Install it with: + +```bash +dotnet add package Aspose.BarCode +``` + +No additional image‑processing libraries are required because the generator can write PNG directly. + +## Step 1: Set up a new console project + +Create a fresh console project so the example stays self‑contained. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +The `Pdf417Demo` folder now contains a `Program.cs` file where we will write the barcode code. + +## Step 2: Import the barcode namespace + +Open `Program.cs` and add the required `using` directive at the top: + +```csharp +using Aspose.BarCode.Generation; +``` + +This namespace gives you access to `BarcodeGenerator`, `EncodeTypes`, and the image‑format enum needed for **how to save PNG**. + +## Step 3: Create the PDF417 barcode generator + +The core of **how to generate PDF417** is the `BarcodeGenerator` class. Pass the encode type `EncodeTypes.Pdf417` and the text you want encoded. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` now holds all settings for the barcode. The default layout works, but we’ll customize it in the next step. + +## Step 4: Define the barcode layout (columns and rows) + +PDF417 allows you to control the number of columns (2‑30) and rows (1‑90). Adjusting these values can improve readability for specific scanners. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tip:** If you omit these settings, the library chooses optimal values automatically. However, fixing columns and rows gives you predictable image dimensions, which is useful when you embed the PNG in a PDF or a UI layout. + +## Step 5: Save the generated barcode as a PNG image + +Now answer **how to save PNG** by calling `Save`. The method accepts the target path and the image format enum. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +The file `Pdf417Layout.png` appears in the project’s `bin/Debug/net6.0` folder after you run the program. + +## Full runnable example + +Below is the complete `Program.cs` file. Copy it into the project created in **Step 1** and run `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Expected output + +When you run the program, the console prints the absolute path to the PNG file, and the file contains a clear PDF417 barcode that looks similar to the image below. + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +You can scan the PNG with any PDF417‑compatible scanner (mobile apps, hardware readers) to verify that the encoded text is `"Sample"`. + +## Handling edge cases and common pitfalls + +| Situation | What to watch for | Recommended fix | +|-----------|-------------------|-----------------| +| **Invalid column/row values** | Values outside the 2‑30 (columns) or 1‑90 (rows) range cause an `ArgumentException`. | Validate user input before assigning, or let the library choose defaults. | +| **Large input strings** | PDF417 can encode up to 1,850 characters, but very long strings increase the required rows dramatically. | Split the data into multiple barcodes or use a higher error‑correction level if needed. | +| **File‑system permissions** | Saving to a read‑only folder throws an `UnauthorizedAccessException`. | Write to `Environment.CurrentDirectory` or a user‑writable path, and handle exceptions with try/catch. | +| **Missing NuGet package** | Compilation fails with “type or namespace name could not be found”. | Ensure `Aspose.BarCode` is installed (`dotnet add package Aspose.BarCode`). | + +## Extending the example + +Now that you know **how to create PDF417 barcode** and **how to save PNG**, you can explore these related topics: + +- **Barcode generator C#**: Change the `EncodeTypes` to `Code128`, `QR`, or other symbologies. +- **Custom colors**: Use `generator.Parameters.Barcode.ForegroundColor` and `BackgroundColor` to match branding. +- **Embedding in PDFs**: Combine the PNG with a PDF library (e.g., iText7) to create printable documents. +- **Dynamic data**: Pull the text from a database or user input to generate barcodes on the fly. + +## Conclusion + +You now have a complete, production‑ready solution for **create PDF417 barcode** in C# and save the result as a PNG file. The tutorial covered every step from project setup to layout customization, and it highlighted how to avoid common errors when using a barcode generator C# library. + +Feel free to experiment with different column/row settings, colors, or even other barcode formats. If you run into any issues, revisit the **how to generate PDF417** section or explore the library’s documentation for advanced features. Happy coding! + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode Quiet Zone for ITF-14 Using Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/og-image.png b/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/og-image.png new file mode 100644 index 000000000..621804f42 Binary files /dev/null and b/barcode/english/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/og-image.png differ diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..da20fde94 --- /dev/null +++ b/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set barcode + size, adjust columns, and enable compact mode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: en +lastmod: 2026-08-22 +og_description: Generate PDF417 barcode in C# with Aspose.BarCode. This guide shows + how to set barcode size, control columns, and enable compact mode for a smaller + image. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Generate PDF417 barcode in C# – set size, columns, and compact mode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: How to generate PDF417 barcode in C# and set barcode size +url: /net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to generate PDF417 barcode in C# and set barcode size + +If you need to **generate PDF417 barcode** in a .NET application, this guide walks you through the complete process. You’ll see exactly **how to generate PDF417** with Aspose.BarCode, adjust the **set barcode size**, and produce a compact PNG that can be embedded in reports or mobile apps. + +Creating a barcode doesn’t require a separate graphics editor. By the end of this tutorial you will have a fully functional C# method that produces a PDF417 image with the exact dimensions you need, ready for downstream processing. + +## What you’ll learn + +* Install and reference the Aspose.BarCode library. +* Create a PDF417 barcode generator and specify the encoded text. +* **Set barcode size** by configuring X‑dimension and column count. +* Enable compact (truncated) mode to shrink the symbol. +* Save the result as a PNG file. +* Troubleshoot common issues such as unreadable codes and oversized images. + +### Prerequisites + +* .NET 6.0 or later (the API works with .NET Framework 4.6+ as well). +* Basic familiarity with C# and Visual Studio (or any C# IDE). +* A valid Aspose.BarCode license (the free evaluation works for testing). + +> **Pro tip:** If you plan to generate many barcodes in a loop, reuse a single `BarcodeGenerator` instance and only change the `CodeText` property. This reduces memory allocations. + +## Generate PDF417 barcode with Aspose.BarCode + +The first step is to instantiate the `BarcodeGenerator` for the PDF417 symbology. This object is the entry point for all barcode operations. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Why this matters*: `EncodeTypes.Pdf417` tells the library to use the PDF417 standard, which supports large data volumes and error correction. The constructor also accepts the data you want to encode, eliminating the need for a separate `CodeText` assignment later. + +## Set barcode size and column count + +PDF417 symbols consist of rows and columns of small rectangular modules. Controlling the module width (X‑dimension) and the number of columns lets you fine‑tune the overall dimensions. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explanation*: +* **X‑dimension** (`Pixels`) determines how wide each module is. Smaller values produce a tighter barcode, while larger values increase readability on low‑resolution scanners. +* **Columns** control the horizontal layout. Fewer columns make the barcode taller; more columns make it wider. Adjust these two settings together to achieve the exact **set barcode size** you need. + +## Enable compact mode for a smaller barcode + +PDF417 includes a “compact” (or truncated) mode that removes unnecessary padding and reduces the overall footprint. This is especially useful when you have limited screen real estate. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Why enable truncation?* +When `Truncate` is `true`, the generator omits the stop pattern and some error‑correction codewords that are not required for most scanning scenarios. The resulting image is roughly 15‑20 % smaller without sacrificing data integrity for typical use cases. + +## Save the barcode as a PNG image + +After configuring size and mode, write the barcode to disk. PNG is lossless, ensuring that the module edges remain sharp. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +The file `CompactPdf417.png` will contain a crisp PDF417 symbol that matches the dimensions you set in the previous steps. + +### Expected output + +Opening the saved PNG should display a vertical‑oriented PDF417 barcode consisting of three columns, each module 2 px wide, and a total size of roughly **120 × 240 px** (width × height). Scanning the image with any standard PDF417 reader returns the original text “Sample text for PDF417”. + +## Common pitfalls and how to avoid them + +| Symptom | Likely cause | Fix | +|---------|--------------|-----| +| Barcode is unreadable | X‑dimension too small for the scanner | Increase `XDimension.Pixels` to 3 or 4 | +| Image is too wide for UI | Too many columns set | Reduce `Pdf417.Columns` or enable `Truncate` | +| Exception `ArgumentOutOfRangeException` | Negative or zero column count | Ensure `Columns` is a positive integer (minimum 1) | +| PNG file is empty | Output path does not exist or lacks write permission | Verify the directory exists and the app has write rights | + +> **Pro tip:** Use `barcodeGenerator.ValidateParameters()` before calling `Save()` to catch configuration errors early. + +## Full, runnable example + +Below is a self‑contained console program that incorporates all the steps above. Copy it into a new C# project, restore the Aspose.BarCode NuGet package, and run it to see the result. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Running the program** produces `CompactPdf417.png` in the executable’s working directory. Scan the image with a mobile app (e.g., “Barcode Scanner”) to verify that the encoded text matches the source string. + +## Next steps and related topics + +* **Increase error correction level** – adjust `Pdf417.ErrorLevel` for environments with noisy scans. +* **Change orientation** – set `Pdf417.Rotate` to `RotationAngle.Rotate90` if you need a horizontal layout. +* **Embed the barcode in a PDF** – combine Aspose.PDF with Aspose.BarCode to place the image directly into a document. +* **Generate other 2‑D barcodes** – the same `BarcodeGenerator` class supports DataMatrix, QR, and Aztec codes; just swap `EncodeTypes.Pdf417` for the desired symbology. + +By mastering **generate PDF417 barcode** techniques, you can automate ticketing, inventory labeling, and secure data transmission across a wide range of .NET applications. + +## Conclusion + +You now know how to **generate PDF417 barcode** in C#, precisely **set barcode size**, configure columns, enable compact mode, and save the result as a PNG. Apply these settings to fit any UI constraint or scanning requirement, and extend the approach to other barcode formats as needed. Happy coding! + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/og-image.png b/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/og-image.png new file mode 100644 index 000000000..a62046ac6 Binary files /dev/null and b/barcode/english/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/og-image.png differ diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..4e2edd31b --- /dev/null +++ b/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: en +lastmod: 2026-08-22 +og_description: How to read PDF417 barcodes in C# quickly. This tutorial shows you + how to read multiple barcodes from an image and retrieve MacroPdf417 extended information. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: How to read PDF417 barcodes in C# – full programming walkthrough +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: How to read PDF417 barcodes in C# – complete guide +url: /net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to read PDF417 barcodes in C# – complete guide + +If you need to **how to read PDF417** bars in a .NET application, this tutorial gives you a ready‑to‑run solution. You’ll learn how to read multiple barcodes from a single image, extract the full MacroPdf417 data set, and display it in the console. The approach works with the Aspose.BarCode for .NET library and requires only a few lines of code. + +Reading barcodes from an image is a common task in inventory systems, ticket validation, and document management. By the end of this guide you will be able to decode any PDF417 or MacroPdf417 barcode, handle several codes in one picture, and understand the extended fields that MacroPdf417 provides. + +## Prerequisites + +- .NET 6.0 SDK or later (the code also compiles with .NET Framework 4.7+) +- Visual Studio 2022 or any C# editor you prefer +- Aspose.BarCode for .NET NuGet package (`Install-Package Aspose.BarCode`) +- A sample image that contains a MacroPdf417 barcode (e.g., `MacroPdf417.png`) + +No additional configuration is required; the library handles image loading and decoding internally. + +## How to read PDF417 barcodes from an image in C# + +The core of the solution is the `BarCodeReader` class. It opens the image, detects all barcodes of the specified type, and returns a collection of `BarCodeResult` objects. The following code shows a complete console program. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Why each line matters + +| Step | Purpose | +|------|---------| +| **1️⃣ Initialize** | Creates a `BarCodeReader` bound to the image file and restricts detection to the MacroPdf417 symbology, which speeds up processing. | +| **2️⃣ Iterate** | `ReadBarCodes()` returns **all** barcodes that match the requested type, enabling you to **read multiple barcodes** without extra loops. | +| **3️⃣ Basic output** | Shows the generic `CodeTypeName` and the human‑readable `CodeText`. This is useful for logging or quick validation. | +| **4️⃣ Extended data** | MacroPdf417 carries additional metadata (file ID, segment count, timestamps, etc.). The `Extended.Pdf417` object exposes each field directly, so you can store or verify the whole data packet. | + +Running the program against a valid MacroPdf417 image produces console output similar to the following: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +The output confirms that the library successfully read the barcode, extracted the text, and provided every MacroPdf417 field. + +## Reading multiple barcodes from a single image + +Many real‑world scenarios place several PDF417 symbols on one label—think of a shipping manifest that contains a carrier code, a tracking number, and a customs declaration. The same code block above already **read multiple barcodes** because `ReadBarCodes()` returns an enumerable of all matches. No additional configuration is needed; you only have to loop through the results, as demonstrated. + +If you want to limit the reader to standard PDF417 (non‑macro) while still handling several codes, replace `DecodeType.MacroPdf417` with `DecodeType.Pdf417`. The rest of the logic stays unchanged. + +## Understanding MacroPdf417 extended data + +MacroPdf417 is an extension of the regular PDF417 specification. It splits large payloads into multiple segments and adds a small header that describes the whole file. The most relevant fields are: + +- **MacroPdf417FileID** – a unique identifier shared by all segments of the same file. +- **MacroPdf417SegmentID** – the sequence number of the current segment. +- **MacroPdf417SegmentsCount** – total number of segments expected. +- **MacroPdf417FileName** – optional file name transmitted with the barcode. +- **MacroPdf417Checksum** – error‑checking value for the complete file. +- **MacroPdf417FileSize** – size of the original binary payload. +- **MacroPdf417TimeStamp** – ISO‑8601 timestamp when the barcode was generated. +- **MacroPdf417Addressee / Sender** – optional textual fields for routing. +- **MacroPdf417Terminator** – indicates whether this segment is the final one. + +When you receive all segments, you can reconstruct the original file by ordering them by `MacroPdf417SegmentID` and concatenating the `CodeText` values. This logic is straightforward to implement once you have the fields available. + +## Common pitfalls and pro tips + +- **Image quality matters** – low‑resolution or heavily compressed PNG/JPEG files can cause missed detections. Use a DPI of at least 300 dpi for printed barcodes. +- **Mixed symbologies** – if the image contains both MacroPdf417 and regular PDF417, instantiate two readers (one for each `DecodeType`) or use `DecodeType.AllSupported` and filter results by `result.CodeTypeName`. +- **Memory usage** – the `using` statement disposes the `BarCodeReader` promptly, preventing large image buffers from staying in memory. +- **Thread safety** – `BarCodeReader` is not thread‑safe. Create a separate instance per thread if you decode images in parallel. +- **Error handling** – wrap the `ReadBarCodes()` call in a try/catch block to capture `BarCodeException` for corrupted images. + +## Full working example recap + +Below is the complete program you can copy into a new console project. It includes all `using` directives, a constant for the image path, and the disposal pattern. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compile with `dotnet build` and run with `dotnet run`. The console prints every barcode’s basic data and the full MacroPdf417 payload. + +## Next steps + +- **Reconstruct multipart files** – collect all segments, sort by `MacroPdf417SegmentID`, and concatenate `CodeText` to + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Read PDF417 Barcodes with Turkish Characters in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [How to Use Aspose for PDF417 Barcode (Chinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/og-image.png b/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/og-image.png new file mode 100644 index 000000000..767919aa1 Binary files /dev/null and b/barcode/english/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/og-image.png differ diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..f1b11074d --- /dev/null +++ b/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-08-22 +description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: en +lastmod: 2026-08-22 +og_description: barcode generator C# lets you produce a Macro PDF417 barcode with + full file‑level metadata and export it as PNG. Follow this guide to implement the + solution. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: barcode generator C# – create Macro PDF417 barcodes step‑by‑step +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: How to use a barcode generator C# for Macro PDF417 +url: /net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to use a barcode generator C# for Macro PDF417 + +If you need a **barcode generator C#** that can emit a Macro PDF417 symbol with file‑level metadata, this guide provides a complete, ready‑to‑run solution. You’ll see how to configure the barcode appearance, embed macro information such as file ID and segment count, and finally save the result as a PNG image. + +The example uses the Aspose.BarCode library, a widely adopted **C# barcode library** that supports the full PDF417 feature set. No external services are required, and the code works with .NET 6 or later. + +## Prerequisites + +Before you start, make sure you have: + +* .NET 6 SDK (or any later version) installed. +* Visual Studio 2022, VS Code, or another C# IDE. +* A NuGet reference to **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Understanding basic C# syntax and the concept of PDF417 barcodes will help you follow the steps, but the tutorial explains every configuration option in detail. + +## What the tutorial covers + +* Initializing a **barcode generator C#** instance for the Macro PDF417 format. +* Adjusting visual parameters such as X‑dimension and column count. +* Supplying Macro PDF417 file‑level fields: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender, and terminator. +* Saving the generated symbol as a PNG file. +* Tips for handling edge cases like large file sizes or custom timestamps. + +By the end of this article you will have a self‑contained program that produces a fully compliant Macro PDF417 barcode. + +## Step 1: Create the barcode generator C# instance + +The first operation is to instantiate `BarcodeGenerator` with the `EncodeTypes.MacroPdf417` enum value and the text you want to encode. The constructor also accepts the payload string, which becomes the data portion of the macro barcode. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Why this matters** – The `EncodeTypes.MacroPdf417` flag tells Aspose.BarCode to treat the symbol as a macro barcode, enabling the extra fields that follow. Without this flag the library would generate a regular PDF417 barcode lacking file‑level metadata. + +## Step 2: Adjust basic barcode appearance (PDF417 visual settings) + +Visual clarity is crucial for reliable scanning. Two common parameters are the module width (`XDimension`) and the number of columns. Setting these values balances size and readability. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` controls the width of each black/white bar. A value of **2** works well for most label printers. +* `Pdf417.Columns` defines how many columns the barcode will use. Five columns produce a compact symbol without sacrificing data capacity. + +## Step 3: Define Macro PDF417 file‑level information + +Macro PDF417 extends the standard PDF417 format with fields that describe how a large file is split across multiple barcode segments. Supplying these fields ensures that downstream scanners can reconstruct the original file. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` must be the same for every segment belonging to the same logical file. +* `MacroPdf417SegmentID` increments from **0** to `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` tells the decoder how many pieces to expect. +* `MacroPdf417FileName` is optional but helpful for human‑readable identification. + +## Step 4: Set additional macro metadata + +Beyond the core file information, the specification allows extra fields such as checksum, file size, timestamp, addressee, sender, and a terminator flag. Populating these fields improves data integrity and traceability. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` provides a 16‑bit CCITT checksum for the entire file; the decoder can verify integrity after reconstruction. +* `MacroPdf417FileSize` should reflect the exact byte count of the original file; values larger than `2^31‑1` require a 64‑bit field, which Aspose handles automatically. +* `MacroPdf417TimeStamp` records when the barcode was generated. Use UTC to avoid timezone ambiguity. +* `MacroPdf417Addressee` and `MacroPdf417Sender` are free‑form strings that can store routing information. +* `MacroPdf417Terminator` signals that this is the final segment; set it to `Set` for the last piece, otherwise leave the default (`NotSet`). + +**Edge‑case tip** – If your file size exceeds 4 GB, split the content into multiple macro segments and adjust `SegmentsCount` accordingly. The library will manage the large‑size field without overflow. + +## Step 5: Save the barcode as a PNG image + +The final step writes the generated symbol to disk. PNG preserves the exact pixel dimensions and is widely supported by scanning hardware. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Replace `YOUR_DIRECTORY` with an absolute or relative path that the executing process can write to. The `BarCodeImageFormat.Png` enum ensures lossless output. + +**Why PNG?** – Raster formats like PNG keep the module edges sharp, which is essential for scanners that rely on high‑contrast edges. If you need a vector format, Aspose also supports `Pdf` and `Svg`. + +## Full runnable example + +Below is the complete program you can copy into a console application. It includes the necessary `using` directives and a `Main` method. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Expected output + +Running the program creates a file named **MacroPdf417.png** in the project’s working directory. Opening the image shows a compact PDF417 barcode with the embedded macro fields. Scanning the image with a PDF417‑compatible reader (e.g., ZXing, Aspose.BarCode decoder) returns the original `"Sample text"` payload along with the macro metadata. + +## Common questions and troubleshooting + +| Question | Answer | +|----------|--------| +| *What if the barcode is too large for the target label?* | Reduce `XDimension.Pixels` or increase `Pdf417.Columns`. Both parameters affect overall size. | +| *Can I generate a vector image instead of PNG?* | Yes. Call `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` for scalable output. | +| *How do I verify the checksum after scanning?* | The Aspose.BarCode decoder automatically validates `MacroPdf417Checksum` and reports mismatches in the `MacroPdf417Result` object. | +| *Is the library compatible with .NET Core?* | The NuGet package supports .NET Standard 2.0+, which covers .NET Core, .NET 5, .NET 6, and later. | +| *What if I need to embed binary data instead of text?* | Convert the binary payload to Base64 or use the `EncodeTypes.MacroPdf417` overload that accepts a byte array. | + +## Pro tips for production use + +* **Cache the generator** – + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/og-image.png b/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/og-image.png new file mode 100644 index 000000000..d1f0d174d Binary files /dev/null and b/barcode/english/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/og-image.png differ diff --git a/barcode/french/net/compact-pdf417-encoding/_index.md b/barcode/french/net/compact-pdf417-encoding/_index.md index c89af8dbf..93c3f1ba9 100644 --- a/barcode/french/net/compact-pdf417-encoding/_index.md +++ b/barcode/french/net/compact-pdf417-encoding/_index.md @@ -68,7 +68,7 @@ Si vous recherchez un guide clair, étape par étape sur **comment générer un - **Qu'est-ce que le Compact PDF417 ?** Un code‑barres bidimensionnel qui stocke de grandes quantités de données dans une zone compacte. - **Pourquoi choisir Aspose.BarCode pour .NET ?** API complète, prise en charge solide de la correction d’erreurs et intégration facile. - **Ai‑je besoin d’une licence ?** Un essai gratuit suffit pour le développement ; une licence est requise pour la production. -- **Plateformes prises en charge ?** .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+. +- **Plateformes prises en charge ?** .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+. - **Temps d’implémentation typique ?** Environ 10‑15 minutes pour un code‑barres de base. ## Qu'est-ce que l'encodage Compact PDF417 ? @@ -142,9 +142,20 @@ La haute densité de données et la correction d’erreurs robuste du Compact PD ## Tutoriels d’encodage Compact PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + +### [Comment créer un code‑barres PDF417 en C# et l’enregistrer au format PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + ### [Créer des codes‑barres Compact PDF417](./compact-pdf417-basic-configuration/) Apprenez à générer des codes‑barres Compact PDF417 en utilisant Aspose.BarCode pour .NET. Guide complet avec des instructions étape par étape et des exemples de code. +### [Comment créer un code‑barres micro PDF417 en C# – guide étape par étape](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [Comment utiliser un générateur de code‑barres C# pour Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [Comment lire les codes‑barres PDF417 en C# – guide complet](./how-to-read-pdf417-barcodes-in-c-complete-guide/) + + ## Foire aux questions **Q : Quelle est la quantité maximale de données que je peux stocker dans un code‑barres Compact PDF417 ?** diff --git a/barcode/french/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/french/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..6bf1359d2 --- /dev/null +++ b/barcode/french/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Apprenez à créer un code‑barres micro PDF417 en C# et à générer une image + PNG du code‑barres. Inclut la définition des dimensions du code‑barres et l’enregistrement + du fichier. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: fr +lastmod: 2026-08-22 +og_description: Créez un code‑barres micro PDF417 en C# et exportez‑le au format PNG. + Suivez ce guide pour définir les dimensions du code‑barres et générer rapidement + une image de code‑barres. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Créer un code‑barres micro PDF417 en C# – tutoriel complet de codage +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Comment créer un code‑barres micro PDF417 en C# – guide étape par étape +url: /fr/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment créer un code-barres micro PDF417 en C# – guide étape par étape + +Si vous devez **créer un code-barres micro PDF417** pour un système de billetterie, une étiquette d'inventaire ou une numérisation mobile, ce tutoriel vous montre exactement comment faire. Vous verrez le programme complet en C# qui génère un PNG de code-barres, apprendrez à définir les dimensions du code-barres et comprendrez chaque option de configuration. + +À la fin de ce guide, vous serez capable de générer une image de code-barres haute résolution, de personnaliser la X‑dimension, de choisir le nombre de colonnes et d’enregistrer le résultat sous forme de fichier PNG — le tout en quelques lignes de code. + +## Ce dont vous avez besoin + +- .NET 6.0 SDK ou version ultérieure (le code fonctionne avec .NET Core et .NET Framework) +- Visual Studio 2022 ou tout IDE compatible C# +- Le package NuGet **Aspose.BarCode for .NET** (ou toute bibliothèque qui prend en charge `EncodeTypes.MicroPdf417`) +- Une connaissance de base de la syntaxe C# + +> **Astuce :** L’édition communautaire gratuite d’Aspose.BarCode suffit pour le développement et les tests. Pour la production, obtenez une licence afin de supprimer les filigranes d’évaluation. + +## Étape 1 : Installer la bibliothèque de codes-barres + +Ouvrez un terminal dans le dossier de votre projet et exécutez : + +```bash +dotnet add package Aspose.BarCode +``` + +Cela ajoute l'assembly `Aspose.BarCode`, qui fournit la classe `BarcodeGenerator` utilisée pour **créer des applications d’image de code-barres C#**. + +## Étape 2 : Initialiser le générateur – créer un code-barres micro PDF417 + +La première ligne opérationnelle crée une instance de `BarcodeGenerator` configurée pour la symbologie Micro PDF417 et fournit les données que vous souhaitez encoder. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Pourquoi c’est important* : L’énumération `EncodeTypes.MicroPdf417` indique à la bibliothèque d’utiliser la version compacte du PDF417, idéale pour les petites étiquettes et les écrans mobiles. + +## Étape 3 : Comment définir les dimensions du code-barres en C# + +Le réglage fin de la largeur du module (X‑dimension) contrôle la densité visuelle du code-barres. Une valeur plus petite produit une image plus nette, tandis qu’une valeur plus grande rend le code-barres plus facile à scanner à distance. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Pourquoi vous devez définir les dimensions** : Sans ajuster la X‑dimension, la valeur par défaut peut produire un code-barres flou lorsqu’il est rendu à haute résolution DPI. La régler à 2 pixels constitue un bon compromis pour la plupart des scans basés sur écran. + +## Étape 4 : Choisir le nombre de colonnes – contrôler la largeur du code-barres + +Micro PDF417 autorise entre 1 et 4 colonnes. Plus de colonnes compressent les données horizontalement, réduisant la largeur globale de l’image. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Cas limite* : Si vous demandez 5 colonnes, la bibliothèque lève une `ArgumentOutOfRangeException`. Restez toujours dans la plage documentée. + +## Étape 5 : Comment générer un PNG de code-barres – enregistrer l’image + +Vous pouvez maintenant exporter le code-barres généré vers un fichier PNG. Le PNG conserve une qualité sans perte, ce qui est essentiel pour un scan fiable. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Lorsque vous exécutez le programme, vous verrez un message console confirmant l’emplacement du fichier. Le `MicroPdf417.png` résultant ressemble à ceci : + +![Capture d’écran montrant un code-barres micro PDF417 généré avec C#](micro-pdf417-example.png "Code-barres micro PDF417 généré") + +*Texte alternatif de l’image* : **code-barres micro PDF417 généré en C#** – montre le résultat final après l’application des dimensions et des paramètres de colonnes. + +## Étape 6 : Exécuter et vérifier la sortie + +1. Construisez le projet : `dotnet build`. +2. Exécutez : `dotnet run`. +3. Ouvrez `MicroPdf417.png` sur votre bureau et scannez‑le avec une application de scanner de code‑barres mobile. + +Vous devriez voir le texte **« Sample text »** décodé. Si le scanner signale une erreur, revérifiez la X‑dimension et le nombre de colonnes – des valeurs extrêmes peuvent rendre le code‑barres trop dense pour certains appareils. + +## Variations courantes et dépannage + +| Situation | Ajustement | +|-----------|------------| +| **Besoin d’un code‑barres plus grand pour les imprimantes basse résolution** | Augmentez `XDimension.Pixels` à 3 ou 4. | +| **Voulez un code‑barres plus haut sans changer la largeur** | Définissez `generator.Parameters.Barcode.Pdf417.Rows` (plage de lignes 3‑90). | +| **Générer plusieurs codes‑barres dans une boucle** | Réutilisez la même instance `BarcodeGenerator` et ne changez que `CodeText` avant chaque `Save`. | +| **Enregistrer en JPEG au lieu de PNG** | Remplacez `BarCodeImageFormat.Png` par `BarCodeImageFormat.Jpeg`. | +| **Exécuter sur .NET Framework 4.7** | Le même code fonctionne ; il suffit de référencer le `Aspose.BarCode.dll` approprié. | + +## Liste complète du code source (exécutable) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Sortie attendue** – un fichier PNG de 200 × 100 pixels contenant un code‑barres Micro PDF417 net qui se décode en « Sample text ». + +## Conclusion + +Vous savez maintenant comment **créer un code‑barres micro PDF417** en C#, **définir les dimensions du code‑barres**, et **générer une image PNG de code‑barres**. L’exemple complet montre chaque étape requise — de l’installation de la bibliothèque à l’enregistrement du fichier final — afin que vous puissiez intégrer la génération de codes‑barres directement dans vos propres applications. + +Ensuite, explorez des sujets connexes tels que **créer des QR codes avec Aspose.BarCode**, **personnaliser les couleurs**, ou **intégrer des codes‑barres dans des documents PDF**. Chacun de ces sujets s’appuie sur les mêmes fondamentaux `BarcodeGenerator` présentés ici. + +N’hésitez pas à expérimenter avec différentes chaînes de données, nombres de colonnes et valeurs de X‑dimension pour répondre à votre environnement de scan spécifique. Bon codage ! + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s’appuient sur les techniques démontrées dans ce guide. Chaque ressource inclut des exemples de code complets et fonctionnels avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités API supplémentaires et explorer des approches d’implémentation alternatives dans vos propres projets. + +- [Comment créer un code‑barres – PDF417 compact avec Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Comment générer un code‑barres PDF417 – Encodage PDF417 compact](/barcode/english/net/compact-pdf417-encoding/) +- [Comment créer un code‑barres Aztec avec Aspose.BarCode pour .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/french/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/french/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..ae33e15a9 --- /dev/null +++ b/barcode/french/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Apprenez à créer un code‑barres PDF417 en C# avec un générateur de codes‑barres, + à définir la mise en page et à enregistrer en PNG. Inclut le code complet et des + conseils pour les projets de générateur de codes‑barres C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: fr +lastmod: 2026-08-22 +og_description: Créez un code‑barres PDF417 en C# à l’aide d’un générateur de codes‑barres, + personnalisez la mise en page et apprenez à enregistrer en PNG. Suivez ce tutoriel + étape par étape. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Créer un code‑barres PDF417 en C# – guide complet pour générer et enregistrer + un PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Comment créer un code‑barres PDF417 en C# et l’enregistrer au format PNG +url: /fr/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment créer un code-barres PDF417 en C# et l’enregistrer en PNG + +Si vous devez **créer un code-barres PDF417** dans une application C#, ce tutoriel vous montre les étapes exactes. Vous verrez comment une bibliothèque de génération de code-barres C# peut transformer n'importe quelle chaîne en une image PDF417 lisible et comment enregistrer des fichiers PNG sans outils supplémentaires. + +La génération de codes-barres est courante dans la logistique, la billetterie et la gestion de documents. À la fin de ce guide, vous disposerez d’un programme console exécutable qui produit un fichier PNG nommé `Pdf417Layout.png` dans le dossier de votre choix. + +## Prérequis + +- .NET 6.0 SDK ou version ultérieure installé (le code fonctionne également avec .NET Framework 4.7+). +- Visual Studio 2022 ou tout éditeur capable de compiler des projets C#. +- Le package NuGet **Aspose.BarCode for .NET** (ou toute bibliothèque compatible de génération de code-barres C#). + Installez-le avec : + +```bash +dotnet add package Aspose.BarCode +``` + +Aucune bibliothèque supplémentaire de traitement d'image n'est requise car le générateur peut écrire directement en PNG. + +## Étape 1 : Configurer un nouveau projet console + +Créez un nouveau projet console afin que l'exemple reste autonome. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Le dossier `Pdf417Demo` contient désormais un fichier `Program.cs` où nous écrirons le code du code-barres. + +## Étape 2 : Importer l'espace de noms du code-barres + +Ouvrez `Program.cs` et ajoutez la directive `using` requise en haut du fichier : + +```csharp +using Aspose.BarCode.Generation; +``` + +Cet espace de noms vous donne accès à `BarcodeGenerator`, `EncodeTypes` et à l'énumération du format d'image nécessaire pour **comment enregistrer le PNG**. + +## Étape 3 : Créer le générateur de code-barres PDF417 + +Le cœur de **comment générer PDF417** est la classe `BarcodeGenerator`. Passez le type d'encodage `EncodeTypes.Pdf417` ainsi que le texte que vous souhaitez encoder. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` contient maintenant tous les paramètres du code-barres. La disposition par défaut fonctionne, mais nous la personnaliserons à l'étape suivante. + +## Étape 4 : Définir la disposition du code-barres (colonnes et lignes) + +PDF417 vous permet de contrôler le nombre de colonnes (2‑30) et de lignes (1‑90). Ajuster ces valeurs peut améliorer la lisibilité pour certains lecteurs. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Astuce :** Si vous omettez ces paramètres, la bibliothèque choisit automatiquement les valeurs optimales. Cependant, fixer les colonnes et les lignes vous donne des dimensions d'image prévisibles, ce qui est utile lorsque vous intégrez le PNG dans un PDF ou une mise en page UI. + +## Étape 5 : Enregistrer le code-barres généré en tant qu'image PNG + +Répondez maintenant à **comment enregistrer le PNG** en appelant `Save`. La méthode accepte le chemin cible et l'énumération du format d'image. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Le fichier `Pdf417Layout.png` apparaît dans le dossier `bin/Debug/net6.0` du projet après l'exécution du programme. + +## Exemple complet exécutable + +Voici le fichier complet `Program.cs`. Copiez-le dans le projet créé à la **Étape 1** et exécutez `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Résultat attendu + +Lorsque vous exécutez le programme, la console affiche le chemin absolu du fichier PNG, et le fichier contient un code-barres PDF417 net qui ressemble à l'image ci‑dessous. + +![exemple de création de code-barres PDF417](image-placeholder.png "Code-barres PDF417 enregistré en PNG") + +Vous pouvez scanner le PNG avec n'importe quel lecteur compatible PDF417 (applications mobiles, lecteurs matériels) pour vérifier que le texte encodé est `"Sample"`. + +## Gestion des cas limites et des pièges courants + +| Situation | Points d'attention | Solution recommandée | +|-----------|-------------------|----------------------| +| **Valeurs de colonne/ligne invalides** | Des valeurs en dehors de la plage 2‑30 (colonnes) ou 1‑90 (lignes) provoquent une `ArgumentException`. | Validez l'entrée utilisateur avant de l'assigner, ou laissez la bibliothèque choisir les valeurs par défaut. | +| **Chaînes d'entrée longues** | PDF417 peut encoder jusqu'à 1 850 caractères, mais des chaînes très longues augmentent considérablement le nombre de lignes requises. | Divisez les données en plusieurs codes-barres ou utilisez un niveau de correction d'erreurs plus élevé si nécessaire. | +| **Permissions du système de fichiers** | Enregistrer dans un dossier en lecture seule génère une `UnauthorizedAccessException`. | Écrivez dans `Environment.CurrentDirectory` ou un chemin accessible en écriture, et gérez les exceptions avec try/catch. | +| **Package NuGet manquant** | La compilation échoue avec « type or namespace name could not be found ». | Assurez‑vous que `Aspose.BarCode` est installé (`dotnet add package Aspose.BarCode`). | + +## Extension de l'exemple + +Maintenant que vous savez **comment créer un code-barres PDF417** et **comment enregistrer le PNG**, vous pouvez explorer les sujets connexes suivants : + +- **Barcode generator C#** : Changez le `EncodeTypes` en `Code128`, `QR`, ou d'autres symbologies. +- **Custom colors** : Utilisez `generator.Parameters.Barcode.ForegroundColor` et `BackgroundColor` pour correspondre à l'identité visuelle. +- **Embedding in PDFs** : Combinez le PNG avec une bibliothèque PDF (par ex., iText7) pour créer des documents imprimables. +- **Dynamic data** : Récupérez le texte depuis une base de données ou une saisie utilisateur pour générer des codes-barres à la volée. + +## Conclusion + +Vous disposez maintenant d’une solution complète et prête pour la production afin de **créer un code-barres PDF417** en C# et d’enregistrer le résultat sous forme de fichier PNG. Le tutoriel a couvert chaque étape, de la configuration du projet à la personnalisation de la disposition, et a souligné comment éviter les erreurs courantes lors de l’utilisation d’une bibliothèque de génération de code-barres C#. + +N’hésitez pas à expérimenter avec différents paramètres de colonnes/lignes, couleurs, ou même d’autres formats de code-barres. Si vous rencontrez des problèmes, revenez à la section **how to generate PDF417** ou explorez la documentation de la bibliothèque pour des fonctionnalités avancées. Bon codage ! + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s’appuient sur les techniques démontrées dans ce guide. Chaque ressource comprend des exemples de code complets et fonctionnels avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités API supplémentaires et explorer des approches d’implémentation alternatives dans vos propres projets. + +- [Comment créer un code-barres – PDF417 compact avec Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Comment générer un code-barres PDF417 – Encodage PDF417 compact](/barcode/english/net/compact-pdf417-encoding/) +- [Comment créer une zone silencieuse de code-barres pour ITF-14 avec Aspose.BarCode pour .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/french/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/french/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..fd19d638b --- /dev/null +++ b/barcode/french/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Apprenez comment générer un code‑barres PDF417 en C# avec Aspose.BarCode, + définir la taille du code‑barres, ajuster les colonnes et activer le mode compact. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: fr +lastmod: 2026-08-22 +og_description: Générez un code‑barres PDF417 en C# avec Aspose.BarCode. Ce guide + montre comment définir la taille du code‑barres, contrôler les colonnes et activer + le mode compact pour une image plus petite. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Générer un code‑barres PDF417 en C# – définir la taille, les colonnes et + le mode compact +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Comment générer un code‑barres PDF417 en C# et définir la taille du code‑barres +url: /fr/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment générer un code-barres PDF417 en C# et définir la taille du code-barres + +Si vous devez **générer un code-barres PDF417** dans une application .NET, ce guide vous accompagne à travers le processus complet. Vous verrez exactement **comment générer PDF417** avec Aspose.BarCode, ajuster le **set barcode size**, et produire un PNG compact qui peut être intégré dans des rapports ou des applications mobiles. + +Créer un code-barres ne nécessite pas d'éditeur graphique séparé. À la fin de ce tutoriel, vous disposerez d'une méthode C# entièrement fonctionnelle qui produit une image PDF417 avec les dimensions exactes dont vous avez besoin, prête pour le traitement en aval. + +## Ce que vous apprendrez + +* Installer et référencer la bibliothèque Aspose.BarCode. +* Créer un générateur de code-barres PDF417 et spécifier le texte encodé. +* **Set barcode size** en configurant la X‑dimension et le nombre de colonnes. +* Activer le mode compact (truncaté) pour réduire le symbole. +* Enregistrer le résultat sous forme de fichier PNG. +* Résoudre les problèmes courants tels que les codes illisibles et les images trop volumineuses. + +### Prérequis + +* .NET 6.0 ou ultérieur (l'API fonctionne également avec .NET Framework 4.6+). +* Familiarité de base avec C# et Visual Studio (ou tout IDE C#). +* Une licence valide Aspose.BarCode (l'évaluation gratuite fonctionne pour les tests). + +> **Conseil pro** : Si vous prévoyez de générer de nombreux codes-barres dans une boucle, réutilisez une seule instance de `BarcodeGenerator` et ne modifiez que la propriété `CodeText`. Cela réduit les allocations de mémoire. + +## Générer un code-barres PDF417 avec Aspose.BarCode + +La première étape consiste à instancier le `BarcodeGenerator` pour la symbologie PDF417. Cet objet est le point d'entrée pour toutes les opérations de code-barres. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Pourquoi c'est important* : `EncodeTypes.Pdf417` indique à la bibliothèque d'utiliser la norme PDF417, qui prend en charge de gros volumes de données et la correction d'erreurs. Le constructeur accepte également les données que vous souhaitez encoder, éliminant ainsi le besoin d'une affectation séparée de `CodeText` ultérieurement. + +## Définir la taille du code-barres et le nombre de colonnes + +Les symboles PDF417 sont composés de rangées et de colonnes de petits modules rectangulaires. Contrôler la largeur du module (X‑dimension) et le nombre de colonnes vous permet d'ajuster finement les dimensions globales. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explication* : +* **X‑dimension** (`Pixels`) détermine la largeur de chaque module. Des valeurs plus petites produisent un code-barres plus compact, tandis que des valeurs plus grandes augmentent la lisibilité sur les scanners basse résolution. +* **Columns** contrôle la disposition horizontale. Moins de colonnes rendent le code-barres plus haut ; plus de colonnes le rendent plus large. Ajustez ces deux paramètres ensemble pour obtenir la **set barcode size** exacte dont vous avez besoin. + +## Activer le mode compact pour un code-barres plus petit + +PDF417 comprend un mode « compact » (ou tronqué) qui supprime les remplissages inutiles et réduit l'empreinte globale. Ceci est particulièrement utile lorsque l'espace d'écran est limité. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Pourquoi activer la troncature ?* +Lorsque `Truncate` est `true`, le générateur omet le motif d'arrêt et certains mots de correction d'erreur qui ne sont pas nécessaires pour la plupart des scénarios de lecture. L'image résultante est environ 15‑20 % plus petite sans sacrifier l'intégrité des données pour les cas d'utilisation typiques. + +## Enregistrer le code-barres en tant qu'image PNG + +Après avoir configuré la taille et le mode, écrivez le code-barres sur le disque. Le PNG est sans perte, garantissant que les bords des modules restent nets. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Le fichier `CompactPdf417.png` contiendra un symbole PDF417 net qui correspond aux dimensions que vous avez définies aux étapes précédentes. + +### Résultat attendu + +L'ouverture du PNG enregistré doit afficher un code-barres PDF417 orienté verticalement composé de trois colonnes, chaque module de 2 px de large, et une taille totale d'environ **120 × 240 px** (largeur × hauteur). Scanner l'image avec n'importe quel lecteur PDF417 standard renvoie le texte original « Sample text for PDF417 ». + +## Pièges courants et comment les éviter + +| Symptôme | Cause probable | Solution | +|----------|----------------|----------| +| Le code-barres est illisible | X‑dimension trop petite pour le scanner | Augmenter `XDimension.Pixels` à 3 ou 4 | +| L'image est trop large pour l'interface | Trop de colonnes définies | Réduire `Pdf417.Columns` ou activer `Truncate` | +| Exception `ArgumentOutOfRangeException` | Nombre de colonnes négatif ou nul | S'assurer que `Columns` est un entier positif (minimum 1) | +| Le fichier PNG est vide | Le chemin de sortie n'existe pas ou manque d'autorisation d'écriture | Vérifier que le répertoire existe et que l'application a les droits d'écriture | + +> **Conseil pro** : Utilisez `barcodeGenerator.ValidateParameters()` avant d'appeler `Save()` pour détecter les erreurs de configuration tôt. + +## Exemple complet et exécutable + +Voici un programme console autonome qui intègre toutes les étapes ci‑dessus. Copiez‑le dans un nouveau projet C#, restaurez le package NuGet Aspose.BarCode, et exécutez‑le pour voir le résultat. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Exécution du programme** produit `CompactPdf417.png` dans le répertoire de travail de l'exécutable. Scannez l image avec une application mobile (par ex., « Barcode Scanner ») pour vérifier que le texte encodé correspond à la chaîne source. + +## Prochaines étapes et sujets associés + +* **Augmenter le niveau de correction d'erreur** – ajustez `Pdf417.ErrorLevel` pour les environnements avec des scans bruyants. +* **Changer l'orientation** – définissez `Pdf417.Rotate` à `RotationAngle.Rotate90` si vous avez besoin d'une disposition horizontale. +* **Intégrer le code-barres dans un PDF** – combinez Aspose.PDF avec Aspose.BarCode pour placer l'image directement dans un document. +* **Générer d'autres codes-barres 2‑D** – la même classe `BarcodeGenerator` prend en charge DataMatrix, QR et Aztec ; il suffit de remplacer `EncodeTypes.Pdf417` par la symbologie souhaitée. + +En maîtrisant les techniques de **generate PDF417 barcode**, vous pouvez automatiser la billetterie, l'étiquetage d'inventaire et la transmission sécurisée de données à travers une large gamme d'applications .NET. + +## Conclusion + +Vous savez maintenant comment **generate PDF417 barcode** en C#, définir précisément le **set barcode size**, configurer les colonnes, activer le mode compact et enregistrer le résultat en PNG. Appliquez ces paramètres pour répondre à toute contrainte d'interface ou exigence de lecture, et étendez l'approche à d'autres formats de code-barres selon les besoins. Bon codage ! + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s'appuient sur les techniques démontrées dans ce guide. Chaque ressource comprend des exemples de code fonctionnels complets avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités API supplémentaires et explorer des approches d'implémentation alternatives dans vos propres projets. + +- [Comment générer un code-barres PDF417 – Encodage PDF417 compact](/barcode/english/net/compact-pdf417-encoding/) +- [Comment créer un code-barres – PDF417 compact avec Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Comment générer des codes-barres DataMatrix avec Aspose.BarCode pour .NET – Guide étape par étape](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/french/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/french/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..250b94447 --- /dev/null +++ b/barcode/french/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Comment lire les codes‑barres PDF417 en C# avec un guide étape par étape, + couvrant la lecture de plusieurs codes‑barres à partir d’une image et l’extraction + des détails MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: fr +lastmod: 2026-08-22 +og_description: Comment lire rapidement les codes‑barres PDF417 en C#. Ce tutoriel + vous montre comment lire plusieurs codes‑barres à partir d’une image et récupérer + les informations étendues MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Comment lire les codes-barres PDF417 en C# – guide complet de programmation +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Comment lire les codes-barres PDF417 en C# – guide complet +url: /fr/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment lire les codes-barres PDF417 en C# – guide complet + +Si vous avez besoin de **comment lire les PDF417** dans une application .NET, ce tutoriel vous fournit une solution prête à l’emploi. Vous apprendrez à lire plusieurs codes-barres à partir d’une seule image, à extraire l’ensemble complet de données MacroPdf417, et à les afficher dans la console. L’approche fonctionne avec la bibliothèque Aspose.BarCode for .NET et ne nécessite que quelques lignes de code. + +Lire des codes-barres à partir d’une image est une tâche courante dans les systèmes d’inventaire, la validation de billets et la gestion de documents. À la fin de ce guide, vous serez capable de décoder n’importe quel code-barres PDF417 ou MacroPdf417, de gérer plusieurs codes sur une même image, et de comprendre les champs étendus fournis par MacroPdf417. + +## Prérequis + +- .NET 6.0 SDK ou version ultérieure (le code compile également avec .NET Framework 4.7+) +- Visual Studio 2022 ou tout éditeur C# de votre choix +- Package NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Une image d’exemple contenant un code-barres MacroPdf417 (par ex., `MacroPdf417.png`) + +Aucune configuration supplémentaire n’est requise ; la bibliothèque gère le chargement et le décodage de l’image en interne. + +## Comment lire les codes-barres PDF417 à partir d’une image en C# + +Le cœur de la solution est la classe `BarCodeReader`. Elle ouvre l’image, détecte tous les codes-barres du type spécifié, et renvoie une collection d’objets `BarCodeResult`. Le code suivant montre un programme console complet. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Pourquoi chaque ligne est importante + +| Étape | Objectif | +|------|----------| +| **1️⃣ Initialiser** | Crée un `BarCodeReader` lié au fichier image et restreint la détection à la symbologie MacroPdf417, ce qui accélère le traitement. | +| **2️⃣ Itérer** | `ReadBarCodes()` renvoie **tous** les codes-barres correspondant au type demandé, vous permettant de **lire plusieurs codes-barres** sans boucles supplémentaires. | +| **3️⃣ Sortie de base** | Affiche le `CodeTypeName` générique et le `CodeText` lisible par l’homme. Ceci est utile pour la journalisation ou une validation rapide. | +| **4️⃣ Données étendues** | MacroPdf417 transporte des métadonnées supplémentaires (ID de fichier, nombre de segments, horodatages, etc.). L’objet `Extended.Pdf417` expose chaque champ directement, vous permettant de stocker ou de vérifier le paquet de données complet. | + +Exécuter le programme avec une image MacroPdf417 valide produit une sortie console similaire à ce qui suit : + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +La sortie confirme que la bibliothèque a correctement lu le code-barres, extrait le texte, et fourni chaque champ MacroPdf417. + +## Lire plusieurs codes-barres à partir d’une seule image + +De nombreux scénarios réels placent plusieurs symboles PDF417 sur une même étiquette — pensez à un manifeste d’expédition contenant un code transporteur, un numéro de suivi et une déclaration en douane. Le même bloc de code ci‑dessus **lit déjà plusieurs codes-barres** car `ReadBarCodes()` renvoie un énumérable de toutes les correspondances. Aucune configuration supplémentaire n’est nécessaire ; vous devez simplement parcourir les résultats, comme démontré. + +Si vous souhaitez limiter le lecteur au PDF417 standard (non‑macro) tout en gérant plusieurs codes, remplacez `DecodeType.MacroPdf417` par `DecodeType.Pdf417`. Le reste de la logique reste inchangé. + +## Comprendre les données étendues MacroPdf417 + +MacroPdf417 est une extension de la spécification PDF417 standard. Il divise les charges utiles importantes en plusieurs segments et ajoute un petit en‑tête décrivant le fichier complet. Les champs les plus pertinents sont : + +- **MacroPdf417FileID** – un identifiant unique partagé par tous les segments du même fichier. +- **MacroPdf417SegmentID** – le numéro de séquence du segment actuel. +- **MacroPdf417SegmentsCount** – nombre total de segments attendus. +- **MacroPdf417FileName** – nom de fichier optionnel transmis avec le code-barres. +- **MacroPdf417Checksum** – valeur de contrôle d’erreur pour le fichier complet. +- **MacroPdf417FileSize** – taille de la charge binaire originale. +- **MacroPdf417TimeStamp** – horodatage ISO‑8601 du moment où le code-barres a été généré. +- **MacroPdf417Addressee / Sender** – champs textuels optionnels pour le routage. +- **MacroPdf417Terminator** – indique si ce segment est le dernier. + +Lorsque vous avez reçu tous les segments, vous pouvez reconstruire le fichier original en les ordonnant par `MacroPdf417SegmentID` et en concaténant les valeurs `CodeText`. Cette logique est simple à implémenter une fois les champs disponibles. + +## Pièges courants et astuces professionnelles + +- **La qualité de l’image compte** – les fichiers PNG/JPEG à basse résolution ou fortement compressés peuvent entraîner des détections manquées. Utilisez une résolution d’au moins 300 dpi pour les codes-barres imprimés. +- **Symbologies mixtes** – si l’image contient à la fois MacroPdf417 et PDF417 standard, créez deux lecteurs (un pour chaque `DecodeType`) ou utilisez `DecodeType.AllSupported` et filtrez les résultats par `result.CodeTypeName`. +- **Utilisation de la mémoire** – l’instruction `using` libère rapidement le `BarCodeReader`, empêchant les gros tampons d’image de rester en mémoire. +- **Sécurité des threads** – `BarCodeReader` n’est pas thread‑safe. Créez une instance distincte par thread si vous décodez des images en parallèle. +- **Gestion des erreurs** – encapsulez l’appel `ReadBarCodes()` dans un bloc try/catch pour capturer `BarCodeException` en cas d’images corrompues. + +## Récapitulatif de l’exemple complet fonctionnel + +Voici le programme complet que vous pouvez copier dans un nouveau projet console. Il inclut toutes les directives `using`, une constante pour le chemin de l’image, et le modèle de libération. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compilez avec `dotnet build` et exécutez avec `dotnet run`. La console affiche les données de base de chaque code-barres ainsi que la charge complète MacroPdf417. + +## Prochaines étapes + +- **Reconstruire les fichiers multipart** – collectez tous les segments, triez par `MacroPdf417SegmentID`, et concaténez `CodeText` to + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s’appuient sur les techniques démontrées dans ce guide. Chaque ressource comprend des exemples de code complets et fonctionnels avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités API supplémentaires et explorer des approches d’implémentation alternatives dans vos propres projets. + +- [Comment générer un code-barres PDF417 – Encodage Compact PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Comment lire les codes-barres PDF417 avec des caractères turcs en Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Comment utiliser Aspose pour le code-barres PDF417 (Chinois) en Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/french/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/french/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..990c6a316 --- /dev/null +++ b/barcode/french/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,226 @@ +--- +category: general +date: 2026-08-22 +description: Le tutoriel du générateur de codes-barres C# montre comment créer un + code-barres Macro PDF417 avec des métadonnées et l’enregistrer au format PNG à l’aide + d’Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: fr +lastmod: 2026-08-22 +og_description: Le générateur de code‑barres C# vous permet de créer un code‑barres + Macro PDF417 avec des métadonnées complètes au niveau du fichier et de l’exporter + au format PNG. Suivez ce guide pour mettre en œuvre la solution. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: générateur de code-barres C# – créer des codes-barres Macro PDF417 étape + par étape +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Comment utiliser un générateur de code‑barres C# pour Macro PDF417 +url: /fr/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment utiliser un générateur de code-barres C# pour Macro PDF417 + +Si vous avez besoin d'un **barcode generator C#** capable d'émettre un symbole Macro PDF417 avec des métadonnées au niveau du fichier, ce guide fournit une solution complète, prête à l'emploi. Vous verrez comment configurer l'apparence du code-barres, intégrer les informations macro telles que l'ID du fichier et le nombre de segments, puis enregistrer le résultat sous forme d'image PNG. + +L'exemple utilise la bibliothèque Aspose.BarCode, une **C# barcode library** largement adoptée qui prend en charge l'ensemble complet des fonctionnalités PDF417. Aucun service externe n'est requis, et le code fonctionne avec .NET 6 ou une version ultérieure. + +## Prérequis + +* .NET 6 SDK (ou toute version ultérieure) installé. +* Visual Studio 2022, VS Code, ou un autre IDE C#. +* Une référence NuGet à **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Comprendre la syntaxe de base du C# et le concept des codes-barres PDF417 vous aidera à suivre les étapes, mais le tutoriel explique chaque option de configuration en détail. + +## Ce que couvre le tutoriel + +* Initialisation d'une instance de **barcode generator C#** pour le format Macro PDF417. +* Ajustement des paramètres visuels tels que la dimension X et le nombre de colonnes. +* Fourniture des champs de niveau fichier Macro PDF417 : ID du fichier, ID du segment, nombre de segments, nom du fichier, somme de contrôle, taille du fichier, horodatage, destinataire, expéditeur et indicateur de terminaison. +* Enregistrement du symbole généré sous forme de fichier PNG. +* Conseils pour gérer les cas limites comme les tailles de fichier importantes ou les horodatages personnalisés. + +À la fin de cet article, vous disposerez d'un programme autonome qui génère un code-barres Macro PDF417 entièrement conforme. + +## Étape 1 : Créer l'instance du barcode generator C# + +La première opération consiste à instancier `BarcodeGenerator` avec la valeur d'énumération `EncodeTypes.MacroPdf417` et le texte que vous souhaitez encoder. Le constructeur accepte également la chaîne de charge utile, qui devient la partie données du code-barres macro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Pourquoi c'est important** – Le drapeau `EncodeTypes.MacroPdf417` indique à Aspose.BarCode de traiter le symbole comme un code-barres macro, activant les champs supplémentaires qui suivent. Sans ce drapeau, la bibliothèque générerait un code-barres PDF417 ordinaire sans métadonnées au niveau du fichier. + +## Étape 2 : Ajuster l'apparence de base du code-barres (paramètres visuels PDF417) + +La clarté visuelle est cruciale pour une lecture fiable. Deux paramètres courants sont la largeur du module (`XDimension`) et le nombre de colonnes. Le réglage de ces valeurs équilibre la taille et la lisibilité. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +- `XDimension.Pixels` contrôle la largeur de chaque barre noire/blanche. Une valeur de **2** fonctionne bien pour la plupart des imprimantes d'étiquettes. +- `Pdf417.Columns` définit le nombre de colonnes utilisées par le code-barres. Cinq colonnes produisent un symbole compact sans sacrifier la capacité de données. + +## Étape 3 : Définir les informations de niveau fichier Macro PDF417 + +Macro PDF417 étend le format PDF417 standard avec des champs décrivant comment un gros fichier est découpé en plusieurs segments de code-barres. Fournir ces champs garantit que les lecteurs en aval peuvent reconstruire le fichier original. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +- `MacroPdf417FileID` doit être identique pour chaque segment appartenant au même fichier logique. +- `MacroPdf417SegmentID` s'incrémente de **0** à `SegmentsCount‑1`. +- `MacroPdf417SegmentsCount` indique au décodeur combien de pièces attendre. +- `MacroPdf417FileName` est optionnel mais utile pour une identification lisible par l'homme. + +## Étape 4 : Définir les métadonnées macro supplémentaires + +Au-delà des informations de base du fichier, la spécification autorise des champs supplémentaires tels que la somme de contrôle, la taille du fichier, l'horodatage, le destinataire, l'expéditeur et un indicateur de terminaison. Remplir ces champs améliore l'intégrité des données et la traçabilité. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +- `MacroPdf417Checksum` fournit une somme de contrôle CCITT de 16 bits pour l'ensemble du fichier ; le décodeur peut vérifier l'intégrité après reconstruction. +- `MacroPdf417FileSize` doit refléter le nombre exact d'octets du fichier original ; les valeurs supérieures à `2^31‑1` nécessitent un champ de 64 bits, que Aspose gère automatiquement. +- `MacroPdf417TimeStamp` enregistre le moment où le code-barres a été généré. Utilisez l'UTC pour éviter toute ambiguïté de fuseau horaire. +- `MacroPdf417Addressee` et `MacroPdf417Sender` sont des chaînes libres pouvant stocker des informations de routage. +- `MacroPdf417Terminator` indique qu'il s'agit du segment final ; réglez-le sur `Set` pour le dernier morceau, sinon laissez la valeur par défaut (`NotSet`). + +**Astuce pour les cas limites** – Si la taille de votre fichier dépasse 4 Go, divisez le contenu en plusieurs segments macro et ajustez `SegmentsCount` en conséquence. La bibliothèque gérera le champ de grande taille sans débordement. + +## Étape 5 : Enregistrer le code-barres en image PNG + +La dernière étape écrit le symbole généré sur le disque. PNG préserve les dimensions exactes des pixels et est largement supporté par le matériel de lecture. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Remplacez `YOUR_DIRECTORY` par un chemin absolu ou relatif auquel le processus d'exécution peut écrire. L'énumération `BarCodeImageFormat.Png` garantit une sortie sans perte. + +**Pourquoi PNG ?** – Les formats raster comme PNG conservent les bords des modules nets, ce qui est essentiel pour les lecteurs qui s'appuient sur des bords à fort contraste. Si vous avez besoin d'un format vectoriel, Aspose prend également en charge `Pdf` et `Svg`. + +## Exemple complet exécutable + +Voici le programme complet que vous pouvez copier dans une application console. Il inclut les directives `using` nécessaires et une méthode `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Résultat attendu + +L'exécution du programme crée un fichier nommé **MacroPdf417.png** dans le répertoire de travail du projet. L'ouverture de l'image montre un code-barres PDF417 compact avec les champs macro intégrés. Scanner l'image avec un lecteur compatible PDF417 (par ex., ZXing, le décodeur Aspose.BarCode) renvoie la charge utile originale `"Sample text"` ainsi que les métadonnées macro. + +## Questions fréquentes et dépannage + +| Question | Réponse | +|----------|--------| +| *Et si le code-barres est trop grand pour l'étiquette cible ?* | Réduisez `XDimension.Pixels` ou augmentez `Pdf417.Columns`. Les deux paramètres influent sur la taille globale. | +| *Puis-je générer une image vectorielle au lieu de PNG ?* | Oui. Appelez `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` pour une sortie évolutive. | +| *Comment vérifier la somme de contrôle après le scan ?* | Le décodeur Aspose.BarCode valide automatiquement `MacroPdf417Checksum` et signale les incohérences dans l'objet `MacroPdf417Result`. | +| *La bibliothèque est‑elle compatible avec .NET Core ?* | Le package NuGet prend en charge .NET Standard 2.0+, qui couvre .NET Core, .NET 5, .NET 6 et les versions ultérieures. | +| *Et si je dois intégrer des données binaires au lieu de texte ?* | Convertissez la charge binaire en Base64 ou utilisez la surcharge `EncodeTypes.MacroPdf417` qui accepte un tableau d'octets. | + +## Astuces professionnelles pour la production + +* **Mettre en cache le générateur** – + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s'appuient sur les techniques démontrées dans ce guide. Chaque ressource comprend des exemples de code complets et fonctionnels avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités API supplémentaires et explorer des approches d'implémentation alternatives dans vos propres projets. + +- [Comment créer un code-barres – PDF417 compact avec Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Comment lire un code-barres depuis un PDF en Java avec Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Créer un code-barres Codabar avec Aspose.Barcode – API Générateur & Lecteur](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/net/compact-pdf417-encoding/_index.md b/barcode/german/net/compact-pdf417-encoding/_index.md index 1ad8b8acf..688d916a9 100644 --- a/barcode/german/net/compact-pdf417-encoding/_index.md +++ b/barcode/german/net/compact-pdf417-encoding/_index.md @@ -171,7 +171,11 @@ A: Nein, es werden keine externen Schriftarten benötigt; die Bibliothek überni - [Wie man Barcode erstellt – Compact PDF417 mit Aspose.BarCode](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [Umfassende Tutorials und Beispiele für Aspose.BarCode für .NET](/barcode/net/) - [Wie man Aztec-Barcode mit Fehlerkorrektur in .NET erstellt](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) - +- [Wie man PDF417-Barcode in C# generiert und die Barcode-Größe festlegt](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +- [Wie man PDF417-Barcode in C# erstellt und als PNG speichert](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +- [Wie man Micro PDF417 Barcode in C# erstellt – Schritt‑für‑Schritt‑Anleitung](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +- [Wie man einen Barcode‑Generator in C# für Macro PDF417 verwendet](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [Wie man PDF417-Barcodes in C# liest – vollständiger Leitfaden](./how-to-read-pdf417-barcodes-in-c-complete-guide/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/german/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/german/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..dca1c0a49 --- /dev/null +++ b/barcode/german/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Erfahren Sie, wie Sie einen Micro‑PDF417‑Barcode in C# erstellen und + ein Barcode‑PNG‑Bild generieren. Enthält das Festlegen der Barcode‑Abmessungen und + das Speichern der Datei. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: de +lastmod: 2026-08-22 +og_description: Erstellen Sie einen Mikro‑PDF417‑Barcode in C# und exportieren Sie + ihn als PNG. Folgen Sie dieser Anleitung, um die Barcode‑Abmessungen festzulegen + und schnell ein Barcode‑Bild zu erzeugen. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Micro-PDF417-Barcode in C# erstellen – vollständiges Codierungstutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Wie man einen Micro‑PDF417‑Barcode in C# erstellt – Schritt‑für‑Schritt‑Anleitung +url: /de/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man einen Micro PDF417 Barcode in C# erstellt – Schritt‑für‑Schritt‑Anleitung + +Wenn Sie einen **Micro PDF417 Barcode** für ein Ticketsystem, ein Inventurlabel oder einen mobilen Scan erstellen müssen, zeigt Ihnen dieses Tutorial genau, wie es geht. Sie sehen das komplette C#‑Programm, das ein Barcode‑PNG erzeugt, lernen, wie man Barcode‑Abmessungen festlegt, und verstehen jede Konfigurationsoption. + +Am Ende dieses Leitfadens können Sie ein hochauflösendes Barcode‑Bild erzeugen, die X‑Dimension anpassen, die Spaltenanzahl wählen und das Ergebnis als PNG‑Datei speichern – alles mit wenigen Code‑Zeilen. + +## Was Sie benötigen + +- .NET 6.0 SDK oder neuer (der Code funktioniert mit .NET Core und .NET Framework) +- Visual Studio 2022 oder jede C#‑kompatible IDE +- Das **Aspose.BarCode for .NET** NuGet‑Paket (oder jede Bibliothek, die `EncodeTypes.MicroPdf417` unterstützt) +- Grundlegende Vertrautheit mit C#‑Syntax + +> **Profi‑Tipp:** Die kostenlose Community‑Edition von Aspose.BarCode ist für Entwicklung und Tests ausreichend. Für die Produktion erhalten Sie eine Lizenz, um Evaluations‑Wasserzeichen zu entfernen. + +## Schritt 1: Bibliothek für Barcode installieren + +Öffnen Sie ein Terminal in Ihrem Projektordner und führen Sie aus: + +```bash +dotnet add package Aspose.BarCode +``` + +Damit wird die `Aspose.BarCode`‑Assembly hinzugefügt, die die `BarcodeGenerator`‑Klasse bereitstellt, die zum **Erstellen von Barcode‑Bildern in C#** verwendet wird. + +## Schritt 2: Generator initialisieren – Micro PDF417 Barcode erstellen + +Die erste ausführbare Zeile erstellt eine `BarcodeGenerator`‑Instanz, die für die Micro PDF417‑Symbologie konfiguriert ist und die zu kodierenden Daten bereitstellt. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Warum das wichtig ist*: Das `EncodeTypes.MicroPdf417`‑Enum weist die Bibliothek an, die kompakte Version von PDF417 zu verwenden, die ideal für kleine Etiketten und mobile Bildschirme ist. + +## Schritt 3: Barcode‑Abmessungen in C# festlegen + +Die Feinabstimmung der Modulbreite (X‑Dimension) steuert die visuelle Dichte des Barcodes. Ein kleinerer Wert ergibt ein schärferes Bild, während ein größerer Wert den Barcode aus größerer Entfernung leichter scanbar macht. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Warum Sie die Abmessungen einstellen sollten**: Ohne Anpassung der X‑Dimension kann der Standardwert einen Barcode erzeugen, der bei hoher DPI unscharf wirkt. Auf 2 Pixel zu setzen ist ein guter Kompromiss für die meisten bildschirmbasierten Scans. + +## Schritt 4: Anzahl der Spalten wählen – Barcode‑Breite steuern + +Micro PDF417 erlaubt zwischen 1 und 4 Spalten. Mehr Spalten komprimieren die Daten horizontal und reduzieren die Gesamtabmessung des Bildes. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Randfall*: Wenn Sie 5 Spalten anfordern, wirft die Bibliothek eine `ArgumentOutOfRangeException`. Bleiben Sie stets innerhalb des dokumentierten Bereichs. + +## Schritt 5: Barcode‑PNG erzeugen – Bild speichern + +Jetzt können Sie den erzeugten Barcode in eine PNG‑Datei exportieren. PNG bewahrt verlustfreie Qualität, die für zuverlässiges Scannen entscheidend ist. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Wenn Sie das Programm ausführen, sehen Sie eine Konsolennachricht, die den Dateipfad bestätigt. Das resultierende `MicroPdf417.png` sieht folgendermaßen aus: + +![Screenshot, der einen generierten Micro PDF417 Barcode zeigt, erstellt mit C#](micro-pdf417-example.png "Generierter Micro PDF417 Barcode") + +*Bild‑Alt‑Text*: **micro PDF417 barcode erstellt in C#** – zeigt das endgültige Ergebnis nach Anwendung der Abmessungen und Spalteneinstellungen. + +## Schritt 6: Ausgabe ausführen und prüfen + +1. Projekt bauen: `dotnet build`. +2. Ausführen: `dotnet run`. +3. Öffnen Sie `MicroPdf417.png` auf Ihrem Desktop und scannen Sie es mit einer mobilen Barcode‑Scanner‑App. + +Sie sollten den Text **„Sample text“** dekodiert sehen. Wenn der Scanner einen Fehler meldet, überprüfen Sie die X‑Dimension und die Spaltenanzahl erneut – extreme Werte können den Barcode für manche Geräte zu dicht machen. + +## Häufige Varianten und Fehlersuche + +| Situation | Adjustment | +|-----------|------------| +| **Benötigen Sie einen größeren Barcode für Niedrigauflösungs‑Drucker** | Increase `XDimension.Pixels` to 3 or 4. | +| **Möchten Sie einen höheren Barcode, ohne die Breite zu ändern** | Set `generator.Parameters.Barcode.Pdf417.Rows` (rows range 3‑90). | +| **Mehrere Barcodes in einer Schleife erzeugen** | Re‑use the same `BarcodeGenerator` instance and only change `CodeText` before each `Save`. | +| **Als JPEG statt PNG speichern** | Replace `BarCodeImageFormat.Png` with `BarCodeImageFormat.Jpeg`. | +| **Ausführen unter .NET Framework 4.7** | The same code works; just reference the appropriate `Aspose.BarCode.dll`. | + +## Vollständiger Quellcode (ausführbar) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Erwartete Ausgabe** – eine 200 × 100‑Pixel‑PNG‑Datei, die einen scharfen Micro PDF417 Barcode enthält, der zu „Sample text“ dekodiert. + +## Fazit + +Sie wissen jetzt, wie man **einen Micro PDF417 Barcode** in C# **erstellt**, **Barcode‑Abmessungen festlegt** und ein **Barcode‑PNG**‑Bild **generiert**. Das vollständige Beispiel demonstriert jeden erforderlichen Schritt – von der Bibliotheksinstallation bis zum Speichern der finalen Datei – sodass Sie die Barcode‑Erzeugung direkt in Ihre eigenen Anwendungen einbetten können. + +Als Nächstes können Sie verwandte Themen erkunden, wie **QR‑Codes mit Aspose.BarCode erstellen**, **Farben anpassen** oder **Barcodes in PDF‑Dokumenten einbetten**. All dies baut auf denselben `BarcodeGenerator`‑Grundlagen auf, die hier behandelt wurden. + +Fühlen Sie sich frei, mit verschiedenen Datenstrings, Spaltenzahlen und X‑Dimension‑Werten zu experimentieren, um Ihre spezifische Scan‑Umgebung zu optimieren. Viel Spaß beim Coden! + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige, funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, zusätzliche API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man Barcode erstellt – Compact PDF417 mit Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Wie man PDF417 Barcode generiert – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Wie man Aztec Barcode mit Aspose.BarCode für .NET erstellt](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/german/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..94f55a054 --- /dev/null +++ b/barcode/german/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Lernen Sie, wie Sie in C# einen PDF417-Barcode mit einem Barcode‑Generator + erstellen, das Layout festlegen und als PNG speichern. Enthält kompletten Code und + Tipps für Barcode‑Generator‑Projekte in C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: de +lastmod: 2026-08-22 +og_description: Erstellen Sie einen PDF417‑Barcode in C# mit einem Barcode‑Generator, + passen Sie das Layout an und lernen Sie, wie Sie PNG speichern. Folgen Sie dieser + Schritt‑für‑Schritt‑Anleitung. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: PDF417-Barcode in C# erstellen – vollständige Anleitung zum Generieren und + Speichern von PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Wie man einen PDF417-Barcode in C# erstellt und als PNG speichert +url: /de/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man PDF417-Barcode in C# erstellt und als PNG speichert + +Wenn Sie **einen PDF417-Barcode** in einer C#‑Anwendung erstellen müssen, zeigt Ihnen dieses Tutorial die genauen Schritte. Sie sehen, wie eine Barcode‑Generator‑C#‑Bibliothek jede Zeichenkette in ein scanbares PDF417‑Bild umwandeln kann und wie PNG‑Dateien ohne zusätzliche Werkzeuge gespeichert werden. + +Das Erzeugen von Barcodes ist in Logistik, Ticketing und Dokumentenmanagement üblich. Am Ende dieses Leitfadens haben Sie ein ausführbares Konsolenprogramm, das eine PNG‑Datei namens `Pdf417Layout.png` im von Ihnen gewählten Ordner erzeugt. + +## Voraussetzungen + +- .NET 6.0 SDK oder neuer installiert (der Code funktioniert auch mit .NET Framework 4.7+). +- Visual Studio 2022 oder ein beliebiger Editor, der C#‑Projekte bauen kann. +- Das **Aspose.BarCode for .NET** NuGet‑Paket (oder jede kompatible Barcode‑Generator‑C#‑Bibliothek). + Installieren Sie es mit: + +```bash +dotnet add package Aspose.BarCode +``` + +Es werden keine zusätzlichen Bildverarbeitungs‑Bibliotheken benötigt, da der Generator PNG direkt schreiben kann. + +## Schritt 1: Neues Konsolenprojekt einrichten + +Erstellen Sie ein frisches Konsolenprojekt, damit das Beispiel eigenständig bleibt. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Der Ordner `Pdf417Demo` enthält nun eine Datei `Program.cs`, in der wir den Barcode‑Code schreiben werden. + +## Schritt 2: Barcode‑Namespace importieren + +Öffnen Sie `Program.cs` und fügen Sie die erforderliche `using`‑Direktive oben hinzu: + +```csharp +using Aspose.BarCode.Generation; +``` + +Dieser Namespace gibt Ihnen Zugriff auf `BarcodeGenerator`, `EncodeTypes` und das Bildformat‑Enum, das für **wie man PNG speichert** benötigt wird. + +## Schritt 3: PDF417‑Barcode‑Generator erstellen + +Der Kern von **wie man PDF417 generiert** ist die Klasse `BarcodeGenerator`. Übergeben Sie den Kodierungstyp `EncodeTypes.Pdf417` und den zu kodierenden Text. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` enthält nun alle Einstellungen für den Barcode. Das Standard‑Layout funktioniert, aber wir werden es im nächsten Schritt anpassen. + +## Schritt 4: Barcode‑Layout definieren (Spalten und Zeilen) + +PDF417 ermöglicht die Steuerung der Anzahl von Spalten (2‑30) und Zeilen (1‑90). Das Anpassen dieser Werte kann die Lesbarkeit für bestimmte Scanner verbessern. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro‑Tipp:** Wenn Sie diese Einstellungen weglassen, wählt die Bibliothek automatisch optimale Werte. Das Festlegen von Spalten und Zeilen liefert jedoch vorhersehbare Bildabmessungen, was nützlich ist, wenn Sie das PNG in ein PDF oder ein UI‑Layout einbetten. + +## Schritt 5: Generierten Barcode als PNG‑Bild speichern + +Jetzt beantworten wir **wie man PNG speichert**, indem wir `Save` aufrufen. Die Methode akzeptiert den Zielpfad und das Bildformat‑Enum. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Die Datei `Pdf417Layout.png` erscheint im Ordner `bin/Debug/net6.0` des Projekts, nachdem Sie das Programm ausgeführt haben. + +## Vollständiges ausführbares Beispiel + +Unten finden Sie die komplette `Program.cs`‑Datei. Kopieren Sie sie in das in **Schritt 1** erstellte Projekt und führen Sie `dotnet run` aus. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Erwartete Ausgabe + +Wenn Sie das Programm ausführen, gibt die Konsole den absoluten Pfad zur PNG‑Datei aus, und die Datei enthält einen klaren PDF417‑Barcode, der dem Bild unten ähnlich sieht. + +![Beispiel für das Erstellen eines PDF417-Barcodes](image-placeholder.png "PDF417-Barcode als PNG gespeichert") + +Sie können das PNG mit jedem PDF417‑kompatiblen Scanner (Mobile‑Apps, Hardware‑Lesegeräte) scannen, um zu prüfen, dass der kodierte Text `"Sample"` ist. + +## Umgang mit Sonderfällen und häufigen Fallstricken + +| Situation | Worauf zu achten ist | Empfohlene Lösung | +|-----------|----------------------|-------------------| +| **Ungültige Spalten-/Zeilenwerte** | Werte außerhalb des Bereichs 2‑30 (Spalten) oder 1‑90 (Zeilen) führen zu einer `ArgumentException`. | Validieren Sie die Benutzereingabe vor der Zuweisung oder lassen Sie die Bibliothek die Standardwerte wählen. | +| **Lange Eingabezeichenketten** | PDF417 kann bis zu 1.850 Zeichen kodieren, aber sehr lange Zeichenketten erhöhen die benötigte Zeilenanzahl dramatisch. | Teilen Sie die Daten in mehrere Barcodes auf oder verwenden Sie bei Bedarf ein höheres Fehlerkorrektur‑Level. | +| **Dateisystem‑Berechtigungen** | Das Speichern in einen schreibgeschützten Ordner löst eine `UnauthorizedAccessException` aus. | Schreiben Sie in `Environment.CurrentDirectory` oder einen benutzerbeschreibbaren Pfad und behandeln Sie Ausnahmen mit try/catch. | +| **Fehlendes NuGet‑Paket** | Die Kompilierung schlägt mit „type or namespace name could not be found“ fehl. | Stellen Sie sicher, dass `Aspose.BarCode` installiert ist (`dotnet add package Aspose.BarCode`). | + +## Beispiel erweitern + +Jetzt, da Sie **wie man PDF417‑Barcode erstellt** und **wie man PNG speichert** kennen, können Sie diese verwandten Themen erkunden: + +- **Barcode‑Generator C#**: Ändern Sie `EncodeTypes` zu `Code128`, `QR` oder anderen Symbologien. +- **Benutzerdefinierte Farben**: Verwenden Sie `generator.Parameters.Barcode.ForegroundColor` und `BackgroundColor`, um das Branding anzupassen. +- **Einbetten in PDFs**: Kombinieren Sie das PNG mit einer PDF‑Bibliothek (z. B. iText7), um druckbare Dokumente zu erstellen. +- **Dynamische Daten**: Holen Sie den Text aus einer Datenbank oder Benutzereingabe, um Barcodes on‑the‑fly zu erzeugen. + +## Fazit + +Sie haben nun eine vollständige, produktionsreife Lösung für **PDF417‑Barcode erstellen** in C# und das Ergebnis als PNG‑Datei zu speichern. Das Tutorial behandelte jeden Schritt von der Projekte‑einrichtung bis zur Layout‑Anpassung und zeigte, wie häufige Fehler bei der Verwendung einer Barcode‑Generator‑C#‑Bibliothek vermieden werden können. + +Experimentieren Sie gern mit verschiedenen Spalten‑/Zeilen‑Einstellungen, Farben oder sogar anderen Barcode‑Formaten. Wenn Sie auf Probleme stoßen, schauen Sie erneut im Abschnitt **wie man PDF417 generiert** nach oder erkunden Sie die Dokumentation der Bibliothek für erweiterte Funktionen. Viel Spaß beim Coden! + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, zusätzliche API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man Barcode erstellt – Compact PDF417 mit Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Wie man PDF417‑Barcode generiert – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Wie man Barcode‑Quiet‑Zone für ITF‑14 mit Aspose.BarCode für .NET erstellt](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/german/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..e03f776a4 --- /dev/null +++ b/barcode/german/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Erfahren Sie, wie Sie in C# mit Aspose.BarCode einen PDF417-Barcode erzeugen, + die Barcode-Größe festlegen, Spalten anpassen und den kompakten Modus aktivieren. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: de +lastmod: 2026-08-22 +og_description: PDF417-Barcode in C# mit Aspose.BarCode generieren. Dieser Leitfaden + zeigt, wie Sie die Barcode‑Größe festlegen, Spalten steuern und den kompakten Modus + für ein kleineres Bild aktivieren. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: PDF417-Barcode in C# erzeugen – Größe, Spalten und Kompaktmodus festlegen +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Wie man in C# einen PDF417-Barcode erzeugt und die Barcode‑Größe festlegt +url: /de/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man PDF417-Barcode in C# erzeugt und die Barcode‑Größe festlegt + +Wenn Sie in einer .NET‑Anwendung **PDF417‑Barcode erzeugen** müssen, führt Sie dieser Leitfaden durch den gesamten Prozess. Sie sehen genau **wie man PDF417 erzeugt** mit Aspose.BarCode, passen die **Barcode‑Größe an** und erzeugen ein kompaktes PNG, das in Berichten oder mobilen Apps eingebettet werden kann. + +Ein Barcode zu erstellen erfordert keinen separaten Grafikeditor. Am Ende dieses Tutorials besitzen Sie eine voll funktionsfähige C#‑Methode, die ein PDF417‑Bild mit den genauen Abmessungen erzeugt, die Sie benötigen, bereit für die Weiterverarbeitung. + +## Was Sie lernen werden + +* Installieren und referenzieren Sie die Aspose.BarCode‑Bibliothek. +* Erstellen Sie einen PDF417‑Barcode‑Generator und geben Sie den zu codierenden Text an. +* **Barcode‑Größe festlegen** durch Konfiguration von X‑Dimension und Spaltenanzahl. +* Aktivieren Sie den kompakten (abgeschnittenen) Modus, um das Symbol zu verkleinern. +* Speichern Sie das Ergebnis als PNG‑Datei. +* Beheben Sie häufige Probleme wie nicht lesbare Codes und zu große Bilder. + +### Voraussetzungen + +* .NET 6.0 oder höher (die API funktioniert auch mit .NET Framework 4.6+). +* Grundlegende Kenntnisse in C# und Visual Studio (oder einer anderen C#‑IDE). +* Eine gültige Aspose.BarCode‑Lizenz (die kostenlose Evaluation funktioniert zum Testen). + +> **Profi‑Tipp:** Wenn Sie viele Barcodes in einer Schleife erzeugen wollen, verwenden Sie eine einzige `BarcodeGenerator`‑Instanz und ändern nur die `CodeText`‑Eigenschaft. Das reduziert Speicherzuweisungen. + +## PDF417‑Barcode mit Aspose.BarCode erzeugen + +Der erste Schritt besteht darin, den `BarcodeGenerator` für die PDF417‑Symbolik zu instanziieren. Dieses Objekt ist der Einstiegspunkt für alle Barcode‑Operationen. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Warum das wichtig ist*: `EncodeTypes.Pdf417` weist die Bibliothek an, den PDF417‑Standard zu verwenden, der große Datenmengen und Fehlerkorrektur unterstützt. Der Konstruktor akzeptiert zudem die zu codierenden Daten, sodass später keine separate Zuweisung von `CodeText` nötig ist. + +## Barcode‑Größe und Spaltenanzahl festlegen + +PDF417‑Symbole bestehen aus Reihen und Spalten kleiner rechteckiger Module. Durch die Steuerung der Modulbreite (X‑Dimension) und der Spaltenanzahl können Sie die Gesamtabmessungen feinjustieren. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Erklärung*: +* **X‑Dimension** (`Pixels`) bestimmt, wie breit jedes Modul ist. Kleinere Werte erzeugen einen dichteren Barcode, während größere Werte die Lesbarkeit bei niedrigauflösenden Scannern erhöhen. +* **Columns** steuern das horizontale Layout. Weniger Spalten machen den Barcode höher; mehr Spalten machen ihn breiter. Passen Sie beide Einstellungen zusammen an, um die genaue **Barcode‑Größe** zu erreichen, die Sie benötigen. + +## Kompakten Modus aktivieren für einen kleineren Barcode + +PDF417 enthält einen „kompakten“ (oder abgeschnittenen) Modus, der überflüssige Polsterungen entfernt und den Gesamtabdruck reduziert. Das ist besonders nützlich, wenn Sie nur begrenzten Bildschirmplatz haben. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Warum Trunkierung aktivieren?* +Wenn `Truncate` **true** ist, lässt der Generator das Stopp‑Muster und einige Fehlerkorrektur‑Codewörter weg, die für die meisten Scan‑Szenarien nicht erforderlich sind. Das resultierende Bild ist etwa 15‑20 % kleiner, ohne die Datenintegrität für typische Anwendungsfälle zu beeinträchtigen. + +## Barcode als PNG‑Bild speichern + +Nach der Konfiguration von Größe und Modus schreiben Sie den Barcode auf die Festplatte. PNG ist verlustfrei und sorgt dafür, dass die Modulkanten scharf bleiben. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Die Datei `CompactPdf417.png` enthält ein klares PDF417‑Symbol, das den in den vorherigen Schritten festgelegten Abmessungen entspricht. + +### Erwartete Ausgabe + +Das Öffnen des gespeicherten PNG sollte einen vertikal ausgerichteten PDF417‑Barcode zeigen, der aus drei Spalten besteht, jedes Modul 2 px breit ist und eine Gesamtabmessung von etwa **120 × 240 px** (Breite × Höhe) hat. Das Scannen des Bildes mit einem beliebigen Standard‑PDF417‑Reader liefert den ursprünglichen Text „Sample text for PDF417“. + +## Häufige Fallstricke und wie man sie vermeidet + +| Symptom | Wahrscheinliche Ursache | Lösung | +|---------|--------------------------|--------| +| Barcode ist nicht lesbar | X‑Dimension zu klein für den Scanner | Erhöhen Sie `XDimension.Pixels` auf 3 oder 4 | +| Bild ist zu breit für die UI | Zu viele Spalten eingestellt | Reduzieren Sie `Pdf417.Columns` oder aktivieren Sie `Truncate` | +| Ausnahme `ArgumentOutOfRangeException` | Negativer oder null Spaltenwert | Stellen Sie sicher, dass `Columns` eine positive ganze Zahl ist (mindestens 1) | +| PNG‑Datei ist leer | Ausgabepfad existiert nicht oder es fehlen Schreibrechte | Überprüfen Sie, ob das Verzeichnis existiert und die Anwendung Schreibrechte hat | + +> **Profi‑Tipp:** Verwenden Sie `barcodeGenerator.ValidateParameters()` bevor Sie `Save()` aufrufen, um Konfigurationsfehler frühzeitig zu erkennen. + +## Vollständiges, ausführbares Beispiel + +Unten finden Sie ein eigenständiges Konsolenprogramm, das alle oben beschriebenen Schritte integriert. Kopieren Sie es in ein neues C#‑Projekt, stellen Sie das Aspose.BarCode‑NuGet‑Paket wieder her und führen Sie es aus, um das Ergebnis zu sehen. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Das Ausführen des Programms** erzeugt `CompactPdf417.png` im Arbeitsverzeichnis der ausführbaren Datei. Scannen Sie das Bild mit einer mobilen App (z. B. „Barcode Scanner“), um zu überprüfen, ob der codierte Text mit dem Quell‑String übereinstimmt. + +## Nächste Schritte und verwandte Themen + +* **Fehlerkorrekturstufe erhöhen** – passen Sie `Pdf417.ErrorLevel` für Umgebungen mit verrauschten Scans an. +* **Orientierung ändern** – setzen Sie `Pdf417.Rotate` auf `RotationAngle.Rotate90`, wenn Sie ein horizontales Layout benötigen. +* **Barcode in ein PDF einbetten** – kombinieren Sie Aspose.PDF mit Aspose.BarCode, um das Bild direkt in ein Dokument zu platzieren. +* **Andere 2‑D‑Barcodes erzeugen** – die gleiche `BarcodeGenerator`‑Klasse unterstützt DataMatrix, QR und Aztec Codes; ersetzen Sie einfach `EncodeTypes.Pdf417` durch die gewünschte Symbolik. + +Durch das Beherrschen von **PDF417‑Barcode‑Erzeugungs**‑Techniken können Sie Ticketing, Inventarkennzeichnung und sichere Datenübertragung in einer breiten Palette von .NET‑Anwendungen automatisieren. + +## Fazit + +Sie wissen jetzt, wie man **PDF417‑Barcode** in C# **erzeugt**, die **Barcode‑Größe** präzise **festlegt**, Spalten konfiguriert, den kompakten Modus aktiviert und das Ergebnis als PNG speichert. Wenden Sie diese Einstellungen an, um jede UI‑Beschränkung oder Scan‑Anforderung zu erfüllen, und erweitern Sie den Ansatz bei Bedarf auf andere Barcode‑Formate. Viel Spaß beim Coden! + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige, funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, zusätzliche API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man PDF417‑Barcode generiert – Kompakte PDF417‑Kodierung](/barcode/english/net/compact-pdf417-encoding/) +- [Wie man Barcode erstellt – Kompakte PDF417 mit Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Wie man DataMatrix‑Barcodes mit Aspose.BarCode für .NET erzeugt – Schritt‑für‑Schritt‑Anleitung](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/german/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..81637ef61 --- /dev/null +++ b/barcode/german/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Wie man PDF417‑Barcodes in C# liest – eine Schritt‑für‑Schritt‑Anleitung, + die erklärt, wie man mehrere Barcodes aus einem Bild ausliest und MacroPdf417‑Details + extrahiert. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: de +lastmod: 2026-08-22 +og_description: Wie man PDF417‑Barcodes in C# schnell liest. Dieses Tutorial zeigt, + wie man mehrere Barcodes aus einem Bild liest und erweiterte MacroPdf417‑Informationen + abruft. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Wie man PDF417‑Barcodes in C# liest – vollständige Programmieranleitung +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Wie man PDF417‑Barcodes in C# liest – vollständige Anleitung +url: /de/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man PDF417-Barcodes in C# liest – vollständige Anleitung + +Wenn Sie **wie man PDF417**-Balken in einer .NET-Anwendung lesen müssen, bietet Ihnen dieses Tutorial eine sofort einsatzbereite Lösung. Sie lernen, wie man mehrere Barcodes aus einem einzigen Bild liest, den vollständigen MacroPdf417-Datensatz extrahiert und in der Konsole anzeigt. Der Ansatz funktioniert mit der Aspose.BarCode für .NET-Bibliothek und erfordert nur wenige Codezeilen. + +Das Lesen von Barcodes aus einem Bild ist eine gängige Aufgabe in Inventursystemen, Ticketvalidierung und Dokumentenmanagement. Am Ende dieses Leitfadens können Sie jeden PDF417- oder MacroPdf417-Barcode dekodieren, mehrere Codes in einem Bild verarbeiten und die erweiterten Felder verstehen, die MacroPdf417 bereitstellt. + +## Voraussetzungen + +- .NET 6.0 SDK oder höher (der Code kompiliert auch mit .NET Framework 4.7+) +- Visual Studio 2022 oder ein beliebiger C#‑Editor Ihrer Wahl +- Aspose.BarCode für .NET NuGet‑Paket (`Install-Package Aspose.BarCode`) +- Ein Beispielbild, das einen MacroPdf417‑Barcode enthält (z. B. `MacroPdf417.png`) + +Es ist keine zusätzliche Konfiguration erforderlich; die Bibliothek übernimmt das Laden und Dekodieren von Bildern intern. + +## Wie man PDF417-Barcodes aus einem Bild in C# liest + +Der Kern der Lösung ist die Klasse `BarCodeReader`. Sie öffnet das Bild, erkennt alle Barcodes des angegebenen Typs und gibt eine Sammlung von `BarCodeResult`‑Objekten zurück. Der folgende Code zeigt ein vollständiges Konsolenprogramm. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Warum jede Zeile wichtig ist + +| Schritt | Zweck | +|---------|-------| +| **1️⃣ Initialize** | Erstellt einen `BarCodeReader`, der an die Bilddatei gebunden ist, und beschränkt die Erkennung auf die MacroPdf417‑Symbologie, was die Verarbeitung beschleunigt. | +| **2️⃣ Iterate** | `ReadBarCodes()` liefert **alle** Barcodes, die dem angeforderten Typ entsprechen, sodass Sie **mehrere Barcodes** ohne zusätzliche Schleifen lesen können. | +| **3️⃣ Basic output** | Zeigt den generischen `CodeTypeName` und den menschenlesbaren `CodeText`. Das ist nützlich für Logging oder schnelle Validierung. | +| **4️⃣ Extended data** | MacroPdf417 enthält zusätzliche Metadaten (Datei‑ID, Segment‑Anzahl, Zeitstempel usw.). Das Objekt `Extended.Pdf417` stellt jedes Feld direkt bereit, sodass Sie das gesamte Datenpaket speichern oder prüfen können. | + +Das Ausführen des Programms mit einem gültigen MacroPdf417‑Bild erzeugt eine Konsolenausgabe, die der folgenden ähnlich ist: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Die Ausgabe bestätigt, dass die Bibliothek den Barcode erfolgreich gelesen, den Text extrahiert und jedes MacroPdf417‑Feld bereitgestellt hat. + +## Lesen mehrerer Barcodes aus einem einzigen Bild + +Viele reale Szenarien platzieren mehrere PDF417‑Symbole auf einem Etikett – denken Sie an ein Versandmanifest, das einen Carrier‑Code, eine Sendungsnummer und eine Zollerklärung enthält. Der obige Codeblock liest bereits **mehrere Barcodes**, weil `ReadBarCodes()` ein Enumerable aller Treffer zurückgibt. Keine zusätzliche Konfiguration ist nötig; Sie müssen lediglich die Ergebnisse durchlaufen, wie gezeigt. + +Wenn Sie den Leser auf Standard‑PDF417 (nicht‑Macro) beschränken möchten, während Sie dennoch mehrere Codes verarbeiten, ersetzen Sie `DecodeType.MacroPdf417` durch `DecodeType.Pdf417`. Der Rest der Logik bleibt unverändert. + +## Verständnis der erweiterten Daten von MacroPdf417 + +MacroPdf417 ist eine Erweiterung der regulären PDF417‑Spezifikation. Es teilt große Nutzdaten in mehrere Segmente auf und fügt einen kleinen Header hinzu, der die gesamte Datei beschreibt. Die wichtigsten Felder sind: + +- **MacroPdf417FileID** – ein eindeutiger Bezeichner, der von allen Segmenten derselben Datei gemeinsam genutzt wird. +- **MacroPdf417SegmentID** – die Sequenznummer des aktuellen Segments. +- **MacroPdf417SegmentsCount** – die erwartete Gesamtzahl der Segmente. +- **MacroPdf417FileName** – optionaler Dateiname, der mit dem Barcode übertragen wird. +- **MacroPdf417Checksum** – Prüfsummenwert für die komplette Datei. +- **MacroPdf417FileSize** – Größe der ursprünglichen binären Nutzdaten. +- **MacroPdf417TimeStamp** – ISO‑8601‑Zeitstempel, wann der Barcode generiert wurde. +- **MacroPdf417Addressee / Sender** – optionale Textfelder für die Adressierung. +- **MacroPdf417Terminator** – gibt an, ob dieses Segment das letzte ist. + +Wenn Sie alle Segmente erhalten haben, können Sie die Originaldatei rekonstruieren, indem Sie sie nach `MacroPdf417SegmentID` sortieren und die `CodeText`‑Werte zusammenfügen. Diese Logik ist leicht zu implementieren, sobald die Felder verfügbar sind. + +## Häufige Fallstricke und Profi‑Tipps + +- **Image quality matters** – Bilder mit niedriger Auflösung oder stark komprimierten PNG/JPEG‑Dateien können zu verpassten Erkennungen führen. Verwenden Sie mindestens 300 dpi für gedruckte Barcodes. +- **Mixed symbologies** – Enthält das Bild sowohl MacroPdf417 als auch reguläres PDF417, erstellen Sie zwei Reader (je einen für jedes `DecodeType`) oder nutzen Sie `DecodeType.AllSupported` und filtern Sie die Ergebnisse nach `result.CodeTypeName`. +- **Memory usage** – Die `using`‑Anweisung entsorgt den `BarCodeReader` sofort, sodass große Bildpuffer nicht im Speicher verbleiben. +- **Thread safety** – `BarCodeReader` ist nicht thread‑sicher. Erzeugen Sie pro Thread eine separate Instanz, wenn Sie Bilder parallel dekodieren. +- **Error handling** – Umschließen Sie den Aufruf von `ReadBarCodes()` mit einem try/catch‑Block, um `BarCodeException` bei beschädigten Bildern abzufangen. + +## Vollständige funktionierende Beispiel‑Zusammenfassung + +Unten finden Sie das komplette Programm, das Sie in ein neues Konsolenprojekt kopieren können. Es enthält alle `using`‑Direktiven, eine Konstante für den Bildpfad und das Entsorgungsmuster. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Kompilieren Sie mit `dotnet build` und führen Sie es mit `dotnet run` aus. Die Konsole gibt die Basisdaten jedes Barcodes und das vollständige MacroPdf417‑Payload aus. + +## Nächste Schritte + +- **Reconstruct multipart files** – sammeln Sie alle Segmente, sortieren Sie nach `MacroPdf417SegmentID` und verketten Sie `CodeText` zu + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige, funktionierende Codebeispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, weitere API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man PDF417-Barcode generiert – Kompakte PDF417-Codierung](/barcode/english/net/compact-pdf417-encoding/) +- [Wie man PDF417-Barcodes mit türkischen Zeichen in Java liest](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Wie man Aspose für PDF417-Barcode (Chinesisch) in Java verwendet](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/german/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..c91ff3211 --- /dev/null +++ b/barcode/german/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,226 @@ +--- +category: general +date: 2026-08-22 +description: Das Barcode‑Generator‑C#‑Tutorial zeigt, wie man einen Macro‑PDF417‑Barcode + mit Metadaten erstellt und ihn mit Aspose.BarCode als PNG speichert. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: de +lastmod: 2026-08-22 +og_description: Der Barcode‑Generator C# ermöglicht das Erstellen eines Macro‑PDF417‑Barcodes + mit vollständigen Dateimetadaten und den Export als PNG. Folgen Sie dieser Anleitung, + um die Lösung zu implementieren. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: Barcode‑Generator C# – Erstelle Macro‑PDF417‑Barcodes Schritt für Schritt +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Wie man einen Barcode‑Generator in C# für Macro PDF417 verwendet +url: /de/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# So verwenden Sie einen Barcode-Generator C# für Macro PDF417 + +Wenn Sie einen **barcode generator C#** benötigen, der ein Macro PDF417‑Symbol mit Date‑Ebene‑Metadaten erzeugen kann, bietet dieser Leitfaden eine vollständige, sofort einsatzbereite Lösung. Sie sehen, wie Sie das Aussehen des Barcodes konfigurieren, Makro‑Informationen wie Datei‑ID und Segmentanzahl einbetten und schließlich das Ergebnis als PNG‑Bild speichern. + +Das Beispiel verwendet die Aspose.BarCode‑Bibliothek, eine weit verbreitete **C# barcode library**, die das gesamte PDF417‑Funktionsset unterstützt. Es werden keine externen Dienste benötigt, und der Code funktioniert mit .NET 6 oder höher. + +## Voraussetzungen + +Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben: + +* .NET 6 SDK (oder eine neuere Version) installiert. +* Visual Studio 2022, VS Code oder eine andere C#‑IDE. +* Ein NuGet‑Verweis auf **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Grundlegende C#‑Syntax und das Konzept von PDF417‑Barcodes zu verstehen, hilft Ihnen, den Schritten zu folgen, aber das Tutorial erklärt jede Konfigurationsoption im Detail. + +## Was das Tutorial behandelt + +* Initialisierung einer **barcode generator C#**‑Instanz für das Macro PDF417‑Format. +* Anpassen visueller Parameter wie X‑Dimension und Spaltenanzahl. +* Bereitstellung der Macro PDF417‑Datei‑Ebene‑Felder: Datei‑ID, Segment‑ID, Segmentanzahl, Dateiname, Prüfsumme, Dateigröße, Zeitstempel, Empfänger, Absender und Terminator. +* Speichern des erzeugten Symbols als PNG‑Datei. +* Tipps zum Umgang mit Sonderfällen wie großen Dateigrößen oder benutzerdefinierten Zeitstempeln. + +Am Ende dieses Artikels verfügen Sie über ein eigenständiges Programm, das einen vollständig konformen Macro PDF417‑Barcode erzeugt. + +## Schritt 1: Erstellen Sie die barcode generator C#‑Instanz + +Der erste Schritt besteht darin, `BarcodeGenerator` mit dem Enum‑Wert `EncodeTypes.MacroPdf417` und dem zu kodierenden Text zu instanziieren. Der Konstruktor akzeptiert außerdem den Payload‑String, der zum Datenanteil des Makro‑Barcodes wird. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Warum das wichtig ist** – Der `EncodeTypes.MacroPdf417`‑Flag teilt Aspose.BarCode mit, das Symbol als Makro‑Barcode zu behandeln, wodurch die nachfolgenden zusätzlichen Felder aktiviert werden. Ohne dieses Flag würde die Bibliothek einen regulären PDF417‑Barcode ohne Date‑Ebene‑Metadaten erzeugen. + +## Schritt 2: Passen Sie das grundlegende Barcode‑Aussehen an (PDF417‑Visuelle Einstellungen) + +Visuelle Klarheit ist entscheidend für zuverlässiges Scannen. Zwei gängige Parameter sind die Modulbreite (`XDimension`) und die Anzahl der Spalten. Durch das Festlegen dieser Werte wird Größe und Lesbarkeit ausbalanciert. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` steuert die Breite jeder schwarzen/weißen Leiste. Ein Wert von **2** funktioniert gut für die meisten Etikettendrucker. +* `Pdf417.Columns` definiert, wie viele **Spalten** der Barcode verwendet. Fünf Spalten erzeugen ein kompaktes Symbol, ohne die Datenkapazität zu verringern. + +## Schritt 3: Definieren Sie die Macro PDF417‑Datei‑Ebene‑Informationen + +Macro PDF417 erweitert das Standard‑PDF417‑Format um Felder, die beschreiben, wie eine große Datei über mehrere Barcode‑Segmente verteilt wird. Das Bereitstellen dieser Felder stellt sicher, dass nachgelagerte Scanner die Originaldatei rekonstruieren können. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` muss für jedes Segment, das zur selben logischen Datei gehört, identisch sein. +* `MacroPdf417SegmentID` erhöht sich von **0** bis `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` gibt dem Decoder an, wie viele Stücke zu erwarten sind. +* `MacroPdf417FileName` ist optional, aber hilfreich für die menschlich lesbare Identifizierung. + +## Schritt 4: Setzen Sie zusätzliche Makro‑Metadaten + +Über die Kern‑Dateiinformationen hinaus erlaubt die Spezifikation zusätzliche Felder wie Prüfsumme, Dateigröße, Zeitstempel, Empfänger, Absender und ein Terminator‑Flag. Das Befüllen dieser Felder verbessert die Datenintegrität und Rückverfolgbarkeit. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` liefert eine 16‑Bit‑CCITT‑Prüfsumme für die gesamte Datei; der Decoder kann die Integrität nach der Rekonstruktion überprüfen. +* `MacroPdf417FileSize` sollte die genaue Byte‑Anzahl der Originaldatei widerspiegeln; Werte größer als `2^31‑1` erfordern ein 64‑Bit‑Feld, das Aspose automatisch verarbeitet. +* `MacroPdf417TimeStamp` zeichnet den Zeitpunkt der Barcode‑Erstellung auf. Verwenden Sie UTC, um Zeitzonen‑Mehrdeutigkeiten zu vermeiden. +* `MacroPdf417Addressee` und `MacroPdf417Sender` sind Freitext‑Strings, die Routing‑Informationen speichern können. +* `MacroPdf417Terminator` signalisiert, dass dies das letzte Segment ist; setzen Sie es auf `Set` für das letzte Stück, andernfalls belassen Sie den Standard (`NotSet`). + +**Hinweis für Sonderfälle** – Wenn Ihre Dateigröße 4 GB überschreitet, teilen Sie den Inhalt in mehrere Makro‑Segmente auf und passen Sie `SegmentsCount` entsprechend an. Die Bibliothek verwaltet das Feld für große Größen ohne Überlauf. + +## Schritt 5: Speichern Sie den Barcode als PNG‑Bild + +Der letzte Schritt schreibt das erzeugte Symbol auf die Festplatte. PNG bewahrt die genauen Pixelabmessungen und wird von Scan‑Hardware breit unterstützt. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Ersetzen Sie `YOUR_DIRECTORY` durch einen absoluten oder relativen Pfad, in den der ausführende Prozess schreiben kann. Das Enum `BarCodeImageFormat.Png` sorgt für verlustfreie Ausgabe. + +**Warum PNG?** – Rasterformate wie PNG halten die Modulkanten scharf, was für Scanner, die auf hochkontrastreiche Kanten angewiesen sind, essenziell ist. Wenn Sie ein Vektorformat benötigen, unterstützt Aspose auch `Pdf` und `Svg`. + +## Vollständiges ausführbares Beispiel + +Unten finden Sie das vollständige Programm, das Sie in eine Konsolenanwendung kopieren können. Es enthält die erforderlichen `using`‑Direktiven und eine `Main`‑Methode. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Erwartete Ausgabe + +Beim Ausführen des Programms wird eine Datei namens **MacroPdf417.png** im Arbeitsverzeichnis des Projekts erstellt. Das Öffnen des Bildes zeigt einen kompakten PDF417‑Barcode mit den eingebetteten Makro‑Feldern. Das Scannen des Bildes mit einem PDF417‑kompatiblen Leser (z. B. ZXing, Aspose.BarCode‑Decoder) liefert das ursprüngliche `"Sample text"`‑Payload zusammen mit den Makro‑Metadaten. + +## Häufige Fragen und Fehlersuche + +| Frage | Antwort | +|-------|---------| +| *Was tun, wenn der Barcode zu groß für das Ziel‑Etikett ist?* | Reduzieren Sie `XDimension.Pixels` oder erhöhen Sie `Pdf417.Columns`. Beide Parameter beeinflussen die Gesamtabmessungen. | +| *Kann ich anstelle von PNG ein Vektor‑Bild erzeugen?* | Ja. Rufen Sie `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` für skalierbare Ausgabe auf. | +| *Wie überprüfe ich die Prüfsumme nach dem Scannen?* | Der Aspose.BarCode‑Decoder validiert automatisch `MacroPdf417Checksum` und meldet Abweichungen im `MacroPdf417Result`‑Objekt. | +| *Ist die Bibliothek mit .NET Core kompatibel?* | Das NuGet‑Paket unterstützt .NET Standard 2.0+, was .NET Core, .NET 5, .NET 6 und neuere Versionen abdeckt. | +| *Was tun, wenn ich Binärdaten statt Text einbetten muss?* | Konvertieren Sie das Binär‑Payload zu Base64 oder verwenden Sie die `EncodeTypes.MacroPdf417`‑Überladung, die ein Byte‑Array akzeptiert. | + +## Pro‑Tipps für den Produktionseinsatz + +* **Cache den Generator** – + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, zusätzliche API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man einen Barcode erstellt – Kompakter PDF417 mit Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Wie man Barcodes aus PDF in Java mit Aspose.BarCode liest](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Codabar‑Barcode mit Aspose.Barcode erstellen – Generator‑ & Reader‑API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/net/compact-pdf417-encoding/_index.md b/barcode/greek/net/compact-pdf417-encoding/_index.md index 5dc5b2a98..c20a4648b 100644 --- a/barcode/greek/net/compact-pdf417-encoding/_index.md +++ b/barcode/greek/net/compact-pdf417-encoding/_index.md @@ -91,7 +91,7 @@ weight: 29 - **Λειτουργία Compact:** Αφαιρεί το περιττό padding, δημιουργώντας έναν μικρότερο γραμμωτό κώδικα χωρίς να θυσιάζει την αναγνωσιμότητα. ### Επιλογές Διόρθωσης Σφαλμάτων PDF417 -Το Aspose.BarCode σας επιτρέπει να ορίσετε την ιδιότητα `Pdf417ErrorCorrectionLevel` (0‑8). Τα υψηλότερα επίπεδα αυξάνουν την πλεοναστικότητα, κάτι που είναι χρήσιμο σε σκληρά περιβάλλοντα όπως η βιομηχανική σάρωση. Επιλέξτε ένα επίπεδο βάσει της ανοχή σας στον κίνδυνο και των περιορισμών χώρου. +Το Aspose.BarCode σας επιτρέπει να ορίσετε την ιδιότητα `Pdf417ErrorCorrectionLevel` (0‑8). Τα υψηλότερα επίπεδα αυξάνουν την πλεοναστικότητα, κάτι που είναι χρήσιμο σε σκληρά περιβάλλοντα όπως η βιομηχανική σάρωση. Επιλέξτε ένα επίπεδο βάσει της ανοχής σας στον κίνδυνο και των περιορισμών χώρου. ## Πώς να δημιουργήσετε PDF417 Barcode βήμα προς βήμα @@ -145,6 +145,21 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); ### [Δημιουργία Compact PDF417 Barcodes](./compact-pdf417-basic-configuration/) Μάθετε πώς να δημιουργείτε Compact PDF417 γραμμωτούς κώδικες χρησιμοποιώντας το Aspose.BarCode for .NET. Πλήρης οδηγός με βήμα‑βήμα οδηγίες και παραδείγματα κώδικα. +### [Πώς να δημιουργήσετε PDF417 barcode σε C# και να ορίσετε το μέγεθος του barcode](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +Μάθετε πώς να δημιουργήσετε PDF417 barcode σε C# και να ρυθμίσετε το μέγεθος του. + +### [Πώς να δημιουργήσετε PDF417 barcode σε C# και να το αποθηκεύσετε ως PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Μάθετε πώς να δημιουργήσετε PDF417 barcode σε C# και να το αποθηκεύσετε ως αρχείο PNG. + +### [Πώς να δημιουργήσετε micro PDF417 barcode σε C# – βήμα‑βήμα οδηγός](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Μάθετε πώς να δημιουργήσετε micro PDF417 γραμμωτό κώδικα σε C# με αναλυτικές οδηγίες βήμα‑βήμα. + +### [Πώς να χρησιμοποιήσετε έναν γεννήτρια γραμμωτού κώδικα C# για Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Μάθετε πώς να δημιουργήσετε Macro PDF417 barcode χρησιμοποιώντας τον BarcodeGenerator σε C#. + +### [Πώς να διαβάσετε γραμμωτούς κώδικες PDF417 σε C# – πλήρης οδηγός](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Μάθετε πώς να διαβάζετε PDF417 γραμμωτούς κώδικες σε C# χρησιμοποιώντας το Aspose.BarCode for .NET, με παραδείγματα κώδικα και βέλτιστες πρακτικές. + ## Συχνές Ερωτήσεις **Ε: Ποιο είναι το μέγιστο ποσό δεδομένων που μπορώ να αποθηκεύσω σε έναν Compact PDF417 γραμμωτό κώδικα;** diff --git a/barcode/greek/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/greek/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..eb72c627d --- /dev/null +++ b/barcode/greek/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Μάθετε πώς να δημιουργήσετε μικρο‑κώδικα PDF417 σε C# και να δημιουργήσετε + μια εικόνα PNG του κώδικα. Περιλαμβάνει τον καθορισμό διαστάσεων του κώδικα και + την αποθήκευση του αρχείου. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: el +lastmod: 2026-08-22 +og_description: Δημιουργήστε μικρο‑PDF417 barcode σε C# και εξάγετέ το ως PNG. Ακολουθήστε + αυτόν τον οδηγό για να ορίσετε τις διαστάσεις του barcode και να δημιουργήσετε γρήγορα + μια εικόνα barcode. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Δημιουργήστε μικρό γραμμωτό κώδικα PDF417 σε C# – πλήρης οδηγός προγραμματισμού +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Πώς να δημιουργήσετε μικρό κωδικό PDF417 σε C# – οδηγός βήμα‑βήμα +url: /el/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να δημιουργήσετε μικρό PDF417 barcode σε C# – οδηγός βήμα‑βήμα + +Αν χρειάζεστε **να δημιουργήσετε μικρό PDF417 barcode** για σύστημα έκδοσης εισιτηρίων, ετικέτα αποθέματος ή κινητή σάρωση, αυτό το tutorial σας δείχνει ακριβώς πώς. Θα δείτε το πλήρες πρόγραμμα C# που δημιουργεί ένα barcode PNG, θα μάθετε πώς να ορίζετε τις διαστάσεις του barcode και θα κατανοήσετε κάθε επιλογή διαμόρφωσης. + +Στο τέλος αυτού του οδηγού θα μπορείτε να δημιουργήσετε μια εικόνα barcode υψηλής ανάλυσης, να προσαρμόσετε τη διάσταση X, να επιλέξετε τον αριθμό στηλών και να αποθηκεύσετε το αποτέλεσμα ως αρχείο PNG — όλα με λίγες γραμμές κώδικα. + +## Τι θα χρειαστείτε + +- .NET 6.0 SDK ή νεότερο (ο κώδικας λειτουργεί με .NET Core και .NET Framework) +- Visual Studio 2022 ή οποιοδήποτε IDE συμβατό με C# +- Το πακέτο NuGet **Aspose.BarCode for .NET** (ή οποιαδήποτε βιβλιοθήκη που υποστηρίζει `EncodeTypes.MicroPdf417`) +- Βασική εξοικείωση με τη σύνταξη C# + +> **Συμβουλή επαγγελματία:** Η δωρεάν έκδοση community του Aspose.BarCode είναι επαρκής για ανάπτυξη και δοκιμές. Για παραγωγή, αποκτήστε άδεια για να αφαιρέσετε τα υδατογράμματα αξιολόγησης. + +## Βήμα 1: Εγκατάσταση της βιβλιοθήκης barcode + +Ανοίξτε ένα τερματικό στο φάκελο του έργου σας και εκτελέστε: + +```bash +dotnet add package Aspose.BarCode +``` + +Αυτό προσθέτει το assembly `Aspose.BarCode`, το οποίο παρέχει την κλάση `BarcodeGenerator` που χρησιμοποιείται για **δημιουργία εικόνας barcode C#** εφαρμογών. + +## Βήμα 2: Αρχικοποίηση του δημιουργού – δημιουργία μικρού PDF417 barcode + +Η πρώτη ενέργεια δημιουργεί ένα στιγμιότυπο `BarcodeGenerator` διαμορφωμένο για τη συμβολική Micro PDF417 και παρέχει τα δεδομένα που θέλετε να κωδικοποιήσετε. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Γιατί είναι σημαντικό*: Η απαρίθμηση `EncodeTypes.MicroPdf417` ενημερώνει τη βιβλιοθήκη να χρησιμοποιήσει τη συμπαγή έκδοση του PDF417, η οποία είναι ιδανική για μικρές ετικέτες και κινητές οθόνες. + +## Βήμα 3: Πώς να ορίσετε τις διαστάσεις του barcode σε C# + +Η λεπτομερής ρύθμιση του πλάτους του μονάδας (διάσταση X) ελέγχει την οπτική πυκνότητα του barcode. Μια μικρότερη τιμή παράγει πιο καθαρή εικόνα, ενώ μια μεγαλύτερη τιμή καθιστά το barcode πιο εύκολο στην σάρωση από απόσταση. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Γιατί πρέπει να ορίσετε διαστάσεις**: Χωρίς να προσαρμόσετε τη διάσταση X, η προεπιλεγμένη τιμή μπορεί να παράγει ένα barcode που φαίνεται θολό όταν αποδίδεται σε υψηλό DPI. Ορίζοντάς το σε 2 pixel είναι μια καλή ισορροπία για τις περισσότερες σάρωσεις μέσω οθόνης. + +## Βήμα 4: Επιλογή αριθμού στηλών – έλεγχος του πλάτους του barcode + +Το Micro PDF417 επιτρέπει από 1 έως 4 στήλες. Περισσότερες στήλες συμπιέζουν τα δεδομένα οριζόντια, μειώνοντας το συνολικό πλάτος της εικόνας. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Ακραία περίπτωση*: Εάν ζητήσετε 5 στήλες, η βιβλιοθήκη ρίχνει `ArgumentOutOfRangeException`. Πάντα παραμείνετε εντός του τεκμηριωμένου εύρους. + +## Βήμα 5: Πώς να δημιουργήσετε PNG barcode – αποθήκευση της εικόνας + +Τώρα μπορείτε να εξάγετε το δημιουργημένο barcode σε αρχείο PNG. Το PNG διατηρεί την απώλεια ποιότητας, κάτι που είναι απαραίτητο για αξιόπιστη σάρωση. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Όταν εκτελέσετε το πρόγραμμα, θα δείτε ένα μήνυμα κονσόλας που επιβεβαιώνει τη θέση του αρχείου. Το αποτέλεσμα `MicroPdf417.png` φαίνεται ως εξής: + +![Στιγμιότυπο οθόνης που δείχνει ένα δημιουργημένο micro PDF417 barcode με C#](micro-pdf417-example.png "Δημιουργημένο micro PDF417 barcode") + +*Κείμενο alt εικόνας*: **micro PDF417 barcode που δημιουργήθηκε σε C#** – δείχνει το τελικό αποτέλεσμα μετά την εφαρμογή των διαστάσεων και των ρυθμίσεων στήλης. + +## Βήμα 6: Εκτέλεση και επαλήθευση του αποτελέσματος + +1. Δομήστε το έργο: `dotnet build`. +2. Εκτελέστε: `dotnet run`. +3. Ανοίξτε το `MicroPdf417.png` στην επιφάνεια εργασίας σας και σαρώστε το με μια εφαρμογή σάρωσης barcode για κινητά. + +Θα πρέπει να δείτε το κείμενο **“Sample text”** να αποκωδικοποιείται. Εάν ο σαρωτής αναφέρει σφάλμα, ελέγξτε ξανά τη διάσταση X και τον αριθμό στηλών — ακραίες τιμές μπορούν να κάνουν το barcode πολύ πυκνό για ορισμένες συσκευές. + +## Συχνές παραλλαγές και αντιμετώπιση προβλημάτων + +| Situation | Adjustment | +|-----------|------------| +| **Απαιτείται μεγαλύτερο barcode για εκτυπωτές χαμηλής ανάλυσης** | Αυξήστε το `XDimension.Pixels` σε 3 ή 4. | +| **Θέλετε ψηλότερο barcode χωρίς αλλαγή του πλάτους** | Ορίστε το `generator.Parameters.Barcode.Pdf417.Rows` (εύρος γραμμών 3‑90). | +| **Δημιουργία πολλαπλών barcode σε βρόχο** | Ξαναχρησιμοποιήστε το ίδιο στιγμιότυπο `BarcodeGenerator` και αλλάξτε μόνο το `CodeText` πριν από κάθε `Save`. | +| **Αποθήκευση ως JPEG αντί για PNG** | Αντικαταστήστε το `BarCodeImageFormat.Png` με `BarCodeImageFormat.Jpeg`. | +| **Εκτέλεση σε .NET Framework 4.7** | Ο ίδιος κώδικας λειτουργεί· απλώς αναφέρετε το κατάλληλο `Aspose.BarCode.dll`. | + +## Πλήρης λίστα πηγαίου κώδικα (εκτελέσιμος) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Αναμενόμενο αποτέλεσμα** – ένα αρχείο PNG 200 × 100 pixel που περιέχει ένα καθαρό Micro PDF417 barcode που αποκωδικοποιείται σε “Sample text”. + +## Συμπέρασμα + +Τώρα ξέρετε πώς να **δημιουργήσετε μικρό PDF417 barcode** σε C#, **ορίσετε τις διαστάσεις του barcode**, και **δημιουργήσετε μια εικόνα barcode PNG**. Το πλήρες παράδειγμα δείχνει κάθε απαιτούμενο βήμα — από την εγκατάσταση της βιβλιοθήκης μέχρι την αποθήκευση του τελικού αρχείου — ώστε να μπορείτε να ενσωματώσετε τη δημιουργία barcode απευθείας στις δικές σας εφαρμογές. + +Στη συνέχεια, εξερευνήστε συναφή θέματα όπως **δημιουργία QR codes με Aspose.BarCode**, **προσαρμογή χρωμάτων**, ή **ενσωμάτωση barcode σε έγγραφα PDF**. Κάθε ένα από αυτά βασίζεται στις ίδιες θεμελιώδεις αρχές `BarcodeGenerator` που καλύφθηκαν εδώ. + +Μη διστάσετε να πειραματιστείτε με διαφορετικές συμβολοσειρές δεδομένων, αριθμούς στηλών και τιμές X‑dimension ώστε να ταιριάζουν στο συγκεκριμένο περιβάλλον σάρωσής σας. Καλή προγραμματιστική! + +## Τι πρέπει να μάθετε στη συνέχεια; + +Τα παρακάτω tutorials καλύπτουν στενά σχετιζόμενα θέματα που βασίζονται στις τεχνικές που παρουσιάζονται σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να σας βοηθήσουν να κατακτήσετε πρόσθετες δυνατότητες API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [Πώς να δημιουργήσετε Barcode – Compact PDF417 με Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Πώς να δημιουργήσετε PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Πώς να δημιουργήσετε Aztec barcode με Aspose.BarCode για .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/greek/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..3fc688889 --- /dev/null +++ b/barcode/greek/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Μάθετε πώς να δημιουργήσετε γραμμωτό κώδικα PDF417 σε C# με έναν δημιουργό + γραμμωτών κωδίκων, ορίστε τη διάταξη και αποθηκεύστε PNG. Περιλαμβάνει πλήρες κώδικα + και συμβουλές για έργα δημιουργού γραμμωτών κωδίκων C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: el +lastmod: 2026-08-22 +og_description: Δημιουργήστε γραμμωτό κώδικα PDF417 σε C# χρησιμοποιώντας έναν δημιουργό + γραμμωτών κωδίκων, προσαρμόστε τη διάταξη και μάθετε πώς να αποθηκεύετε PNG. Ακολουθήστε + αυτό το βήμα‑βήμα οδηγό. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Δημιουργία γραμμωτού κώδικα PDF417 σε C# – πλήρης οδηγός για τη δημιουργία + και αποθήκευση PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Πώς να δημιουργήσετε γραμμωτό κώδικα PDF417 σε C# και να τον αποθηκεύσετε ως + PNG +url: /el/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να δημιουργήσετε PDF417 barcode σε C# και να τον αποθηκεύσετε ως PNG + +Αν χρειάζεστε **create PDF417 barcode** σε μια εφαρμογή C#, αυτό το tutorial σας δείχνει τα ακριβή βήματα. Θα δείτε πώς μια βιβλιοθήκη barcode generator C# μπορεί να μετατρέψει οποιαδήποτε συμβολοσειρά σε μια δυνατότητα σάρωσης εικόνα PDF417 και πώς να αποθηκεύσετε αρχεία PNG χωρίς επιπλέον εργαλεία. + +Η δημιουργία γραμμωτών κωδίκων είναι κοινή στη λογιστική, τα εισιτήρια και τη διαχείριση εγγράφων. Στο τέλος αυτού του οδηγού θα έχετε ένα εκτελέσιμο πρόγραμμα κονσόλας που παράγει ένα αρχείο PNG με όνομα `Pdf417Layout.png` στον φάκελο που θα επιλέξετε. + +## Προαπαιτούμενα + +- .NET 6.0 SDK ή νεότερο εγκατεστημένο (ο κώδικας λειτουργεί επίσης με .NET Framework 4.7+). +- Visual Studio 2022 ή οποιονδήποτε επεξεργαστή που μπορεί να δημιουργήσει έργα C#. +- Το πακέτο NuGet **Aspose.BarCode for .NET** (ή οποιαδήποτε συμβατή βιβλιοθήκη barcode generator C#). + Εγκαταστήστε το με: + +```bash +dotnet add package Aspose.BarCode +``` + +Δεν απαιτούνται πρόσθετες βιβλιοθήκες επεξεργασίας εικόνας επειδή ο δημιουργός μπορεί να γράψει PNG απευθείας. + +## Βήμα 1: Δημιουργία νέου έργου κονσόλας + +Δημιουργήστε ένα νέο έργο κονσόλας ώστε το παράδειγμα να παραμείνει αυτόνομο. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Ο φάκελος `Pdf417Demo` περιέχει τώρα ένα αρχείο `Program.cs` όπου θα γράψουμε τον κώδικα του γραμμωτού κώδικα. + +## Βήμα 2: Εισαγωγή του namespace του γραμμωτού κώδικα + +Ανοίξτε το `Program.cs` και προσθέστε την απαιτούμενη οδηγία `using` στην κορυφή: + +```csharp +using Aspose.BarCode.Generation; +``` + +Αυτό το namespace σας δίνει πρόσβαση στα `BarcodeGenerator`, `EncodeTypes` και το enum μορφής εικόνας που απαιτείται για **how to save PNG**. + +## Βήμα 3: Δημιουργία του PDF417 barcode generator + +Ο πυρήνας του **how to generate PDF417** είναι η κλάση `BarcodeGenerator`. Περνάτε τον τύπο κωδικοποίησης `EncodeTypes.Pdf417` και το κείμενο που θέλετε να κωδικοποιηθεί. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` τώρα περιέχει όλες τις ρυθμίσεις για τον γραμμωτό κώδικα. Η προεπιλεγμένη διάταξη λειτουργεί, αλλά θα την προσαρμόσουμε στο επόμενο βήμα. + +## Βήμα 4: Ορισμός της διάταξης του γραμμωτού κώδικα (στήλες και σειρές) + +Το PDF417 σας επιτρέπει να ελέγχετε τον αριθμό των στηλών (2‑30) και των σειρών (1‑90). Η ρύθμιση αυτών των τιμών μπορεί να βελτιώσει την ευανάγνωστη για συγκεκριμένους σαρωτές. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tip:** Εάν παραλείψετε αυτές τις ρυθμίσεις, η βιβλιοθήκη επιλέγει αυτόματα βέλτιστες τιμές. Ωστόσο, η σταθεροποίηση των στηλών και των σειρών σας δίνει προβλέψιμες διαστάσεις εικόνας, κάτι που είναι χρήσιμο όταν ενσωματώνετε το PNG σε PDF ή σε διάταξη UI. + +## Βήμα 5: Αποθήκευση του παραγόμενου γραμμωτού κώδικα ως εικόνα PNG + +Τώρα απαντήστε στο **how to save PNG** καλώντας τη μέθοδο `Save`. Η μέθοδος δέχεται τη διαδρομή προορισμού και το enum μορφής εικόνας. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Το αρχείο `Pdf417Layout.png` εμφανίζεται στο φάκελο `bin/Debug/net6.0` του έργου μετά την εκτέλεση του προγράμματος. + +## Πλήρες εκτελέσιμο παράδειγμα + +Παρακάτω είναι το πλήρες αρχείο `Program.cs`. Αντιγράψτε το στο έργο που δημιουργήθηκε στο **Step 1** και εκτελέστε `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Αναμενόμενη έξοδος + +Όταν εκτελέσετε το πρόγραμμα, η κονσόλα εκτυπώνει τη απόλυτη διαδρομή του αρχείου PNG, και το αρχείο περιέχει έναν καθαρό γραμμωτό κώδικα PDF417 που μοιάζει με την παρακάτω εικόνα. + +![παράδειγμα δημιουργίας PDF417 barcode](image-placeholder.png "Γραμμωτός κώδικας PDF417 αποθηκευμένος ως PNG") + +Μπορείτε να σαρώσετε το PNG με οποιονδήποτε σαρωτή συμβατό με PDF417 (εφαρμογές κινητών, υλικό αναγνώστη) για να επαληθεύσετε ότι το κωδικοποιημένο κείμενο είναι `"Sample"`. + +## Διαχείριση περιπτώσεων άκρων και κοινών παγίδων + +| Κατάσταση | Τι πρέπει να προσέξετε | Προτεινόμενη διόρθωση | +|-----------|------------------------|-----------------------| +| **Invalid column/row values** | Τιμές εκτός του εύρους 2‑30 (στήλες) ή 1‑90 (σειρές) προκαλούν `ArgumentException`. | Επικυρώστε την είσοδο του χρήστη πριν την ανάθεση, ή αφήστε τη βιβλιοθήκη να επιλέξει προεπιλογές. | +| **Large input strings** | PDF417 μπορεί να κωδικοποιήσει έως 1.850 χαρακτήρες, αλλά πολύ μεγάλες συμβολοσειρές αυξάνουν δραστικά τις απαιτούμενες σειρές. | Διαιρέστε τα δεδομένα σε πολλαπλούς γραμμωτούς κώδικες ή χρησιμοποιήστε υψηλότερο επίπεδο διόρθωσης σφαλμάτων αν χρειάζεται. | +| **File‑system permissions** | Η αποθήκευση σε φάκελο μόνο για ανάγνωση προκαλεί `UnauthorizedAccessException`. | Γράψτε στο `Environment.CurrentDirectory` ή σε διαδρομή εγγραφής από τον χρήστη, και διαχειριστείτε τις εξαιρέσεις με try/catch. | +| **Missing NuGet package** | Η μεταγλώττιση αποτυγχάνει με το μήνυμα “type or namespace name could not be found”. | Βεβαιωθείτε ότι το `Aspose.BarCode` είναι εγκατεστημένο (`dotnet add package Aspose.BarCode`). | + +## Επέκταση του παραδείγματος + +Τώρα που γνωρίζετε **how to create PDF417 barcode** και **how to save PNG**, μπορείτε να εξερευνήσετε τα παρακάτω συναφή θέματα: + +- **Barcode generator C#**: Αλλάξτε το `EncodeTypes` σε `Code128`, `QR`, ή άλλες συμβολές. +- **Custom colors**: Χρησιμοποιήστε `generator.Parameters.Barcode.ForegroundColor` και `BackgroundColor` για να ταιριάξετε με την επωνυμία. +- **Embedding in PDFs**: Συνδυάστε το PNG με μια βιβλιοθήκη PDF (π.χ., iText7) για να δημιουργήσετε εκτυπώσιμα έγγραφα. +- **Dynamic data**: Αντλήστε το κείμενο από μια βάση δεδομένων ή είσοδο χρήστη για να δημιουργήσετε γραμμωτούς κώδικες σε πραγματικό χρόνο. + +## Συμπέρασμα + +Τώρα έχετε μια πλήρη, έτοιμη για παραγωγή λύση για **create PDF417 barcode** σε C# και αποθήκευση του αποτελέσματος ως αρχείο PNG. Το tutorial κάλυψε κάθε βήμα από τη ρύθμιση του έργου μέχρι την προσαρμογή της διάταξης, και τόνισε πώς να αποφύγετε κοινά σφάλματα όταν χρησιμοποιείτε μια βιβλιοθήκη barcode generator C#. + +Μη διστάσετε να πειραματιστείτε με διαφορετικές ρυθμίσεις στήλης/σειράς, χρώματα, ή ακόμη και άλλες μορφές γραμμωτών κωδίκων. Εάν αντιμετωπίσετε προβλήματα, επιστρέψτε στην ενότητα **how to generate PDF417** ή εξερευνήστε την τεκμηρίωση της βιβλιοθήκης για προχωρημένα χαρακτηριστικά. Καλή προγραμματιστική! + +## Τι πρέπει να μάθετε στη συνέχεια; + +Τα παρακάτω tutorials καλύπτουν στενά συναφή θέματα που βασίζονται στις τεχνικές που παρουσιάζονται σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα-βήμα εξηγήσεις για να σας βοηθήσουν να κατακτήσετε πρόσθετα χαρακτηριστικά API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [Πώς να δημιουργήσετε γραμμωτό κώδικα – Compact PDF417 με Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Πώς να δημιουργήσετε PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Πώς να δημιουργήσετε Quiet Zone για ITF-14 χρησιμοποιώντας Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/greek/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..2ed47eb56 --- /dev/null +++ b/barcode/greek/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-08-22 +description: Μάθετε πώς να δημιουργήσετε γραμμωτό κώδικα PDF417 σε C# με το Aspose.BarCode, + να ορίσετε το μέγεθος του κώδικα, να προσαρμόσετε τις στήλες και να ενεργοποιήσετε + τη συμπαγή λειτουργία. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: el +lastmod: 2026-08-22 +og_description: Δημιουργήστε γραμμωτό κώδικα PDF417 σε C# με το Aspose.BarCode. Αυτός + ο οδηγός δείχνει πώς να ορίσετε το μέγεθος του κώδικα, να ελέγξετε τις στήλες και + να ενεργοποιήσετε τη συμπαγή λειτουργία για μικρότερη εικόνα. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Δημιουργία barcode PDF417 σε C# – ορισμός μεγέθους, στηλών και συμπαγούς + λειτουργίας +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Πώς να δημιουργήσετε γραμμωτό κώδικα PDF417 σε C# και να ορίσετε το μέγεθός + του +url: /el/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να δημιουργήσετε PDF417 barcode σε C# και να ορίσετε το μέγεθος του barcode + +Αν χρειάζεστε **να δημιουργήσετε PDF417 barcode** σε μια εφαρμογή .NET, αυτός ο οδηγός σας καθοδηγεί μέσα από τη διαδικασία. Θα δείτε ακριβώς **πώς να δημιουργήσετε PDF417** με το Aspose.BarCode, να προσαρμόσετε το **set barcode size**, και να παραγάγετε ένα συμπαγές PNG που μπορεί να ενσωματωθεί σε αναφορές ή κινητές εφαρμογές. + +Η δημιουργία ενός barcode δεν απαιτεί ξεχωριστό πρόγραμμα επεξεργασίας γραφικών. Στο τέλος αυτού του tutorial θα έχετε μια πλήρως λειτουργική μέθοδο C# που παράγει μια εικόνα PDF417 με τις ακριβείς διαστάσεις που χρειάζεστε, έτοιμη για επεξεργασία downstream. + +## Τι θα μάθετε + +* Εγκαταστήστε και αναφέρετε τη βιβλιοθήκη Aspose.BarCode. +* Δημιουργήστε έναν PDF417 barcode generator και καθορίστε το κωδικοποιημένο κείμενο. +* **Set barcode size** μέσω ρύθμισης του X‑dimension και του αριθμού στηλών. +* Ενεργοποιήστε τη συμπαγή (truncated) λειτουργία για να μειώσετε το σύμβολο. +* Αποθηκεύστε το αποτέλεσμα ως αρχείο PNG. +* Αντιμετωπίστε κοινά προβλήματα όπως μη αναγνώσιμα κώδικα και υπερβολικά μεγάλες εικόνες. + +### Προαπαιτούμενα + +* .NET 6.0 ή νεότερο (το API λειτουργεί επίσης με .NET Framework 4.6+). +* Βασική εξοικείωση με C# και Visual Studio (ή οποιοδήποτε IDE για C#). +* Ένα έγκυρο license Aspose.BarCode (η δωρεάν αξιολόγηση λειτουργεί για δοκιμές). + +> **Pro tip:** Εάν σκοπεύετε να δημιουργήσετε πολλά barcodes σε βρόχο, επαναχρησιμοποιήστε μια μοναδική παρουσία `BarcodeGenerator` και αλλάξτε μόνο την ιδιότητα `CodeText`. Αυτό μειώνει τις εκχωρήσεις μνήμης. + +## Δημιουργία PDF417 barcode με Aspose.BarCode + +Το πρώτο βήμα είναι η δημιουργία μιας παρουσίας του `BarcodeGenerator` για τη συμβολική PDF417. Αυτό το αντικείμενο είναι το σημείο εισόδου για όλες τις λειτουργίες barcode. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Γιατί είναι σημαντικό*: `EncodeTypes.Pdf417` ενημερώνει τη βιβλιοθήκη να χρησιμοποιήσει το πρότυπο PDF417, το οποίο υποστηρίζει μεγάλα όγκους δεδομένων και διόρθωση σφαλμάτων. Ο κατασκευαστής δέχεται επίσης τα δεδομένα που θέλετε να κωδικοποιήσετε, εξαλείφοντας την ανάγκη για ξεχωριστή ανάθεση `CodeText` αργότερα. + +## Ορισμός μεγέθους barcode και αριθμού στηλών + +Τα σύμβολα PDF417 αποτελούνται από σειρές και στήλες μικρών ορθογωνίων μονάδων. Ο έλεγχος του πλάτους της μονάδας (X‑dimension) και του αριθμού των στηλών σας επιτρέπει να ρυθμίσετε ακριβώς τις συνολικές διαστάσεις. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Επεξήγηση*: +* **X‑dimension** (`Pixels`) καθορίζει το πλάτος κάθε μονάδας. Μικρότερες τιμές παράγουν πιο πυκνό barcode, ενώ μεγαλύτερες τιμές αυξάνουν την αναγνωσιμότητα σε σαρωτές χαμηλής ανάλυσης. +* **Columns** ελέγχει τη οριζόντια διάταξη. Λιγότερες στήλες κάνουν το barcode ψηλότερο· περισσότερες στήλες το κάνουν πιο πλατύ. Ρυθμίστε αυτές τις δύο παραμέτρους μαζί για να πετύχετε το ακριβές **set barcode size** που χρειάζεστε. + +## Ενεργοποίηση συμπαγούς λειτουργίας για μικρότερο barcode + +Το PDF417 περιλαμβάνει μια λειτουργία “compact” (ή truncated) που αφαιρεί περιττές επενδύσεις και μειώνει το συνολικό αποτύπωμα. Αυτό είναι ιδιαίτερα χρήσιμο όταν έχετε περιορισμένο χώρο οθόνης. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Γιατί να ενεργοποιήσετε την περικοπή;* +Όταν το `Truncate` είναι `true`, ο δημιουργός παραλείπει το μοτίβο τερματισμού και ορισμένες λέξεις κώδικα διόρθωσης σφαλμάτων που δεν απαιτούνται για τις περισσότερες περιπτώσεις σάρωσης. Η προκύπτουσα εικόνα είναι περίπου 15‑20 % μικρότερη χωρίς να θυσιάζεται η ακεραιότητα των δεδομένων για τυπικές περιπτώσεις χρήσης. + +## Αποθήκευση του barcode ως εικόνα PNG + +Αφού ρυθμίσετε το μέγεθος και τη λειτουργία, γράψτε το barcode στο δίσκο. Το PNG είναι lossless, διασφαλίζοντας ότι οι άκρες των μονάδων παραμένουν οξείς. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Το αρχείο `CompactPdf417.png` θα περιέχει ένα καθαρό σύμβολο PDF417 που ταιριάζει με τις διαστάσεις που ορίσατε στα προηγούμενα βήματα. + +### Αναμενόμενο αποτέλεσμα + +Ανοίγοντας το αποθηκευμένο PNG θα πρέπει να εμφανίζεται ένα PDF417 barcode προσανατολισμένο κατακόρυφα, αποτελούμενο από τρεις στήλες, κάθε μονάδα 2 px πλάτος, και συνολικό μέγεθος περίπου **120 × 240 px** (πλάτος × ύψος). Η σάρωση της εικόνας με οποιονδήποτε τυπικό αναγνώστη PDF417 επιστρέφει το αρχικό κείμενο “Sample text for PDF417”. + +## Συνηθισμένα προβλήματα και πώς να τα αποφύγετε + +| Σύμπτωμα | Πιθανή αιτία | Διόρθωση | +|----------|--------------|----------| +| Το barcode δεν είναι αναγνώσιμο | Το X‑dimension είναι πολύ μικρό για τον σαρωτή | Αυξήστε το `XDimension.Pixels` σε 3 ή 4 | +| Η εικόνα είναι πολύ πλατιά για το UI | Έχουν οριστεί πάρα πολλές στήλες | Μειώστε το `Pdf417.Columns` ή ενεργοποιήστε το `Truncate` | +| Εξαίρεση `ArgumentOutOfRangeException` | Αρνητικός ή μηδενικός αριθμός στηλών | Βεβαιωθείτε ότι το `Columns` είναι θετικός ακέραιος (ελάχιστο 1) | +| Το αρχείο PNG είναι κενό | Η διαδρομή εξόδου δεν υπάρχει ή δεν έχει δικαίωμα εγγραφής | Επαληθεύστε ότι ο φάκελος υπάρχει και η εφαρμογή έχει δικαιώματα εγγραφής | + +> **Pro tip:** Χρησιμοποιήστε το `barcodeGenerator.ValidateParameters()` πριν καλέσετε το `Save()` για να εντοπίσετε σφάλματα διαμόρφωσης νωρίς. + +## Πλήρες, εκτελέσιμο παράδειγμα + +Παρακάτω υπάρχει ένα αυτόνομο πρόγραμμα κονσόλας που ενσωματώνει όλα τα παραπάνω βήματα. Αντιγράψτε το σε ένα νέο έργο C#, επαναφέρετε το πακέτο NuGet Aspose.BarCode και εκτελέστε το για να δείτε το αποτέλεσμα. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Η εκτέλεση του προγράμματος** παράγει το `CompactPdf417.png` στον φάκελο εργασίας του εκτελέσιμου. Σαρώστε την εικόνα με μια κινητή εφαρμογή (π.χ., “Barcode Scanner”) για να επαληθεύσετε ότι το κωδικοποιημένο κείμενο ταιριάζει με το αρχικό string. + +## Επόμενα βήματα και συναφή θέματα + +* **Αύξηση επιπέδου διόρθωσης σφαλμάτων** – προσαρμόστε το `Pdf417.ErrorLevel` για περιβάλλοντα με θορυβώδεις σάρωσες. +* **Αλλαγή προσανατολισμού** – ορίστε το `Pdf417.Rotate` σε `RotationAngle.Rotate90` εάν χρειάζεστε οριζόντια διάταξη. +* **Ενσωμάτωση του barcode σε PDF** – συνδυάστε το Aspose.PDF με το Aspose.BarCode για να τοποθετήσετε την εικόνα απευθείας σε ένα έγγραφο. +* **Δημιουργία άλλων 2‑Δ barcode** – η ίδια κλάση `BarcodeGenerator` υποστηρίζει DataMatrix, QR και Aztec κώδικες· απλώς αντικαταστήστε το `EncodeTypes.Pdf417` με τη ζητούμενη συμβολική. + +Με την εξοικείωση στις τεχνικές **generate PDF417 barcode**, μπορείτε να αυτοματοποιήσετε την έκδοση εισιτηρίων, την ετικετοθέτηση αποθεμάτων και τη ασφαλή μετάδοση δεδομένων σε ένα ευρύ φάσμα εφαρμογών .NET. + +## Συμπέρασμα + +Τώρα γνωρίζετε πώς να **generate PDF417 barcode** σε C#, ακριβώς **set barcode size**, να ρυθμίσετε τις στήλες, να ενεργοποιήσετε τη συμπαγή λειτουργία και να αποθηκεύσετε το αποτέλεσμα ως PNG. Εφαρμόστε αυτές τις ρυθμίσεις για να ταιριάζουν σε οποιονδήποτε περιορισμό UI ή απαίτηση σάρωσης, και επεκτείνετε την προσέγγιση σε άλλες μορφές barcode όπως απαιτείται. Καλό προγραμματισμό! + +## Τι Θα Πρέπει Να Μάθετε Στη Σειρά; + +Τα παρακάτω tutorials καλύπτουν στενά σχετικά θέματα που βασίζονται στις τεχνικές που παρουσιάζονται σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να σας βοηθήσουν να εξοικειωθείτε με πρόσθετες δυνατότητες του API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/greek/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..2308528f6 --- /dev/null +++ b/barcode/greek/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Πώς να διαβάσετε κωδικούς PDF417 σε C# με έναν οδηγό βήμα‑βήμα, καλύπτοντας + πώς να διαβάσετε πολλαπλούς κωδικούς από μια εικόνα και να εξάγετε λεπτομέρειες + MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: el +lastmod: 2026-08-22 +og_description: Πώς να διαβάσετε γρήγορα κώδικες PDF417 σε C#. Αυτό το σεμινάριο σας + δείχνει πώς να διαβάσετε πολλαπλούς κώδικες από μια εικόνα και να ανακτήσετε τις + εκτεταμένες πληροφορίες MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Πώς να διαβάζετε κωδικούς PDF417 σε C# – πλήρης οδηγός προγραμματισμού +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Πώς να διαβάσετε κωδικούς PDF417 σε C# – πλήρης οδηγός +url: /el/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να διαβάσετε κωδικούς PDF417 σε C# – πλήρης οδηγός + +Αν χρειάζεστε **πώς να διαβάσετε PDF417** μπαρ σε μια εφαρμογή .NET, αυτό το tutorial σας παρέχει μια έτοιμη λύση. Θα μάθετε πώς να διαβάζετε πολλαπλούς κωδικούς από μία εικόνα, να εξάγετε το πλήρες σύνολο δεδομένων MacroPdf417 και να το εμφανίσετε στην κονσόλα. Η προσέγγιση λειτουργεί με τη βιβλιοθήκη Aspose.BarCode for .NET και απαιτεί μόνο λίγες γραμμές κώδικα. + +Η ανάγνωση κωδικών από εικόνα είναι μια συνηθισμένη εργασία σε συστήματα απογραφής, επικύρωση εισιτηρίων και διαχείριση εγγράφων. Στο τέλος αυτού του οδηγού θα μπορείτε να αποκωδικοποιήσετε οποιονδήποτε κωδικό PDF417 ή MacroPdf417, να χειριστείτε πολλούς κωδικούς σε μία εικόνα και να κατανοήσετε τα εκτεταμένα πεδία που παρέχει το MacroPdf417. + +## Προαπαιτούμενα + +- .NET 6.0 SDK ή νεότερο (ο κώδικας συντάσσεται επίσης με .NET Framework 4.7+) +- Visual Studio 2022 ή οποιονδήποτε επεξεργαστή C# προτιμάτε +- Πακέτο NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Ένα δείγμα εικόνας που περιέχει κωδικό MacroPdf417 (π.χ., `MacroPdf417.png`) + +Δεν απαιτείται πρόσθετη ρύθμιση· η βιβλιοθήκη διαχειρίζεται την φόρτωση εικόνας και την αποκωδικοποίηση εσωτερικά. + +## Πώς να διαβάσετε κωδικούς PDF417 από εικόνα σε C# + +Ο πυρήνας της λύσης είναι η κλάση `BarCodeReader`. Ανοίγει την εικόνα, εντοπίζει όλους τους κωδικούς του καθορισμένου τύπου και επιστρέφει μια συλλογή αντικειμένων `BarCodeResult`. Ο παρακάτω κώδικας δείχνει ένα πλήρες πρόγραμμα κονσόλας. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Γιατί κάθε γραμμή είναι σημαντική + +| Βήμα | Σκοπός | +|------|--------| +| **1️⃣ Initialize** | Δημιουργεί ένα `BarCodeReader` δεσμευμένο στο αρχείο εικόνας και περιορίζει την ανίχνευση στη συμβολή MacroPdf417, κάτι που επιταχύνει την επεξεργασία. | +| **2️⃣ Iterate** | Η `ReadBarCodes()` επιστρέφει **όλους** τους κωδικούς που ταιριάζουν με τον ζητούμενο τύπο, επιτρέποντάς σας να **διαβάσετε πολλαπλούς κωδικούς** χωρίς επιπλέον βρόχους. | +| **3️⃣ Basic output** | Εμφανίζει το γενικό `CodeTypeName` και το ανθρώπινα αναγνώσιμο `CodeText`. Αυτό είναι χρήσιμο για καταγραφή ή γρήγορη επαλήθευση. | +| **4️⃣ Extended data** | Το MacroPdf417 μεταφέρει πρόσθετα μεταδεδομένα (αριθμός αρχείου, αριθμός τμημάτων, χρονικές σφραγίδες κ.λπ.). Το αντικείμενο `Extended.Pdf417` εκθέτει κάθε πεδίο άμεσα, ώστε να μπορείτε να το αποθηκεύσετε ή να επαληθεύσετε ολόκληρο το πακέτο δεδομένων. | + +Η εκτέλεση του προγράμματος με μια έγκυρη εικόνα MacroPdf417 παράγει έξοδο κονσόλας παρόμοια με την παρακάτω: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Η έξοδος επιβεβαιώνει ότι η βιβλιοθήκη διάβασε επιτυχώς τον κωδικό, εξήγαγε το κείμενο και παρείχε κάθε πεδίο MacroPdf417. + +## Ανάγνωση πολλαπλών κωδικών από μία εικόνα + +Πολλά πραγματικά σενάρια τοποθετούν αρκετά σύμβολα PDF417 σε μία ετικέτα — σκεφτείτε ένα φορτωτικό δελτίο που περιέχει κωδικό μεταφορέα, αριθμό παρακολούθησης και δήλωση τελωνείου. Ο ίδιος κώδικας παραπάνω ήδη **διαβάζει πολλαπλούς κωδικούς** επειδή η `ReadBarCodes()` επιστρέφει ένα enumerable με όλα τα αποτελέσματα. Δεν απαιτείται πρόσθετη ρύθμιση· χρειάζεται μόνο να επαναλάβετε τα αποτελέσματα, όπως δείχνεται. + +Αν θέλετε να περιορίσετε τον αναγνώστη σε τυπικό PDF417 (μη‑macro) ενώ εξακολουθείτε να διαχειρίζεστε πολλούς κωδικούς, αντικαταστήστε το `DecodeType.MacroPdf417` με `DecodeType.Pdf417`. Η υπόλοιπη λογική παραμένει αμετάβλητη. + +## Κατανόηση των εκτεταμένων δεδομένων MacroPdf417 + +Το MacroPdf417 είναι μια επέκταση της κανονικής προδιαγραφής PDF417. Διασπά μεγάλα payloads σε πολλαπλά τμήματα και προσθέτει μια μικρή κεφαλίδα που περιγράφει ολόκληρο το αρχείο. Τα πιο σημαντικά πεδία είναι: + +- **MacroPdf417FileID** – μοναδικό αναγνωριστικό που μοιράζεται από όλα τα τμήματα του ίδιου αρχείου. +- **MacroPdf417SegmentID** – ο αριθμός σειράς του τρέχοντος τμήματος. +- **MacroPdf417SegmentsCount** – συνολικός αριθμός τμημάτων που αναμένονται. +- **MacroPdf417FileName** – προαιρετικό όνομα αρχείου που μεταδίδεται με τον κωδικό. +- **MacroPdf417Checksum** – τιμή ελέγχου σφαλμάτων για ολόκληρο το αρχείο. +- **MacroPdf417FileSize** – μέγεθος του αρχικού δυαδικού payload. +- **MacroPdf417TimeStamp** – χρονική σφραγίδα ISO‑8601 όταν δημιουργήθηκε ο κωδικός. +- **MacroPdf417Addressee / Sender** – προαιρετικά κείμενα για δρομολόγηση. +- **MacroPdf417Terminator** – υποδεικνύει αν αυτό το τμήμα είναι το τελευταίο. + +Όταν λάβετε όλα τα τμήματα, μπορείτε να επανασυνθέσετε το αρχικό αρχείο ταξινομώντας τα κατά `MacroPdf417SegmentID` και συνενώνοντας τις τιμές `CodeText`. Η λογική αυτή είναι απλή στην υλοποίηση μόλις έχετε τα πεδία διαθέσιμα. + +## Συνηθισμένα προβλήματα και επαγγελματικές συμβουλές + +- **Η ποιότητα της εικόνας μετρά** – εικόνες χαμηλής ανάλυσης ή έντονης συμπίεσης PNG/JPEG μπορούν να προκαλέσουν χαμένες ανιχνεύσεις. Χρησιμοποιήστε DPI τουλάχιστον 300 dpi για τυπωμένους κωδικούς. +- **Μικτές συμβολές** – αν η εικόνα περιέχει τόσο MacroPdf417 όσο και κανονικό PDF417, δημιουργήστε δύο αναγνώστες (έναν για κάθε `DecodeType`) ή χρησιμοποιήστε `DecodeType.AllSupported` και φιλτράρετε τα αποτελέσματα με `result.CodeTypeName`. +- **Χρήση μνήμης** – η δήλωση `using` απελευθερώνει άμεσα το `BarCodeReader`, αποτρέποντας μεγάλους buffer εικόνας να παραμένουν στη μνήμη. +- **Ασφάλεια νήματος** – το `BarCodeReader` δεν είναι thread‑safe. Δημιουργήστε ξεχωριστό στιγμιότυπο ανά νήμα αν αποκωδικοποιείτε εικόνες παράλληλα. +- **Διαχείριση σφαλμάτων** – τυλίξτε την κλήση `ReadBarCodes()` σε try/catch για να συλλάβετε `BarCodeException` σε κατεστραμμένες εικόνες. + +## Συνοπτικό παράδειγμα πλήρους κώδικα + +Παρακάτω βρίσκεται το πλήρες πρόγραμμα που μπορείτε να αντιγράψετε σε ένα νέο έργο κονσόλας. Περιλαμβάνει όλες τις οδηγίες `using`, μια σταθερά για τη διαδρομή της εικόνας και το πρότυπο διαχείρισης πόρων. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Συγκεντρώστε με `dotnet build` και τρέξτε με `dotnet run`. Η κονσόλα θα εκτυπώσει τα βασικά δεδομένα κάθε κωδικού και το πλήρες payload MacroPdf417. + +## Επόμενα βήματα + +- **Ανασυνθέστε αρχεία multipart** – συλλέξτε όλα τα τμήματα, ταξινομήστε τα κατά `MacroPdf417SegmentID` και συνενώστε το `CodeText` για να δημιουργήσετε το αρχικό αρχείο. + +## Τι πρέπει να μάθετε στη συνέχεια; + +Τα παρακάτω tutorials καλύπτουν στενά σχετιζόμενα θέματα που επεκτείνουν τις τεχνικές που παρουσιάστηκαν σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να κατακτήσετε πρόσθετες δυνατότητες API και να εξερευνήσετε εναλλακτικές προσεγγίσεις στην δική σας υλοποίηση. + +- [Πώς να δημιουργήσετε κωδικό PDF417 – Συμπαγής κωδικοποίηση PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Πώς να διαβάσετε κωδικούς PDF417 με τουρκικούς χαρακτήρες σε Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Πώς να χρησιμοποιήσετε Aspose για κωδικό PDF417 (Κινέζικα) σε Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/greek/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..6cbda4e19 --- /dev/null +++ b/barcode/greek/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: Το tutorial δημιουργίας barcode σε C# δείχνει πώς να δημιουργήσετε ένα + barcode Macro PDF417 με μεταδεδομένα και να το αποθηκεύσετε ως PNG χρησιμοποιώντας + το Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: el +lastmod: 2026-08-22 +og_description: Το barcode generator C# σας επιτρέπει να δημιουργήσετε έναν κώδικα + Macro PDF417 με πλήρη μεταδεδομένα σε επίπεδο αρχείου και να τον εξάγετε ως PNG. + Ακολουθήστε αυτόν τον οδηγό για να υλοποιήσετε τη λύση. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: Γεννήτρια barcode C# – δημιουργία barcode Macro PDF417 βήμα προς βήμα +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Πώς να χρησιμοποιήσετε έναν δημιουργό γραμμωτού κώδικα C# για Macro PDF417 +url: /el/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να χρησιμοποιήσετε έναν γεννήτρια barcode C# για Macro PDF417 + +Αν χρειάζεστε έναν **barcode generator C#** που μπορεί να δημιουργήσει ένα σύμβολο Macro PDF417 με μεταδεδομένα επιπέδου αρχείου, αυτός ο οδηγός παρέχει μια πλήρη, έτοιμη προς εκτέλεση λύση. Θα δείτε πώς να διαμορφώσετε την εμφάνιση του barcode, να ενσωματώσετε πληροφορίες macro όπως το αναγνωριστικό αρχείου και τον αριθμό τμημάτων, και τέλος να αποθηκεύσετε το αποτέλεσμα ως εικόνα PNG. + +Το παράδειγμα χρησιμοποιεί τη βιβλιοθήκη Aspose.BarCode, μια ευρέως υιοθετημένη **C# barcode library** που υποστηρίζει το πλήρες σύνολο λειτουργιών PDF417. Δεν απαιτούνται εξωτερικές υπηρεσίες και ο κώδικας λειτουργεί με .NET 6 ή νεότερο. + +## Προαπαιτούμενα + +* .NET 6 SDK (ή οποιαδήποτε μεταγενέστερη έκδοση) εγκατεστημένο. +* Visual Studio 2022, VS Code ή άλλο C# IDE. +* Μια αναφορά NuGet στη **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Η κατανόηση της βασικής σύνταξης C# και της έννοιας των barcode PDF417 θα σας βοηθήσει να ακολουθήσετε τα βήματα, αλλά ο οδηγός εξηγεί κάθε επιλογή ρύθμισης λεπτομερώς. + +## Τι καλύπτει ο οδηγός + +* Αρχικοποίηση ενός αντικειμένου **barcode generator C#** για τη μορφή Macro PDF417. +* Προσαρμογή οπτικών παραμέτρων όπως η διάσταση X και ο αριθμός στηλών. +* Παροχή πεδίων επιπέδου αρχείου Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender, και terminator. +* Αποθήκευση του παραγόμενου συμβόλου ως αρχείο PNG. +* Συμβουλές για διαχείριση ειδικών περιπτώσεων όπως μεγάλα μεγέθη αρχείων ή προσαρμοσμένα timestamps. + +Στο τέλος αυτού του άρθρου θα έχετε ένα αυτόνομο πρόγραμμα που παράγει ένα πλήρως συμβατό barcode Macro PDF417. + +## Βήμα 1: Δημιουργία του αντικειμένου barcode generator C# + +Η πρώτη ενέργεια είναι η δημιουργία ενός αντικειμένου `BarcodeGenerator` με την τιμή του enum `EncodeTypes.MacroPdf417` και το κείμενο που θέλετε να κωδικοποιήσετε. Ο κατασκευαστής δέχεται επίσης τη συμβολοσειρά payload, η οποία γίνεται το τμήμα δεδομένων του macro barcode. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Γιατί είναι σημαντικό** – Η σημαία `EncodeTypes.MacroPdf417` λέει στη Aspose.BarCode να αντιμετωπίσει το σύμβολο ως macro barcode, ενεργοποιώντας τα επιπλέον πεδία που ακολουθούν. Χωρίς αυτή τη σημαία η βιβλιοθήκη θα δημιουργούσε ένα κανονικό barcode PDF417 χωρίς μεταδεδομένα επιπέδου αρχείου. + +## Βήμα 2: Προσαρμογή βασικής εμφάνισης barcode (οπτικές ρυθμίσεις PDF417) + +Η οπτική σαφήνεια είναι κρίσιμη για αξιόπιστη σάρωση. Δύο συνηθισμένες παράμετροι είναι το πλάτος του μονάδας (`XDimension`) και ο αριθμός των στηλών. Η ρύθμιση αυτών των τιμών ισορροπεί το μέγεθος και την αναγνωσιμότητα. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` ελέγχει το πλάτος κάθε μαύρης/λευκής γραμμής. Μια τιμή **2** λειτουργεί καλά για τους περισσότερους εκτυπωτές ετικετών. +* `Pdf417.Columns` ορίζει πόσες στήλες θα χρησιμοποιήσει το barcode. Πέντε στήλες παράγουν ένα συμπαγές σύμβολο χωρίς να θυσιάζεται η χωρητικότητα δεδομένων. + +## Βήμα 3: Ορισμός πληροφοριών επιπέδου αρχείου Macro PDF417 + +Το Macro PDF417 επεκτείνει τη στάνταρ μορφή PDF417 με πεδία που περιγράφουν πώς ένα μεγάλο αρχείο χωρίζεται σε πολλαπλά τμήματα barcode. Η παροχή αυτών των πεδίων εξασφαλίζει ότι οι σαρωτές μπορούν να ανασυνθέσουν το αρχικό αρχείο. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` πρέπει να είναι το ίδιο για κάθε τμήμα που ανήκει στο ίδιο λογικό αρχείο. +* `MacroPdf417SegmentID` αυξάνεται από **0** έως `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` ενημερώνει τον αποκωδικοποιητή πόσα κομμάτια να περιμένει. +* `MacroPdf417FileName` είναι προαιρετικό αλλά χρήσιμο για ανθρώπινη αναγνώσιμη ταυτοποίηση. + +## Βήμα 4: Ορισμός πρόσθετων macro μεταδεδομένων + +Πέρα από τις βασικές πληροφορίες αρχείου, η προδιαγραφή επιτρέπει επιπλέον πεδία όπως checksum, μέγεθος αρχείου, timestamp, addressee, sender, και μια σημαία terminator. Η συμπλήρωση αυτών των πεδίων βελτιώνει την ακεραιότητα των δεδομένων και την ανιχνευσιμότητα. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` παρέχει έναν 16‑bit CCITT checksum για ολόκληρο το αρχείο· ο αποκωδικοποιητής μπορεί να επαληθεύσει την ακεραιότητα μετά την ανασύνθεση. +* `MacroPdf417FileSize` πρέπει να αντανακλά τον ακριβή αριθμό byte του αρχικού αρχείου· τιμές μεγαλύτερες από `2^31‑1` απαιτούν πεδίο 64‑bit, το οποίο η Aspose διαχειρίζεται αυτόματα. +* `MacroPdf417TimeStamp` καταγράφει πότε δημιουργήθηκε το barcode. Χρησιμοποιήστε UTC για να αποφύγετε ασάφειες ζώνης ώρας. +* `MacroPdf417Addressee` και `MacroPdf417Sender` είναι ελεύθερες συμβολοσειρές που μπορούν να αποθηκεύσουν πληροφορίες δρομολόγησης. +* `MacroPdf417Terminator` υποδηλώνει ότι αυτό είναι το τελικό τμήμα· ορίστε το σε `Set` για το τελευταίο κομμάτι, διαφορετικά αφήστε την προεπιλογή (`NotSet`). + +**Συμβουλή για ειδικές περιπτώσεις** – Αν το μέγεθος του αρχείου σας υπερβαίνει τα 4 GB, χωρίστε το περιεχόμενο σε πολλαπλά macro τμήματα και προσαρμόστε το `SegmentsCount` αναλόγως. Η βιβλιοθήκη θα διαχειριστεί το πεδίο μεγάλου μεγέθους χωρίς υπερχείλιση. + +## Βήμα 5: Αποθήκευση του barcode ως εικόνα PNG + +Το τελευταίο βήμα γράφει το παραγόμενο σύμβολο στο δίσκο. Το PNG διατηρεί τις ακριβείς διαστάσεις pixel και υποστηρίζεται ευρέως από το υλικό σάρωσης. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Αντικαταστήστε το `YOUR_DIRECTORY` με μια απόλυτη ή σχετική διαδρομή στην οποία η εκτελούμενη διαδικασία μπορεί να γράψει. Η enum `BarCodeImageFormat.Png` εξασφαλίζει απώλεια‑απώλειας έξοδο. + +**Γιατί PNG;** – Τα raster formats όπως το PNG διατηρούν τις άκρες των μονάδων οξίνες, κάτι που είναι ουσιώδες για σαρωτές που βασίζονται σε υψηλής αντίθεσης άκρες. Αν χρειάζεστε διανυσματική μορφή, η Aspose υποστηρίζει επίσης `Pdf` και `Svg`. + +## Πλήρες εκτελέσιμο παράδειγμα + +Παρακάτω βρίσκεται το πλήρες πρόγραμμα που μπορείτε να αντιγράψετε σε μια εφαρμογή κονσόλας. Περιλαμβάνει τις απαραίτητες οδηγίες `using` και μια μέθοδο `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Αναμενόμενο αποτέλεσμα + +Η εκτέλεση του προγράμματος δημιουργεί ένα αρχείο με όνομα **MacroPdf417.png** στον φάκελο εργασίας του έργου. Το άνοιγμα της εικόνας εμφανίζει ένα συμπαγές barcode PDF417 με τα ενσωματωμένα macro πεδία. Η σάρωση της εικόνας με έναν αναγνώστη συμβατό με PDF417 (π.χ., ZXing, Aspose.BarCode decoder) επιστρέφει το αρχικό payload `"Sample text"` μαζί με τα macro μεταδεδομένα. + +## Συχνές ερωτήσεις και αντιμετώπιση προβλημάτων + +| Ερώτηση | Απάντηση | +|----------|--------| +| *Τι γίνεται αν το barcode είναι πολύ μεγάλο για την ετικέτα στόχο;* | Μειώστε το `XDimension.Pixels` ή αυξήστε το `Pdf417.Columns`. Και οι δύο παράμετροι επηρεάζουν το συνολικό μέγεθος. | +| *Μπορώ να δημιουργήσω μια διανυσματική εικόνα αντί για PNG;* | Ναι. Καλέστε `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` για κλιμακώσιμη έξοδο. | +| *Πώς μπορώ να επαληθεύσω το checksum μετά τη σάρωση;* | Ο αποκωδικοποιητής Aspose.BarCode επαληθεύει αυτόματα το `MacroPdf417Checksum` και αναφέρει τυχόν ασυμφωνίες στο αντικείμενο `MacroPdf417Result`. | +| *Είναι η βιβλιοθήκη συμβατή με .NET Core;* | Το πακέτο NuGet υποστηρίζει .NET Standard 2.0+, που καλύπτει .NET Core, .NET 5, .NET 6 και νεότερες εκδόσεις. | +| *Τι γίνεται αν χρειαστεί να ενσωματώσω δυαδικά δεδομένα αντί για κείμενο;* | Μετατρέψτε το δυαδικό payload σε Base64 ή χρησιμοποιήστε την υπερφόρτωση `EncodeTypes.MacroPdf417` που δέχεται έναν πίνακα byte. | + +## Συμβουλές για παραγωγική χρήση + +* **Cache the generator** – + +## Τι πρέπει να μάθετε στη συνέχεια; + +Τα παρακάτω tutorials καλύπτουν στενά συναφή θέματα που βασίζονται στις τεχνικές που παρουσιάζονται σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να σας βοηθήσουν να κατακτήσετε πρόσθετες δυνατότητες API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [Πώς να δημιουργήσετε Barcode – Compact PDF417 με Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Πώς να διαβάσετε barcode από PDF σε Java χρησιμοποιώντας Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Δημιουργία Codabar Barcode με Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/net/compact-pdf417-encoding/_index.md b/barcode/hindi/net/compact-pdf417-encoding/_index.md index b54f71fb9..035bcfeb8 100644 --- a/barcode/hindi/net/compact-pdf417-encoding/_index.md +++ b/barcode/hindi/net/compact-pdf417-encoding/_index.md @@ -171,7 +171,11 @@ Aspose.BarCode for .NET का उपयोग करके Compact PDF417 ब - [बारकोड कैसे बनाएं – Aspose.BarCode के साथ कॉम्पैक्ट PDF417](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [Aspose.BarCode for .NET के व्यापक ट्यूटोरियल और उदाहरण](/barcode/net/) - [.NET में एरर करेक्शन के साथ Aztec बारकोड कैसे बनाएं](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) - +- [C# में PDF417 बारकोड कैसे जनरेट करें और बारकोड आकार सेट करें](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +- [C# में PDF417 बारकोड बनाएं और PNG के रूप में सहेजें](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +- [C# में माइक्रो PDF417 बारकोड कैसे बनाएं – चरण‑दर‑चरण गाइड](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +- [C# के साथ मैक्रो PDF417 बारकोड जेनरेटर कैसे उपयोग करें](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [C# में PDF417 बारकोड कैसे पढ़ें – पूर्ण गाइड](./how-to-read-pdf417-barcodes-in-c-complete-guide/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/hindi/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/hindi/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..792aa05c5 --- /dev/null +++ b/barcode/hindi/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-08-22 +description: C# में माइक्रो PDF417 बारकोड बनाना सीखें और बारकोड PNG इमेज जेनरेट करें। + इसमें बारकोड के आयाम सेट करना और फ़ाइल को सहेजना शामिल है। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: hi +lastmod: 2026-08-22 +og_description: C# में माइक्रो PDF417 बारकोड बनाएं और इसे PNG के रूप में निर्यात करें। + बारकोड के आयाम निर्धारित करने और जल्दी से बारकोड इमेज उत्पन्न करने के लिए इस गाइड + का पालन करें। +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: C# में माइक्रो PDF417 बारकोड बनाएं – पूर्ण कोडिंग ट्यूटोरियल +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: C# में माइक्रो PDF417 बारकोड कैसे बनाएं – चरण‑दर‑चरण गाइड +url: /hi/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# में माइक्रो PDF417 बारकोड कैसे बनाएं – चरण‑दर‑चरण गाइड + +यदि आपको टिकटिंग सिस्टम, इन्वेंटरी लेबल, या मोबाइल स्कैन के लिए **micro PDF417 barcode बनाएं** की आवश्यकता है, तो यह ट्यूटोरियल आपको बिल्कुल दिखाएगा कि कैसे। आप पूरा C# प्रोग्राम देखेंगे जो बारकोड PNG बनाता है, बारकोड आयाम कैसे सेट करें सीखेंगे, और प्रत्येक कॉन्फ़िगरेशन विकल्प को समझेंगे। + +इस गाइड के अंत तक आप एक हाई‑रेज़ोल्यूशन बारकोड इमेज जेनरेट कर सकेंगे, X‑डायमेंशन को कस्टमाइज़ कर सकेंगे, कॉलम काउंट चुन सकेंगे, और परिणाम को PNG फ़ाइल के रूप में सहेज सकेंगे—सिर्फ कुछ लाइनों के कोड से। + +## आपको क्या चाहिए + +- .NET 6.0 SDK या बाद का (कोड .NET Core और .NET Framework के साथ काम करता है) +- Visual Studio 2022 या कोई भी C#‑compatible IDE +- **Aspose.BarCode for .NET** NuGet पैकेज (या कोई लाइब्रेरी जो `EncodeTypes.MicroPdf417` को सपोर्ट करती है) +- C# सिंटैक्स की बुनियादी जानकारी + +> **प्रो टिप:** Aspose.BarCode का फ्री कम्युनिटी एडिशन विकास और परीक्षण के लिए पर्याप्त है। प्रोडक्शन के लिए, इवैल्यूएशन वाटरमार्क हटाने हेतु लाइसेंस प्राप्त करें। + +## चरण 1: बारकोड लाइब्रेरी इंस्टॉल करें + +अपने प्रोजेक्ट फ़ोल्डर में टर्मिनल खोलें और चलाएँ: + +```bash +dotnet add package Aspose.BarCode +``` + +यह `Aspose.BarCode` असेंबली जोड़ता है, जो `BarcodeGenerator` क्लास प्रदान करता है जिसका उपयोग **C# में बारकोड इमेज बनाने** के लिए किया जाता है। + +## चरण 2: जेनरेटर इनिशियलाइज़ करें – माइक्रो PDF417 बारकोड बनाएं + +पहली कार्यात्मक लाइन एक `BarcodeGenerator` इंस्टेंस बनाती है जिसे माइक्रो PDF417 सिम्बोलॉजी के लिए कॉन्फ़िगर किया गया है और वह डेटा प्रदान करती है जिसे आप एन्कोड करना चाहते हैं। + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*क्यों यह महत्वपूर्ण है*: `EncodeTypes.MicroPdf417` एन्नम लाइब्रेरी को PDF417 का कॉम्पैक्ट वर्ज़न उपयोग करने के लिए बताता है, जो छोटे लेबल और मोबाइल स्क्रीन के लिए आदर्श है। + +## चरण 3: C# में बारकोड डाइमेंशन्स कैसे सेट करें + +मॉड्यूल चौड़ाई (X‑डायमेंशन) को फाइन‑ट्यून करने से बारकोड की विज़ुअल डेंसिटी नियंत्रित होती है। छोटा मान तेज़ इमेज देता है, जबकि बड़ा मान बारकोड को दूरी से स्कैन करना आसान बनाता है। + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **डाइमेंशन सेट क्यों करें**: X‑डायमेंशन को एडजस्ट किए बिना, डिफ़ॉल्ट मान हाई DPI पर रेंडर होने पर बारकोड धुंधला दिखा सकता है। इसे 2 पिक्सेल पर सेट करना अधिकांश स्क्रीन‑आधारित स्कैन के लिए एक अच्छा बैलेंस है। + +## चरण 4: कॉलम की संख्या चुनें – बारकोड की चौड़ाई नियंत्रित करना + +Micro PDF417 1 से 4 कॉलम तक की अनुमति देता है। अधिक कॉलम डेटा को हॉरिज़ॉन्टली कंप्रेस करते हैं, जिससे कुल इमेज की चौड़ाई घटती है। + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*एज केस*: यदि आप 5 कॉलम का अनुरोध करते हैं तो लाइब्रेरी `ArgumentOutOfRangeException` थ्रो करती है। हमेशा डॉक्यूमेंटेड रेंज के भीतर रहें। + +## चरण 5: बारकोड PNG कैसे जेनरेट करें – इमेज को सेव करना + +अब आप जेनरेटेड बारकोड को PNG फ़ाइल में एक्सपोर्ट कर सकते हैं। PNG लॉसलेस क्वालिटी को बनाए रखता है, जो विश्वसनीय स्कैनिंग के लिए आवश्यक है। + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +जब आप प्रोग्राम चलाएंगे, तो आपको फ़ाइल लोकेशन की पुष्टि करने वाला कंसोल मैसेज दिखाई देगा। परिणामी `MicroPdf417.png` इस प्रकार दिखता है: + +![C# से निर्मित जेनरेटेड माइक्रो PDF417 बारकोड का स्क्रीनशॉट](micro-pdf417-example.png "जेनरेटेड माइक्रो PDF417 बारकोड") + +*इमेज अल्ट टेक्स्ट*: **C# में जेनरेटेड माइक्रो PDF417 बारकोड** – डाइमेंशन और कॉलम सेटिंग्स लागू करने के बाद अंतिम आउटपुट दर्शाता है। + +## चरण 6: आउटपुट चलाएँ और वेरिफ़ाई करें + +1. प्रोजेक्ट बनाएं: `dotnet build`। +2. चलाएँ: `dotnet run`। +3. डेस्कटॉप पर `MicroPdf417.png` खोलें और इसे मोबाइल बारकोड स्कैनर ऐप से स्कैन करें। + +आपको टेक्स्ट **“Sample text”** डिकोडेड दिखना चाहिए। यदि स्कैनर एरर रिपोर्ट करता है, तो X‑डायमेंशन और कॉलम काउंट को दोबारा चेक करें – अत्यधिक मान कुछ डिवाइसों के लिए बारकोड को बहुत डेंस बना सकते हैं। + +## सामान्य वैरिएशन्स और ट्रबलशूटिंग + +| Situation | Adjustment | +|-----------|------------| +| **लो‑रेज़ोल्यूशन प्रिंटरों के लिए बड़ा बारकोड चाहिए** | `XDimension.Pixels` को 3 या 4 तक बढ़ाएँ। | +| **चौड़ाई बदले बिना ऊँचा बारकोड चाहिए** | `generator.Parameters.Barcode.Pdf417.Rows` सेट करें (पंक्तियों की रेंज 3‑90)। | +| **लूप में कई बारकोड जेनरेट करना** | एक ही `BarcodeGenerator` इंस्टेंस को पुनः उपयोग करें और प्रत्येक `Save` से पहले केवल `CodeText` बदलें। | +| **PNG के बजाय JPEG के रूप में सेव करना** | `BarCodeImageFormat.Png` को `BarCodeImageFormat.Jpeg` से बदलें। | +| **.NET Framework 4.7 पर चलाना** | कोड वही काम करता है; बस उपयुक्त `Aspose.BarCode.dll` को रेफ़रेंस करें। | + +## पूर्ण स्रोत सूची (चलाने योग्य) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**अपेक्षित आउटपुट** – 200 × 100‑पिक्सेल PNG फ़ाइल जिसमें एक स्पष्ट Micro PDF417 बारकोड है जो “Sample text” को डिकोड करता है। + +## निष्कर्ष + +अब आप जानते हैं कि C# में **micro PDF417 barcode** कैसे **बनाएँ**, **बारकोड डाइमेंशन सेट करें**, और **बारकोड PNG** इमेज जेनरेट करें। पूरा उदाहरण सभी आवश्यक चरणों को दर्शाता है—लाइब्रेरी इंस्टॉलेशन से लेकर अंतिम फ़ाइल को सेव करने तक—ताकि आप अपने एप्लिकेशन में सीधे बारकोड जेनरेशन एम्बेड कर सकें। + +अगले, संबंधित विषयों को एक्सप्लोर करें जैसे **Aspose.BarCode के साथ QR कोड बनाना**, **रंग कस्टमाइज़ करना**, या **PDF दस्तावेज़ों में बारकोड एम्बेड करना**। इन सभी में यहाँ कवर किए गए समान `BarcodeGenerator` मूलभूत सिद्धांतों का उपयोग किया गया है। + +विभिन्न डेटा स्ट्रिंग्स, कॉलम काउंट, और X‑डायमेंशन वैल्यूज़ के साथ प्रयोग करने में संकोच न करें ताकि आपका स्कैनिंग वातावरण अनुकूल हो। कोडिंग का आनंद लें! + +## अब आपको क्या सीखना चाहिए? + +निम्नलिखित ट्यूटोरियल्स निकट-संबंधित विषयों को कवर करते हैं जो इस गाइड में दिखाए गए तकनीकों पर आधारित हैं। प्रत्येक रिसोर्स में पूर्ण कार्यशील कोड उदाहरण और चरण‑दर‑चरण व्याख्याएँ शामिल हैं जो आपको अतिरिक्त API फीचर्स में महारत हासिल करने और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन अप्रोचेज़ को एक्सप्लोर करने में मदद करेंगे। + +- [बारकोड कैसे बनाएं – Aspose.BarCode के साथ कॉम्पैक्ट PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [PDF417 बारकोड कैसे जेनरेट करें – कॉम्पैक्ट PDF417 एन्कोडिंग](/barcode/english/net/compact-pdf417-encoding/) +- [.NET के लिए Aspose.BarCode के साथ Aztec बारकोड कैसे बनाएं](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/hindi/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..d39805776 --- /dev/null +++ b/barcode/hindi/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: C# में बारकोड जेनरेटर का उपयोग करके PDF417 बारकोड बनाना सीखें, लेआउट + सेट करें और PNG सहेजें। इसमें पूर्ण कोड और बारकोड जेनरेटर C# प्रोजेक्ट्स के लिए + टिप्स शामिल हैं। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: hi +lastmod: 2026-08-22 +og_description: बारकोड जेनरेटर का उपयोग करके C# में PDF417 बारकोड बनाएं, लेआउट को + कस्टमाइज़ करें, और PNG को कैसे सहेजें सीखें। इस चरण‑दर‑चरण ट्यूटोरियल का पालन करें। +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: C# में PDF417 बारकोड बनाएं – PNG उत्पन्न करने और सहेजने के लिए पूर्ण गाइड +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: C# में PDF417 बारकोड कैसे बनाएं और इसे PNG के रूप में सहेजें +url: /hi/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# में PDF417 बारकोड कैसे बनाएं और PNG के रूप में सहेजें + +यदि आपको C# एप्लिकेशन में **PDF417 बारकोड बनाना** है, तो यह ट्यूटोरियल आपको सटीक चरण दिखाता है। आप देखेंगे कि कैसे एक बारकोड जेनरेटर C# लाइब्रेरी किसी भी स्ट्रिंग को स्कैन करने योग्य PDF417 इमेज में बदल सकती है और अतिरिक्त टूल्स के बिना PNG फ़ाइल कैसे सहेजते हैं। + +बारकोड जेनरेट करना लॉजिस्टिक्स, टिकटिंग और दस्तावेज़ प्रबंधन में आम है। इस गाइड के अंत तक आपके पास एक रन करने योग्य कंसोल प्रोग्राम होगा जो चुनी गई फ़ोल्डर में `Pdf417Layout.png` नाम की PNG फ़ाइल बनाता है। + +## आवश्यकताएँ + +शुरू करने से पहले सुनिश्चित करें कि आपके पास ये हैं: + +- .NET 6.0 SDK या बाद का संस्करण स्थापित हो (कोड .NET Framework 4.7+ के साथ भी काम करता है)। +- Visual Studio 2022 या कोई भी एडिटर जो C# प्रोजेक्ट बना सके। +- **Aspose.BarCode for .NET** NuGet पैकेज (या कोई भी संगत बारकोड जेनरेटर C# लाइब्रेरी)। + इसे इस तरह इंस्टॉल करें: + +```bash +dotnet add package Aspose.BarCode +``` + +कोई अतिरिक्त इमेज‑प्रोसेसिंग लाइब्रेरी आवश्यक नहीं है क्योंकि जेनरेटर सीधे PNG लिख सकता है। + +## चरण 1: नया कंसोल प्रोजेक्ट सेट अप करें + +एक नया कंसोल प्रोजेक्ट बनाएं ताकि उदाहरण स्वयं‑समाहित रहे। + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` फ़ोल्डर में अब एक `Program.cs` फ़ाइल है जहाँ हम बारकोड कोड लिखेंगे। + +## चरण 2: बारकोड नेमस्पेस इम्पोर्ट करें + +`Program.cs` खोलें और शीर्ष पर आवश्यक `using` निर्देश जोड़ें: + +```csharp +using Aspose.BarCode.Generation; +``` + +यह नेमस्पेस आपको `BarcodeGenerator`, `EncodeTypes` और इमेज‑फ़ॉर्मेट enum तक पहुंच देता है जो **PNG कैसे सहेजें** के लिए आवश्यक है। + +## चरण 3: PDF417 बारकोड जेनरेटर बनाएं + +**PDF417 कैसे जेनरेट करें** का मूल `BarcodeGenerator` क्लास है। एन्कोड टाइप `EncodeTypes.Pdf417` और वह टेक्स्ट पास करें जिसे आप एन्कोड करना चाहते हैं। + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` अब बारकोड की सभी सेटिंग्स रखता है। डिफ़ॉल्ट लेआउट काम करता है, लेकिन हम अगले चरण में इसे कस्टमाइज़ करेंगे। + +## चरण 4: बारकोड लेआउट (कॉलम और रो) निर्धारित करें + +PDF417 आपको कॉलम (2‑30) और रो (1‑90) की संख्या नियंत्रित करने देता है। इन मानों को समायोजित करने से विशिष्ट स्कैनरों के लिए पठनीयता बेहतर हो सकती है। + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **प्रो टिप:** यदि आप ये सेटिंग्स नहीं देते, तो लाइब्रेरी स्वचालित रूप से इष्टतम मान चुन लेती है। लेकिन कॉलम और रो को फिक्स करने से इमेज के आयाम पूर्वानुमेय होते हैं, जो PNG को PDF या UI लेआउट में एम्बेड करने पर उपयोगी होता है। + +## चरण 5: जेनरेटेड बारकोड को PNG इमेज के रूप में सहेजें + +अब **PNG कैसे सहेजें** का उत्तर `Save` मेथड को कॉल करके दें। यह मेथड लक्ष्य पाथ और इमेज फ़ॉर्मेट enum लेता है। + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +प्रोग्राम चलाने के बाद फ़ाइल `Pdf417Layout.png` प्रोजेक्ट की `bin/Debug/net6.0` फ़ोल्डर में दिखाई देगी। + +## पूर्ण रन करने योग्य उदाहरण + +नीचे पूरा `Program.cs` फ़ाइल है। इसे **चरण 1** में बनाए गए प्रोजेक्ट में कॉपी करें और `dotnet run` चलाएँ। + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### अपेक्षित आउटपुट + +जब आप प्रोग्राम चलाते हैं, कंसोल PNG फ़ाइल का पूर्ण पाथ प्रिंट करता है, और फ़ाइल में एक स्पष्ट PDF417 बारकोड होता है जो नीचे की इमेज जैसा दिखता है। + +![PDF417 बारकोड उदाहरण बनाएं](image-placeholder.png "PDF417 बारकोड PNG के रूप में सहेजा गया") + +आप PNG को किसी भी PDF417‑संगत स्कैनर (मोबाइल ऐप, हार्डवेयर रीडर) से स्कैन कर सकते हैं यह सत्यापित करने के लिए कि एन्कोड किया गया टेक्स्ट `"Sample"` है। + +## एज केस और सामान्य समस्याएँ संभालना + +| स्थिति | ध्यान रखने योग्य बात | सुझाया गया समाधान | +|-----------|-------------------|-----------------| +| **अमान्य कॉलम/रो मान** | 2‑30 (कॉलम) या 1‑90 (रो) सीमा से बाहर के मान `ArgumentException` उत्पन्न करते हैं। | उपयोगकर्ता इनपुट को वैलिडेट करें या लाइब्रेरी को डिफ़ॉल्ट चुनने दें। | +| **बड़ी इनपुट स्ट्रिंग्स** | PDF417 अधिकतम 1,850 कैरेक्टर एन्कोड कर सकता है, लेकिन बहुत लंबी स्ट्रिंग्स से रो की संख्या बहुत बढ़ जाती है। | डेटा को कई बारकोड में विभाजित करें या आवश्यक होने पर उच्च एरर‑करेक्शन लेवल उपयोग करें। | +| **फ़ाइल‑सिस्टम अनुमतियाँ** | रीड‑ओनली फ़ोल्डर में सहेजने से `UnauthorizedAccessException` आता है। | `Environment.CurrentDirectory` या उपयोगकर्ता‑लिखने योग्य पाथ में लिखें, और try/catch से एक्सेप्शन हैंडल करें। | +| **NuGet पैकेज गायब** | “type or namespace name could not be found” त्रुटि आती है। | सुनिश्चित करें कि `Aspose.BarCode` इंस्टॉल है (`dotnet add package Aspose.BarCode`)। | + +## उदाहरण का विस्तार + +अब जब आप **PDF417 बारकोड बनाना** और **PNG कैसे सहेजें** दोनों जानते हैं, तो आप इन संबंधित विषयों को एक्सप्लोर कर सकते हैं: + +- **Barcode generator C#**: `EncodeTypes` को `Code128`, `QR` या अन्य सिम्बोलॉजीज़ में बदलें। +- **कस्टम रंग**: `generator.Parameters.Barcode.ForegroundColor` और `BackgroundColor` का उपयोग करके ब्रांडिंग के अनुसार रंग सेट करें। +- **PDF में एम्बेड करना**: PNG को किसी PDF लाइब्रेरी (जैसे iText7) के साथ मिलाकर प्रिंटेबल डॉक्यूमेंट बनाएं। +- **डायनामिक डेटा**: डेटाबेस या उपयोगकर्ता इनपुट से टेक्स्ट लेकर रियल‑टाइम बारकोड जेनरेट करें। + +## निष्कर्ष + +आपके पास अब C# में **PDF417 बारकोड बनाना** और परिणाम को PNG फ़ाइल के रूप में सहेजने के लिए एक पूर्ण, प्रोडक्शन‑रेडी समाधान है। इस ट्यूटोरियल ने प्रोजेक्ट सेटअप से लेआउट कस्टमाइज़ेशन तक हर चरण को कवर किया, और बारकोड जेनरेटर C# लाइब्रेरी का उपयोग करते समय सामान्य त्रुटियों से बचने के टिप्स भी दिए। + +विभिन्न कॉलम/रो सेटिंग्स, रंग या अन्य बारकोड फॉर्मेट के साथ प्रयोग करने में संकोच न करें। यदि कोई समस्या आती है, तो **PDF417 कैसे जेनरेट करें** सेक्शन को फिर से देखें या लाइब्रेरी की डॉक्यूमेंटेशन में उन्नत फीचर्स खोजें। कोडिंग का आनंद लें! + +## आगे आप क्या सीखें? + +निम्नलिखित ट्यूटोरियल्स उन विषयों को कवर करते हैं जो इस गाइड में दिखाए गए तकनीकों पर आधारित हैं। प्रत्येक संसाधन में पूर्ण कार्यशील कोड उदाहरण और चरण‑दर‑चरण व्याख्याएँ हैं, जिससे आप अतिरिक्त API फीचर्स में महारत हासिल कर सकें और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन अप्रोचेज़ को एक्सप्लोर कर सकें। + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode Quiet Zone for ITF-14 Using Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/hindi/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..45205a2ec --- /dev/null +++ b/barcode/hindi/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Aspose.BarCode के साथ C# में PDF417 बारकोड बनाना सीखें, बारकोड का आकार + सेट करें, कॉलम समायोजित करें, और कॉम्पैक्ट मोड सक्षम करें। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: hi +lastmod: 2026-08-22 +og_description: C# में Aspose.BarCode के साथ PDF417 बारकोड जेनरेट करें। यह गाइड दिखाता + है कि बारकोड का आकार कैसे सेट करें, कॉलम को नियंत्रित करें, और छोटे इमेज के लिए + कॉम्पैक्ट मोड कैसे सक्षम करें। +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: C# में PDF417 बारकोड बनाएं – आकार, कॉलम और कॉम्पैक्ट मोड सेट करें +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: C# में PDF417 बारकोड कैसे बनाएं और बारकोड का आकार सेट करें +url: /hi/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# में PDF417 बारकोड कैसे जनरेट करें और बारकोड आकार सेट करें + +यदि आपको .NET एप्लिकेशन में **PDF417 बारकोड जनरेट** करने की आवश्यकता है, तो यह गाइड आपको पूरी प्रक्रिया के माध्यम से ले जाएगा। आप देखेंगे कि Aspose.BarCode के साथ **PDF417 कैसे जनरेट करें**, **बारकोड आकार सेट** कैसे समायोजित करें, और एक कॉम्पैक्ट PNG बनाएं जिसे रिपोर्ट या मोबाइल ऐप्स में एम्बेड किया जा सकता है। + +बारकोड बनाने के लिए अलग ग्राफ़िक्स एडिटर की आवश्यकता नहीं होती। इस ट्यूटोरियल के अंत तक आपके पास एक पूरी तरह कार्यशील C# मेथड होगा जो आवश्यक सटीक आयामों के साथ PDF417 इमेज बनाता है, जो आगे की प्रोसेसिंग के लिए तैयार है। + +## आप क्या सीखेंगे + +* Aspose.BarCode लाइब्रेरी को इंस्टॉल और रेफ़रेंस करें। +* एक PDF417 बारकोड जेनरेटर बनाएं और एन्कोडेड टेक्स्ट निर्दिष्ट करें। +* **बारकोड आकार सेट** X‑डायमेंशन और कॉलम काउंट को कॉन्फ़िगर करके। +* सिंबल को छोटा करने के लिए कॉम्पैक्ट (ट्रंकेटेड) मोड सक्षम करें। +* परिणाम को PNG फ़ाइल के रूप में सहेजें। +* असमर्थनीय कोड और अत्यधिक बड़े इमेज जैसी सामान्य समस्याओं का समाधान करें। + +### पूर्वापेक्षाएँ + +* .NET 6.0 या बाद का संस्करण (API .NET Framework 4.6+ के साथ भी काम करता है)। +* C# और Visual Studio (या कोई भी C# IDE) की बुनियादी परिचितता। +* एक वैध Aspose.BarCode लाइसेंस (नि:शुल्क इवैल्यूएशन परीक्षण के लिए काम करता है)। + +> **प्रो टिप:** यदि आप लूप में कई बारकोड जनरेट करने की योजना बना रहे हैं, तो एक ही `BarcodeGenerator` इंस्टेंस को पुन: उपयोग करें और केवल `CodeText` प्रॉपर्टी बदलें। इससे मेमोरी अलोकेशन कम होते हैं। + +## Aspose.BarCode के साथ PDF417 बारकोड जनरेट करें + +पहला कदम PDF417 सिम्बोलॉजी के लिए `BarcodeGenerator` को इंस्टैंशिएट करना है। यह ऑब्जेक्ट सभी बारकोड ऑपरेशन्स का एंट्री पॉइंट है। + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*यह क्यों महत्वपूर्ण है*: `EncodeTypes.Pdf417` लाइब्रेरी को PDF417 मानक उपयोग करने के लिए बताता है, जो बड़े डेटा वॉल्यूम और एरर करेक्शन को सपोर्ट करता है। कंस्ट्रक्टर भी वह डेटा लेता है जिसे आप एन्कोड करना चाहते हैं, जिससे बाद में अलग `CodeText` असाइनमेंट की आवश्यकता नहीं रहती। + +## बारकोड आकार और कॉलम काउंट सेट करें + +PDF417 सिम्बॉल छोटे आयताकार मॉड्यूल्स की पंक्तियों और कॉलम्स से बनते हैं। मॉड्यूल की चौड़ाई (X‑डायमेंशन) और कॉलम की संख्या को नियंत्रित करके आप समग्र आयामों को बारीकी से ट्यून कर सकते हैं। + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*व्याख्या*: +* **X‑डायमेंशन** (`Pixels`) निर्धारित करता है कि प्रत्येक मॉड्यूल कितनी चौड़ी है। छोटे मान एक टाइट बारकोड बनाते हैं, जबकि बड़े मान कम‑रिज़ॉल्यूशन स्कैनर्स पर पढ़ने की क्षमता बढ़ाते हैं। +* **Columns** क्षैतिज लेआउट को नियंत्रित करते हैं। कम कॉलम बारकोड को लंबा बनाते हैं; अधिक कॉलम इसे चौड़ा बनाते हैं। इन दो सेटिंग्स को साथ में समायोजित करें ताकि आपको आवश्यक सटीक **बारकोड आकार सेट** मिल सके। + +## छोटे बारकोड के लिए कॉम्पैक्ट मोड सक्षम करें + +PDF417 में एक “कॉम्पैक्ट” (या ट्रंकेटेड) मोड शामिल है जो अनावश्यक पैडिंग को हटाता है और कुल फ़ुटप्रिंट को कम करता है। यह विशेष रूप से तब उपयोगी है जब स्क्रीन स्पेस सीमित हो। + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*ट्रंकेशन क्यों सक्षम करें?* +जब `Truncate` `true` होता है, तो जेनरेटर स्टॉप पैटर्न और कुछ एरर‑करेक्शन कोडवर्ड्स को छोड़ देता है जो अधिकांश स्कैनिंग परिदृश्यों के लिए आवश्यक नहीं होते। परिणामी इमेज लगभग 15‑20 % छोटी होती है, बिना सामान्य उपयोग मामलों के लिए डेटा इंटेग्रिटी को नुकसान पहुँचाए। + +## बारकोड को PNG इमेज के रूप में सहेजें + +आकार और मोड कॉन्फ़िगर करने के बाद, बारकोड को डिस्क पर लिखें। PNG लॉसलेस है, जिससे मॉड्यूल किनारे तेज़ रहते हैं। + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +`CompactPdf417.png` फ़ाइल में एक स्पष्ट PDF417 सिम्बॉल होगा जो पिछले चरणों में सेट किए गए आयामों से मेल खाता है। + +### अपेक्षित आउटपुट + +सेव किए गए PNG को खोलने पर एक वर्टिकल‑ओरिएंटेड PDF417 बारकोड दिखना चाहिए, जिसमें तीन कॉलम हों, प्रत्येक मॉड्यूल 2 px चौड़ा हो, और कुल आकार लगभग **120 × 240 px** (चौड़ाई × ऊँचाई) हो। किसी भी मानक PDF417 रीडर से इमेज स्कैन करने पर मूल टेक्स्ट “Sample text for PDF417” प्राप्त होगा। + +## सामान्य समस्याएँ और उन्हें कैसे टालें + +| लक्षण | संभावित कारण | समाधान | +|---------|--------------|-----| +| बारकोड पढ़ा नहीं जा रहा | स्कैनर के लिए X‑डायमेंशन बहुत छोटा | `XDimension.Pixels` को 3 या 4 बढ़ाएँ | +| इमेज UI के लिए बहुत चौड़ी है | बहुत अधिक कॉलम सेट किए गए | `Pdf417.Columns` को कम करें या `Truncate` सक्षम करें | +| Exception `ArgumentOutOfRangeException` | नकारात्मक या शून्य कॉलम काउंट | `Columns` एक सकारात्मक पूर्णांक (न्यूनतम 1) हो, यह सुनिश्चित करें | +| PNG फ़ाइल खाली है | आउटपुट पाथ मौजूद नहीं है या लिखने की अनुमति नहीं है | डायरेक्टरी मौजूद है और एप्लिकेशन के पास लिखने की अनुमति है, यह जांचें | + +> **प्रो टिप:** `Save()` कॉल करने से पहले `barcodeGenerator.ValidateParameters()` का उपयोग करें ताकि कॉन्फ़िगरेशन त्रुटियों को जल्दी पकड़ सकें। + +## पूर्ण, चलाने योग्य उदाहरण + +नीचे एक स्व-निहित कंसोल प्रोग्राम है जो ऊपर बताए गए सभी चरणों को सम्मिलित करता है। इसे एक नए C# प्रोजेक्ट में कॉपी करें, Aspose.BarCode NuGet पैकेज को रिस्टोर करें, और परिणाम देखने के लिए चलाएँ। + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**प्रोग्राम चलाने** से `CompactPdf417.png` निष्पादन योग्य की कार्य निर्देशिका में बनता है। इमेज को मोबाइल ऐप (जैसे, “Barcode Scanner”) से स्कैन करें ताकि एन्कोडेड टेक्स्ट स्रोत स्ट्रिंग से मेल खाता हो, यह सत्यापित हो सके। + +## अगले कदम और संबंधित विषय + +* **Error correction level बढ़ाएँ** – शोरयुक्त स्कैन वाले वातावरण के लिए `Pdf417.ErrorLevel` को समायोजित करें। +* **Orientation बदलें** – यदि आपको क्षैतिज लेआउट चाहिए तो `Pdf417.Rotate` को `RotationAngle.Rotate90` सेट करें। +* **बारकोड को PDF में एम्बेड करें** – Aspose.PDF को Aspose.BarCode के साथ मिलाकर इमेज को सीधे दस्तावेज़ में रखें। +* **अन्य 2‑D बारकोड जनरेट करें** – वही `BarcodeGenerator` क्लास DataMatrix, QR, और Aztec कोड्स को सपोर्ट करता है; केवल `EncodeTypes.Pdf417` को इच्छित सिम्बोलॉजी से बदलें। + +**PDF417 बारकोड जनरेट** तकनीकों में निपुण होकर, आप टिकटिंग, इन्वेंटरी लेबलिंग, और सुरक्षित डेटा ट्रांसमिशन को विभिन्न .NET एप्लिकेशन्स में स्वचालित कर सकते हैं। + +## निष्कर्ष + +अब आप जानते हैं कि C# में **PDF417 बारकोड जनरेट** कैसे करें, सटीक **बारकोड आकार सेट** करें, कॉलम कॉन्फ़िगर करें, कॉम्पैक्ट मोड सक्षम करें, और परिणाम को PNG के रूप में सहेजें। इन सेटिंग्स को किसी भी UI प्रतिबंध या स्कैनिंग आवश्यकता के अनुसार लागू करें, और आवश्यकता अनुसार अन्य बारकोड फ़ॉर्मैट्स में इस दृष्टिकोण को विस्तारित करें। कोडिंग का आनंद लें! + +## अगला आप क्या सीखें? + +निम्नलिखित ट्यूटोरियल्स उन निकट संबंधित विषयों को कवर करते हैं जो इस गाइड में प्रदर्शित तकनीकों पर आधारित हैं। प्रत्येक संसाधन में पूर्ण कार्यशील कोड उदाहरण और चरण‑दर‑चरण व्याख्याएँ शामिल हैं, जो आपको अतिरिक्त API फीचर्स में निपुण होने और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन एप्रोच को खोजने में मदद करेंगे। + +- [PDF417 बारकोड कैसे जनरेट करें – कॉम्पैक्ट PDF417 एन्कोडिंग](/barcode/english/net/compact-pdf417-encoding/) +- [बारकोड कैसे बनाएं – Aspose.BarCode के साथ कॉम्पैक्ट PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Aspose.BarCode for .NET का उपयोग करके DataMatrix बारकोड कैसे जनरेट करें – चरण‑दर‑चरण गाइड](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/hindi/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..c862bcfe9 --- /dev/null +++ b/barcode/hindi/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: C# में PDF417 बारकोड पढ़ने के लिए चरण‑दर‑चरण गाइड, जिसमें एक छवि से कई + बारकोड पढ़ना और MacroPdf417 विवरण निकालना शामिल है। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: hi +lastmod: 2026-08-22 +og_description: C# में PDF417 बारकोड को तेज़ी से कैसे पढ़ें। यह ट्यूटोरियल आपको दिखाता + है कि कैसे एक छवि से कई बारकोड पढ़ें और MacroPdf417 विस्तारित जानकारी प्राप्त करें। +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: C# में PDF417 बारकोड कैसे पढ़ें – पूर्ण प्रोग्रामिंग मार्गदर्शिका +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: C# में PDF417 बारकोड कैसे पढ़ें – पूर्ण गाइड +url: /hi/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# में PDF417 बारकोड कैसे पढ़ें – पूर्ण गाइड + +यदि आपको .NET एप्लिकेशन में **PDF417 कैसे पढ़ें** बारकोड पढ़ने की आवश्यकता है, तो यह ट्यूटोरियल आपको एक तैयार‑से‑चलाने वाला समाधान देता है। आप सीखेंगे कि एक ही छवि से कई बारकोड कैसे पढ़ें, पूर्ण MacroPdf417 डेटा सेट निकालें, और इसे कंसोल में प्रदर्शित करें। यह तरीका Aspose.BarCode for .NET लाइब्रेरी के साथ काम करता है और केवल कुछ पंक्तियों के कोड की आवश्यकता होती है। + +छवि से बारकोड पढ़ना इन्वेंटरी सिस्टम, टिकट वैलिडेशन और दस्तावेज़ प्रबंधन में एक सामान्य कार्य है। इस गाइड के अंत तक आप किसी भी PDF417 या MacroPdf417 बारकोड को डिकोड कर सकेंगे, एक तस्वीर में कई कोड संभाल सकेंगे, और MacroPdf417 द्वारा प्रदान किए गए विस्तारित फ़ील्ड को समझ सकेंगे। + +## आवश्यकताएँ + +- .NET 6.0 SDK या बाद का संस्करण (कोड .NET Framework 4.7+ के साथ भी संकलित होता है) +- Visual Studio 2022 या आपका पसंदीदा C# एडिटर +- Aspose.BarCode for .NET NuGet पैकेज (`Install-Package Aspose.BarCode`) +- एक नमूना छवि जिसमें MacroPdf417 बारकोड हो (उदाहरण के लिए `MacroPdf417.png`) + +कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं है; लाइब्रेरी आंतरिक रूप से छवि लोडिंग और डिकोडिंग को संभालती है। + +## C# में छवि से PDF417 बारकोड कैसे पढ़ें + +समाधान का मूल `BarCodeReader` क्लास है। यह छवि को खोलता है, निर्दिष्ट प्रकार के सभी बारकोड का पता लगाता है, और `BarCodeResult` ऑब्जेक्ट्स का संग्रह लौटाता है। नीचे पूर्ण कंसोल प्रोग्राम दिखाया गया है। + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### प्रत्येक पंक्ति का महत्व क्यों है + +| कदम | उद्देश्य | +|------|----------| +| **1️⃣ Initialize** | एक `BarCodeReader` बनाता है जो छवि फ़ाइल से बंधा होता है और पहचान को केवल MacroPdf417 सिम्बोलॉजी तक सीमित करता है, जिससे प्रोसेसिंग तेज़ होती है। | +| **2️⃣ Iterate** | `ReadBarCodes()` **सभी** बारकोड लौटाता है जो अनुरोधित प्रकार से मेल खाते हैं, जिससे आप अतिरिक्त लूप्स के बिना **कई बारकोड पढ़** सकते हैं। | +| **3️⃣ Basic output** | सामान्य `CodeTypeName` और मानव‑पठनीय `CodeText` दिखाता है। यह लॉगिंग या त्वरित वैधता के लिए उपयोगी है। | +| **4️⃣ Extended data** | MacroPdf417 अतिरिक्त मेटाडेटा (फ़ाइल ID, सेगमेंट काउंट, टाइमस्टैम्प आदि) ले जाता है। `Extended.Pdf417` ऑब्जेक्ट प्रत्येक फ़ील्ड को सीधे उजागर करता है, ताकि आप पूरे डेटा पैकेट को संग्रहीत या सत्यापित कर सकें। | + +एक वैध MacroPdf417 छवि के विरुद्ध प्रोग्राम चलाने पर कंसोल आउटपुट नीचे दिखाए गए समान होता है: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +आउटपुट यह पुष्टि करता है कि लाइब्रेरी ने सफलतापूर्वक बारकोड पढ़ा, टेक्स्ट निकाला, और प्रत्येक MacroPdf417 फ़ील्ड प्रदान किया। + +## एक ही छवि से कई बारकोड पढ़ना + +वास्तविक दुनिया में कई PDF417 प्रतीक एक लेबल पर रखे जा सकते हैं—जैसे शिपिंग मैनिफेस्ट जिसमें कैरियर कोड, ट्रैकिंग नंबर, और कस्टम्स डिक्लेरेशन होते हैं। ऊपर दिया गया कोड ब्लॉक पहले से ही **कई बारकोड पढ़ता** है क्योंकि `ReadBarCodes()` सभी मेलों का एक enumerable लौटाता है। कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं है; आपको केवल परिणामों के माध्यम से लूप करना है, जैसा कि दर्शाया गया है। + +यदि आप मानक PDF417 (नॉन‑मैक्रो) तक रीडर को सीमित करना चाहते हैं जबकि फिर भी कई कोड संभालना चाहते हैं, तो `DecodeType.MacroPdf417` को `DecodeType.Pdf417` से बदल दें। बाकी लॉजिक अपरिवर्तित रहता है। + +## MacroPdf417 विस्तारित डेटा को समझना + +MacroPdf417 नियमित PDF417 विनिर्देशन का एक विस्तार है। यह बड़े पेलोड को कई सेगमेंट में विभाजित करता है और एक छोटा हेडर जोड़ता है जो पूरी फ़ाइल का वर्णन करता है। सबसे प्रासंगिक फ़ील्ड हैं: + +- **MacroPdf417FileID** – उसी फ़ाइल के सभी सेगमेंट द्वारा साझा किया गया एक अद्वितीय पहचानकर्ता। +- **MacroPdf417SegmentID** – वर्तमान सेगमेंट का क्रमांक। +- **MacroPdf417SegmentsCount** – अपेक्षित कुल सेगमेंट की संख्या। +- **MacroPdf417FileName** – बारकोड के साथ प्रसारित वैकल्पिक फ़ाइल नाम। +- **MacroPdf417Checksum** – पूरी फ़ाइल के लिए त्रुटि‑जाँच मान। +- **MacroPdf417FileSize** – मूल बाइनरी पेलोड का आकार। +- **MacroPdf417TimeStamp** – ISO‑8601 टाइमस्टैम्प जब बारकोड उत्पन्न किया गया था। +- **MacroPdf417Addressee / Sender** – रूटिंग के लिए वैकल्पिक टेक्स्ट फ़ील्ड। +- **MacroPdf417Terminator** – दर्शाता है कि यह सेगमेंट अंतिम है या नहीं। + +जब आप सभी सेगमेंट प्राप्त कर लेते हैं, तो आप उन्हें `MacroPdf417SegmentID` के अनुसार क्रमबद्ध करके और `CodeText` मानों को जोड़कर मूल फ़ाइल को पुनः निर्मित कर सकते हैं। यह लॉजिक फ़ील्ड उपलब्ध होने पर सरलता से लागू किया जा सकता है। + +## सामान्य समस्याएँ और प्रो टिप्स + +- **छवि की गुणवत्ता महत्वपूर्ण है** – कम‑रिज़ॉल्यूशन या अत्यधिक संकुचित PNG/JPEG फ़ाइलें डिटेक्शन में चूक का कारण बन सकती हैं। प्रिंटेड बारकोड के लिए कम से कम 300 dpi उपयोग करें। +- **मिश्रित सिम्बोलॉजी** – यदि छवि में MacroPdf417 और सामान्य PDF417 दोनों हों, तो दो रीडर इंस्टैंसिएट करें (प्रत्येक `DecodeType` के लिए एक) या `DecodeType.AllSupported` उपयोग करें और परिणामों को `result.CodeTypeName` द्वारा फ़िल्टर करें। +- **मेमोरी उपयोग** – `using` स्टेटमेंट `BarCodeReader` को तुरंत डिस्पोज़ करता है, जिससे बड़े छवि बफ़र मेमोरी में नहीं रहते। +- **थ्रेड सुरक्षा** – `BarCodeReader` थ्रेड‑सेफ़ नहीं है। यदि आप छवियों को समानांतर में डिकोड कर रहे हैं तो प्रत्येक थ्रेड के लिए एक अलग इंस्टेंस बनाएं। +- **त्रुटि संभालना** – `ReadBarCodes()` कॉल को try/catch ब्लॉक में रखें ताकि भ्रष्ट छवियों के लिए `BarCodeException` को पकड़ सकें। + +## पूर्ण कार्यशील उदाहरण सारांश + +नीचे पूरा प्रोग्राम दिया गया है जिसे आप नई कंसोल प्रोजेक्ट में कॉपी कर सकते हैं। इसमें सभी `using` निर्देश, छवि पथ के लिए एक कॉन्स्टेंट, और डिस्पोज़ल पैटर्न शामिल है। + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +`dotnet build` के साथ संकलित करें और `dotnet run` के साथ चलाएँ। कंसोल प्रत्येक बारकोड का बुनियादी डेटा और पूर्ण MacroPdf417 पेलोड प्रिंट करता है। + +## अगले कदम + +- **बहु‑भाग फ़ाइलें पुनः बनाएं** – सभी सेगमेंट एकत्र करें, `MacroPdf417SegmentID` के अनुसार क्रमबद्ध करें, और `CodeText` को जोड़ें + +## आप आगे क्या सीखें? + +निम्नलिखित ट्यूटोरियल्स उन विषयों को कवर करते हैं जो इस गाइड में प्रदर्शित तकनीकों पर आधारित हैं। प्रत्येक संसाधन में पूर्ण कार्यशील कोड उदाहरण और चरण‑दर‑चरण व्याख्याएँ शामिल हैं, जिससे आप अतिरिक्त API सुविधाओं में महारत हासिल कर सकें और अपने प्रोजेक्ट्स में वैकल्पिक कार्यान्वयन दृष्टिकोणों का अन्वेषण कर सकें। + +- [PDF417 बारकोड कैसे जनरेट करें – कॉम्पैक्ट PDF417 एन्कोडिंग](/barcode/english/net/compact-pdf417-encoding/) +- [Java में तुर्की अक्षरों के साथ PDF417 बारकोड कैसे पढ़ें](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Java में PDF417 बारकोड (चीनी) के लिए Aspose का उपयोग कैसे करें](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/hindi/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..f14db6579 --- /dev/null +++ b/barcode/hindi/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: बारकोड जेनरेटर C# ट्यूटोरियल दिखाता है कि कैसे मेटाडेटा के साथ मैक्रो + PDF417 बारकोड बनाएं और इसे Aspose.BarCode का उपयोग करके PNG के रूप में सहेजें। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: hi +lastmod: 2026-08-22 +og_description: बारकोड जेनरेटर C# आपको पूर्ण फ़ाइल‑स्तर मेटाडेटा के साथ एक मैक्रो + PDF417 बारकोड बनाने और इसे PNG के रूप में निर्यात करने की सुविधा देता है। समाधान + को लागू करने के लिए इस गाइड का पालन करें। +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: बारकोड जेनरेटर C# – मैक्रो PDF417 बारकोड चरण-दर-चरण बनाएं +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Macro PDF417 के लिए C# में बारकोड जेनरेटर का उपयोग कैसे करें +url: /hi/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Macro PDF417 के लिए C# बारकोड जेनरेटर का उपयोग कैसे करें + +यदि आपको एक **barcode generator C#** चाहिए जो फ़ाइल‑स्तर मेटाडेटा के साथ Macro PDF417 प्रतीक उत्पन्न कर सके, तो यह गाइड एक पूर्ण, तैयार‑चलाने योग्य समाधान प्रदान करता है। आप देखेंगे कि बारकोड की उपस्थिति कैसे कॉन्फ़िगर करें, फ़ाइल ID और सेगमेंट काउंट जैसी मैक्रो जानकारी एम्बेड करें, और अंत में परिणाम को PNG छवि के रूप में सहेजें। + +यह उदाहरण Aspose.BarCode लाइब्रेरी का उपयोग करता है, जो एक व्यापक रूप से अपनाई गई **C# barcode library** है और पूर्ण PDF417 फीचर सेट का समर्थन करती है। कोई बाहरी सेवा आवश्यक नहीं है, और कोड .NET 6 या बाद के संस्करणों के साथ काम करता है। + +## आवश्यकताएँ + +* .NET 6 SDK (या कोई भी बाद का संस्करण) स्थापित हो। +* Visual Studio 2022, VS Code, या कोई अन्य C# IDE। +* **Aspose.BarCode** का एक NuGet रेफ़रेंस (`dotnet add package Aspose.BarCode`)। + +बुनियादी C# सिंटैक्स और PDF417 बारकोड की अवधारणा को समझना आपको चरणों का पालन करने में मदद करेगा, लेकिन ट्यूटोरियल प्रत्येक कॉन्फ़िगरेशन विकल्प को विस्तार से समझाता है। + +## इस ट्यूटोरियल में क्या कवर किया गया है + +* Macro PDF417 फ़ॉर्मेट के लिए **barcode generator C#** इंस्टेंस को इनिशियलाइज़ करना। +* X‑dimension और कॉलम काउंट जैसे विज़ुअल पैरामीटर को समायोजित करना। +* Macro PDF417 फ़ाइल‑स्तर फ़ील्ड्स प्रदान करना: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender, और terminator। +* उत्पन्न प्रतीक को PNG फ़ाइल के रूप में सहेजना। +* बड़े फ़ाइल आकार या कस्टम टाइमस्टैम्प जैसे एज केस को संभालने के टिप्स। + +इस लेख के अंत तक आपके पास एक स्व-निहित प्रोग्राम होगा जो पूरी तरह से मानक अनुरूप Macro PDF417 बारकोड उत्पन्न करता है। + +## चरण 1: बारकोड जेनरेटर C# इंस्टेंस बनाएं + +पहला ऑपरेशन `BarcodeGenerator` को `EncodeTypes.MacroPdf417` एन्‍म वैल्यू और आप जो टेक्स्ट एन्कोड करना चाहते हैं, उसके साथ इंस्टैंशिएट करना है। कंस्ट्रक्टर पेलोड स्ट्रिंग भी स्वीकार करता है, जो मैक्रो बारकोड के डेटा भाग बन जाता है। + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**यह क्यों महत्वपूर्ण है** – `EncodeTypes.MacroPdf417` फ़्लैग Aspose.BarCode को संकेत देता है कि प्रतीक को एक मैक्रो बारकोड के रूप में माना जाए, जिससे आगे के अतिरिक्त फ़ील्ड सक्षम होते हैं। इस फ़्लैग के बिना लाइब्रेरी एक सामान्य PDF417 बारकोड उत्पन्न करेगी जिसमें फ़ाइल‑स्तर मेटाडेटा नहीं होगा। + +## चरण 2: बुनियादी बारकोड उपस्थिति समायोजित करें (PDF417 विज़ुअल सेटिंग्स) + +विश्वसनीय स्कैनिंग के लिए विज़ुअल स्पष्टता अत्यंत महत्वपूर्ण है। दो सामान्य पैरामीटर मॉड्यूल चौड़ाई (`XDimension`) और कॉलम की संख्या हैं। इन मानों को सेट करने से आकार और पठनीयता का संतुलन बनता है। + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` प्रत्येक काली/सफ़ेद बार की चौड़ाई नियंत्रित करता है। **2** का मान अधिकांश लेबल प्रिंटरों के लिए उपयुक्त है। +* `Pdf417.Columns` निर्धारित करता है कि बारकोड कितने कॉलम उपयोग करेगा। पाँच कॉलम डेटा क्षमता को कम किए बिना एक कॉम्पैक्ट प्रतीक उत्पन्न करते हैं। + +## चरण 3: Macro PDF417 फ़ाइल‑स्तर जानकारी निर्धारित करें + +Macro PDF417 मानक PDF417 फ़ॉर्मेट को उन फ़ील्ड्स के साथ विस्तारित करता है जो यह वर्णन करते हैं कि एक बड़ी फ़ाइल कई बारकोड सेगमेंट्स में कैसे विभाजित की गई है। इन फ़ील्ड्स को प्रदान करने से डाउनस्ट्रीम स्कैनर मूल फ़ाइल को पुनः निर्मित कर सकते हैं। + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` समान लॉजिकल फ़ाइल के प्रत्येक सेगमेंट के लिए समान होना चाहिए। +* `MacroPdf417SegmentID` **0** से `SegmentsCount‑1` तक बढ़ता है। +* `MacroPdf417SegmentsCount` डिकोडर को बताता है कि कितने टुकड़े अपेक्षित हैं। +* `MacroPdf417FileName` वैकल्पिक है लेकिन मानव‑पठनीय पहचान के लिए उपयोगी है। + +## चरण 4: अतिरिक्त मैक्रो मेटाडेटा सेट करें + +कोर फ़ाइल जानकारी के अलावा, विनिर्देशन अतिरिक्त फ़ील्ड्स जैसे checksum, file size, timestamp, addressee, sender, और एक terminator फ़्लैग की अनुमति देता है। इन फ़ील्ड्स को भरने से डेटा इंटेग्रिटी और ट्रैसेबिलिटी में सुधार होता है। + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` पूरी फ़ाइल के लिए 16‑bit CCITT checksum प्रदान करता है; पुनर्निर्माण के बाद डिकोडर इंटेग्रिटी को सत्यापित कर सकता है। +* `MacroPdf417FileSize` मूल फ़ाइल के सटीक बाइट काउंट को दर्शाना चाहिए; `2^31‑1` से बड़े मानों के लिए 64‑bit फ़ील्ड आवश्यक है, जिसे Aspose स्वचालित रूप से संभालता है। +* `MacroPdf417TimeStamp` रिकॉर्ड करता है कि बारकोड कब जेनरेट किया गया था। टाइमज़ोन अस्पष्टता से बचने के लिए UTC उपयोग करें। +* `MacroPdf417Addressee` और `MacroPdf417Sender` फ्री‑फ़ॉर्म स्ट्रिंग्स हैं जो रूटिंग जानकारी संग्रहीत कर सकती हैं। +* `MacroPdf417Terminator` संकेत देता है कि यह अंतिम सेगमेंट है; अंतिम टुकड़े के लिए इसे `Set` पर सेट करें, अन्यथा डिफ़ॉल्ट (`NotSet`) ही रहने दें। + +**एज‑केस टिप** – यदि आपका फ़ाइल आकार 4 GB से अधिक है, तो सामग्री को कई मैक्रो सेगमेंट्स में विभाजित करें और `SegmentsCount` को तदनुसार समायोजित करें। लाइब्रेरी ओवरफ़्लो के बिना बड़े‑आकार फ़ील्ड को संभालेगी। + +## चरण 5: बारकोड को PNG छवि के रूप में सहेजें + +अंतिम चरण उत्पन्न प्रतीक को डिस्क पर लिखता है। PNG सटीक पिक्सेल आयाम को बनाए रखता है और स्कैनिंग हार्डवेयर द्वारा व्यापक रूप से समर्थित है। + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +`YOUR_DIRECTORY` को एक पूर्ण या सापेक्ष पाथ से बदलें जहाँ निष्पादित प्रक्रिया लिख सकती है। `BarCodeImageFormat.Png` एन्‍म लॉसलेस आउटपुट सुनिश्चित करता है। + +**PNG क्यों?** – Raster फ़ॉर्मेट जैसे PNG मॉड्यूल किनारों को तेज़ रखता है, जो उच्च‑कॉन्ट्रास्ट किनारों पर निर्भर स्कैनरों के लिए आवश्यक है। यदि आपको वेक्टर फ़ॉर्मेट चाहिए, तो Aspose `Pdf` और `Svg` का भी समर्थन करता है। + +## पूर्ण चलाने योग्य उदाहरण + +नीचे पूरा प्रोग्राम दिया गया है जिसे आप एक कंसोल एप्लिकेशन में कॉपी कर सकते हैं। इसमें आवश्यक `using` निर्देश और एक `Main` मेथड शामिल है। + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### अपेक्षित आउटपुट + +प्रोग्राम चलाने से प्रोजेक्ट की कार्यशील डायरेक्टरी में **MacroPdf417.png** नाम की फ़ाइल बनती है। छवि खोलने पर एम्बेडेड मैक्रो फ़ील्ड्स के साथ एक कॉम्पैक्ट PDF417 बारकोड दिखता है। छवि को PDF417‑संगत रीडर (जैसे ZXing, Aspose.BarCode डिकोडर) से स्कैन करने पर मूल `"Sample text"` पेलोड के साथ मैक्रो मेटाडेटा भी प्राप्त होता है। + +## सामान्य प्रश्न और समस्या निवारण + +| प्रश्न | उत्तर | +|----------|--------| +| *यदि बारकोड लक्ष्य लेबल के लिए बहुत बड़ा हो तो क्या करें?* | `XDimension.Pixels` को कम करें या `Pdf417.Columns` को बढ़ाएँ। दोनों पैरामीटर कुल आकार को प्रभावित करते हैं। | +| *क्या मैं PNG के बजाय वेक्टर इमेज जेनरेट कर सकता हूँ?* | हां। स्केलेबल आउटपुट के लिए `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` कॉल करें। | +| *स्कैन करने के बाद मैं checksum कैसे सत्यापित करूँ?* | Aspose.BarCode डिकोडर स्वचालित रूप से `MacroPdf417Checksum` को वैध करता है और `MacroPdf417Result` ऑब्जेक्ट में असंगतियों की रिपोर्ट करता है। | +| *क्या लाइब्रेरी .NET Core के साथ संगत है?* | NuGet पैकेज .NET Standard 2.0+ का समर्थन करता है, जो .NET Core, .NET 5, .NET 6 और बाद के संस्करणों को कवर करता है। | +| *यदि मुझे टेक्स्ट के बजाय बाइनरी डेटा एम्बेड करना हो तो क्या करें?* | बाइनरी पेलोड को Base64 में बदलें या `EncodeTypes.MacroPdf417` ओवरलोड का उपयोग करें जो बाइट एरे को स्वीकार करता है। | + +## प्रोडक्शन उपयोग के लिए प्रो टिप्स + +* **Cache the generator** – + + +## अब आप क्या सीखें? + +निम्नलिखित ट्यूटोरियल्स उन संबंधित विषयों को कवर करते हैं जो इस गाइड में प्रदर्शित तकनीकों पर आधारित हैं। प्रत्येक संसाधन में पूर्ण कार्यशील कोड उदाहरण और चरण-दर-चरण व्याख्याएँ शामिल हैं, जो आपको अतिरिक्त API फीचर्स में महारत हासिल करने और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन अप्रोचेज़ को खोजने में मदद करती हैं। + +- [बारकोड कैसे बनाएं – Aspose.BarCode के साथ कॉम्पैक्ट PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Java में Aspose.BarCode का उपयोग करके PDF से बारकोड कैसे पढ़ें](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Aspose.Barcode के साथ Codabar बारकोड बनाएं – जेनरेटर और रीडर API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/net/compact-pdf417-encoding/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/_index.md index af77b7a71..cb1d26c73 100644 --- a/barcode/hongkong/net/compact-pdf417-encoding/_index.md +++ b/barcode/hongkong/net/compact-pdf417-encoding/_index.md @@ -143,6 +143,9 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); ### [建立緊湊型 PDF417 條碼](./compact-pdf417-basic-configuration/) 了解如何使用 Aspose.BarCode for .NET 產生緊湊型 PDF417 條碼。完整指南，提供逐步說明與程式碼範例。 +### [如何在 C# 中產生 PDF417 條碼並設定條碼大小](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +說明在 C# 使用 Aspose.BarCode 產生 PDF417 條碼並調整條碼尺寸的步驟與範例。 + ## 常見問與答 **Q: 緊湊型 PDF417 條碼最多能儲存多少資料？** @@ -171,6 +174,10 @@ A: 不需要額外字型；函式庫會在內部處理所有渲染。 - [如何建立條碼 – 使用 Aspose.BarCode 的緊湊型 PDF417](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [Aspose.BarCode for .NET 的完整教學與範例](/barcode/net/) - [如何在 .NET 中建立具錯誤更正的 Aztec 條碼](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) +- [如何在 C# 中建立微型 PDF417 條碼 – 步驟說明指南](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +- [如何在 C# 中建立 PDF417 條碼並儲存為 PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +- [如何在 C# 中使用條碼產生器產生宏 PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [如何在 C# 中讀取 PDF417 條碼 – 完整指南](./how-to-read-pdf417-barcodes-in-c-complete-guide/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..218f1b717 --- /dev/null +++ b/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,211 @@ +--- +category: general +date: 2026-08-22 +description: 學習如何在 C# 中建立微型 PDF417 條碼並產生條碼 PNG 圖像。包括設定條碼尺寸及儲存檔案。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: zh-hant +lastmod: 2026-08-22 +og_description: 在 C# 中建立微型 PDF417 條碼並匯出為 PNG。請遵循本指南設定條碼尺寸，快速產生條碼圖像。 +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: 在 C# 中建立微型 PDF417 條碼 – 完整程式碼教學 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: 如何在 C# 中建立微型 PDF417 條碼 – 逐步指南 +url: /zh-hant/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中建立微型 PDF417 條碼 – 步驟指南 + +如果您需要為票務系統、庫存標籤或手機掃描 **建立微型 PDF417 條碼**，本教學將完整說明。您將看到產生條碼 PNG 的完整 C# 程式碼，學習如何設定條碼尺寸，並了解每個設定選項。 + +完成本指南後，您將能夠產生高解析度的條碼影像、客製化 X‑dimension、選擇欄位數，並將結果儲存為 PNG 檔案——只需幾行程式碼。 + +## 您需要的環境 + +- .NET 6.0 SDK 或更新版本（此程式碼可於 .NET Core 與 .NET Framework 使用） +- Visual Studio 2022 或任何相容 C# 的 IDE +- **Aspose.BarCode for .NET** NuGet 套件（或任何支援 `EncodeTypes.MicroPdf417` 的函式庫） +- 基本的 C# 語法熟悉度 + +> **專業提示：** Aspose.BarCode 的免費社群版已足夠開發與測試使用。正式上線時，請取得授權以移除評估水印。 + +## 步驟 1：安裝條碼函式庫 + +在專案資料夾中開啟終端機並執行以下指令： + +```bash +dotnet add package Aspose.BarCode +``` + +此指令會加入 `Aspose.BarCode` 程式集，提供用於 **建立條碼影像 C#** 應用程式的 `BarcodeGenerator` 類別。 + +## 步驟 2：初始化產生器 – 建立微型 PDF417 條碼 + +第一行可執行的程式碼會建立一個 `BarcodeGenerator` 實例，設定為 Micro PDF417 符號，並提供您欲編碼的資料。 + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*為什麼這很重要*：`EncodeTypes.MicroPdf417` 列舉告訴函式庫使用 PDF417 的緊縮版，適合小型標籤與手機螢幕。 + +## 步驟 3：在 C# 中設定條碼尺寸 + +微調模組寬度（X‑dimension）可控制條碼的視覺密度。較小的數值會產生較銳利的影像，而較大的數值則使條碼在遠距離時更易於掃描。 + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +**為什麼要設定尺寸**：若未調整 X‑dimension，預設值在高 DPI 渲染時可能會使條碼看起來模糊。將其設定為 2 像素對大多數螢幕掃描而言是一個不錯的平衡。 + +## 步驟 4：選擇欄位數 – 控制條碼寬度 + +Micro PDF417 支援 1 至 4 欄。欄位數越多，資料水平壓縮越多，整體影像寬度亦會減少。 + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*邊緣情況*：若要求 5 欄，函式庫會拋出 `ArgumentOutOfRangeException`。請始終保持在文件規定的範圍內。 + +## 步驟 5：產生條碼 PNG – 儲存影像 + +現在您可以將產生的條碼匯出為 PNG 檔案。PNG 保留無損品質，對於可靠的掃描至關重要。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +執行程式時，您會在主控台看到確認檔案位置的訊息。產生的 `MicroPdf417.png` 如下所示： + +![顯示使用 C# 產生的微型 PDF417 條碼的螢幕截圖](micro-pdf417-example.png "產生的微型 PDF417 條碼") + +*圖片替代文字*：**使用 C# 產生的微型 PDF417 條碼** – 展示套用尺寸與欄位設定後的最終輸出。 + +## 步驟 6：執行並驗證輸出 + +1. 建置專案：`dotnet build`。 +2. 執行：`dotnet run`。 +3. 在桌面開啟 `MicroPdf417.png`，並使用手機條碼掃描應用程式掃描。 + +您應該會看到解碼後的文字 **“Sample text”**。若掃描器回報錯誤，請再次檢查 X‑dimension 與欄位數——極端值可能使條碼對某些裝置過於密集。 + +## 常見變化與故障排除 + +| Situation | Adjustment | +|-----------|------------| +| **需要較大的條碼以適應低解析度印表機** | 將 `XDimension.Pixels` 提升至 3 或 4。 | +| **想要更高的條碼而不改變寬度** | 設定 `generator.Parameters.Barcode.Pdf417.Rows`（列範圍 3‑90）。 | +| **在迴圈中產生多個條碼** | 重複使用相同的 `BarcodeGenerator` 實例，並在每次 `Save` 前僅更改 `CodeText`。 | +| **儲存為 JPEG 而非 PNG** | 將 `BarCodeImageFormat.Png` 替換為 `BarCodeImageFormat.Jpeg`。 | +| **在 .NET Framework 4.7 上執行** | 相同程式碼可執行；只需參考相應的 `Aspose.BarCode.dll`。 | + +## 完整程式碼清單（可執行） + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**預期輸出** – 一個 200 × 100 像素的 PNG 檔案，內含清晰的 Micro PDF417 條碼，解碼後為 “Sample text”。 + +## 結論 + +現在您已了解如何在 C# 中 **建立微型 PDF417 條碼**、**設定條碼尺寸**，以及 **產生條碼 PNG** 影像。完整範例示範了從函式庫安裝到儲存最終檔案的每一步，讓您能將條碼產生直接嵌入自己的應用程式中。 + +接下來，您可以探索相關主題，例如 **使用 Aspose.BarCode 建立 QR Code**、**自訂顏色**，或 **在 PDF 文件中嵌入條碼**。這些皆基於此處說明的 `BarcodeGenerator` 基礎。 + +歡迎嘗試不同的資料字串、欄位數與 X‑dimension 值，以符合您的特定掃描環境。祝開發愉快！ + +## 接下來您可以學習什麼？ + +以下教學涵蓋與本指南密切相關的主題，建立在此處示範的技巧之上。每個資源皆提供完整可執行的程式碼範例與步驟說明，協助您精通其他 API 功能，並在專案中探索替代實作方式。 + +- [如何建立條碼 – 緊縮 PDF417（使用 Aspose.BarCode）](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何產生 PDF417 條碼 – 緊縮 PDF417 編碼](/barcode/english/net/compact-pdf417-encoding/) +- [如何使用 Aspose.BarCode for .NET 建立 Aztec 條碼](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..a44e7be17 --- /dev/null +++ b/barcode/hongkong/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-08-22 +description: 學習如何在 C# 中使用條碼產生器建立 PDF417 條碼、設定版面並儲存為 PNG。內含完整程式碼及條碼產生器 C# 專案的技巧。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: zh-hant +lastmod: 2026-08-22 +og_description: 使用條碼產生器在 C# 中建立 PDF417 條碼，自訂版面配置，並學習如何儲存 PNG。請依照此步驟教學進行。 +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: 在 C# 中建立 PDF417 條碼 – 完整的 PNG 產生與儲存指南 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: 如何在 C# 中建立 PDF417 條碼並儲存為 PNG +url: /zh-hant/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中建立 PDF417 條碼並儲存為 PNG + +如果您需要在 C# 應用程式中**建立 PDF417 條碼**，本教學將向您展示完整步驟。您將看到條碼產生器 C# 函式庫如何將任意字串轉換為可掃描的 PDF417 圖像，以及如何在不使用額外工具的情況下儲存 PNG 檔案。 + +產生條碼在物流、票務與文件管理等領域相當常見。完成本指南後，您將擁有一個可執行的主控台程式，能在您指定的資料夾中產生名為 `Pdf417Layout.png` 的 PNG 檔案。 + +## 前置條件 + +在開始之前，請確保您已具備： + +- 已安裝 .NET 6.0 SDK 或更新版本（此程式碼亦相容於 .NET Framework 4.7 以上）。 +- Visual Studio 2022 或任何能編譯 C# 專案的編輯器。 +- **Aspose.BarCode for .NET** NuGet 套件（或任何相容的條碼產生器 C# 函式庫）。 + 使用以下指令安裝： + +```bash +dotnet add package Aspose.BarCode +``` + +不需要額外的影像處理函式庫，因為產生器可以直接寫入 PNG。 + +## 步驟 1：建立新的主控台專案 + +建立一個全新的主控台專案，讓範例保持自包含。 + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` 資料夾現在包含一個 `Program.cs` 檔案，我們將在此撰寫條碼程式碼。 + +## 步驟 2：匯入條碼命名空間 + +開啟 `Program.cs`，在檔案頂部加入所需的 `using` 指示詞： + +```csharp +using Aspose.BarCode.Generation; +``` + +此命名空間讓您可以存取 `BarcodeGenerator`、`EncodeTypes` 以及用於**如何儲存 PNG**的影像格式列舉。 + +## 步驟 3：建立 PDF417 條碼產生器 + +**如何產生 PDF417** 的核心是 `BarcodeGenerator` 類別。傳入編碼類型 `EncodeTypes.Pdf417` 以及您想要編碼的文字。 + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` 現在保存了條碼的所有設定。預設版面已可使用，但我們會在下一步自訂它。 + +## 步驟 4：定義條碼版面（欄與列） + +PDF417 允許您控制欄數（2‑30）與列數（1‑90）。調整這些值可提升特定掃描器的可讀性。 + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **小技巧：** 若省略這些設定，函式庫會自動選擇最佳值。然而，固定欄與列可讓影像尺寸可預測，這在將 PNG 嵌入 PDF 或 UI 版面時相當有用。 + +## 步驟 5：將產生的條碼儲存為 PNG 圖像 + +現在透過呼叫 `Save` 來回答**如何儲存 PNG**。此方法接受目標路徑與影像格式列舉。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +執行程式後，`Pdf417Layout.png` 會出現在專案的 `bin/Debug/net6.0` 資料夾中。 + +## 完整可執行範例 + +以下為完整的 `Program.cs` 檔案。將它複製到 **步驟 1** 建立的專案中，然後執行 `dotnet run`。 + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### 預期輸出 + +執行程式時，主控台會印出 PNG 檔案的絕對路徑，檔案本身則包含一個清晰的 PDF417 條碼，外觀與下方圖片相似。 + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +您可以使用任何支援 PDF417 的掃描器（行動應用、硬體讀取器）掃描此 PNG，以驗證編碼文字為 `"Sample"`。 + +## 處理邊緣案例與常見陷阱 + +| 情況 | 需要留意的地方 | 建議的解決方式 | +|-----------|-------------------|-----------------| +| **欄/列值不合法** | 超出 2‑30（欄）或 1‑90（列）範圍會拋出 `ArgumentException`。 | 在指派前驗證使用者輸入，或讓函式庫自行選擇預設值。 | +| **輸入字串過長** | PDF417 最多可編碼 1,850 個字元，但過長字串會大幅增加所需列數。 | 將資料切割成多個條碼，或在必要時提升錯誤更正等級。 | +| **檔案系統權限** | 儲存至唯讀資料夾會拋出 `UnauthorizedAccessException`。 | 寫入 `Environment.CurrentDirectory` 或使用使用者可寫入的路徑，並以 try/catch 處理例外。 | +| **缺少 NuGet 套件** | 編譯時出現「type or namespace name could not be found」錯誤。 | 確認已安裝 `Aspose.BarCode`（`dotnet add package Aspose.BarCode`）。 | + +## 延伸範例 + +既然您已掌握**如何建立 PDF417 條碼**以及**如何儲存 PNG**，可以進一步探索以下相關主題： + +- **Barcode generator C#**：將 `EncodeTypes` 改為 `Code128`、`QR` 或其他符號。 +- **自訂顏色**：使用 `generator.Parameters.Barcode.ForegroundColor` 與 `BackgroundColor` 來符合品牌色彩。 +- **嵌入 PDF**：結合 PNG 與 PDF 函式庫（例如 iText7）以產生可列印的文件。 +- **動態資料**：從資料庫或使用者輸入取得文字，即時產生條碼。 + +## 結論 + +您現在擁有一套完整、可投入生產環境的 **create PDF417 barcode** 解決方案，能在 C# 中產生條碼並將結果儲存為 PNG 檔案。本文從專案設定、版面自訂，一路說明如何避免使用條碼產生器 C# 函式庫時的常見錯誤。 + +歡迎嘗試不同的欄/列設定、顏色，甚至其他條碼格式。若遇到問題，可重新閱讀 **how to generate PDF417** 章節，或參考函式庫文件以取得進階功能說明。祝開發順利！ + +## 接下來您可以學習什麼？ + +以下教學與本指南緊密相關，能進一步深化您在專案中使用的技巧。每個資源皆提供完整可執行的程式碼範例與逐步說明，協助您掌握更多 API 功能與替代實作方式。 + +- [如何使用 Aspose.BarCode 建立緊湊型 PDF417 條碼](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何產生緊湊型 PDF417 條碼](/barcode/english/net/compact-pdf417-encoding/) +- [如何為 ITF-14 條碼建立靜音區（Quiet Zone）](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..2c2b82010 --- /dev/null +++ b/barcode/hongkong/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-08-22 +description: 學習如何在 C# 中使用 Aspose.BarCode 生成 PDF417 條碼，設定條碼大小、調整列數，並啟用緊湊模式。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: zh-hant +lastmod: 2026-08-22 +og_description: 使用 Aspose.BarCode 在 C# 中生成 PDF417 條碼。本指南說明如何設定條碼尺寸、控制列數，以及啟用緊湊模式以獲得更小的圖像。 +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: 在 C# 中產生 PDF417 條碼 – 設定大小、欄位與緊湊模式 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: 如何在 C# 中產生 PDF417 條碼並設定條碼尺寸 +url: /zh-hant/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中產生 PDF417 條碼並設定條碼尺寸 + +如果您需要在 .NET 應用程式中 **產生 PDF417 條碼**，本指南將一步步說明完整流程。您將會看到如何使用 Aspose.BarCode **產生 PDF417**、**設定條碼尺寸**，以及產出可嵌入報表或行動應用程式的緊湊 PNG。 + +產生條碼不需要額外的圖形編輯器。完成本教學後，您將擁有一個功能完整的 C# 方法，能產生符合精確尺寸需求的 PDF417 圖片，供後續處理使用。 + +## 您將學會 + +* 安裝並參考 Aspose.BarCode 套件。 +* 建立 PDF417 條碼產生器並指定要編碼的文字。 +* 透過設定 X‑dimension 與欄位數 **設定條碼尺寸**。 +* 啟用緊湊（截斷）模式以縮小符號。 +* 將結果儲存為 PNG 檔案。 +* 排除常見問題，如條碼無法辨識或影像過大等。 + +### 前置條件 + +* .NET 6.0 或更新版本（亦支援 .NET Framework 4.6+）。 +* 具備 C# 與 Visual Studio（或任意 C# IDE）的基本知識。 +* 有效的 Aspose.BarCode 授權（免費評估版可用於測試）。 + +> **專業提示：** 若需在迴圈中大量產生條碼，請重複使用同一個 `BarcodeGenerator` 實例，僅變更 `CodeText` 屬性。這樣可減少記憶體配置。 + +## 使用 Aspose.BarCode 產生 PDF417 條碼 + +第一步是為 PDF417 符號建立 `BarcodeGenerator` 實例。此物件是所有條碼操作的入口。 + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*為什麼這很重要*：`EncodeTypes.Pdf417` 告訴函式庫使用 PDF417 標準，該標準支援大量資料與錯誤更正。建構子同時接受要編碼的資料，省去之後再指定 `CodeText` 的步驟。 + +## 設定條碼尺寸與欄位數 + +PDF417 符號由多列多欄的矩形模組組成。控制模組寬度（X‑dimension）與欄位數即可微調整體尺寸。 + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*說明*： +* **X‑dimension**（`Pixels`）決定每個模組的寬度。數值較小會產生更緊密的條碼，數值較大則提升低解析度掃描器的可讀性。 +* **Columns** 控制水平佈局。欄位較少會使條碼變高，欄位較多則變寬。請同時調整這兩個設定，以取得所需的 **設定條碼尺寸**。 + +## 啟用緊湊模式以產生較小的條碼 + +PDF417 提供「緊湊」或「截斷」模式，可移除不必要的留白，減少佔用空間。當螢幕空間受限時特別有用。 + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*為什麼要啟用截斷？* +當 `Truncate` 為 `true` 時，產生器會省略停止圖樣以及部分不需要的錯誤更正碼字。如此產出的影像大約縮小 15‑20 %，同時在一般使用情境下不會影響資料完整性。 + +## 將條碼儲存為 PNG 圖片 + +完成尺寸與模式設定後，將條碼寫入磁碟。PNG 為無損格式，可確保模組邊緣保持銳利。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +檔案 `CompactPdf417.png` 會包含一個符合先前設定尺寸的清晰 PDF417 符號。 + +### 預期輸出 + +開啟儲存的 PNG 應會看到一個垂直方向的 PDF417 條碼，包含三個欄位、每個模組寬度為 2 px，總尺寸約 **120 × 240 px**（寬 × 高）。使用任何標準 PDF417 讀取器掃描此影像，即可得到原始文字 “Sample text for PDF417”。 + +## 常見陷阱與避免方式 + +| 症狀 | 可能原因 | 解決方式 | +|------|----------|----------| +| 條碼無法辨識 | X‑dimension 對掃描器太小 | 將 `XDimension.Pixels` 提升至 3 或 4 | +| 影像寬度過大，佔用 UI 空間 | 設定的欄位過多 | 減少 `Pdf417.Columns` 或啟用 `Truncate` | +| 拋出 `ArgumentOutOfRangeException` | 欄位數為負或零 | 確認 `Columns` 為正整數（最小 1） | +| PNG 檔案為空 | 輸出路徑不存在或無寫入權限 | 檢查目錄是否存在且程式具有寫入權限 | + +> **專業提示：** 在呼叫 `Save()` 前使用 `barcodeGenerator.ValidateParameters()`，可提前捕捉設定錯誤。 + +## 完整可執行範例 + +以下是一個自包含的主控台程式，整合了上述所有步驟。將程式碼複製到新的 C# 專案、還原 Aspose.BarCode NuGet 套件後執行，即可看到結果。 + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**執行程式** 後會在執行目錄產生 `CompactPdf417.png`。使用行動應用程式（例如「Barcode Scanner」）掃描該影像，即可驗證編碼文字與來源字串相符。 + +## 後續步驟與相關主題 + +* **提升錯誤更正等級** – 調整 `Pdf417.ErrorLevel` 以因應噪聲較大的掃描環境。 +* **變更方向** – 若需水平布局，將 `Pdf417.Rotate` 設為 `RotationAngle.Rotate90`。 +* **將條碼嵌入 PDF** – 結合 Aspose.PDF 與 Aspose.BarCode，直接將影像放入文件。 +* **產生其他 2‑D 條碼** – 同一個 `BarcodeGenerator` 類別支援 DataMatrix、QR、Aztec 等，只要把 `EncodeTypes.Pdf417` 換成目標符號即可。 + +掌握 **產生 PDF417 條碼** 的技巧後，您可以自動化票證、庫存標籤與安全資料傳輸，應用於各種 .NET 場景。 + +## 結論 + +現在您已了解如何在 C# 中 **產生 PDF417 條碼**、精確 **設定條碼尺寸**、配置欄位、啟用緊湊模式，並將結果儲存為 PNG。將這些設定套用於任何 UI 限制或掃描需求，亦可延伸至其他條碼格式。祝您開發順利！ + +## 接下來該學什麼？ + +以下教學與本指南緊密相關，能進一步深化您所學的技巧。每篇資源皆提供完整可執行的程式碼範例與逐步說明，協助您掌握更多 API 功能，並探索在專案中的其他實作方式。 + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..6eb11cb45 --- /dev/null +++ b/barcode/hongkong/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-08-22 +description: 如何在 C# 中讀取 PDF417 條碼的逐步指南，涵蓋如何從圖像中讀取多個條碼以及提取 MacroPdf417 詳情。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: zh-hant +lastmod: 2026-08-22 +og_description: 如何在 C# 中快速讀取 PDF417 條碼。本教學示範如何從圖像中讀取多個條碼並取得 MacroPDF417 的擴充資訊。 +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: 如何在 C# 中讀取 PDF417 條碼 – 完整程式教學 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: 如何在 C# 中讀取 PDF417 條碼 – 完整指南 +url: /zh-hant/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中讀取 PDF417 條碼 – 完整指南 + +如果您需要在 .NET 應用程式中 **how to read PDF417** 條碼，本教學提供即時可執行的解決方案。您將學會如何從單一圖像讀取多個條碼、提取完整的 MacroPdf417 資料集，並在主控台顯示。此方法使用 Aspose.BarCode for .NET 函式庫，僅需幾行程式碼。 + +從圖像中讀取條碼是庫存系統、票證驗證與文件管理中的常見任務。完成本指南後，您將能解碼任何 PDF417 或 MacroPdf417 條碼、在同一張圖片中處理多個條碼，並了解 MacroPdf417 所提供的擴充欄位。 + +## 先決條件 + +- .NET 6.0 SDK 或更新版本（程式碼亦可在 .NET Framework 4.7+ 編譯） +- Visual Studio 2022 或您偏好的任何 C# 編輯器 +- Aspose.BarCode for .NET NuGet 套件（`Install-Package Aspose.BarCode`） +- 一張包含 MacroPdf417 條碼的範例圖像（例如 `MacroPdf417.png`） + +不需要額外的設定；函式庫會在內部處理圖像載入與解碼。 + +## 如何在 C# 中從圖像讀取 PDF417 條碼 + +此解決方案的核心是 `BarCodeReader` 類別。它會開啟圖像、偵測所有指定類型的條碼，並回傳 `BarCodeResult` 物件集合。以下程式碼示範完整的主控台程式。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### 為何每一行都很重要 + +| Step | Purpose | +|------|---------| +| **1️⃣ Initialize** | 建立一個綁定至圖像檔案的 `BarCodeReader`，並限制偵測為 MacroPdf417 符號，可加快處理速度。 | +| **2️⃣ Iterate** | `ReadBarCodes()` 會回傳 **所有** 符合請求類型的條碼，讓您 **read multiple barcodes** 而不需額外迴圈。 | +| **3️⃣ Basic output** | 顯示通用的 `CodeTypeName` 與可讀的 `CodeText`，方便記錄或快速驗證。 | +| **4️⃣ Extended data** | MacroPdf417 會攜帶額外的中繼資料（檔案 ID、段落數量、時間戳記等）。`Extended.Pdf417` 物件直接公開每個欄位，讓您能儲存或驗證完整的資料封包。 | + +執行程式對有效的 MacroPdf417 圖像時，會產生類似以下的主控台輸出： + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +此輸出證實函式庫成功讀取條碼、擷取文字，並提供所有 MacroPdf417 欄位。 + +## 從單一圖像讀取多個條碼 + +許多實務情境會在同一標籤上放置多個 PDF417 符號——例如包含承運人代碼、追蹤號碼與海關申報的運輸清單。上述程式碼區塊已經 **read multiple barcodes**，因為 `ReadBarCodes()` 會回傳所有符合的列舉。無需額外設定，只要如示範般遍歷結果即可。 + +若您想將讀取器限制為標準 PDF417（非 macro），同時仍能處理多個條碼，只需將 `DecodeType.MacroPdf417` 改為 `DecodeType.Pdf417`。其餘邏輯保持不變。 + +## 了解 MacroPdf417 擴充資料 + +MacroPdf417 是一般 PDF417 規範的延伸。它將大型負載切割成多個段落，並加入描述整個檔案的小型標頭。最相關的欄位包括： + +- **MacroPdf417FileID** – 同一檔案所有段落共享的唯一識別碼。 +- **MacroPdf417SegmentID** – 目前段落的序號。 +- **MacroPdf417SegmentsCount** – 預期的總段落數。 +- **MacroPdf417FileName** – 隨條碼傳送的可選檔名。 +- **MacroPdf417Checksum** – 整個檔案的錯誤檢查值。 +- **MacroPdf417FileSize** – 原始二進位負載的大小。 +- **MacroPdf417TimeStamp** – 條碼產生時的 ISO‑8601 時間戳記。 +- **MacroPdf417Addressee / Sender** – 用於路由的可選文字欄位。 +- **MacroPdf417Terminator** – 表示此段是否為最後一段。 + +當您收到所有段落後，可依 `MacroPdf417SegmentID` 排序，並將 `CodeText` 串接起來，以重建原始檔案。只要取得這些欄位，實作此邏輯相當直接。 + +## 常見陷阱與專業提示 + +- **Image quality matters** – 低解析度或高度壓縮的 PNG/JPEG 可能導致偵測遺漏。列印條碼時建議使用至少 300 dpi 的解析度。 +- **Mixed symbologies** – 若圖像同時包含 MacroPdf417 與一般 PDF417，請為每個 `DecodeType` 建立兩個讀取器，或使用 `DecodeType.AllSupported` 後依 `result.CodeTypeName` 篩選結果。 +- **Memory usage** – `using` 陳述式會即時釋放 `BarCodeReader`，避免大型圖像緩衝區長時間佔用記憶體。 +- **Thread safety** – `BarCodeReader` 並非執行緒安全。若平行解碼圖像，請為每個執行緒建立獨立實例。 +- **Error handling** – 將 `ReadBarCodes()` 包在 try/catch 中，以捕捉 `BarCodeException` 處理損毀的圖像。 + +## 完整範例回顧 + +以下是可直接複製到新主控台專案的完整程式碼。它包含所有 `using` 指示、圖像路徑常數，以及正確的釋放模式。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +使用 `dotnet build` 編譯，並以 `dotnet run` 執行。主控台會列印每個條碼的基本資料與完整的 MacroPdf417 負載。 + +## 後續步驟 + +- **Reconstruct multipart files** – 收集所有段落，依 `MacroPdf417SegmentID` 排序，並將 `CodeText` 串接至 + +## 接下來該學什麼？ + +以下教學涵蓋與本指南緊密相關的主題，並在此基礎上延伸技術。每個資源皆提供完整可執行的程式碼範例與逐步說明，協助您精通更多 API 功能，並在自己的專案中探索替代實作方式。 + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Read PDF417 Barcodes with Turkish Characters in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [How to Use Aspose for PDF417 Barcode (Chinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/hongkong/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..f4f1b6144 --- /dev/null +++ b/barcode/hongkong/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,221 @@ +--- +category: general +date: 2026-08-22 +description: 條碼產生器 C# 教學示範如何使用 Aspose.BarCode 建立帶有元資料的 Macro PDF417 條碼，並將其儲存為 PNG。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: zh-hant +lastmod: 2026-08-22 +og_description: 條碼產生器 C# 讓您能夠產生帶有完整檔案層級中繼資料的 Macro PDF417 條碼，並匯出為 PNG。請遵循本指南實作此解決方案。 +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: 條碼產生器 C# – 逐步創建 Macro PDF417 條碼 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: 如何在 C# 中使用條碼產生器產生 Macro PDF417 +url: /zh-hant/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 C# 中使用條碼產生器產生 Macro PDF417 + +如果您需要一個 **barcode generator C#** 能夠產生帶有檔案層級中繼資料的 Macro PDF417 符號，本指南提供完整、可直接執行的解決方案。您將會看到如何設定條碼外觀、嵌入如檔案 ID 與段落計數等宏資訊，最後將結果儲存為 PNG 圖片。 + +本範例使用 Aspose.BarCode 函式庫，這是一個廣受採用的 **C# barcode library**，支援完整的 PDF417 功能集。無需外部服務，且程式碼可於 .NET 6 或更新版本執行。 + +## 前置條件 + +* 已安裝 .NET 6 SDK（或任何更新版本）。 +* Visual Studio 2022、VS Code 或其他 C# IDE。 +* 參考 **Aspose.BarCode** 的 NuGet 套件 (`dotnet add package Aspose.BarCode`)。 + +了解基本的 C# 語法與 PDF417 條碼概念將有助於您跟隨步驟，但本教學會詳細說明每個設定選項。 + +## 本教學涵蓋內容 + +* 為 Macro PDF417 格式初始化 **barcode generator C#** 實例。 +* 調整視覺參數，如 X‑dimension 與欄位數。 +* 提供 Macro PDF417 檔案層級欄位：file ID、segment ID、segment count、file name、checksum、file size、timestamp、addressee、sender 與 terminator。 +* 將產生的符號儲存為 PNG 檔案。 +* 處理大型檔案或自訂時間戳等邊緣情況的技巧。 + +閱讀完本篇文章後，您將擁有一個自包含的程式，可產生完全符合規範的 Macro PDF417 條碼。 + +## 步驟 1：建立 barcode generator C# 實例 + +第一步是以 `EncodeTypes.MacroPdf417` 列舉值以及您想編碼的文字來實例化 `BarcodeGenerator`。建構子同時接受 payload 字串，該字串會成為宏條碼的資料部份。 + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**為什麼這很重要** – `EncodeTypes.MacroPdf417` 旗標告訴 Aspose.BarCode 將此符號視為宏條碼，從而啟用後續的額外欄位。若未設定此旗標，函式庫會產生普通的 PDF417 條碼，且不含檔案層級的中繼資料。 + +## 步驟 2：調整基本條碼外觀（PDF417 視覺設定） + +視覺清晰度對於可靠掃描至關重要。兩個常見參數為模組寬度（`XDimension`）與欄位數。設定這些值可在尺寸與可讀性之間取得平衡。 + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` 控制每條黑白條的寬度。**2** 的數值對大多數標籤印表機而言表現良好。 +* `Pdf417.Columns` 定義條碼使用的欄位數。五欄可產生緊湊的符號，同時不犧牲資料容量。 + +## 步驟 3：定義 Macro PDF417 檔案層級資訊 + +Macro PDF417 在標準 PDF417 格式上擴充了描述大型檔案如何分割成多個條碼段的欄位。提供這些欄位可確保下游掃描器能重建原始檔案。 + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` 必須在屬於同一邏輯檔案的所有段落中保持相同。 +* `MacroPdf417SegmentID` 從 **0** 依序遞增至 `SegmentsCount‑1`。 +* `MacroPdf417SegmentsCount` 告訴解碼器預期的段落總數。 +* `MacroPdf417FileName` 為可選項，但有助於人類可讀的辨識。 + +## 步驟 4：設定其他宏中繼資料 + +除了核心檔案資訊外，規範還允許額外欄位，如 checksum、file size、timestamp、addressee、sender 以及 terminator 旗標。填寫這些欄位可提升資料完整性與可追溯性。 + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` 為整個檔案提供 16 位元 CCITT checksum；解碼器可在重建後驗證完整性。 +* `MacroPdf417FileSize` 應反映原始檔案的精確位元組數；若值大於 `2^31‑1`，需使用 64 位元欄位，Aspose 會自動處理。 +* `MacroPdf417TimeStamp` 記錄條碼產生的時間。請使用 UTC 以避免時區歧義。 +* `MacroPdf417Addressee` 與 `MacroPdf417Sender` 為自由格式字串，可存放路由資訊。 +* `MacroPdf417Terminator` 表示此為最後段落；最後一段請設為 `Set`，否則保留預設 (`NotSet`)。 + +**邊緣情況提示** – 若檔案大小超過 4 GB，請將內容分割成多個宏段，並相應調整 `SegmentsCount`。函式庫會在不發生溢位的情況下處理大型尺寸欄位。 + +## 步驟 5：將條碼儲存為 PNG 圖片 + +最後一步將產生的符號寫入磁碟。PNG 能保留精確的像素尺寸，且被掃描硬體廣泛支援。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +將 `YOUR_DIRECTORY` 替換為執行程序可寫入的絕對或相對路徑。`BarCodeImageFormat.Png` 列舉確保無損輸出。 + +**為什麼選擇 PNG？** – PNG 等點陣格式能保持模組邊緣銳利，這對依賴高對比度邊緣的掃描器至關重要。若需要向量格式，Aspose 亦支援 `Pdf` 與 `Svg`。 + +## 完整可執行範例 + +以下是完整程式碼，您可將其複製到主控台應用程式中。它包含必要的 `using` 指令與 `Main` 方法。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### 預期輸出 + +執行程式會在專案的工作目錄中產生名為 **MacroPdf417.png** 的檔案。開啟圖片會看到帶有嵌入宏欄位的緊湊 PDF417 條碼。使用支援 PDF417 的讀取器（例如 ZXing、Aspose.BarCode 解碼器）掃描此圖像，可取得原始的 `"Sample text"` payload 以及宏中繼資料。 + +## 常見問題與故障排除 + +| Question | Answer | +|----------|--------| +| *如果條碼對目標標籤來說太大怎麼辦？* | 降低 `XDimension.Pixels` 或增加 `Pdf417.Columns`。兩個參數皆會影響整體尺寸。 | +| *我可以產生向量圖像而非 PNG 嗎？* | 可以。呼叫 `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` 以取得可縮放的輸出。 | +| *掃描後如何驗證 checksum？* | Aspose.BarCode 解碼器會自動驗證 `MacroPdf417Checksum`，並在 `MacroPdf417Result` 物件中回報不匹配情況。 | +| *此函式庫是否相容 .NET Core？* | NuGet 套件支援 .NET Standard 2.0+，涵蓋 .NET Core、.NET 5、.NET 6 及之後的版本。 | +| *如果需要嵌入二進位資料而非文字該怎麼辦？* | 將二進位 payload 轉為 Base64，或使用接受 byte 陣列的 `EncodeTypes.MacroPdf417` 重載。 | + +## 生產環境的專業提示 + +* **Cache the generator** – + +## 接下來該學什麼？ + +以下教學涵蓋與本指南緊密相關的主題，並以此為基礎延伸。每個資源皆包含完整可執行的程式碼範例與逐步說明，協助您精通其他 API 功能，並在專案中探索替代實作方式。 + +- [如何使用 Aspose.BarCode 建立條碼 – 緊湊 PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [如何在 Java 中使用 Aspose.BarCode 從 PDF 讀取條碼](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [使用 Aspose.Barcode 建立 Codabar 條碼 – 產生器與讀取器 API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/net/compact-pdf417-encoding/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/_index.md index 806ec82c7..afc0a3c9a 100644 --- a/barcode/hungarian/net/compact-pdf417-encoding/_index.md +++ b/barcode/hungarian/net/compact-pdf417-encoding/_index.md @@ -145,22 +145,25 @@ A Compact PDF417 magas adat sűrűsége és robusztus hibajavítása miatt szám Ismerje meg, hogyan generálhat Compact PDF417 vonalkódokat az Aspose.BarCode for .NET segítségével. Átfogó útmutató lépésről‑lépésre útmutatással és kódrészletekkel. -## Gyakran Ismételt Kérdések +### [Hogyan generáljunk PDF417 vonalkódot C#-ban és állítsuk be a vonalkód méretét](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) -**Q: Mekkora a maximális adat mennyiség, amelyet egy Compact PDF417 vonalkódban tárolhatok?** -A: Körülbelül 2 KB szöveg vagy bináris adat, a választott hibajavítási szinttől függően. +Tanulja meg, hogyan állíthatja be a PDF417 vonalkód méretét C#-ban az Aspose.BarCode használatával. -**Q: Miben különbözik a PDF417 hibajavítása más vonalkódtípusoktól?** -A: A PDF417 Reed‑Solomon kódokat használ, nyolc választható szintet (0‑8) kínálva, amelyekkel a redundanciát a szimbólum méretéhez igazíthatja. +### [Hogyan hozzunk létre micro PDF417 vonalkódot C#‑ban – lépésről‑lépésre útmutató](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) -**Q: Generálhatok Compact PDF417 vonalkódot .NET Core konzolalkalmazásban?** -A: Igen. Az Aspose.BarCode for .NET teljes mértékben támogatja a .NET Core 3.1-et és későbbi verziókat, valamint a .NET 5/6-ot. +Ismerje meg, hogyan generálhat micro PDF417 vonalkódot C#‑ban az Aspose.BarCode for .NET segítségével, részletes lépésekkel. -**Q: Lehet testreszabni a vonalkód előtér és háttér színeit?** -A: Természetesen. Használja a `ForeColor` és `BackColor` tulajdonságokat a `BarcodeGenerator`‑ben, hogy illeszkedjen a UI témájához. +### [Hogyan használjunk C#-os vonalkód-generátort Macro PDF417-hez](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) -**Q: Szükséges további betűtípusokat vagy erőforrásokat telepíteni?** -A: Nem szükséges külső betűtípus, a könyvtár minden renderelést belülről kezeli. +Ismerje meg, hogyan hozhat létre Macro PDF417 vonalkódot C#‑ban az Aspose.BarCode for .NET segítségével. + +### [Hogyan olvassunk PDF417 vonalkódokat C#‑ban – teljes útmutató](./how-to-read-pdf417-barcodes-in-c-complete-guide/) + +Ismerje meg, hogyan olvashat PDF417 vonalkódokat C#‑ban az Aspose.BarCode for .NET használatával, részletes példákkal és beállításokkal. + +### [Hogyan hozzunk létre PDF417 vonalkódot C#-ban és mentsük PNG-ként](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + +Tanulja meg, hogyan generálhat PDF417 vonalkódot C#-ban és mentheti PNG formátumban az Aspose.BarCode segítségével. --- diff --git a/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..f1a4dbfb9 --- /dev/null +++ b/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Tanulja meg, hogyan hozhat létre micro PDF417 vonalkódot C#-ban, és generálhat + egy vonalkód PNG képet. Tartalmazza a vonalkód méreteinek beállítását és a fájl + mentését. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: hu +lastmod: 2026-08-22 +og_description: Készíts micro PDF417 vonalkódot C#-ban, és exportáld PNG formátumban. + Kövesd ezt az útmutatót a vonalkód méreteinek beállításához és a vonalkód kép gyors + generálásához. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Micro PDF417 vonalkód létrehozása C#‑ban – teljes kódolási útmutató +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Hogyan készítsünk micro PDF417 vonalkódot C#‑ban – lépésről‑lépésre útmutató +url: /hu/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan hozzunk létre micro PDF417 vonalkódot C#‑ban – lépésről‑lépésre útmutató + +Ha **micro PDF417 vonalkódot** kell létrehoznod egy jegyrendszerhez, készletcímkéhez vagy mobilos beolvasáshoz, ez az útmutató pontosan megmutatja, hogyan. Megtekintheted a teljes C# programot, amely vonalkód PNG‑t generál, megtanulod beállítani a vonalkód méreteit, és megérted az egyes konfigurációs beállításokat. + +A útmutató végére képes leszel magas felbontású vonalkód képet generálni, testre szabni az X‑dimenziót, kiválasztani az oszlopszámot, és PNG fájlként menteni az eredményt – mindezt néhány kódsorral. + +## Amire szükséged lesz + +- .NET 6.0 SDK vagy újabb (a kód működik .NET Core‑ral és .NET Framework‑kel) +- Visual Studio 2022 vagy bármely C#‑kompatibilis IDE +- A **Aspose.BarCode for .NET** NuGet csomag (vagy bármely könyvtár, amely támogatja a `EncodeTypes.MicroPdf417`‑t) +- Alapvető ismeretek a C# szintaxisról + +> **Pro tipp:** Az Aspose.BarCode ingyenes közösségi kiadása elegendő fejlesztéshez és teszteléshez. Gyártásra licencet kell beszerezni a kiértékelési vízjelek eltávolításához. + +## 1. lépés: A vonalkód könyvtár telepítése + +Nyiss egy terminált a projekt mappádban, és futtasd: + +```bash +dotnet add package Aspose.BarCode +``` + +Ez hozzáadja az `Aspose.BarCode` assembly‑t, amely biztosítja a `BarcodeGenerator` osztályt, amelyet **create barcode image C#** alkalmazások létrehozásához használnak. + +## 2. lépés: A generátor inicializálása – micro PDF417 vonalkód létrehozása + +Az első végrehajtható sor egy `BarcodeGenerator` példányt hoz létre, amely a Micro PDF417 szimbólumra van beállítva, és megadja a kódolni kívánt adatot. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Miért fontos*: Az `EncodeTypes.MicroPdf417` enum azt mondja a könyvtárnak, hogy a PDF417 kompakt változatát használja, ami ideális kis címkékhez és mobil képernyőkhöz. + +## 3. lépés: Hogyan állítsuk be a vonalkód méreteit C#‑ban + +A modul szélességének (X‑dimenzió) finomhangolása szabályozza a vonalkód vizuális sűrűségét. A kisebb érték élesebb képet eredményez, míg a nagyobb érték könnyebbé teszi a vonalkód távolabbról történő beolvasását. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Miért kell beállítani a méreteket**: Az X‑dimenzió beállítása nélkül az alapértelmezett érték elmosódott vonalkódot eredményezhet magas DPI‑nél. 2 pixelre állítása jó egyensúlyt biztosít a legtöbb képernyőalapú beolvasáshoz. + +## 4. lépés: Oszlopszám kiválasztása – a vonalkód szélességének szabályozása + +A Micro PDF417 1 és 4 oszlop között engedélyezett. Több oszlop vízszintesen tömöríti az adatot, csökkentve a kép teljes szélességét. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Szélsőséges eset*: Ha 5 oszlopot kérsz, a könyvtár `ArgumentOutOfRangeException`‑t dob. Mindig tartsd be a dokumentált tartományt. + +## 5. lépés: Hogyan generáljunk barcode PNG‑t – a kép mentése + +Most exportálhatod a generált vonalkódot PNG fájlba. A PNG veszteségmentes minőséget őriz meg, ami elengedhetetlen a megbízható beolvasáshoz. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +A program futtatásakor egy konzolüzenetet látsz, amely megerősíti a fájl helyét. A kapott `MicroPdf417.png` így néz ki: + +![Képernyőkép, amely egy C#‑ban létrehozott micro PDF417 vonalkódot mutat](micro-pdf417-example.png "Létrehozott micro PDF417 vonalkód") + +*Kép alternatív szöveg*: **micro PDF417 barcode generated in C#** – bemutatja a végső kimenetet a méretek és oszlopszámok alkalmazása után. + +## 6. lépés: Futtatás és a kimenet ellenőrzése + +1. A projekt felépítése: `dotnet build`. +2. Futtatás: `dotnet run`. +3. Nyisd meg a `MicroPdf417.png` fájlt az asztalodon, és olvasd be egy mobil vonalkódolvasó alkalmazással. + +A **“Sample text”** szöveget kell látnod dekódolva. Ha a szkenner hibát jelez, ellenőrizd újra az X‑dimenziót és az oszlopszámot – extrém értékek túl sűrűvé tehetik a vonalkódot egyes eszközök számára. + +## Gyakori variációk és hibaelhárítás + +| Situation | Adjustment | +|-----------|------------| +| **Nagyobb vonalkódra van szükség alacsony felbontású nyomtatókhoz** | Increase `XDimension.Pixels` to 3 or 4. | +| **Magasabb vonalkód kívánt szélesség változtatása nélkül** | Set `generator.Parameters.Barcode.Pdf417.Rows` (rows range 3‑90). | +| **Több vonalkód generálása egy ciklusban** | Re‑use the same `BarcodeGenerator` instance and only change `CodeText` before each `Save`. | +| **Mentés JPEG‑ként PNG helyett** | Replace `BarCodeImageFormat.Png` with `BarCodeImageFormat.Jpeg`. | +| **Futtatás .NET Framework 4.7‑en** | The same code works; just reference the appropriate `Aspose.BarCode.dll`. | + +## Teljes forráskód (futtatható) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Várt kimenet** – egy 200 × 100‑pixel méretű PNG fájl, amely egy éles Micro PDF417 vonalkódot tartalmaz, és a “Sample text” szöveget dekódolja. + +## Következtetés + +Most már tudod, hogyan **hozz létre micro PDF417 vonalkódot** C#‑ban, **állítsd be a vonalkód méreteit**, és **generálj barcode PNG** képet. A teljes példa bemutatja az összes szükséges lépést – a könyvtár telepítésétől a végső fájl mentéséig –, így közvetlenül beágyazhatod a vonalkód generálást saját alkalmazásaidba. + +Ezután fedezd fel a kapcsolódó témákat, például **QR kódok létrehozása az Aspose.BarCode‑dal**, **színek testreszabása**, vagy **vonalkódok beágyazása PDF dokumentumokba**. Mindegyik a itt bemutatott `BarcodeGenerator` alapokra épül. + +Nyugodtan kísérletezz különböző adatkarakterláncokkal, oszlopszámokkal és X‑dimenzió értékekkel, hogy a saját beolvasási környezetedhez igazodjanak. Jó kódolást! + +## Mit érdemes legközelebb megtanulni? + +A következő oktatóanyagok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás tartalmaz teljes, működő kódpéldákat lépésről‑lépésre magyarázatokkal, hogy elsajátíthasd a további API‑funkciókat és alternatív megvalósítási megközelítéseket a saját projektjeidben. + +- [Hogyan hozzunk létre vonalkódot – Compact PDF417 az Aspose.BarCode‑dal](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hogyan generáljunk PDF417 vonalkódot – Compact PDF417 kódolás](/barcode/english/net/compact-pdf417-encoding/) +- [Hogyan hozzunk létre Aztec vonalkódot az Aspose.BarCode for .NET‑tel](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..3cb0ecc51 --- /dev/null +++ b/barcode/hungarian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Tanulja meg, hogyan hozhat létre PDF417 vonalkódot C#‑ban egy vonalkód‑generátorral, + állítsa be az elrendezést, és mentse PNG‑ként. Teljes kódot és tippeket tartalmaz + a vonalkód‑generátor C# projektekhez. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: hu +lastmod: 2026-08-22 +og_description: PDF417 vonalkód létrehozása C#‑ban egy vonalkód-generátorral, az elrendezés + testreszabása, és a PNG mentésének megtanulása. Kövesse ezt a lépésről‑lépésre útmutatót. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: PDF417 vonalkód létrehozása C#-ban – teljes útmutató a PNG generálásához + és mentéséhez +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hogyan készítsünk PDF417 vonalkódot C#-ban, és mentsük PNG formátumban +url: /hu/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# PDF417 vonalkód létrehozása C#-ban és mentése PNG-ként + +Ha **PDF417 vonalkódot** kell létrehoznod egy C# alkalmazásban, ez a tutorial bemutatja a pontos lépéseket. Megmutatjuk, hogyan tud egy barcode generator C# library bármely karakterláncot beolvasható PDF417 képpé alakítani, és hogyan lehet PNG fájlokat menteni extra eszközök nélkül. + +A vonalkódok generálása gyakori a logisztikában, jegyértékesítésben és dokumentumkezelésben. A útmutató végére egy futtatható konzolprogrammal rendelkezel majd, amely egy `Pdf417Layout.png` nevű PNG fájlt hoz létre a általad választott mappában. + +## Előfeltételek + +- .NET 6.0 SDK vagy újabb telepítve (a kód .NET Framework 4.7+ verzióval is működik). +- Visual Studio 2022 vagy bármely szerkesztő, amely képes C# projektek építésére. +- A **Aspose.BarCode for .NET** NuGet csomag (vagy bármely kompatibilis barcode generator C# library). + Telepítsd a következővel: + +```bash +dotnet add package Aspose.BarCode +``` + +Nem szükséges további képfeldolgozó könyvtár, mivel a generátor közvetlenül tud PNG-t írni. + +## 1. lépés: Új konzolprojekt létrehozása + +Hozz létre egy új konzolprojektet, hogy a példa önálló maradjon. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +A `Pdf417Demo` mappa most már tartalmaz egy `Program.cs` fájlt, ahol a vonalkód kódot fogjuk írni. + +## 2. lépés: A vonalkód névtér importálása + +Nyisd meg a `Program.cs` fájlt, és a tetejére add hozzá a szükséges `using` direktívát: + +```csharp +using Aspose.BarCode.Generation; +``` + +Ez a névtér hozzáférést biztosít a `BarcodeGenerator`, `EncodeTypes` és a PNG mentéséhez szükséges képformátum enum-hoz. + +## 3. lépés: PDF417 vonalkód generátor létrehozása + +A **PDF417 generálásának** központja a `BarcodeGenerator` osztály. Add meg az enkód típust `EncodeTypes.Pdf417` és a kódolni kívánt szöveget. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +A `generator` most már tartalmazza a vonalkód összes beállítását. Az alapértelmezett elrendezés működik, de a következő lépésben testre szabjuk. + +## 4. lépés: A vonalkód elrendezésének meghatározása (oszlopok és sorok) + +A PDF417 lehetővé teszi az oszlopok (2‑30) és sorok (1‑90) számának szabályozását. Ezeknek az értékeknek a módosítása javíthatja az olvashatóságot bizonyos szkennerek esetén. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tipp:** Ha kihagyod ezeket a beállításokat, a könyvtár automatikusan optimális értékeket választ. Azonban az oszlopok és sorok rögzítése kiszámítható képméreteket eredményez, ami hasznos, ha a PNG-t PDF-be vagy UI elrendezésbe ágyazod. + +## 5. lépés: A generált vonalkód mentése PNG képként + +Most válaszolj a **PNG mentésére** a `Save` hívásával. A metódus elfogadja a célútvonalat és a képformátum enum-ot. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +A `Pdf417Layout.png` fájl a projekt `bin/Debug/net6.0` mappájában jelenik meg a program futtatása után. + +## Teljes futtatható példa + +Alább látható a teljes `Program.cs` fájl. Másold be a **1. lépés**‑ben létrehozott projektbe, és futtasd a `dotnet run` parancsot. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Várt kimenet + +A program futtatásakor a konzol kiírja a PNG fájl abszolút útvonalát, és a fájl egy tiszta PDF417 vonalkódot tartalmaz, amely hasonló az alábbi képen láthatóhoz. + +![PDF417 vonalkód létrehozása példa](image-placeholder.png "PDF417 vonalkód mentve PNG-ként") + +A PNG-t bármely PDF417‑kompatibilis szkennerrel (mobilalkalmazások, hardveres olvasók) beolvashatod, hogy ellenőrizd, a kódolt szöveg `"Sample"`. + +## Szélsőséges esetek és gyakori buktatók kezelése + +| Situation | What to watch for | Recommended fix | +|-----------|-------------------|-----------------| +| **Érvénytelen oszlop/sor értékek** | A 2‑30 (oszlopok) vagy 1‑90 (sorok) tartományon kívüli értékek `ArgumentException`-t okoznak. | Érvényesítsd a felhasználói bemenetet a hozzárendelés előtt, vagy hagyd, hogy a könyvtár válasszon alapértelmezéseket. | +| **Nagy bemeneti karakterláncok** | A PDF417 legfeljebb 1 850 karaktert tud kódolni, de a nagyon hosszú karakterláncok jelentősen növelik a szükséges sorok számát. | Oszd fel az adatot több vonalkódra, vagy ha szükséges, használj magasabb hibajavító szintet. | +| **Fájlrendszer jogosultságok** | Írás egy csak‑olvasásra beállított mappába `UnauthorizedAccessException`-t eredményez. | Írj az `Environment.CurrentDirectory` vagy egy felhasználó által írható útvonalra, és kezeld a kivételeket try/catch‑el. | +| **Hiányzó NuGet csomag** | A fordítás “type or namespace name could not be found” hibával meghiúsul. | Győződj meg róla, hogy az `Aspose.BarCode` telepítve van (`dotnet add package Aspose.BarCode`). | + +## A példa kibővítése + +Most, hogy ismered a **PDF417 vonalkód létrehozását** és a **PNG mentését**, felfedezheted a következő kapcsolódó témákat: + +- **Barcode generator C#**: Módosítsd az `EncodeTypes` értékét `Code128`, `QR` vagy más szimbólumokra. +- **Custom colors**: Használd a `generator.Parameters.Barcode.ForegroundColor` és `BackgroundColor` beállításokat a márka színeinek megfelelően. +- **Embedding in PDFs**: Kombináld a PNG-t egy PDF könyvtárral (pl. iText7), hogy nyomtatható dokumentumot hozz létre. +- **Dynamic data**: Hozd be a szöveget adatbázisból vagy felhasználói bemenetből, hogy a vonalkódokat valós időben generáld. + +## Összegzés + +Most már egy teljes, termelés‑kész megoldással rendelkezel a **PDF417 vonalkód létrehozásához** C#-ban, és az eredmény PNG fájlba mentéséhez. A tutorial minden lépést lefedett a projekt beállításától az elrendezés testreszabásáig, és kiemelte, hogyan kerüld el a gyakori hibákat a barcode generator C# library használata során. + +Nyugodtan kísérletezz különböző oszlop/sor beállításokkal, színekkel vagy akár más vonalkód formátumokkal. Ha bármilyen problémába ütközöl, nézd meg újra a **PDF417 generálásának** szekciót, vagy böngészd a könyvtár dokumentációját a haladó funkciókért. Boldog kódolást! + +## Mit érdemes következőként megtanulni? + +A következő tutorialok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás teljes, működő kódrészleteket tartalmaz lépésről‑lépésre magyarázatokkal, hogy segítsenek elsajátítani további API funkciókat és alternatív megvalósítási megközelítéseket a saját projektjeidben. + +- [Hogyan hozzunk létre vonalkódot – Kompakt PDF417 az Aspose.BarCode segítségével](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hogyan generáljunk PDF417 vonalkódot – Kompakt PDF417 kódolás](/barcode/english/net/compact-pdf417-encoding/) +- [Hogyan hozzunk létre vonalkód csendes zónát ITF-14-hez az Aspose.BarCode for .NET használatával](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..de453104b --- /dev/null +++ b/barcode/hungarian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Ismerje meg, hogyan generálhat PDF417 vonalkódot C#-ban az Aspose.BarCode + segítségével, állítsa be a vonalkód méretét, módosítsa az oszlopokat, és engedélyezze + a kompakt módot. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: hu +lastmod: 2026-08-22 +og_description: PDF417 vonalkód generálása C#-ban az Aspose.BarCode segítségével. + Ez az útmutató bemutatja, hogyan állítható be a vonalkód mérete, szabályozhatók + az oszlopok, és engedélyezhető a kompakt mód a kisebb képhez. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: PDF417 vonalkód generálása C#-ban – méret, oszlopok és kompakt mód beállítása +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Hogyan generáljunk PDF417 vonalkódot C#-ban, és állítsuk be a vonalkód méretét +url: /hu/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan generáljunk PDF417 vonalkódot C#-ban és állítsuk be a vonalkód méretét + +Ha **PDF417 vonalkódot** kell generálnod egy .NET alkalmazásban, ez az útmutató végigvezet a teljes folyamaton. Megmutatjuk pontosan, **hogyan generáljunk PDF417**-et az Aspose.BarCode segítségével, hogyan állítsuk be a **vonalkód méretét**, és hogyan hozzunk létre egy kompakt PNG-t, amely beágyazható jelentésekbe vagy mobilalkalmazásokba. + +Vonalkód létrehozásához nem szükséges külön grafikus szerkesztő. A tutorial végére egy teljesen működő C# metódusod lesz, amely a szükséges pontos méretekkel ellátott PDF417 képet állít elő, készen áll a további feldolgozásra. + +## Mit fogsz megtanulni + +* Az Aspose.BarCode könyvtár telepítése és hivatkozása. +* PDF417 vonalkód generátor létrehozása és a kódolt szöveg megadása. +* **Set barcode size** beállítása az X‑dimenzió és az oszlopszám konfigurálásával. +* Kompakt (truncált) mód engedélyezése a szimbólum méretének csökkentéséhez. +* Az eredmény mentése PNG fájlként. +* Gyakori problémák hibaelhárítása, például olvashatatlan kódok és túl nagy képek. + +### Előfeltételek + +* .NET 6.0 vagy újabb (az API a .NET Framework 4.6+ verzióval is működik). +* Alapvető ismeretek C#-ban és a Visual Studio-ban (vagy bármely C# IDE-ben). +* Érvényes Aspose.BarCode licenc (az ingyenes értékelés teszteléshez használható). + +> **Pro tipp:** Ha sok vonalkódot szeretnél generálni egy ciklusban, használd újra ugyanazt a `BarcodeGenerator` példányt, és csak a `CodeText` tulajdonságot módosítsd. Ez csökkenti a memóriafoglalásokat. + +## PDF417 vonalkód generálása az Aspose.BarCode segítségével + +Az első lépés a `BarcodeGenerator` példányosítása a PDF417 szimbólumhoz. Ez az objektum a belépési pont minden vonalkód művelethez. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Miért fontos*: `EncodeTypes.Pdf417` azt mondja a könyvtárnak, hogy a PDF417 szabványt használja, amely nagy adatvolumeneket és hibajavítást támogat. A konstruktor egyben elfogadja a kódolni kívánt adatot, így később nem kell külön `CodeText` értéket beállítani. + +## Vonalkód méretének és oszlopszámának beállítása + +A PDF417 szimbólumok sorokból és oszlopokból álló kis téglalap alakú modulokból állnak. A modul szélességének (X‑dimenzió) és az oszlopok számának szabályozásával finoman hangolhatod a teljes méreteket. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Magyarázat*: +* **X‑dimension** (`Pixels`) határozza meg, milyen széles egy modul. A kisebb értékek szorosabb vonalkódot eredményeznek, míg a nagyobb értékek javítják az olvashatóságot alacsony felbontású szkennereknél. +* **Columns** szabályozza a vízszintes elrendezést. Kevesebb oszlop magasabb, több oszlop szélesebb vonalkódot eredményez. Ezeket a beállításokat együtt módosítva érheted el a pontos **set barcode size**-t, amelyre szükséged van. + +## Kompakt mód engedélyezése a kisebb vonalkódhoz + +A PDF417 tartalmaz egy “compact” (vagy truncált) módot, amely eltávolítja a felesleges kitöltést és csökkenti a teljes lábnyomot. Ez különösen hasznos, ha korlátozott a képernyőhely. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Miért engedélyezzük a truncálást?* +Amikor a `Truncate` értéke `true`, a generátor kihagyja a stop mintát és néhány hibajavító kódszót, amelyek a legtöbb szkennelési helyzetben nem szükségesek. Az eredményül kapott kép körülbelül 15‑20 %-kal kisebb, anélkül, hogy a tipikus felhasználási eseteknél adat integritást veszélyeztetne. + +## Vonalkód mentése PNG képként + +A méret és mód beállítása után írd a vonalkódot a lemezre. A PNG veszteségmentes, így a modulok élei élesek maradnak. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +A `CompactPdf417.png` fájl egy éles PDF417 szimbólumot fog tartalmazni, amely megegyezik a korábbi lépésekben beállított méretekkel. + +### Várt kimenet + +A mentett PNG megnyitása egy függőlegesen orientált PDF417 vonalkódot kell, hogy mutasson, három oszlopból áll, minden modul 2 px széles, és a teljes méret körülbelül **120 × 240 px** (szélesség × magasság). A kép beolvasása bármely szabványos PDF417 olvasóval visszaadja az eredeti szöveget: „Sample text for PDF417”. + +## Gyakori buktatók és elkerülésük módja + +| Szimbólum | Valószínű ok | Javítás | +|-----------|--------------|---------| +| A vonalkód olvashatatlan | Az X‑dimenzió túl kicsi a szkennerhez | `XDimension.Pixels` növelése 3‑ra vagy 4‑re | +| A kép túl széles a felhasználói felülethez | Túl sok oszlop van beállítva | `Pdf417.Columns` csökkentése vagy a `Truncate` engedélyezése | +| Kivétel `ArgumentOutOfRangeException` | Negatív vagy nulla oszlopszám | Győződj meg róla, hogy a `Columns` pozitív egész szám (minimum 1) | +| A PNG fájl üres | A kimeneti útvonal nem létezik vagy nincs írási jogosultság | Ellenőrizd, hogy a könyvtár létezik és az alkalmazásnak van írási joga | + +> **Pro tipp:** Használd a `barcodeGenerator.ValidateParameters()` metódust a `Save()` hívása előtt, hogy korán elkapd a konfigurációs hibákat. + +## Teljes, futtatható példa + +Az alábbi önálló konzolprogram tartalmazza a fenti összes lépést. Másold be egy új C# projektbe, állítsd vissza az Aspose.BarCode NuGet csomagot, és futtasd, hogy lásd az eredményt. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**A program futtatása** `CompactPdf417.png` fájlt hoz létre a végrehajtható munkakönyvtárában. Olvasd be a képet egy mobilalkalmazással (pl. „Barcode Scanner”), hogy ellenőrizd, a kódolt szöveg megegyezik a forráskarakterlánccal. + +## Következő lépések és kapcsolódó témák + +* **Increase error correction level** – állítsd be a `Pdf417.ErrorLevel`-t zajos szkennelési környezetekhez. +* **Change orientation** – állítsd a `Pdf417.Rotate`-t `RotationAngle.Rotate90`-ra, ha vízszintes elrendezésre van szükség. +* **Embed the barcode in a PDF** – kombináld az Aspose.PDF-et az Aspose.BarCode-dal, hogy a képet közvetlenül egy dokumentumba helyezd. +* **Generate other 2‑D barcodes** – ugyanaz a `BarcodeGenerator` osztály támogatja a DataMatrix, QR és Aztec kódokat; csak cseréld le a `EncodeTypes.Pdf417`-t a kívánt szimbólumra. + +A **generate PDF417 barcode** technikák elsajátításával automatizálhatod a jegykezelést, a készletcímkézést és a biztonságos adatátvitelt a .NET alkalmazások széles skálájában. + +## Következtetés + +Most már tudod, hogyan **generate PDF417 barcode** C#-ban, pontosan **set barcode size**, hogyan konfiguráld az oszlopokat, engedélyezd a kompakt módot, és mentsd el az eredményt PNG-ként. Alkalmazd ezeket a beállításokat bármilyen UI korláthoz vagy szkennelési követelményhez, és szükség szerint bővítsd a megközelítést más vonalkódformátumokra. Boldog kódolást! + +## Mit érdemes legközelebb megtanulni? + +A következő tutorialok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás tartalmaz teljes, működő kódrészleteket lépésről‑lépésre magyarázatokkal, hogy segítsenek elsajátítani további API funkciókat és alternatív megvalósítási megközelítéseket a saját projektjeidben. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..e6fcfa4a8 --- /dev/null +++ b/barcode/hungarian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Hogyan olvassuk be a PDF417 vonalkódokat C#-ban lépésről‑lépésre útmutatóval, + amely lefedi, hogyan olvassunk be több vonalkódot egy képből, és hogyan nyerjük + ki a MacroPdf417 részleteket. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: hu +lastmod: 2026-08-22 +og_description: Hogyan olvassunk PDF417 vonalkódokat C#-ban gyorsan. Ez az útmutató + megmutatja, hogyan olvassunk több vonalkódot egy képből, és hogyan nyerjünk ki MacroPdf417 + kiterjesztett információkat. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Hogyan olvassunk PDF417 vonalkódokat C#-ban – teljes programozási útmutató +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Hogyan olvassuk be a PDF417 vonalkódokat C#-ban – teljes útmutató +url: /hu/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan olvassuk be a PDF417 vonalkódokat C#‑ban – teljes útmutató + +Ha **hogyan olvassuk be a PDF417** vonalkódokat szeretne egy .NET alkalmazásban, ez az útmutató egy azonnal futtatható megoldást nyújt. Megtanulja, hogyan olvasson be több vonalkódot egyetlen képből, hogyan nyerje ki a teljes MacroPdf417 adatkészletet, és hogyan jelenítse meg a konzolon. A megközelítés az Aspose.BarCode for .NET könyvtárral működik, és csak néhány sor kódot igényel. + +A vonalkódok képről történő olvasása gyakori feladat készletkezelő rendszerekben, jegyellenőrzésben és dokumentumkezelésben. A útmutató végére képes lesz dekódolni bármely PDF417 vagy MacroPdf417 vonalkódot, több kódot kezelni egy képen, és megérteni a MacroPdf417 által biztosított kiterjesztett mezőket. + +## Előkövetelmények + +- .NET 6.0 SDK vagy újabb (a kód .NET Framework 4.7+‑vel is lefordítható) +- Visual Studio 2022 vagy bármely kedvelt C# szerkesztő +- Aspose.BarCode for .NET NuGet csomag (`Install-Package Aspose.BarCode`) +- Egy minta kép, amely MacroPdf417 vonalkódot tartalmaz (pl. `MacroPdf417.png`) + +Nem szükséges további konfiguráció; a könyvtár belsőleg kezeli a kép betöltését és a dekódolást. + +## Hogyan olvassuk be a PDF417 vonalkódokat egy képről C#‑ban + +A megoldás központja a `BarCodeReader` osztály. Megnyitja a képet, felismeri az összes megadott típusú vonalkódot, és egy `BarCodeResult` objektumok gyűjteményét adja vissza. Az alábbi kód egy teljes konzolos programot mutat. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Miért fontos minden sor + +| Lépés | Cél | +|------|-----| +| **1️⃣ Initialize** | Létrehozza a `BarCodeReader`‑t, amely a képfájlhoz van kötve, és a felismerést a MacroPdf417 szimbólumra korlátozza, ezáltal felgyorsítja a feldolgozást. | +| **2️⃣ Iterate** | A `ReadBarCodes()` **összes** olyan vonalkódot visszaad, amely megfelel a kért típusnak, lehetővé téve a **több vonalkód** beolvasását extra ciklusok nélkül. | +| **3️⃣ Basic output** | Megjeleníti az általános `CodeTypeName`‑t és az emberi olvasásra alkalmas `CodeText`‑et. Ez hasznos naplózáshoz vagy gyors ellenőrzéshez. | +| **4️⃣ Extended data** | A MacroPdf417 további metaadatokat (fájlazonosító, szegmensszám, időbélyegek stb.) tartalmaz. Az `Extended.Pdf417` objektum közvetlenül elérhetővé teszi ezeket a mezőket, így tárolhatja vagy ellenőrizheti a teljes adatcsomagot. | + +A program futtatása egy érvényes MacroPdf417 képen a következőhöz hasonló konzolkimenetet eredményez: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +A kimenet megerősíti, hogy a könyvtár sikeresen beolvasta a vonalkódot, kinyerte a szöveget, és minden MacroPdf417 mezőt biztosított. + +## Több vonalkód olvasása egyetlen képről + +Sok valós helyzetben több PDF417 szimbólum is elhelyezkedik egy címkén – gondoljunk egy szállítmánylistára, amely tartalmaz egy fuvarozói kódot, egy nyomkövetési számot és egy vámnyilatkozatot. A fenti kódrészlet már **több vonalkódot** olvas, mivel a `ReadBarCodes()` egy enumerátort ad vissza az összes egyezésről. Nem szükséges további beállítás; csak végig kell iterálni az eredményeken, ahogy a példában látható. + +Ha a leolvasót csak a standard PDF417‑ra (nem‑macro) szeretné korlátozni, miközben több kódot is kezel, cserélje le a `DecodeType.MacroPdf417`‑t `DecodeType.Pdf417`‑ra. A logika többi része változatlan marad. + +## A MacroPdf417 kiterjesztett adatainak megértése + +A MacroPdf417 a szokásos PDF417 specifikáció kiterjesztése. Nagy adatcsomagokat több szegmensre bont, és egy kis fejlécet ad hozzá, amely leírja a teljes fájlt. A legfontosabb mezők: + +- **MacroPdf417FileID** – egyedi azonosító, amelyet a fájl összes szegmense megoszt. +- **MacroPdf417SegmentID** – az aktuális szegmens sorszáma. +- **MacroPdf417SegmentsCount** – a várható szegmensek teljes száma. +- **MacroPdf417FileName** – opcionális fájlnév, amely a vonalkóddal együtt továbbítódik. +- **MacroPdf417Checksum** – hibakereső érték a teljes fájlhoz. +- **MacroPdf417FileSize** – az eredeti bináris adat mérete. +- **MacroPdf417TimeStamp** – ISO‑8601 időbélyeg, amikor a vonalkódot generálták. +- **MacroPdf417Addressee / Sender** – opcionális szöveges mezők az útvonal meghatározásához. +- **MacroPdf417Terminator** – jelzi, hogy ez a szegmens az utolsó-e. + +Ha megkapja az összes szegmenst, az eredeti fájlt újraépítheti a `MacroPdf417SegmentID` szerint rendezve, majd a `CodeText` értékeket összefűzve. Ez a logika egyszerűen megvalósítható, amint a mezők rendelkezésre állnak. + +## Gyakori hibák és profi tippek + +- **Image quality matters** – alacsony felbontású vagy erősen tömörített PNG/JPEG fájlok hibás felismerést okozhatnak. Nyomtatott vonalkódok esetén legalább 300 dpi DPI‑t használjon. +- **Mixed symbologies** – ha a kép tartalmazza a MacroPdf417‑t és a hagyományos PDF417‑t is, hozzon létre két olvasót (egyik a megfelelő `DecodeType`‑hez), vagy használja a `DecodeType.AllSupported`‑t, és szűrje a találatokat a `result.CodeTypeName` alapján. +- **Memory usage** – a `using` utasítás azonnal felszabadítja a `BarCodeReader`‑t, megakadályozva, hogy nagy képbufferek a memóriában maradjanak. +- **Thread safety** – a `BarCodeReader` nem szálbiztos. Hozzon létre külön példányt szálanként, ha párhuzamosan dekódol képeket. +- **Error handling** – a `ReadBarCodes()` hívást helyezze try/catch blokkba, hogy elkapja a `BarCodeException`‑t sérült képek esetén. + +## Teljes működő példa összefoglaló + +Az alábbi teljes programot másolja be egy új konzolos projektbe. Tartalmazza az összes `using` direktívát, egy állandó változót a kép útvonalához, és a megfelelő erőforrás‑felszabadítási mintát. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Fordítsa le `dotnet build`‑kel, majd futtassa `dotnet run`‑nal. A konzol kiírja minden vonalkód alapadatait és a teljes MacroPdf417 payload‑ot. + +## Következő lépések + +- **Reconstruct multipart files** – collect all segments, sort by `MacroPdf417SegmentID`, and concatenate `CodeText` to + +## Mit érdemes még megtanulni? + +Az alábbi oktatóanyagok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás teljes, működő kódpéldákat tartalmaz lépésről‑lépésre magyarázatokkal, hogy segítsen elsajátítani további API‑funkciókat és alternatív megvalósítási megközelítéseket saját projektjeiben. + +- [Hogyan generáljunk PDF417 vonalkódot – Kompakt PDF417 kódolás](/barcode/english/net/compact-pdf417-encoding/) +- [Hogyan olvassuk be a PDF417 vonalkódokat török karakterekkel Java‑ban](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Hogyan használjuk az Aspose‑t PDF417 vonalkódhoz (kínai) Java‑ban](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/hungarian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..503ded844 --- /dev/null +++ b/barcode/hungarian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-08-22 +description: A barcode generator C# oktatóanyag bemutatja, hogyan lehet létrehozni + egy Macro PDF417 vonalkódot metaadatokkal, és PNG formátumban menteni az Aspose.BarCode + használatával. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: hu +lastmod: 2026-08-22 +og_description: A C# vonalkódgenerátor lehetővé teszi, hogy Macro PDF417 vonalkódot + hozzon létre teljes fájlszintű metaadatokkal, és PNG‑ként exportálja. Kövesse ezt + az útmutatót a megoldás megvalósításához. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: C# vonalkódgenerátor – Macro PDF417 vonalkódok lépésről lépésre létrehozása +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hogyan használjunk C#-os vonalkódgenerátort a Macro PDF417-hez +url: /hu/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan használjunk C# barcode generator‑t Macro PDF417‑hez + +Ha **barcode generator C#**‑re van szüksége, amely képes Macro PDF417 szimbólumot előállítani fájlszintű metaadatokkal, ez az útmutató egy teljes, azonnal futtatható megoldást nyújt. Megmutatjuk, hogyan állítható be a vonalkód megjelenése, hogyan ágyazhatók be a makróinformációk, például a fájlazonosító és a szegmensszám, és végül hogyan menthető el az eredmény PNG képként. + +A példa az Aspose.BarCode könyvtárat használja, amely egy széles körben elterjedt **C# barcode library**, és támogatja a PDF417 teljes funkciókészletét. Külső szolgáltatásra nincs szükség, a kód .NET 6 vagy újabb verzióval működik. + +## Előfeltételek + +Mielőtt elkezdené, győződjön meg róla, hogy rendelkezik: + +* .NET 6 SDK‑val (vagy bármely későbbi verzióval) telepítve. +* Visual Studio 2022‑vel, VS Code‑dal vagy más C# IDE‑vel. +* NuGet hivatkozással az **Aspose.BarCode**‑ra (`dotnet add package Aspose.BarCode`). + +Az alapvető C# szintaxis és a PDF417 vonalkódok koncepciójának ismerete segíti a lépések követését, de az útmutató minden konfigurációs lehetőséget részletesen elmagyaráz. + +## Miről szól a tutorial + +* **barcode generator C#** példány inicializálása a Macro PDF417 formátumhoz. +* Vizuális paraméterek, például az X‑dimenzió és az oszlopszám beállítása. +* Macro PDF417 fájlszintű mezők megadása: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender és terminator. +* A generált szimbólum mentése PNG fájlként. +* Tippek a szélsőséges esetek kezeléséhez, például nagy fájlméretek vagy egyedi időbélyegek esetén. + +A cikk végére egy önálló programmal rendelkezik, amely teljesen szabványos Macro PDF417 vonalkódot állít elő. + +## 1. lépés: A barcode generator C# példány létrehozása + +Az első művelet a `BarcodeGenerator` példányosítása a `EncodeTypes.MacroPdf417` enum értékkel és a kódolni kívánt szöveggel. A konstruktor a payload stringet is elfogadja, amely a makró vonalkód adat részévé válik. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Miért fontos** – A `EncodeTypes.MacroPdf417` jelző azt mondja az Aspose.BarCode‑nak, hogy a szimbólumot makró vonalkódként kezelje, ezáltal engedélyezve a további mezőket. Enélkül a könyvtár egy szokásos PDF417 vonalkódot generálna, amely nem tartalmaz fájlszintű metaadatokat. + +## 2. lépés: Alapvető vonalkód megjelenés beállítása (PDF417 vizuális beállítások) + +A vizuális tisztaság kulcsfontosságú a megbízható leolvasáshoz. Két gyakori paraméter az modul szélessége (`XDimension`) és az oszlopok száma. Ezeknek a beállításával egyensúlyozhat a méret és az olvashatóság között. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` szabályozza minden fekete/fehér sáv szélességét. A **2** érték a legtöbb címkenyomtatóhoz megfelelő. +* `Pdf417.Columns` meghatározza, hány oszlopot használ a vonalkód. Öt oszlop kompakt szimbólumot eredményez anélkül, hogy csökkenne az adatkapacitás. + +## 3. lépés: Macro PDF417 fájlszintű információk definiálása + +A Macro PDF417 a standard PDF417 formátumot kiterjeszti olyan mezőkkel, amelyek leírják, hogyan oszlik egy nagy fájl több vonalkódszegmensre. Ezeknek a mezőknek a megadása biztosítja, hogy a downstream leolvasók rekonstruálni tudják az eredeti fájlt. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` minden szegmensnél ugyanaz kell legyen, amely ugyanahhoz a logikai fájlhoz tartozik. +* `MacroPdf417SegmentID` **0**‑tól `SegmentsCount‑1`‑ig növekszik. +* `MacroPdf417SegmentsCount` megadja a dekódernek, hány darabra számíthat. +* `MacroPdf417FileName` opcionális, de hasznos az ember által olvasható azonosításhoz. + +## 4. lépés: További makró metaadatok beállítása + +A fő fájlinformációkon túl a specifikáció enged extra mezőket, például checksum, file size, timestamp, addressee, sender és terminator jelzőt. Ezeknek a mezőknek a kitöltése javítja az adat integritását és nyomon követhetőségét. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` 16‑bit CCITT checksum‑ot biztosít a teljes fájlhoz; a dekóder a rekonstrukció után ellenőrizheti az integritást. +* `MacroPdf417FileSize` a forrásfájl pontos bájt számát kell, hogy tükrözze; a `2^31‑1`‑nél nagyobb értékekhez 64‑bit mező szükséges, amelyet az Aspose automatikusan kezel. +* `MacroPdf417TimeStamp` rögzíti, mikor készült a vonalkód. Használjon UTC‑t a időzóna‑kettőtlenség elkerülése érdekében. +* `MacroPdf417Addressee` és `MacroPdf417Sender` szabad szöveges mezők, amelyek tárolhatják a címzési információkat. +* `MacroPdf417Terminator` jelzi, hogy ez az utolsó szegmens; állítsa `Set`‑re az utolsó darabnál, egyébként hagyja az alapértelmezettet (`NotSet`). + +**Szélsőséges eset tip** – Ha a fájlméret meghaladja a 4 GB‑ot, ossza a tartalmat több makró szegmensre, és ennek megfelelően állítsa be a `SegmentsCount`‑ot. A könyvtár a nagy méretű mezőt túlcsordulás nélkül kezeli. + +## 5. lépés: A vonalkód mentése PNG képként + +Az utolsó lépés a generált szimbólum leírása a lemezre. A PNG megőrzi a pontos pixelméreteket, és széles körben támogatott a leolvasó hardverek által. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Cserélje le a `YOUR_DIRECTORY`‑t egy abszolút vagy relatív útvonalra, amelyre a futó folyamat írási jogosultsággal rendelkezik. A `BarCodeImageFormat.Png` enum veszteségmentes kimenetet biztosít. + +**Miért PNG?** – A raster formátumok, mint a PNG, éles modul széleket tartanak, ami elengedhetetlen a magas kontrasztú éleket igénylő leolvasók számára. Ha vektoros formátumra van szüksége, az Aspose támogatja a `Pdf` és `Svg` formátumokat is. + +## Teljesen futtatható példa + +Az alábbi program a teljes kódot tartalmazza, amelyet beilleszthet egy konzolalkalmazásba. Tartalmazza a szükséges `using` direktívákat és egy `Main` metódust. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Várt kimenet + +A program futtatása egy **MacroPdf417.png** nevű fájlt hoz létre a projekt munkakönyvtárában. A kép megnyitása egy kompakt PDF417 vonalkódot mutat be a beágyazott makrómezőkkel. A vonalkód PDF417‑kompatibilis olvasóval (pl. ZXing, Aspose.BarCode decoder) történő leolvasása visszaadja az eredeti `"Sample text"` payload‑ot a makró metaadatokkal együtt. + +## Gyakori kérdések és hibaelhárítás + +| Question | Answer | +|----------|--------| +| *Mi a teendő, ha a vonalkód túl nagy a címkén?* | Csökkentse az `XDimension.Pixels` értékét vagy növelje a `Pdf417.Columns` számát. Mindkét paraméter befolyásolja a teljes méretet. | +| *Generálhatok vektoros képet PNG helyett?* | Igen. Hívja a `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` metódust a skálázható kimenethez. | +| *Hogyan ellenőrizhetem a checksum‑ot leolvasás után?* | Az Aspose.BarCode dekóder automatikusan validálja a `MacroPdf417Checksum`‑et, és a `MacroPdf417Result` objektumban jelzi a eltéréseket. | +| *Kompatibilis a könyvtár .NET Core‑ral?* | A NuGet csomag .NET Standard 2.0+‑t támogat, ami lefedi a .NET Core, .NET 5, .NET 6 és későbbi verziókat. | +| *Mi a teendő, ha bináris adatot kell beágyazni szöveg helyett?* | Konvertálja a bináris payload‑ot Base64‑re, vagy használja a `EncodeTypes.MacroPdf417` túlterhelést, amely byte tömböt fogad. | + +## Pro tippek termelési környezethez + +* **Cache the generator** – + + +## Mit érdemes még tanulni? + +A következő tutorialok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás komplett, működő kódrészleteket tartalmaz lépésről‑lépésre magyarázatokkal, hogy segítsenek elsajátítani további API funkciókat és alternatív megvalósítási megközelítéseket saját projektjeiben. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/net/compact-pdf417-encoding/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/_index.md index 941851857..ef54d13fb 100644 --- a/barcode/indonesian/net/compact-pdf417-encoding/_index.md +++ b/barcode/indonesian/net/compact-pdf417-encoding/_index.md @@ -141,9 +141,22 @@ Kepadatan data tinggi dan koreksi kesalahan yang kuat pada Compact PDF417 menjad ## Tutorial Pengkodean Compact PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + ### [Membuat Barcode Compact PDF417](./compact-pdf417-basic-configuration/) Pelajari cara menghasilkan barcode Compact PDF417 menggunakan Aspose.BarCode untuk .NET. Panduan komprehensif dengan instruksi langkah demi langkah dan contoh kode. +### [Cara membuat barcode micro PDF417 di C# – panduan langkah demi langkah](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Panduan lengkap membuat barcode micro PDF417 menggunakan C# dengan Aspose.BarCode, termasuk contoh kode dan pengaturan. + +### [Cara menggunakan generator barcode C# untuk Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [Cara membaca barcode PDF417 di C# – panduan lengkap](./how-to-read-pdf417-barcodes-in-c-complete-guide/) + +### [Cara membuat barcode PDF417 di C# dan menyimpannya sebagai PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Panduan langkah demi langkah membuat barcode PDF417 dan menyimpannya dalam format PNG menggunakan Aspose.BarCode. + ## Pertanyaan yang Sering Diajukan **Q: Berapa jumlah maksimum data yang dapat saya simpan dalam barcode Compact PDF417?** diff --git a/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..f82b22014 --- /dev/null +++ b/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-08-22 +description: Pelajari cara membuat kode batang micro PDF417 di C# dan menghasilkan + gambar PNG kode batang. Termasuk mengatur dimensi kode batang dan menyimpan file. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: id +lastmod: 2026-08-22 +og_description: Buat kode batang micro PDF417 dalam C# dan ekspor sebagai PNG. Ikuti + panduan ini untuk mengatur dimensi kode batang dan menghasilkan gambar kode batang + dengan cepat. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Buat barcode micro PDF417 di C# – tutorial pemrograman lengkap +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Cara membuat barcode micro PDF417 di C# – panduan langkah demi langkah +url: /id/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara membuat micro PDF417 barcode di C# – panduan langkah demi langkah + +Jika Anda perlu **membuat micro PDF417 barcode** untuk sistem tiket, label inventaris, atau pemindaian seluler, tutorial ini menunjukkan secara tepat cara melakukannya. Anda akan melihat program C# lengkap yang menghasilkan barcode PNG, mempelajari cara mengatur dimensi barcode, dan memahami setiap opsi konfigurasi. + +Pada akhir panduan ini Anda akan dapat menghasilkan gambar barcode resolusi tinggi, menyesuaikan X‑dimension, memilih jumlah kolom, dan menyimpan hasilnya sebagai file PNG—semua dengan beberapa baris kode. + +## Apa yang Anda perlukan + +- .NET 6.0 SDK atau yang lebih baru (kode ini bekerja dengan .NET Core dan .NET Framework) +- Visual Studio 2022 atau IDE apa pun yang kompatibel dengan C# +- Paket NuGet **Aspose.BarCode for .NET** (atau perpustakaan apa pun yang mendukung `EncodeTypes.MicroPdf417`) +- Pemahaman dasar tentang sintaks C# + +> **Pro tip:** Edisi komunitas gratis Aspose.BarCode sudah cukup untuk pengembangan dan pengujian. Untuk produksi, dapatkan lisensi untuk menghapus watermark evaluasi. + +## Langkah 1: Instal perpustakaan barcode + +Buka terminal di folder proyek Anda dan jalankan: + +```bash +dotnet add package Aspose.BarCode +``` + +Ini menambahkan assembly `Aspose.BarCode`, yang menyediakan kelas `BarcodeGenerator` yang digunakan untuk **membuat aplikasi gambar barcode C#**. + +## Langkah 2: Inisialisasi generator – buat barcode micro PDF417 + +Baris pertama yang dapat dijalankan membuat instance `BarcodeGenerator` yang dikonfigurasi untuk simbolik Micro PDF417 dan menyediakan data yang ingin Anda enkode. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Mengapa ini penting*: Enum `EncodeTypes.MicroPdf417` memberi tahu perpustakaan untuk menggunakan versi kompak PDF417, yang ideal untuk label kecil dan layar seluler. + +## Langkah 3: Cara mengatur dimensi barcode di C# + +Penyetelan halus lebar modul (X‑dimension) mengontrol kepadatan visual barcode. Nilai yang lebih kecil menghasilkan gambar yang lebih tajam, sementara nilai yang lebih besar membuat barcode lebih mudah dipindai dari jarak jauh. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Mengapa Anda harus mengatur dimensi**: Tanpa menyesuaikan X‑dimension, nilai default dapat menghasilkan barcode yang tampak buram saat dirender pada DPI tinggi. Mengaturnya ke 2 piksel adalah keseimbangan yang baik untuk kebanyakan pemindaian berbasis layar. + +## Langkah 4: Pilih jumlah kolom – mengontrol lebar barcode + +Micro PDF417 memungkinkan antara 1 hingga 4 kolom. Lebih banyak kolom mengompres data secara horizontal, mengurangi lebar gambar secara keseluruhan. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Kasus tepi*: Jika Anda meminta 5 kolom, perpustakaan akan melempar `ArgumentOutOfRangeException`. Selalu tetap dalam rentang yang didokumentasikan. + +## Langkah 5: Cara menghasilkan barcode PNG – menyimpan gambar + +Sekarang Anda dapat mengekspor barcode yang dihasilkan ke file PNG. PNG mempertahankan kualitas lossless, yang penting untuk pemindaian yang dapat diandalkan. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Saat Anda menjalankan program, Anda akan melihat pesan konsol yang mengonfirmasi lokasi file. `MicroPdf417.png` yang dihasilkan terlihat seperti ini: + +![Tangkapan layar yang menunjukkan barcode micro PDF417 yang dihasilkan dengan C#](micro-pdf417-example.png "Barcode micro PDF417 yang dihasilkan") + +*Teks alt gambar*: **barcode micro PDF417 yang dihasilkan dalam C#** – menunjukkan output akhir setelah menerapkan dimensi dan pengaturan kolom. + +## Langkah 6: Jalankan dan verifikasi output + +1. Bangun proyek: `dotnet build`. +2. Jalankan: `dotnet run`. +3. Buka `MicroPdf417.png` di desktop Anda dan pindai dengan aplikasi pemindai barcode seluler. + +Anda harus melihat teks **“Sample text”** terdekripsi. Jika pemindai melaporkan kesalahan, periksa kembali X‑dimension dan jumlah kolom – nilai ekstrem dapat membuat barcode terlalu padat untuk beberapa perangkat. + +## Variasi umum dan pemecahan masalah + +| Situation | Adjustment | +|-----------|------------| +| **Butuh barcode lebih besar untuk printer beresolusi rendah** | Increase `XDimension.Pixels` to 3 or 4. | +| **Ingin barcode lebih tinggi tanpa mengubah lebar** | Set `generator.Parameters.Barcode.Pdf417.Rows` (rows range 3‑90). | +| **Membuat beberapa barcode dalam loop** | Re‑use the same `BarcodeGenerator` instance and only change `CodeText` before each `Save`. | +| **Menyimpan sebagai JPEG bukan PNG** | Replace `BarCodeImageFormat.Png` with `BarCodeImageFormat.Jpeg`. | +| **Menjalankan pada .NET Framework 4.7** | The same code works; just reference the appropriate `Aspose.BarCode.dll`. | + +## Daftar sumber lengkap (dapat dijalankan) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Output yang diharapkan** – file PNG 200 × 100 piksel yang berisi barcode Micro PDF417 yang tajam dan mendekode menjadi “Sample text”. + +## Kesimpulan + +Anda sekarang tahu cara **membuat barcode micro PDF417** di C#, **mengatur dimensi barcode**, dan **menghasilkan gambar barcode PNG**. Contoh lengkap ini menunjukkan setiap langkah yang diperlukan—dari instalasi perpustakaan hingga menyimpan file akhir—sehingga Anda dapat menyematkan pembuatan barcode langsung ke dalam aplikasi Anda. + +Selanjutnya, jelajahi topik terkait seperti **membuat kode QR dengan Aspose.BarCode**, **menyesuaikan warna**, atau **menyematkan barcode dalam dokumen PDF**. Masing‑masingnya dibangun di atas dasar `BarcodeGenerator` yang sama yang dibahas di sini. + +Silakan bereksperimen dengan string data yang berbeda, jumlah kolom, dan nilai X‑dimension untuk menyesuaikan lingkungan pemindaian Anda. Selamat coding! + +## Apa yang Harus Anda Pelajari Selanjutnya? + +Tutorial berikut mencakup topik yang sangat terkait yang dibangun di atas teknik yang ditunjukkan dalam panduan ini. Setiap sumber mencakup contoh kode lengkap yang berfungsi dengan penjelasan langkah demi langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [Cara Membuat Barcode – PDF417 Kompak dengan Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cara Menghasilkan Barcode PDF417 – Enkoding PDF417 Kompak](/barcode/english/net/compact-pdf417-encoding/) +- [Cara membuat barcode Aztec dengan Aspose.BarCode untuk .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..38ff12f5b --- /dev/null +++ b/barcode/indonesian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-08-22 +description: Pelajari cara membuat barcode PDF417 di C# dengan generator barcode, + mengatur tata letak, dan menyimpan PNG. Termasuk kode lengkap serta tips untuk proyek + generator barcode C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: id +lastmod: 2026-08-22 +og_description: Buat kode batang PDF417 di C# menggunakan generator kode batang, sesuaikan + tata letak, dan pelajari cara menyimpan PNG. Ikuti tutorial langkah demi langkah + ini. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Buat kode batang PDF417 di C# – panduan lengkap untuk menghasilkan dan menyimpan + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cara membuat barcode PDF417 di C# dan menyimpannya sebagai PNG +url: /id/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara membuat barcode PDF417 di C# dan menyimpannya sebagai PNG + +Jika Anda perlu **membuat barcode PDF417** dalam aplikasi C#, tutorial ini menunjukkan langkah‑langkah yang tepat. Anda akan melihat bagaimana library generator barcode C# dapat mengubah string apa pun menjadi gambar PDF417 yang dapat dipindai dan cara menyimpan file PNG tanpa alat tambahan. + +Membuat barcode umum dalam bidang logistik, tiket, dan manajemen dokumen. Pada akhir panduan ini Anda akan memiliki program konsol yang dapat dijalankan dan menghasilkan file PNG bernama `Pdf417Layout.png` di folder yang Anda pilih. + +## Prasyarat + +Sebelum memulai, pastikan Anda memiliki: + +- .NET 6.0 SDK atau yang lebih baru terpasang (kode ini juga berfungsi dengan .NET Framework 4.7+). +- Visual Studio 2022 atau editor apa pun yang dapat membangun proyek C#. +- Paket NuGet **Aspose.BarCode for .NET** (atau library generator barcode C# yang kompatibel). + Pasang dengan: + +```bash +dotnet add package Aspose.BarCode +``` + +Tidak diperlukan library pemrosesan gambar tambahan karena generator dapat menulis PNG secara langsung. + +## Langkah 1: Siapkan proyek konsol baru + +Buat proyek konsol baru agar contoh tetap mandiri. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Folder `Pdf417Demo` kini berisi file `Program.cs` tempat kita akan menulis kode barcode. + +## Langkah 2: Impor namespace barcode + +Buka `Program.cs` dan tambahkan arahan `using` yang diperlukan di bagian atas: + +```csharp +using Aspose.BarCode.Generation; +``` + +Namespace ini memberi Anda akses ke `BarcodeGenerator`, `EncodeTypes`, dan enum format gambar yang diperlukan untuk **cara menyimpan PNG**. + +## Langkah 3: Buat generator barcode PDF417 + +Inti dari **cara menghasilkan PDF417** adalah kelas `BarcodeGenerator`. Berikan tipe enkode `EncodeTypes.Pdf417` dan teks yang ingin Anda enkode. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` kini menyimpan semua pengaturan untuk barcode. Tata letak default berfungsi, tetapi kita akan menyesuaikannya pada langkah berikutnya. + +## Langkah 4: Tentukan tata letak barcode (kolom dan baris) + +PDF417 memungkinkan Anda mengontrol jumlah kolom (2‑30) dan baris (1‑90). Menyesuaikan nilai‑nilai ini dapat meningkatkan keterbacaan untuk pemindai tertentu. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tip:** Jika Anda tidak menyertakan pengaturan ini, library akan memilih nilai optimal secara otomatis. Namun, menetapkan kolom dan baris memberikan dimensi gambar yang dapat diprediksi, yang berguna saat Anda menyematkan PNG ke dalam PDF atau tata letak UI. + +## Langkah 5: Simpan barcode yang dihasilkan sebagai gambar PNG + +Sekarang jawab **cara menyimpan PNG** dengan memanggil `Save`. Metode ini menerima jalur target dan enum format gambar. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +File `Pdf417Layout.png` akan muncul di folder `bin/Debug/net6.0` proyek setelah Anda menjalankan program. + +## Contoh lengkap yang dapat dijalankan + +Berikut adalah file `Program.cs` lengkap. Salin ke dalam proyek yang dibuat pada **Langkah 1** dan jalankan `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Output yang diharapkan + +Saat Anda menjalankan program, konsol akan mencetak jalur absolut ke file PNG, dan file tersebut berisi barcode PDF417 yang jelas dan mirip dengan gambar di bawah ini. + +![contoh pembuatan barcode PDF417](image-placeholder.png "Barcode PDF417 disimpan sebagai PNG") + +Anda dapat memindai PNG dengan pemindai yang kompatibel PDF417 apa pun (aplikasi seluler, pembaca perangkat keras) untuk memverifikasi bahwa teks yang dienkode adalah `"Sample"`. + +## Menangani kasus tepi dan jebakan umum + +| Situasi | Hal yang perlu diperhatikan | Solusi yang disarankan | +|-----------|-------------------|-----------------| +| **Nilai kolom/baris tidak valid** | Nilai di luar rentang 2‑30 (kolom) atau 1‑90 (baris) menyebabkan `ArgumentException`. | Validasi input pengguna sebelum menetapkan, atau biarkan library memilih nilai default. | +| **String input besar** | PDF417 dapat mengenkode hingga 1.850 karakter, tetapi string yang sangat panjang meningkatkan jumlah baris secara dramatis. | Bagi data menjadi beberapa barcode atau gunakan tingkat koreksi kesalahan yang lebih tinggi jika diperlukan. | +| **Izin sistem file** | Menyimpan ke folder read‑only akan memunculkan `UnauthorizedAccessException`. | Tulis ke `Environment.CurrentDirectory` atau jalur yang dapat ditulisi pengguna, dan tangani pengecualian dengan try/catch. | +| **Paket NuGet tidak ada** | Kompilasi gagal dengan “type or namespace name could not be found”. | Pastikan `Aspose.BarCode` terpasang (`dotnet add package Aspose.BarCode`). | + +## Memperluas contoh + +Setelah Anda mengetahui **cara membuat barcode PDF417** dan **cara menyimpan PNG**, Anda dapat menjelajahi topik terkait berikut: + +- **Barcode generator C#**: Ubah `EncodeTypes` menjadi `Code128`, `QR`, atau simbol lainnya. +- **Warna kustom**: Gunakan `generator.Parameters.Barcode.ForegroundColor` dan `BackgroundColor` untuk menyesuaikan dengan identitas merek. +- **Menyematkan ke PDF**: Gabungkan PNG dengan library PDF (misalnya iText7) untuk membuat dokumen yang dapat dicetak. +- **Data dinamis**: Ambil teks dari basis data atau input pengguna untuk menghasilkan barcode secara otomatis. + +## Kesimpulan + +Anda kini memiliki solusi lengkap dan siap produksi untuk **membuat barcode PDF417** di C# dan menyimpan hasilnya sebagai file PNG. Tutorial ini mencakup setiap langkah mulai dari penyiapan proyek hingga penyesuaian tata letak, serta menyoroti cara menghindari kesalahan umum saat menggunakan library generator barcode C#. + +Silakan bereksperimen dengan pengaturan kolom/baris, warna, atau bahkan format barcode lainnya. Jika Anda menemui masalah, tinjau kembali bagian **cara menghasilkan PDF417** atau jelajahi dokumentasi library untuk fitur lanjutan. Selamat coding! + +## Apa yang Harus Anda Pelajari Selanjutnya? + +Tutorial berikut mencakup topik terkait yang membangun teknik yang ditunjukkan dalam panduan ini. Setiap sumber menyertakan contoh kode lengkap dengan penjelasan langkah demi langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [Cara Membuat Barcode – PDF417 Kompak dengan Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cara Menghasilkan Barcode PDF417 – Pengkodean PDF417 Kompak](/barcode/english/net/compact-pdf417-encoding/) +- [Cara Membuat Zona Tenang Barcode untuk ITF-14 Menggunakan Aspose.BarCode untuk .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..12cc7237f --- /dev/null +++ b/barcode/indonesian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Pelajari cara menghasilkan barcode PDF417 di C# dengan Aspose.BarCode, + mengatur ukuran barcode, menyesuaikan kolom, dan mengaktifkan mode kompak. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: id +lastmod: 2026-08-22 +og_description: Hasilkan kode batang PDF417 dalam C# dengan Aspose.BarCode. Panduan + ini menunjukkan cara mengatur ukuran kode batang, mengontrol kolom, dan mengaktifkan + mode kompak untuk gambar yang lebih kecil. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Buat kode batang PDF417 di C# – atur ukuran, kolom, dan mode kompak +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Cara menghasilkan barcode PDF417 di C# dan mengatur ukuran barcode +url: /id/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara menghasilkan barcode PDF417 di C# dan mengatur ukuran barcode + +Jika Anda perlu **menghasilkan barcode PDF417** dalam aplikasi .NET, panduan ini akan membawa Anda melalui proses lengkap. Anda akan melihat secara tepat **cara menghasilkan PDF417** dengan Aspose.BarCode, menyesuaikan **ukuran barcode**, dan menghasilkan PNG kompak yang dapat disematkan dalam laporan atau aplikasi seluler. + +Membuat barcode tidak memerlukan editor grafis terpisah. Pada akhir tutorial ini Anda akan memiliki metode C# yang berfungsi penuh yang menghasilkan gambar PDF417 dengan dimensi tepat yang Anda butuhkan, siap untuk diproses lebih lanjut. + +## Apa yang akan Anda pelajari + +* Menginstal dan mereferensikan pustaka Aspose.BarCode. +* Membuat generator barcode PDF417 dan menentukan teks yang akan dienkode. +* **Mengatur ukuran barcode** dengan mengonfigurasi X‑dimension dan jumlah kolom. +* Mengaktifkan mode kompak (truncated) untuk memperkecil simbol. +* Menyimpan hasil sebagai file PNG. +* Memecahkan masalah umum seperti kode yang tidak terbaca dan gambar yang terlalu besar. + +### Prasyarat + +* .NET 6.0 atau yang lebih baru (API juga berfungsi dengan .NET Framework 4.6+). +* Familiaritas dasar dengan C# dan Visual Studio (atau IDE C# apa pun). +* Lisensi Aspose.BarCode yang valid (evaluasi gratis dapat digunakan untuk pengujian). + +> **Pro tip:** Jika Anda berencana menghasilkan banyak barcode dalam sebuah loop, gunakan kembali satu instance `BarcodeGenerator` dan hanya ubah properti `CodeText`. Ini mengurangi alokasi memori. + +## Menghasilkan barcode PDF417 dengan Aspose.BarCode + +Langkah pertama adalah menginstansiasi `BarcodeGenerator` untuk simbolologi PDF417. Objek ini merupakan titik masuk untuk semua operasi barcode. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Mengapa ini penting*: `EncodeTypes.Pdf417` memberi tahu pustaka untuk menggunakan standar PDF417, yang mendukung volume data besar dan koreksi kesalahan. Konstruktor juga menerima data yang ingin Anda enkode, menghilangkan kebutuhan penetapan `CodeText` terpisah nanti. + +## Mengatur ukuran barcode dan jumlah kolom + +Simbol PDF417 terdiri dari baris dan kolom modul persegi panjang kecil. Mengontrol lebar modul (X‑dimension) dan jumlah kolom memungkinkan Anda menyesuaikan dimensi keseluruhan dengan presisi. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Penjelasan*: +* **X‑dimension** (`Pixels`) menentukan seberapa lebar setiap modul. Nilai yang lebih kecil menghasilkan barcode yang lebih rapat, sementara nilai yang lebih besar meningkatkan keterbacaan pada pemindai beresolusi rendah. +* **Columns** mengontrol tata letak horizontal. Kolom yang lebih sedikit membuat barcode lebih tinggi; kolom yang lebih banyak membuatnya lebih lebar. Sesuaikan kedua pengaturan ini bersama‑sama untuk mencapai **ukuran barcode** yang tepat yang Anda butuhkan. + +## Mengaktifkan mode kompak untuk barcode yang lebih kecil + +PDF417 memiliki mode “compact” (atau truncated) yang menghapus padding yang tidak diperlukan dan mengurangi jejak keseluruhan. Ini sangat berguna ketika Anda memiliki ruang layar yang terbatas. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Mengapa mengaktifkan pemotongan?* +Ketika `Truncate` bernilai `true`, generator menghilangkan pola berhenti dan beberapa kode koreksi‑kesalahan yang tidak diperlukan untuk kebanyakan skenario pemindaian. Gambar yang dihasilkan kira‑kira 15‑20 % lebih kecil tanpa mengorbankan integritas data untuk penggunaan umum. + +## Menyimpan barcode sebagai gambar PNG + +Setelah mengonfigurasi ukuran dan mode, tulis barcode ke disk. PNG bersifat lossless, memastikan tepi modul tetap tajam. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +File `CompactPdf417.png` akan berisi simbol PDF417 yang jelas dan sesuai dengan dimensi yang Anda tetapkan pada langkah‑langkah sebelumnya. + +### Output yang diharapkan + +Membuka PNG yang disimpan seharusnya menampilkan barcode PDF417 berorientasi vertikal yang terdiri dari tiga kolom, masing‑masing modul berukuran 2 px, dengan total ukuran kira‑kira **120 × 240 px** (lebar × tinggi). Memindai gambar dengan pembaca PDF417 standar mengembalikan teks asli “Sample text for PDF417”. + +## Kesalahan umum dan cara menghindarinya + +| Gejala | Penyebab yang mungkin | Solusi | +|--------|-----------------------|--------| +| Barcode tidak terbaca | X‑dimension terlalu kecil untuk pemindai | Tingkatkan `XDimension.Pixels` menjadi 3 atau 4 | +| Gambar terlalu lebar untuk UI | Terlalu banyak kolom yang diatur | Kurangi `Pdf417.Columns` atau aktifkan `Truncate` | +| Exception `ArgumentOutOfRangeException` | Jumlah kolom negatif atau nol | Pastikan `Columns` adalah bilangan bulat positif (minimum 1) | +| File PNG kosong | Jalur output tidak ada atau tidak memiliki izin menulis | Verifikasi direktori ada dan aplikasi memiliki hak menulis | + +> **Pro tip:** Gunakan `barcodeGenerator.ValidateParameters()` sebelum memanggil `Save()` untuk menangkap kesalahan konfigurasi lebih awal. + +## Contoh lengkap yang dapat dijalankan + +Berikut adalah program konsol mandiri yang menggabungkan semua langkah di atas. Salin ke proyek C# baru, pulihkan paket NuGet Aspose.BarCode, dan jalankan untuk melihat hasilnya. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Menjalankan program** menghasilkan `CompactPdf417.png` di direktori kerja executable. Pindai gambar dengan aplikasi seluler (misalnya “Barcode Scanner”) untuk memverifikasi bahwa teks yang dienkode cocok dengan string sumber. + +## Langkah selanjutnya dan topik terkait + +* **Meningkatkan level koreksi kesalahan** – sesuaikan `Pdf417.ErrorLevel` untuk lingkungan dengan pemindaian yang berisik. +* **Mengubah orientasi** – setel `Pdf417.Rotate` ke `RotationAngle.Rotate90` jika Anda membutuhkan tata letak horizontal. +* **Menyematkan barcode dalam PDF** – gabungkan Aspose.PDF dengan Aspose.BarCode untuk menempatkan gambar langsung ke dalam dokumen. +* **Menghasilkan barcode 2‑D lainnya** – kelas `BarcodeGenerator` yang sama mendukung DataMatrix, QR, dan Aztec; cukup ganti `EncodeTypes.Pdf417` dengan simbolologi yang diinginkan. + +Dengan menguasai teknik **menghasilkan barcode PDF417**, Anda dapat mengotomatiskan tiket, pelabelan inventaris, dan transmisi data aman di berbagai aplikasi .NET. + +## Kesimpulan + +Anda kini tahu cara **menghasilkan barcode PDF417** di C#, secara tepat **mengatur ukuran barcode**, mengonfigurasi kolom, mengaktifkan mode kompak, dan menyimpan hasil sebagai PNG. Terapkan pengaturan ini untuk menyesuaikan dengan batasan UI atau kebutuhan pemindaian apa pun, dan perluas pendekatan ke format barcode lain bila diperlukan. Selamat coding! + +## Apa yang Harus Anda Pelajari Selanjutnya? + +Tutorial berikut mencakup topik yang berhubungan erat dan membangun di atas teknik yang ditunjukkan dalam panduan ini. Setiap sumber menyertakan contoh kode lengkap dengan penjelasan langkah‑demi‑langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..7ca96add1 --- /dev/null +++ b/barcode/indonesian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,235 @@ +--- +category: general +date: 2026-08-22 +description: Cara membaca kode batang PDF417 di C# dengan panduan langkah demi langkah, + mencakup cara membaca beberapa kode batang dari sebuah gambar dan mengekstrak detail + MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: id +lastmod: 2026-08-22 +og_description: Cara membaca kode batang PDF417 di C# dengan cepat. Tutorial ini menunjukkan + cara membaca beberapa kode batang dari sebuah gambar dan mengambil informasi tambahan + MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Cara membaca kode batang PDF417 di C# – panduan pemrograman lengkap +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Cara membaca kode batang PDF417 di C# – panduan lengkap +url: /id/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara Membaca Kode Bar PDF417 di C# – Panduan Lengkap + +Jika Anda perlu **cara membaca PDF417** di aplikasi .NET, tutorial ini memberikan solusi siap‑jalankan. Anda akan belajar cara membaca beberapa kode bar dari satu gambar, mengekstrak set data MacroPdf417 lengkap, dan menampilkannya di konsol. Pendekatan ini bekerja dengan pustaka Aspose.BarCode untuk .NET dan hanya memerlukan beberapa baris kode. + +Membaca kode bar dari gambar adalah tugas umum dalam sistem inventaris, validasi tiket, dan manajemen dokumen. Pada akhir panduan ini Anda akan dapat mendekode kode bar PDF417 atau MacroPdf417 apa pun, menangani beberapa kode dalam satu gambar, dan memahami bidang tambahan yang disediakan MacroPdf417. + +## Prasyarat + +- .NET 6.0 SDK atau yang lebih baru (kode ini juga dapat dikompilasi dengan .NET Framework 4.7+) +- Visual Studio 2022 atau editor C# pilihan Anda +- Paket NuGet Aspose.BarCode untuk .NET (`Install-Package Aspose.BarCode`) +- Gambar contoh yang berisi kode bar MacroPdf417 (misalnya `MacroPdf417.png`) + +Tidak ada konfigurasi tambahan yang diperlukan; pustaka menangani pemuatan gambar dan proses dekoding secara internal. + +## Cara Membaca Kode Bar PDF417 dari Gambar di C# + +Inti solusi adalah kelas `BarCodeReader`. Ia membuka gambar, mendeteksi semua kode bar dari tipe yang ditentukan, dan mengembalikan koleksi objek `BarCodeResult`. Kode berikut menampilkan program konsol lengkap. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Mengapa Setiap Baris Penting + +| Langkah | Tujuan | +|------|---------| +| **1️⃣ Inisialisasi** | Membuat `BarCodeReader` yang terikat pada file gambar dan membatasi deteksi hanya pada simbolologi MacroPdf417, sehingga mempercepat proses. | +| **2️⃣ Iterasi** | `ReadBarCodes()` mengembalikan **semua** kode bar yang cocok dengan tipe yang diminta, memungkinkan Anda **membaca beberapa kode bar** tanpa loop tambahan. | +| **3️⃣ Output dasar** | Menampilkan `CodeTypeName` generik dan `CodeText` yang dapat dibaca manusia. Ini berguna untuk pencatatan atau validasi cepat. | +| **4️⃣ Data tambahan** | MacroPdf417 membawa metadata tambahan (ID file, jumlah segmen, cap waktu, dll.). Objek `Extended.Pdf417` mengekspose setiap bidang secara langsung, sehingga Anda dapat menyimpan atau memverifikasi seluruh paket data. | + +Menjalankan program terhadap gambar MacroPdf417 yang valid menghasilkan output konsol serupa dengan berikut: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Output tersebut mengonfirmasi bahwa pustaka berhasil membaca kode bar, mengekstrak teks, dan menyediakan setiap bidang MacroPdf417. + +## Membaca Beberapa Kode Bar dari Satu Gambar + +Banyak skenario dunia nyata menempatkan beberapa simbol PDF417 pada satu label—misalnya manifest pengiriman yang berisi kode carrier, nomor pelacakan, dan deklarasi bea cukai. Blok kode yang sama di atas sudah **membaca beberapa kode bar** karena `ReadBarCodes()` mengembalikan enumerable dari semua kecocokan. Tidak ada konfigurasi tambahan yang diperlukan; Anda hanya perlu melakukan loop melalui hasil, seperti yang ditunjukkan. + +Jika Anda ingin membatasi pembaca hanya pada PDF417 standar (non‑macro) sambil tetap menangani beberapa kode, ganti `DecodeType.MacroPdf417` dengan `DecodeType.Pdf417`. Logika lainnya tetap tidak berubah. + +## Memahami Data Tambahan MacroPdf417 + +MacroPdf417 adalah ekstensi dari spesifikasi PDF417 biasa. Ia membagi muatan besar menjadi beberapa segmen dan menambahkan header kecil yang mendeskripsikan seluruh file. Bidang paling relevan meliputi: + +- **MacroPdf417FileID** – pengidentifikasi unik yang dibagikan oleh semua segmen dari file yang sama. +- **MacroPdf417SegmentID** – nomor urut segmen saat ini. +- **MacroPdf417SegmentsCount** – total jumlah segmen yang diharapkan. +- **MacroPdf417FileName** – nama file opsional yang dikirim bersama kode bar. +- **MacroPdf417Checksum** – nilai pemeriksaan kesalahan untuk file lengkap. +- **MacroPdf417FileSize** – ukuran muatan biner asli. +- **MacroPdf417TimeStamp** – cap waktu ISO‑8601 saat kode bar dibuat. +- **MacroPdf417Addressee / Sender** – bidang teks opsional untuk routing. +- **MacroPdf417Terminator** – menunjukkan apakah segmen ini adalah yang terakhir. + +Ketika Anda menerima semua segmen, Anda dapat merekonstruksi file asli dengan mengurutkan mereka berdasarkan `MacroPdf417SegmentID` dan menggabungkan nilai `CodeText`. Logika ini mudah diimplementasikan setelah bidang-bidang tersedia. + +## Kesalahan Umum dan Tips Profesional + +- **Kualitas gambar penting** – file PNG/JPEG beresolusi rendah atau terkompresi berat dapat menyebabkan deteksi terlewat. Gunakan DPI minimal 300 dpi untuk kode bar yang dicetak. +- **Simbolologi campuran** – jika gambar berisi baik MacroPdf417 maupun PDF417 biasa, buat dua pembaca (satu untuk tiap `DecodeType`) atau gunakan `DecodeType.AllSupported` dan filter hasil berdasarkan `result.CodeTypeName`. +- **Penggunaan memori** – pernyataan `using` membuang `BarCodeReader` dengan cepat, mencegah buffer gambar besar tetap berada di memori. +- **Keamanan thread** – `BarCodeReader` tidak thread‑safe. Buat instance terpisah per thread jika Anda mendekode gambar secara paralel. +- **Penanganan error** – bungkus pemanggilan `ReadBarCodes()` dalam blok try/catch untuk menangkap `BarCodeException` pada gambar yang rusak. + +## Ringkasan Contoh Kerja Lengkap + +Berikut adalah program lengkap yang dapat Anda salin ke proyek konsol baru. Program ini mencakup semua direktif `using`, konstanta untuk jalur gambar, dan pola disposisi. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Kompilasi dengan `dotnet build` dan jalankan dengan `dotnet run`. Konsol akan mencetak data dasar setiap kode bar serta payload MacroPdf417 lengkap. + +## Langkah Selanjutnya + +- **Merekonstruksi file multipart** – kumpulkan semua segmen, urutkan berdasarkan `MacroPdf417SegmentID`, dan gabungkan `CodeText` ke + + +## Apa yang Harus Anda Pelajari Selanjutnya? + + +Tutorial berikut mencakup topik terkait yang membangun teknik yang ditunjukkan dalam panduan ini. Setiap sumber menyertakan contoh kode lengkap dengan penjelasan langkah demi langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [Cara Membuat Kode Bar PDF417 – Enkoding PDF417 Kompak](/barcode/english/net/compact-pdf417-encoding/) +- [Cara Membaca Kode Bar PDF417 dengan Karakter Turki di Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Cara Menggunakan Aspose untuk Kode Bar PDF417 (Cina) di Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/indonesian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..46a7829e6 --- /dev/null +++ b/barcode/indonesian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-08-22 +description: Tutorial generator barcode C# menunjukkan cara membuat barcode Macro + PDF417 dengan metadata dan menyimpannya sebagai PNG menggunakan Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: id +lastmod: 2026-08-22 +og_description: Generator barcode C# memungkinkan Anda menghasilkan barcode Macro + PDF417 dengan metadata tingkat file lengkap dan mengekspornya sebagai PNG. Ikuti + panduan ini untuk mengimplementasikan solusi. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: generator kode batang C# – buat kode batang Macro PDF417 langkah demi langkah +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cara menggunakan generator barcode C# untuk Macro PDF417 +url: /id/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara menggunakan barcode generator C# untuk Macro PDF417 + +Jika Anda membutuhkan **barcode generator C#** yang dapat menghasilkan simbol Macro PDF417 dengan metadata tingkat‑file, panduan ini menyediakan solusi lengkap yang siap dijalankan. Anda akan melihat cara mengonfigurasi tampilan barcode, menyematkan informasi makro seperti ID file dan jumlah segmen, dan akhirnya menyimpan hasilnya sebagai gambar PNG. + +Contoh ini menggunakan pustaka Aspose.BarCode, **C# barcode library** yang banyak dipakai dan mendukung seluruh fitur PDF417. Tidak diperlukan layanan eksternal, dan kode ini bekerja dengan .NET 6 atau yang lebih baru. + +## Prasyarat + +Sebelum memulai, pastikan Anda memiliki: + +* .NET 6 SDK (atau versi yang lebih baru) terpasang. +* Visual Studio 2022, VS Code, atau IDE C# lainnya. +* Referensi NuGet ke **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Memahami sintaks dasar C# dan konsep barcode PDF417 akan membantu Anda mengikuti langkah‑langkahnya, namun tutorial ini menjelaskan setiap opsi konfigurasi secara detail. + +## Apa yang dibahas dalam tutorial ini + +* Menginisialisasi instance **barcode generator C#** untuk format Macro PDF417. +* Menyesuaikan parameter visual seperti dimensi‑X dan jumlah kolom. +* Menyediakan bidang tingkat‑file Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender, dan terminator. +* Menyimpan simbol yang dihasilkan sebagai file PNG. +* Tips menangani kasus tepi seperti ukuran file besar atau timestamp khusus. + +Pada akhir artikel ini Anda akan memiliki program mandiri yang menghasilkan barcode Macro PDF417 yang sepenuhnya sesuai standar. + +## Langkah 1: Buat instance barcode generator C# + +Operasi pertama adalah menginstansiasi `BarcodeGenerator` dengan nilai enum `EncodeTypes.MacroPdf417` dan teks yang ingin Anda enkode. Konstruktor juga menerima string payload, yang menjadi bagian data dari barcode makro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Mengapa ini penting** – Flag `EncodeTypes.MacroPdf417` memberi tahu Aspose.BarCode untuk memperlakukan simbol sebagai barcode makro, sehingga bidang tambahan yang akan disertakan dapat diaktifkan. Tanpa flag ini pustaka akan menghasilkan barcode PDF417 biasa tanpa metadata tingkat‑file. + +## Langkah 2: Sesuaikan tampilan barcode dasar (pengaturan visual PDF417) + +Kejelasan visual sangat penting untuk pemindaian yang dapat diandalkan. Dua parameter umum adalah lebar modul (`XDimension`) dan jumlah kolom. Menyetel nilai‑nilai ini menyeimbangkan ukuran dan keterbacaan. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` mengontrol lebar setiap bar hitam/putih. Nilai **2** biasanya cocok untuk sebagian besar printer label. +* `Pdf417.Columns` menentukan berapa banyak kolom yang akan digunakan barcode. Lima kolom menghasilkan simbol yang kompak tanpa mengorbankan kapasitas data. + +## Langkah 3: Definisikan informasi tingkat‑file Macro PDF417 + +Macro PDF417 memperluas format PDF417 standar dengan bidang‑bidang yang menjelaskan cara sebuah file besar dibagi menjadi beberapa segmen barcode. Menyediakan bidang‑bidang ini memastikan pemindai di sisi penerima dapat merekonstruksi file asli. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` harus sama untuk setiap segmen yang termasuk dalam file logis yang sama. +* `MacroPdf417SegmentID` meningkat dari **0** hingga `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` memberi tahu decoder berapa banyak bagian yang harus diharapkan. +* `MacroPdf417FileName` bersifat opsional namun berguna untuk identifikasi yang dapat dibaca manusia. + +## Langkah 4: Atur metadata makro tambahan + +Selain informasi file inti, spesifikasi memperbolehkan bidang tambahan seperti checksum, ukuran file, timestamp, addressee, sender, dan flag terminator. Mengisi bidang‑bidang ini meningkatkan integritas data dan jejak audit. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` menyediakan checksum CCITT 16‑bit untuk seluruh file; decoder dapat memverifikasi integritas setelah rekonstruksi. +* `MacroPdf417FileSize` harus mencerminkan jumlah byte tepat dari file asli; nilai yang lebih besar dari `2^31‑1` memerlukan bidang 64‑bit, yang ditangani otomatis oleh Aspose. +* `MacroPdf417TimeStamp` mencatat kapan barcode dibuat. Gunakan UTC untuk menghindari ambiguitas zona waktu. +* `MacroPdf417Addressee` dan `MacroPdf417Sender` adalah string bebas yang dapat menyimpan informasi routing. +* `MacroPdf417Terminator` menandakan bahwa ini adalah segmen terakhir; set ke `Set` untuk bagian akhir, jika tidak biarkan default (`NotSet`). + +**Tips kasus tepi** – Jika ukuran file Anda melebihi 4 GB, bagi konten menjadi beberapa segmen makro dan sesuaikan `SegmentsCount` secara tepat. Pustaka akan mengelola bidang ukuran besar tanpa overflow. + +## Langkah 5: Simpan barcode sebagai gambar PNG + +Langkah terakhir menuliskan simbol yang dihasilkan ke disk. PNG mempertahankan dimensi piksel secara tepat dan didukung luas oleh perangkat pemindai. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Ganti `YOUR_DIRECTORY` dengan jalur absolut atau relatif yang dapat ditulis oleh proses yang sedang berjalan. Enum `BarCodeImageFormat.Png` memastikan output lossless. + +**Mengapa PNG?** – Format raster seperti PNG menjaga tepi modul tetap tajam, yang penting bagi pemindai yang mengandalkan kontras tinggi. Jika Anda memerlukan format vektor, Aspose juga mendukung `Pdf` dan `Svg`. + +## Contoh lengkap yang dapat dijalankan + +Berikut adalah program lengkap yang dapat Anda salin ke aplikasi console. Program ini mencakup direktif `using` yang diperlukan serta metode `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Output yang diharapkan + +Menjalankan program akan membuat file bernama **MacroPdf417.png** di direktori kerja proyek. Membuka gambar tersebut menampilkan barcode PDF417 yang kompak dengan bidang makro yang disematkan. Memindai gambar dengan pembaca yang kompatibel dengan PDF417 (misalnya ZXing, decoder Aspose.BarCode) mengembalikan payload `"Sample text"` asli beserta metadata makro. + +## Pertanyaan umum dan pemecahan masalah + +| Pertanyaan | Jawaban | +|------------|---------| +| *Bagaimana jika barcode terlalu besar untuk label target?* | Kurangi `XDimension.Pixels` atau tingkatkan `Pdf417.Columns`. Kedua parameter memengaruhi ukuran keseluruhan. | +| *Bisakah saya menghasilkan gambar vektor alih‑alih PNG?* | Ya. Panggil `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` untuk output yang dapat diskalakan. | +| *Bagaimana cara memverifikasi checksum setelah pemindaian?* | Decoder Aspose.BarCode secara otomatis memvalidasi `MacroPdf417Checksum` dan melaporkan ketidaksesuaian di objek `MacroPdf417Result`. | +| *Apakah pustaka ini kompatibel dengan .NET Core?* | Paket NuGet mendukung .NET Standard 2.0+, yang mencakup .NET Core, .NET 5, .NET 6, dan versi selanjutnya. | +| *Bagaimana jika saya perlu menyematkan data biner alih‑alih teks?* | Konversi payload biner ke Base64 atau gunakan overload `EncodeTypes.MacroPdf417` yang menerima array byte. | + +## Pro tips untuk penggunaan produksi + +* **Cache generator** – + + +## Apa yang Harus Anda Pelajari Selanjutnya? + + +Tutorial berikut mencakup topik terkait yang membangun teknik yang ditunjukkan dalam panduan ini. Setiap sumber menyertakan contoh kode lengkap dengan penjelasan langkah‑demi‑langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/net/compact-pdf417-encoding/_index.md b/barcode/italian/net/compact-pdf417-encoding/_index.md index 0978acdc4..7f24985a9 100644 --- a/barcode/italian/net/compact-pdf417-encoding/_index.md +++ b/barcode/italian/net/compact-pdf417-encoding/_index.md @@ -80,7 +80,7 @@ Il formato può codificare fino a **~2 KB of text or binary data** a seconda d ## Perché Usare Compact PDF417 con Aspose.BarCode per .NET? -Carica il tuo codice a barre PDF417 in sole due righe e lascia che Aspose gestisca il lavoro pesante. L'API a chiamata singola della libreria seleziona automaticamente la dimensione ottimale dei moduli, applica il livello di correzione d'errore scelto e genera immagini di alta qualità, riducendo i tempi di sviluppo fino al 70 %. Supporta oltre 50 formati di output—including PNG, JPEG, SVG, and PDF—and can process multi‑hundred‑page documents without loading the entire file into memory. +Carica il tuo codice a barre PDF417 in sole due righe e lascia che Aspose gestisca il lavoro pesante. L'API a chiamata singola della libreria seleziona automaticamente la dimensione ottimale dei moduli, applica il livello di correzione d'errore scelto e genera immagini di alta qualità, riducendo i tempi di sviluppo fino al 70 %. Supporta oltre 50 formati di output—including PNG, JPEG, SVG, and PDF-and can process multi‑hundred‑page documents without loading the entire file into memory. ## Comprendere la Codifica Compact PDF417 @@ -173,7 +173,11 @@ A: Nessun font esterno è richiesto; la libreria gestisce tutto il rendering int - [Come Creare Codice a Barre – Compact PDF417 con Aspose.BarCode](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) - [Tutorial Completi ed Esempi di Aspose.BarCode per .NET](/barcode/net/) - [Come creare un codice a barre Aztec con correzione degli errori in .NET](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) - +- [Come generare il codice a barre PDF417 in C# e impostare le dimensioni del codice a barre](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +- [Come creare un codice a barre micro PDF417 in C# – guida passo‑per‑passo](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +- [Come utilizzare un generatore di codici a barre C# per Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [Come leggere i codici a barre PDF417 in C# – guida completa](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +- [Come creare un codice a barre PDF417 in C# e salvarlo come PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/italian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/italian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..4d56ffae2 --- /dev/null +++ b/barcode/italian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Impara a creare un codice a barre micro PDF417 in C# e a generare un'immagine + PNG del codice a barre. Include la definizione delle dimensioni del codice a barre + e il salvataggio del file. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: it +lastmod: 2026-08-22 +og_description: Crea un codice a barre micro PDF417 in C# ed esportalo come PNG. Segui + questa guida per impostare le dimensioni del codice a barre e generare rapidamente + un'immagine del codice a barre. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Crea codice a barre micro PDF417 in C# – tutorial completo di programmazione +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Come creare un codice a barre micro PDF417 in C# – guida passo passo +url: /it/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come creare un codice a barre micro PDF417 in C# – guida passo‑passo + +Se hai bisogno di **creare un codice a barre micro PDF417** per un sistema di biglietteria, un'etichetta di inventario o una scansione mobile, questo tutorial ti mostra esattamente come fare. Vedrai il programma C# completo che genera un PNG del codice a barre, imparerai a impostare le dimensioni del codice a barre e comprenderai ogni opzione di configurazione. + +Entro la fine di questa guida sarai in grado di generare un'immagine di codice a barre ad alta risoluzione, personalizzare la X‑dimension, scegliere il numero di colonne e salvare il risultato come file PNG—tutto con poche righe di codice. + +## Cosa ti serve + +- .NET 6.0 SDK o versioni successive (il codice funziona con .NET Core e .NET Framework) +- Visual Studio 2022 o qualsiasi IDE compatibile con C# +- Il pacchetto NuGet **Aspose.BarCode for .NET** (o qualsiasi libreria che supporti `EncodeTypes.MicroPdf417`) +- Familiarità di base con la sintassi C# + +> **Consiglio professionale:** L'edizione community gratuita di Aspose.BarCode è sufficiente per lo sviluppo e i test. Per la produzione, procurati una licenza per rimuovere i watermark di valutazione. + +## Passo 1: Installa la libreria di codici a barre + +Apri un terminale nella cartella del tuo progetto ed esegui: + +```bash +dotnet add package Aspose.BarCode +``` + +Questo aggiunge l'assembly `Aspose.BarCode`, che fornisce la classe `BarcodeGenerator` usata per **creare applicazioni C# per immagini di codici a barre**. + +## Passo 2: Inizializza il generatore – crea un codice a barre micro PDF417 + +La prima riga operativa crea un'istanza di `BarcodeGenerator` configurata per la simbologia Micro PDF417 e fornisce i dati che desideri codificare. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Perché è importante*: L'enumerazione `EncodeTypes.MicroPdf417` indica alla libreria di utilizzare la versione compatta di PDF417, ideale per etichette piccole e schermi mobili. + +## Passo 3: Come impostare le dimensioni del codice a barre in C# + +Regolare finemente la larghezza del modulo (X‑dimension) controlla la densità visiva del codice a barre. Un valore più piccolo produce un'immagine più nitida, mentre un valore più grande rende il codice a barre più facile da scansionare a distanza. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Perché dovresti impostare le dimensioni**: Senza regolare la X‑dimension, il valore predefinito può produrre un codice a barre che appare sfocato quando viene renderizzato a DPI elevati. Impostarla a 2 pixel è un buon compromesso per la maggior parte delle scansioni basate su schermo. + +## Passo 4: Scegli il numero di colonne – controllare la larghezza del codice a barre + +Micro PDF417 consente tra 1 e 4 colonne. Più colonne comprimono i dati orizzontalmente, riducendo la larghezza complessiva dell'immagine. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Caso limite*: Se richiedi 5 colonne la libreria genera un'`ArgumentOutOfRangeException`. Rimani sempre entro l'intervallo documentato. + +## Passo 5: Come generare un PNG del codice a barre – salvare l'immagine + +Ora puoi esportare il codice a barre generato in un file PNG. PNG conserva la qualità lossless, fondamentale per una scansione affidabile. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Quando esegui il programma, vedrai un messaggio nella console che conferma la posizione del file. Il risultato `MicroPdf417.png` appare così: + +![Screenshot che mostra un codice a barre micro PDF417 generato con C#](micro-pdf417-example.png "Codice a barre micro PDF417 generato") + +*Testo alternativo dell'immagine*: **codice a barre micro PDF417 generato in C#** – dimostra l'output finale dopo aver applicato le dimensioni e le impostazioni delle colonne. + +## Passo 6: Esegui e verifica l'output + +1. Compila il progetto: `dotnet build`. +2. Esegui: `dotnet run`. +3. Apri `MicroPdf417.png` sul desktop e scansionalo con un'app scanner di codici a barre mobile. + +Dovresti vedere il testo **“Sample text”** decodificato. Se lo scanner segnala un errore, ricontrolla la X‑dimension e il numero di colonne – valori estremi possono rendere il codice a barre troppo denso per alcuni dispositivi. + +## Variazioni comuni e risoluzione dei problemi + +| Situazione | Regolazione | +|-----------|------------| +| **Necessità di un codice a barre più grande per stampanti a bassa risoluzione** | Aumenta `XDimension.Pixels` a 3 o 4. | +| **Vuoi un codice a barre più alto senza cambiare la larghezza** | Imposta `generator.Parameters.Barcode.Pdf417.Rows` (intervallo righe 3‑90). | +| **Generazione di più codici a barre in un ciclo** | Riutilizza la stessa istanza di `BarcodeGenerator` e cambia solo `CodeText` prima di ogni `Save`. | +| **Salvare come JPEG invece di PNG** | Sostituisci `BarCodeImageFormat.Png` con `BarCodeImageFormat.Jpeg`. | +| **Esecuzione su .NET Framework 4.7** | Lo stesso codice funziona; basta fare riferimento al `Aspose.BarCode.dll` appropriato. | + +## Elenco completo del codice sorgente (eseguibile) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Output previsto** – un file PNG di 200 × 100 pixel contenente un codice a barre Micro PDF417 nitido che decodifica “Sample text”. + +## Conclusione + +Ora sai come **creare un codice a barre micro PDF417** in C#, **impostare le dimensioni del codice a barre** e **generare un'immagine PNG del codice a barre**. L'esempio completo dimostra ogni passaggio necessario—dall'installazione della libreria al salvataggio del file finale—così puoi incorporare la generazione di codici a barre direttamente nelle tue applicazioni. + +Successivamente, esplora argomenti correlati come **creare codici QR con Aspose.BarCode**, **personalizzare i colori**, o **incorporare codici a barre in documenti PDF**. Ognuno di questi si basa sugli stessi fondamenti di `BarcodeGenerator` trattati qui. + +Sentiti libero di sperimentare con diverse stringhe di dati, numeri di colonne e valori di X‑dimension per adattarli al tuo specifico ambiente di scansione. Buon coding! + +## Cosa dovresti imparare dopo? + +I tutorial seguenti coprono argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo‑passo per aiutarti a padroneggiare funzionalità API aggiuntive ed esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [Come creare un codice a barre – PDF417 compatto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Come generare un codice a barre PDF417 – Codifica PDF417 compatto](/barcode/english/net/compact-pdf417-encoding/) +- [Come creare un codice a barre Aztec con Aspose.BarCode per .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/italian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..404deb623 --- /dev/null +++ b/barcode/italian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-08-22 +description: Scopri come creare un codice a barre PDF417 in C# con un generatore di + codici a barre, impostare il layout e salvare in PNG. Include il codice completo + e consigli per progetti di generatori di codici a barre in C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: it +lastmod: 2026-08-22 +og_description: Crea un codice a barre PDF417 in C# usando un generatore di codici + a barre, personalizza il layout e impara come salvare in PNG. Segui questo tutorial + passo‑passo. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Crea codice a barre PDF417 in C# – guida completa per generare e salvare + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Come creare un codice a barre PDF417 in C# e salvarlo come PNG +url: /it/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come creare un codice a barre PDF417 in C# e salvarlo come PNG + +Se hai bisogno di **creare un codice a barre PDF417** in un'applicazione C#, questo tutorial ti mostra i passaggi esatti. Vedrai come una libreria generatore di codici a barre C# può trasformare qualsiasi stringa in un'immagine PDF417 leggibile e come salvare file PNG senza strumenti aggiuntivi. + +Generare codici a barre è comune nella logistica, nella gestione dei biglietti e nella gestione dei documenti. Alla fine di questa guida avrai un programma console eseguibile che produce un file PNG chiamato `Pdf417Layout.png` nella cartella che scegli. + +## Prerequisiti + +Prima di iniziare, assicurati di avere: + +- .NET 6.0 SDK o versioni successive installate (il codice funziona anche con .NET Framework 4.7+). +- Visual Studio 2022 o qualsiasi editor in grado di compilare progetti C#. +- Il pacchetto NuGet **Aspose.BarCode for .NET** (o qualsiasi libreria generatore di codici a barre C# compatibile). + Installa con: + +```bash +dotnet add package Aspose.BarCode +``` + +Non sono necessarie librerie aggiuntive per l'elaborazione delle immagini perché il generatore può scrivere direttamente PNG. + +## Passo 1: Configurare un nuovo progetto console + +Crea un nuovo progetto console così l'esempio rimane autonomo. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +La cartella `Pdf417Demo` ora contiene un file `Program.cs` dove scriveremo il codice del codice a barre. + +## Passo 2: Importare lo spazio dei nomi del codice a barre + +Apri `Program.cs` e aggiungi la direttiva `using` necessaria in cima: + +```csharp +using Aspose.BarCode.Generation; +``` + +Questo spazio dei nomi ti dà accesso a `BarcodeGenerator`, `EncodeTypes` e all'enumerazione del formato immagine necessaria per **come salvare PNG**. + +## Passo 3: Creare il generatore di codice a barre PDF417 + +Il cuore di **come generare PDF417** è la classe `BarcodeGenerator`. Passa il tipo di codifica `EncodeTypes.Pdf417` e il testo che vuoi codificare. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` ora contiene tutte le impostazioni per il codice a barre. Il layout predefinito funziona, ma lo personalizzeremo nel passo successivo. + +## Passo 4: Definire il layout del codice a barre (colonne e righe) + +PDF417 ti permette di controllare il numero di colonne (2‑30) e righe (1‑90). Regolare questi valori può migliorare la leggibilità per scanner specifici. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Consiglio professionale:** Se ometti queste impostazioni, la libreria sceglie automaticamente valori ottimali. Tuttavia, fissare colonne e righe ti garantisce dimensioni dell'immagine prevedibili, utile quando incorpori il PNG in un PDF o in un layout UI. + +## Passo 5: Salvare il codice a barre generato come immagine PNG + +Ora rispondi a **come salvare PNG** chiamando `Save`. Il metodo accetta il percorso di destinazione e l'enumerazione del formato immagine. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Il file `Pdf417Layout.png` appare nella cartella `bin/Debug/net6.0` del progetto dopo aver eseguito il programma. + +## Esempio completo eseguibile + +Di seguito il file `Program.cs` completo. Copialo nel progetto creato nel **Passo 1** ed esegui `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Output previsto + +Quando esegui il programma, la console stampa il percorso assoluto del file PNG, e il file contiene un chiaro codice a barre PDF417 che assomiglia all'immagine qui sotto. + +![create PDF417 barcode example](image-placeholder.png "PDF417 barcode saved as PNG") + +Puoi scansionare il PNG con qualsiasi scanner compatibile PDF417 (app mobile, lettori hardware) per verificare che il testo codificato sia `"Sample"`. + +## Gestione di casi limite e problemi comuni + +| Situazione | Cosa controllare | Correzione consigliata | +|-----------|-------------------|------------------------| +| **Valori di colonna/riga non validi** | Valori al di fuori dell'intervallo 2‑30 (colonne) o 1‑90 (righe) generano un `ArgumentException`. | Convalida l'input dell'utente prima di assegnare, oppure lascia che la libreria scelga i valori predefiniti. | +| **Stringhe di input molto lunghe** | PDF417 può codificare fino a 1.850 caratteri, ma stringhe molto lunghe aumentano drasticamente il numero di righe richieste. | Suddividi i dati in più codici a barre o usa un livello di correzione errori più alto se necessario. | +| **Permessi del file system** | Salvare in una cartella di sola lettura genera un `UnauthorizedAccessException`. | Scrivi in `Environment.CurrentDirectory` o in un percorso scrivibile dall'utente, e gestisci le eccezioni con try/catch. | +| **Pacchetto NuGet mancante** | La compilazione fallisce con “type or namespace name could not be found”. | Assicurati che `Aspose.BarCode` sia installato (`dotnet add package Aspose.BarCode`). | + +## Estendere l'esempio + +Ora che sai **come creare un codice a barre PDF417** e **come salvare PNG**, puoi approfondire questi argomenti correlati: + +- **Barcode generator C#**: cambia `EncodeTypes` in `Code128`, `QR` o altre simbologie. +- **Colori personalizzati**: usa `generator.Parameters.Barcode.ForegroundColor` e `BackgroundColor` per allineare il branding. +- **Incorporare in PDF**: combina il PNG con una libreria PDF (ad es., iText7) per creare documenti stampabili. +- **Dati dinamici**: preleva il testo da un database o da input utente per generare codici a barre al volo. + +## Conclusione + +Ora disponi di una soluzione completa, pronta per la produzione, per **creare un codice a barre PDF417** in C# e salvare il risultato come file PNG. Il tutorial ha coperto ogni passo, dalla configurazione del progetto alla personalizzazione del layout, evidenziando come evitare errori comuni quando si utilizza una libreria generatore di codici a barre C#. + +Sentiti libero di sperimentare con impostazioni diverse di colonne/righe, colori o persino altri formati di codice a barre. Se incontri problemi, rivedi la sezione **come generare PDF417** o consulta la documentazione della libreria per funzionalità avanzate. Buon coding! + +## Cosa dovresti imparare dopo? + +I tutorial seguenti trattano argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo‑passo per aiutarti a padroneggiare ulteriori funzionalità API ed esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode Quiet Zone for ITF-14 Using Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/italian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..0ee3fd7fa --- /dev/null +++ b/barcode/italian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-08-22 +description: Scopri come generare il codice a barre PDF417 in C# con Aspose.BarCode, + impostare le dimensioni del codice a barre, regolare le colonne e abilitare la modalità + compatta. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: it +lastmod: 2026-08-22 +og_description: Genera codice a barre PDF417 in C# con Aspose.BarCode. Questa guida + mostra come impostare le dimensioni del codice a barre, controllare le colonne e + abilitare la modalità compatta per un'immagine più piccola. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Genera codice a barre PDF417 in C# – imposta dimensioni, colonne e modalità + compatta +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Come generare un codice a barre PDF417 in C# e impostare la dimensione del + codice a barre +url: /it/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come generare PDF417 barcode in C# e impostare le dimensioni del barcode + +Se hai bisogno di **generare un codice a barre PDF417** in un'applicazione .NET, questa guida ti accompagna passo passo attraverso l'intero processo. Vedrai esattamente **come generare PDF417** con Aspose.BarCode, regolare le **dimensioni del codice a barre**, e produrre un PNG compatto che può essere incorporato in report o app mobili. + +Creare un codice a barre non richiede un editor grafico separato. Alla fine di questo tutorial avrai un metodo C# completamente funzionante che produce un'immagine PDF417 con le dimensioni esatte di cui hai bisogno, pronta per l'elaborazione successiva. + +## Cosa imparerai + +* Installa e aggiungi riferimento alla libreria Aspose.BarCode. +* Crea un generatore di codice a barre PDF417 e specifica il testo da codificare. +* **Imposta le dimensioni del codice a barre** configurando la X‑dimension e il numero di colonne. +* Abilita la modalità compatta (troncata) per ridurre il simbolo. +* Salva il risultato come file PNG. +* Risolvi i problemi comuni come codici illeggibili e immagini troppo grandi. + +### Prerequisiti + +* .NET 6.0 o successivo (l'API funziona anche con .NET Framework 4.6+). +* Familiarità di base con C# e Visual Studio (o qualsiasi IDE C#). +* Una licenza valida di Aspose.BarCode (la valutazione gratuita è sufficiente per i test). + +> **Consiglio professionale:** se prevedi di generare molti codici a barre in un ciclo, riutilizza una singola istanza di `BarcodeGenerator` e modifica solo la proprietà `CodeText`. Questo riduce le allocazioni di memoria. + +## Genera PDF417 barcode con Aspose.BarCode + +Il primo passo è istanziare il `BarcodeGenerator` per la simbologia PDF417. Questo oggetto è il punto di ingresso per tutte le operazioni sui codici a barre. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Perché è importante*: `EncodeTypes.Pdf417` indica alla libreria di utilizzare lo standard PDF417, che supporta grandi volumi di dati e correzione degli errori. Il costruttore accetta anche i dati da codificare, eliminando la necessità di un'assegnazione separata di `CodeText` in seguito. + +## Imposta le dimensioni del barcode e il conteggio delle colonne + +I simboli PDF417 sono composti da righe e colonne di piccoli moduli rettangolari. Controllare la larghezza del modulo (X‑dimension) e il numero di colonne consente di regolare finemente le dimensioni complessive. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Spiegazione*: +* **X‑dimension** (`Pixels`) determina quanto è largo ogni modulo. Valori più piccoli producono un codice a barre più compatto, mentre valori più grandi aumentano la leggibilità su scanner a bassa risoluzione. +* **Columns** controlla il layout orizzontale. Meno colonne rendono il codice a barre più alto; più colonne lo rendono più largo. Regola questi due parametri insieme per ottenere le **dimensioni del codice a barre** esatte di cui hai bisogno. + +## Abilita la modalità compatta per un barcode più piccolo + +PDF417 include una modalità “compact” (o troncata) che rimuove il padding non necessario e riduce l'ingombro complessivo. È particolarmente utile quando lo spazio sullo schermo è limitato. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Perché abilitare la troncatura?* +Quando `Truncate` è `true`, il generatore omette il pattern di stop e alcune parole di correzione degli errori che non sono necessarie per la maggior parte degli scenari di scansione. L'immagine risultante è circa il 15‑20 % più piccola senza compromettere l'integrità dei dati per i casi d'uso tipici. + +## Salva il barcode come immagine PNG + +Dopo aver configurato dimensioni e modalità, scrivi il codice a barre su disco. PNG è senza perdita, garantendo che i bordi dei moduli rimangano nitidi. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Il file `CompactPdf417.png` conterrà un simbolo PDF417 nitido che corrisponde alle dimensioni impostate nei passaggi precedenti. + +### Output previsto + +Aprendo il PNG salvato dovrebbe comparire un codice a barre PDF417 orientato verticalmente, composto da tre colonne, ciascun modulo largo 2 px, e una dimensione totale di circa **120 × 240 px** (larghezza × altezza). La scansione dell'immagine con qualsiasi lettore PDF417 standard restituisce il testo originale “Sample text for PDF417”. + +## Problemi comuni e come evitarli + +| Sintomo | Causa probabile | Correzione | +|---------|----------------|------------| +| Il codice a barre è illeggibile | X‑dimension troppo piccola per lo scanner | Aumenta `XDimension.Pixels` a 3 o 4 | +| L'immagine è troppo larga per l'interfaccia | Sono state impostate troppe colonne | Riduci `Pdf417.Columns` o abilita `Truncate` | +| Eccezione `ArgumentOutOfRangeException` | Conteggio colonne negativo o zero | Assicurati che `Columns` sia un intero positivo (minimo 1) | +| Il file PNG è vuoto | Il percorso di output non esiste o manca il permesso di scrittura | Verifica che la directory esista e che l'app abbia i diritti di scrittura | + +> **Consiglio professionale:** usa `barcodeGenerator.ValidateParameters()` prima di chiamare `Save()` per rilevare gli errori di configurazione in anticipo. + +## Esempio completo e eseguibile + +Di seguito trovi un programma console autonomo che incorpora tutti i passaggi descritti sopra. Copialo in un nuovo progetto C#, ripristina il pacchetto NuGet Aspose.BarCode e eseguilo per vedere il risultato. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Eseguendo il programma** verrà generato `CompactPdf417.png` nella directory di lavoro dell'eseguibile. Scansiona l'immagine con un'app mobile (ad es., “Barcode Scanner”) per verificare che il testo codificato corrisponda alla stringa di origine. + +## Prossimi passi e argomenti correlati + +* **Aumenta il livello di correzione degli errori** – regola `Pdf417.ErrorLevel` per ambienti con scansioni rumorose. +* **Cambia orientamento** – imposta `Pdf417.Rotate` a `RotationAngle.Rotate90` se ti serve un layout orizzontale. +* **Incorpora il barcode in un PDF** – combina Aspose.PDF con Aspose.BarCode per inserire l'immagine direttamente in un documento. +* **Genera altri codici a barre 2‑D** – la stessa classe `BarcodeGenerator` supporta DataMatrix, QR e codici Aztec; basta sostituire `EncodeTypes.Pdf417` con la simbologia desiderata. + +Padroneggiando le tecniche per **generare PDF417 barcode**, puoi automatizzare la gestione dei biglietti, l'etichettatura dell'inventario e la trasmissione sicura dei dati in una vasta gamma di applicazioni .NET. + +## Conclusione + +Ora sai come **generare PDF417 barcode** in C#, impostare con precisione le **dimensioni del codice a barre**, configurare le colonne, abilitare la modalità compatta e salvare il risultato come PNG. Applica queste impostazioni per soddisfare qualsiasi vincolo UI o requisito di scansione, e estendi l'approccio ad altri formati di codice a barre secondo necessità. Buona programmazione! + +## Cosa dovresti imparare dopo? + +I seguenti tutorial trattano argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo passo per aiutarti a padroneggiare funzionalità API aggiuntive ed esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [Come generare PDF417 Barcode – Codifica PDF417 compatta](/barcode/english/net/compact-pdf417-encoding/) +- [Come creare Barcode – PDF417 compatto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Come generare codici a barre DataMatrix usando Aspose.BarCode per .NET – Guida passo‑passo](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/italian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..cdeeb3e1e --- /dev/null +++ b/barcode/italian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Come leggere i codici a barre PDF417 in C# con una guida passo passo, + che copre come leggere più codici a barre da un'immagine ed estrarre i dettagli + MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: it +lastmod: 2026-08-22 +og_description: Come leggere rapidamente i codici a barre PDF417 in C#. Questo tutorial + ti mostra come leggere più codici a barre da un'immagine e recuperare le informazioni + estese MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Come leggere i codici a barre PDF417 in C# – guida completa alla programmazione +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Come leggere i codici a barre PDF417 in C# – guida completa +url: /it/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come leggere i codici a barre PDF417 in C# – guida completa + +Se hai bisogno di **come leggere PDF417** in un'applicazione .NET, questo tutorial ti fornisce una soluzione pronta all'uso. Imparerai a leggere più codici a barre da una singola immagine, estrarre l'intero set di dati MacroPdf417 e visualizzarlo nella console. L'approccio funziona con la libreria Aspose.BarCode per .NET e richiede solo poche righe di codice. + +La lettura di codici a barre da un'immagine è un'operazione comune nei sistemi di inventario, nella validazione dei biglietti e nella gestione dei documenti. Alla fine di questa guida sarai in grado di decodificare qualsiasi codice a barre PDF417 o MacroPdf417, gestire più codici in un'unica immagine e comprendere i campi estesi forniti da MacroPdf417. + +## Prerequisiti + +- .NET 6.0 SDK o successivo (il codice si compila anche con .NET Framework 4.7+) +- Visual Studio 2022 o qualsiasi editor C# tu preferisca +- Pacchetto NuGet Aspose.BarCode per .NET (`Install-Package Aspose.BarCode`) +- Un'immagine di esempio che contenga un codice a barre MacroPdf417 (ad es., `MacroPdf417.png`) + +Non è necessaria alcuna configurazione aggiuntiva; la libreria gestisce internamente il caricamento e la decodifica dell'immagine. + +## Come leggere i codici a barre PDF417 da un'immagine in C# + +Il cuore della soluzione è la classe `BarCodeReader`. Essa apre l'immagine, rileva tutti i codici a barre del tipo specificato e restituisce una collezione di oggetti `BarCodeResult`. Il codice seguente mostra un programma console completo. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Perché ogni riga è importante + +| Passo | Scopo | +|------|---------| +| **1️⃣ Initialize** | Crea un `BarCodeReader` associato al file immagine e limita il rilevamento alla simbologia MacroPdf417, velocizzando l'elaborazione. | +| **2️⃣ Iterate** | `ReadBarCodes()` restituisce **tutti** i codici a barre che corrispondono al tipo richiesto, consentendoti di **leggere più codici a barre** senza cicli aggiuntivi. | +| **3️⃣ Basic output** | Mostra il generico `CodeTypeName` e il `CodeText` leggibile dall’uomo. Questo è utile per il logging o per una rapida validazione. | +| **4️⃣ Extended data** | MacroPdf417 trasporta metadati aggiuntivi (ID file, conteggio segmenti, timestamp, ecc.). L'oggetto `Extended.Pdf417` espone direttamente ogni campo, così puoi memorizzare o verificare l'intero pacchetto di dati. | + +Eseguire il programma su un'immagine MacroPdf417 valida produce un output in console simile al seguente: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +L'output conferma che la libreria ha letto correttamente il codice a barre, estratto il testo e fornito tutti i campi MacroPdf417. + +## Lettura di più codici a barre da un'unica immagine + +Molti scenari reali posizionano diversi simboli PDF417 su un'unica etichetta—pensa a un manifesto di spedizione che contiene un codice vettore, un numero di tracciamento e una dichiarazione doganale. Il blocco di codice mostrato sopra legge già **più codici a barre** perché `ReadBarCodes()` restituisce un enumerabile di tutti i risultati. Non è necessaria alcuna configurazione aggiuntiva; basta iterare sui risultati, come dimostrato. + +Se desideri limitare il lettore al PDF417 standard (non macro) mantenendo la capacità di gestire più codici, sostituisci `DecodeType.MacroPdf417` con `DecodeType.Pdf417`. Il resto della logica rimane invariato. + +## Comprendere i dati estesi MacroPdf417 + +MacroPdf417 è un’estensione della specifica PDF417 normale. Divide grandi payload in più segmenti e aggiunge un piccolo header che descrive l’intero file. I campi più rilevanti sono: + +- **MacroPdf417FileID** – un identificatore unico condiviso da tutti i segmenti dello stesso file. +- **MacroPdf417SegmentID** – il numero di sequenza del segmento corrente. +- **MacroPdf417SegmentsCount** – numero totale di segmenti attesi. +- **MacroPdf417FileName** – nome file opzionale trasmesso con il codice a barre. +- **MacroPdf417Checksum** – valore di controllo per l’intero file. +- **MacroPdf417FileSize** – dimensione del payload binario originale. +- **MacroPdf417TimeStamp** – timestamp ISO‑8601 al momento della generazione del codice a barre. +- **MacroPdf417Addressee / Sender** – campi testuali opzionali per l’instradamento. +- **MacroPdf417Terminator** – indica se questo segmento è quello finale. + +Quando ricevi tutti i segmenti, puoi ricostruire il file originale ordinandoli per `MacroPdf417SegmentID` e concatenando i valori di `CodeText`. Questa logica è semplice da implementare una volta che i campi sono disponibili. + +## Problemi comuni e consigli professionali + +- **La qualità dell’immagine è fondamentale** – file PNG/JPEG a bassa risoluzione o fortemente compressi possono causare mancati rilevamenti. Usa almeno 300 dpi per i codici a barre stampati. +- **Simboli misti** – se l’immagine contiene sia MacroPdf417 sia PDF417 normale, istanzia due lettori (uno per ciascun `DecodeType`) oppure usa `DecodeType.AllSupported` e filtra i risultati in base a `result.CodeTypeName`. +- **Uso della memoria** – l’istruzione `using` elimina prontamente il `BarCodeReader`, evitando che grandi buffer di immagine rimangano in memoria. +- **Sicurezza dei thread** – `BarCodeReader` non è thread‑safe. Crea un’istanza separata per ogni thread se decodifichi immagini in parallelo. +- **Gestione degli errori** – avvolgi la chiamata a `ReadBarCodes()` in un blocco try/catch per catturare `BarCodeException` in caso di immagini corrotte. + +## Riepilogo dell’esempio completo funzionante + +Di seguito trovi il programma completo che puoi copiare in un nuovo progetto console. Include tutte le direttive `using`, una costante per il percorso dell’immagine e lo schema di disposal. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compila con `dotnet build` ed esegui con `dotnet run`. La console stampa i dati di base di ogni codice a barre e l’intero payload MacroPdf417. + +## Prossimi passi + +- **Ricostruire file multipart** – raccogli tutti i segmenti, ordina per `MacroPdf417SegmentID` e concatena `CodeText` per + +## Cosa dovresti imparare dopo? + +I tutorial seguenti trattano argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi con spiegazioni passo‑passo per aiutarti a padroneggiare ulteriori funzionalità dell’API e a esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [Come generare il codice a barre PDF417 – Codifica PDF417 compatta](/barcode/english/net/compact-pdf417-encoding/) +- [Come leggere i codici a barre PDF417 con caratteri turchi in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Come usare Aspose per il codice a barre PDF417 (cinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/italian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..549a945f0 --- /dev/null +++ b/barcode/italian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: Il tutorial su come generare barcode C# mostra come creare un codice + a barre Macro PDF417 con metadati e salvarlo come PNG usando Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: it +lastmod: 2026-08-22 +og_description: Il generatore di codici a barre C# ti consente di creare un codice + a barre Macro PDF417 con metadati a livello di file completi e di esportarlo come + PNG. Segui questa guida per implementare la soluzione. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: generatore di codici a barre C# – crea codici a barre Macro PDF417 passo + dopo passo +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Come utilizzare un generatore di codici a barre C# per Macro PDF417 +url: /it/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come utilizzare un generatore di codici a barre C# per Macro PDF417 + +Se hai bisogno di un **barcode generator C#** in grado di generare un simbolo Macro PDF417 con metadati a livello di file, questa guida fornisce una soluzione completa, pronta all'uso. Vedrai come configurare l'aspetto del codice a barre, incorporare le informazioni macro come ID file e conteggio dei segmenti, e infine salvare il risultato come immagine PNG. + +L'esempio utilizza la libreria Aspose.BarCode, una **C# barcode library** ampiamente adottata che supporta l'intero set di funzionalità PDF417. Non sono richiesti servizi esterni e il codice funziona con .NET 6 o versioni successive. + +## Prerequisiti + +* .NET 6 SDK (o qualsiasi versione successiva) installato. +* Visual Studio 2022, VS Code, o un altro IDE C#. +* Un riferimento NuGet a **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Comprendere la sintassi di base di C# e il concetto dei codici a barre PDF417 ti aiuterà a seguire i passaggi, ma il tutorial spiega in dettaglio ogni opzione di configurazione. + +## Cosa copre il tutorial + +* Inizializzare un'istanza di **barcode generator C#** per il formato Macro PDF417. +* Regolare i parametri visivi come X‑dimension e il numero di colonne. +* Fornire i campi a livello di file Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender e terminator. +* Salvare il simbolo generato come file PNG. +* Suggerimenti per gestire casi limite come file di grandi dimensioni o timestamp personalizzati. + +Alla fine di questo articolo avrai un programma autonomo che produce un codice a barre Macro PDF417 pienamente conforme. + +## Passo 1: Creare l'istanza del barcode generator C# + +La prima operazione è istanziare `BarcodeGenerator` con il valore enum `EncodeTypes.MacroPdf417` e il testo che desideri codificare. Il costruttore accetta anche la stringa payload, che diventa la parte dati del codice a barre macro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Perché è importante** – Il flag `EncodeTypes.MacroPdf417` indica ad Aspose.BarCode di trattare il simbolo come un macro barcode, abilitando i campi aggiuntivi che seguono. Senza questo flag la libreria genererebbe un normale codice a barre PDF417 privo di metadati a livello di file. + +## Passo 2: Regolare l'aspetto base del codice a barre (impostazioni visive PDF417) + +La chiarezza visiva è fondamentale per una scansione affidabile. Due parametri comuni sono la larghezza del modulo (`XDimension`) e il numero di colonne. Impostare questi valori bilancia dimensione e leggibilità. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +- `XDimension.Pixels` controlla la larghezza di ogni barra nera/bianca. Un valore di **2** funziona bene per la maggior parte delle stampanti di etichette. +- `Pdf417.Columns` definisce quante colonne utilizzerà il codice a barre. Cinque colonne producono un simbolo compatto senza sacrificare la capacità dei dati. + +## Passo 3: Definire le informazioni a livello di file Macro PDF417 + +Macro PDF417 estende il formato PDF417 standard con campi che descrivono come un file di grandi dimensioni è suddiviso in più segmenti di codice a barre. Fornire questi campi garantisce che gli scanner a valle possano ricostruire il file originale. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +- `MacroPdf417FileID` deve essere lo stesso per ogni segmento appartenente allo stesso file logico. +- `MacroPdf417SegmentID` incrementa da **0** a `SegmentsCount‑1`. +- `MacroPdf417SegmentsCount` indica al decoder quante parti aspettarsi. +- `MacroPdf417FileName` è opzionale ma utile per un'identificazione leggibile dall'uomo. + +## Passo 4: Impostare metadati macro aggiuntivi + +Oltre alle informazioni di base del file, la specifica consente campi extra come checksum, dimensione del file, timestamp, destinatario, mittente e un flag terminatore. Popolare questi campi migliora l'integrità dei dati e la tracciabilità. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +- `MacroPdf417Checksum` fornisce un checksum CCITT a 16 bit per l'intero file; il decoder può verificare l'integrità dopo la ricostruzione. +- `MacroPdf417FileSize` dovrebbe riflettere il conteggio esatto dei byte del file originale; valori superiori a `2^31‑1` richiedono un campo a 64 bit, che Aspose gestisce automaticamente. +- `MacroPdf417TimeStamp` registra quando il codice a barre è stato generato. Usa UTC per evitare ambiguità di fuso orario. +- `MacroPdf417Addressee` e `MacroPdf417Sender` sono stringhe libere che possono contenere informazioni di instradamento. +- `MacroPdf417Terminator` segnala che questo è il segmento finale; impostalo su `Set` per l'ultimo pezzo, altrimenti lascia il valore predefinito (`NotSet`). + +**Suggerimento per casi limite** – Se la dimensione del tuo file supera i 4 GB, suddividi il contenuto in più segmenti macro e regola `SegmentsCount` di conseguenza. La libreria gestirà il campo di grandi dimensioni senza overflow. + +## Passo 5: Salvare il codice a barre come immagine PNG + +L'ultimo passaggio scrive il simbolo generato su disco. PNG preserva le dimensioni esatte dei pixel ed è ampiamente supportato dall'hardware di scansione. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Sostituisci `YOUR_DIRECTORY` con un percorso assoluto o relativo a cui il processo in esecuzione può scrivere. L'enum `BarCodeImageFormat.Png` garantisce un output senza perdita. + +**Perché PNG?** – I formati raster come PNG mantengono i bordi dei moduli nitidi, il che è essenziale per gli scanner che si basano su bordi ad alto contrasto. Se ti serve un formato vettoriale, Aspose supporta anche `Pdf` e `Svg`. + +## Esempio completo eseguibile + +Di seguito trovi il programma completo che puoi copiare in un'applicazione console. Include le direttive `using` necessarie e un metodo `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Output previsto + +Eseguendo il programma viene creato un file chiamato **MacroPdf417.png** nella directory di lavoro del progetto. Aprendo l'immagine si vede un codice a barre PDF417 compatto con i campi macro incorporati. Scansionando l'immagine con un lettore compatibile PDF417 (ad es., ZXing, decoder Aspose.BarCode) si ottiene il payload originale `"Sample text"` insieme ai metadati macro. + +## Domande comuni e risoluzione dei problemi + +| Question | Answer | +|----------|--------| +| *Cosa fare se il codice a barre è troppo grande per l'etichetta target?* | Riduci `XDimension.Pixels` o aumenta `Pdf417.Columns`. Entrambi i parametri influenzano le dimensioni complessive. | +| *Posso generare un'immagine vettoriale invece di PNG?* | Sì. Chiama `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` per un output scalabile. | +| *Come verificare il checksum dopo la scansione?* | Il decoder Aspose.BarCode valida automaticamente `MacroPdf417Checksum` e segnala le discrepanze nell'oggetto `MacroPdf417Result`. | +| *La libreria è compatibile con .NET Core?* | Il pacchetto NuGet supporta .NET Standard 2.0+, che copre .NET Core, .NET 5, .NET 6 e versioni successive. | +| *Cosa fare se devo incorporare dati binari invece di testo?* | Converti il payload binario in Base64 o utilizza la sovraccarico `EncodeTypes.MacroPdf417` che accetta un array di byte. | + +## Suggerimenti professionali per l'uso in produzione + +* **Cache the generator** – + +## Cosa dovresti imparare dopo? + +I seguenti tutorial coprono argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo passo per aiutarti a padroneggiare funzionalità API aggiuntive ed esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [Come creare un codice a barre – PDF417 compatto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Come leggere un codice a barre da PDF in Java usando Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Creare Codabar Barcode con Aspose.Barcode – API Generator & Reader](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/net/compact-pdf417-encoding/_index.md b/barcode/japanese/net/compact-pdf417-encoding/_index.md index 0f07925be..3dc486389 100644 --- a/barcode/japanese/net/compact-pdf417-encoding/_index.md +++ b/barcode/japanese/net/compact-pdf417-encoding/_index.md @@ -144,6 +144,21 @@ Compact PDF417 の高いデータ密度と堅牢なエラー訂正により、 ### [Compact PDF417 バーコードの作成](./compact-pdf417-basic-configuration/) Aspose.BarCode for .NET を使用して Compact PDF417 バーコードを生成する方法を学びます。ステップバイステップの手順とコード例を含む包括的なガイドです。 +### [C# で PDF417 バーコードを生成し、サイズを設定する方法](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +C# で PDF417 バーコードを生成し、サイズをカスタマイズする手順を解説します。 + +### [C# でマイクロ PDF417 バーコードを作成する方法 – ステップバイステップガイド](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Aspose.BarCode for .NET を使用して、C# でマイクロ PDF417 バーコードを作成する手順を詳しく解説します。 + +### [Macro PDF417 用 C# バーコードジェネレータの使い方](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Aspose.BarCode for .NET を使用して、Macro PDF417 バーコードを C# で生成する手順を解説します。 + +### [C# で PDF417 バーコードを読み取る方法 – 完全ガイド](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Aspose.BarCode for .NET を使用して、C# で PDF417 バーコードをスキャンし、データを抽出する手順を詳しく解説します。 + +### [C# で PDF417 バーコードを作成し、PNG として保存する方法](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Aspose.BarCode for .NET を使用して、C# で PDF417 バーコードを生成し PNG 形式で保存する手順を解説します。 + ## よくある質問 **Q: Compact PDF417 バーコードに保存できる最大データ量はどれくらいですか？** diff --git a/barcode/japanese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/japanese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..05c066c07 --- /dev/null +++ b/barcode/japanese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,211 @@ +--- +category: general +date: 2026-08-22 +description: C#でマイクロPDF417バーコードを作成し、バーコードのPNG画像を生成する方法を学びます。バーコードのサイズ設定とファイルの保存が含まれます。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: ja +lastmod: 2026-08-22 +og_description: C#でマイクロPDF417バーコードを作成し、PNGとしてエクスポートします。このガイドに従ってバーコードのサイズを設定し、素早くバーコード画像を生成しましょう。 +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: C#でマイクロPDF417バーコードを作成する – 完全コーディングチュートリアル +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: C#でマイクロPDF417バーコードを作成する方法 – ステップバイステップガイド +url: /ja/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# でマイクロ PDF417 バーコードを作成する方法 – ステップバイステップガイド + +チケットシステム、在庫ラベル、モバイルスキャン用に **マイクロ PDF417 バーコードを作成** する必要がある場合、本チュートリアルで手順をすべて解説します。バーコード PNG を生成する完全な C# プログラムを確認し、バーコードのサイズ設定方法や各構成オプションの意味を理解できます。 + +このガイドを終えると、高解像度のバーコード画像を生成し、X‑ディメンションをカスタマイズし、列数を選択し、数行のコードで PNG ファイルとして保存できるようになります。 + +## 必要なもの + +- .NET 6.0 SDK 以降（コードは .NET Core と .NET Framework でも動作します） +- Visual Studio 2022 または任意の C# 対応 IDE +- **Aspose.BarCode for .NET** NuGet パッケージ（または `EncodeTypes.MicroPdf417` をサポートする任意のライブラリ） +- C# の基本的な文法に関する知識 + +> **プロのコツ:** Aspose.BarCode の無料コミュニティエディションで開発・テストは十分可能です。製品版ではライセンスを取得して評価版の透かしを除去してください。 + +## 手順 1: バーコードライブラリをインストール + +プロジェクトフォルダーでターミナルを開き、次のコマンドを実行します。 + +```bash +dotnet add package Aspose.BarCode +``` + +これにより `Aspose.BarCode` アセンブリが追加され、**C# でバーコード画像を作成** する際に使用する `BarcodeGenerator` クラスが利用可能になります。 + +## 手順 2: ジェネレータを初期化 – マイクロ PDF417 バーコードを作成 + +最初の実行行で、Micro PDF417 シンボロジー用に設定された `BarcodeGenerator` インスタンスを作成し、エンコードしたいデータを渡します。 + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*重要ポイント*: `EncodeTypes.MicroPdf417` 列挙体は、コンパクト版 PDF417 を使用するようライブラリに指示します。小さなラベルやモバイル画面に最適です。 + +## 手順 3: C# でバーコードのサイズを設定する方法 + +モジュール幅（X‑ディメンション）を微調整すると、バーコードの視覚的密度が変わります。値が小さいほど画像はシャープになり、値が大きいほど遠距離でも読み取りやすくなります。 + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **サイズ設定の理由**: X‑ディメンションを調整しないと、デフォルト値のままで高 DPI で描画した際にぼやけたバーコードになることがあります。多くの画面ベースのスキャンでは 2 ピクセルがバランスの良い設定です。 + +## 手順 4: 列数を選択 – バーコード幅の調整 + +Micro PDF417 は 1〜4 列をサポートします。列数を増やすとデータが横方向に圧縮され、画像全体の幅が小さくなります。 + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*エッジケース*: 5 列を指定するとライブラリは `ArgumentOutOfRangeException` をスローします。必ずドキュメントに記載された範囲内で設定してください。 + +## 手順 5: バーコード PNG を生成 – 画像の保存 + +生成したバーコードを PNG ファイルとしてエクスポートします。PNG はロスレス品質を保持するため、信頼性の高いスキャンに必須です。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +プログラムを実行すると、コンソールにファイル保存場所が表示されます。生成された `MicroPdf417.png` は次のようになります： + +![C# で生成されたマイクロ PDF417 バーコードのスクリーンショット](micro-pdf417-example.png "生成されたマイクロ PDF417 バーコード") + +*画像の代替テキスト*: **C# で生成されたマイクロ PDF417 バーコード** – サイズと列設定を適用した最終出力を示しています。 + +## 手順 6: 実行して出力を確認 + +1. プロジェクトをビルド: `dotnet build` +2. 実行: `dotnet run` +3. デスクトップ上の `MicroPdf417.png` を開き、モバイル用バーコードスキャナアプリで読み取る + +テキスト **“Sample text”** がデコードされれば成功です。スキャナがエラーを返す場合は、X‑ディメンションと列数を再確認してください。極端な値は一部デバイスでバーコードが密すぎて読み取れなくなることがあります。 + +## よくあるバリエーションとトラブルシューティング + +| 状況 | 調整方法 | +|-----------|------------| +| **低解像度プリンタ向けにバーコードを大きくしたい** | `XDimension.Pixels` を 3 または 4 に増やす | +| **幅は変えずにバーコードを縦長にしたい** | `generator.Parameters.Barcode.Pdf417.Rows` を設定（行数は 3‑90 の範囲） | +| **ループで複数のバーコードを生成したい** | 同じ `BarcodeGenerator` インスタンスを再利用し、`Save` 前に `CodeText` だけを変更 | +| **PNG ではなく JPEG で保存したい** | `BarCodeImageFormat.Png` を `BarCodeImageFormat.Jpeg` に置き換える | +| **.NET Framework 4.7 上で実行する場合** | 同一コードで動作します。適切な `Aspose.BarCode.dll` を参照してください | + +## 完全なソースリスト（実行可能） + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**期待される出力** – 200 × 100 ピクセルの PNG ファイルで、鮮明な Micro PDF417 バーコードが「Sample text」にデコードされます。 + +## 結論 + +これで C# で **マイクロ PDF417 バーコードを作成** し、**バーコードのサイズを設定**、**バーコード PNG 画像を生成** する方法が分かりました。ライブラリのインストールから最終ファイルの保存までの全手順を示した完全なサンプルなので、独自アプリケーションにバーコード生成機能を組み込む際の参考にしてください。 + +次は **Aspose.BarCode で QR コードを作成**、**色のカスタマイズ**、**PDF 文書へのバーコード埋め込み** など、ここで学んだ `BarcodeGenerator` の基礎を応用できるトピックを探求してみましょう。 + +さまざまなデータ文字列、列数、X‑ディメンションを試して、使用環境に最適な設定を見つけてください。コーディングを楽しんでください！ + +## 次に学ぶべきこと + +以下のチュートリアルは、本ガイドで示した手法を基にした関連トピックを扱っています。各リソースには、ステップバイステップの解説と完全なコード例が含まれているので、API の追加機能をマスターしたり、別の実装アプローチを自分のプロジェクトに取り入れたりするのに役立ちます。 + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/japanese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..d10c0654d --- /dev/null +++ b/barcode/japanese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,196 @@ +--- +category: general +date: 2026-08-22 +description: C#でバーコードジェネレータを使用してPDF417バーコードを作成し、レイアウトを設定してPNGとして保存する方法を学びます。完全なコードと、バーコードジェネレータC#プロジェクト向けのヒントが含まれています。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: ja +lastmod: 2026-08-22 +og_description: バーコードジェネレータを使用してC#でPDF417バーコードを作成し、レイアウトをカスタマイズし、PNGの保存方法を学びましょう。ステップバイステップのチュートリアルに従ってください。 +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: C#でPDF417バーコードを作成 – PNG生成と保存の完全ガイド +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: C#でPDF417バーコードを作成し、PNGとして保存する方法 +url: /ja/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#でPDF417バーコードを作成し、PNGとして保存する方法 + +C# アプリケーションで **PDF417 バーコードを作成** する必要がある場合、このチュートリアルでは正確な手順を示します。バーコードジェネレータ C# ライブラリが任意の文字列をスキャン可能な PDF417 画像に変換し、追加ツールなしで PNG ファイルを保存する方法が分かります。 + +バーコードの生成は物流、チケット発行、文書管理で一般的です。このガイドの最後までに、選択したフォルダーに `Pdf417Layout.png` という名前の PNG ファイルを生成する実行可能なコンソールプログラムが完成します。 + +## 前提条件 + +- .NET 6.0 SDK 以上がインストールされていること（コードは .NET Framework 4.7 以降でも動作します）。 +- Visual Studio 2022 または C# プロジェクトをビルドできるエディタ。 +- **Aspose.BarCode for .NET** NuGet パッケージ（または互換性のあるバーコードジェネレータ C# ライブラリ）。 + 以下でインストールします： + +```bash +dotnet add package Aspose.BarCode +``` + +ジェネレータが直接 PNG を書き出せるため、追加の画像処理ライブラリは必要ありません。 + +## 手順 1: 新しいコンソールプロジェクトを設定する + +例が自己完結するように、新しいコンソールプロジェクトを作成します。 + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` フォルダーには、バーコードコードを記述する `Program.cs` ファイルが含まれています。 + +## 手順 2: バーコード名前空間をインポートする + +`Program.cs` を開き、先頭に必要な `using` ディレクティブを追加します： + +```csharp +using Aspose.BarCode.Generation; +``` + +この名前空間により、**PNG の保存方法** に必要な `BarcodeGenerator`、`EncodeTypes`、画像フォーマット列挙型にアクセスできます。 + +## 手順 3: PDF417 バーコードジェネレータを作成する + +**PDF417 の生成方法** の核心は `BarcodeGenerator` クラスです。エンコードタイプ `EncodeTypes.Pdf417` とエンコードしたいテキストを渡します。 + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` は現在、バーコードのすべての設定を保持しています。デフォルトのレイアウトでも機能しますが、次の手順でカスタマイズします。 + +## 手順 4: バーコードレイアウト（列と行）を定義する + +PDF417 では列数（2‑30）と行数（1‑90）を制御できます。これらの値を調整すると、特定のスキャナ向けの可読性が向上します。 + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **プロのコツ:** これらの設定を省略すると、ライブラリが自動的に最適な値を選択します。ただし、列と行を固定すると画像サイズが予測可能になり、PNG を PDF や UI レイアウトに埋め込む際に便利です。 + +## 手順 5: 生成したバーコードを PNG 画像として保存する + +`Save` を呼び出すことで **PNG の保存方法** に答えます。このメソッドは保存先パスと画像フォーマット列挙型を受け取ります。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +プログラムを実行すると、ファイル `Pdf417Layout.png` がプロジェクトの `bin/Debug/net6.0` フォルダーに生成されます。 + +## 完全な実行可能サンプル + +以下は完全な `Program.cs` ファイルです。**手順 1** で作成したプロジェクトにコピーし、`dotnet run` を実行してください。 + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### 期待される出力 + +プログラムを実行すると、コンソールに PNG ファイルへの絶対パスが表示され、ファイルには以下の画像に似たはっきりした PDF417 バーコードが含まれます。 + +![PDF417 バーコード作成例](image-placeholder.png "PNG として保存された PDF417 バーコード") + +任意の PDF417 対応スキャナ（モバイルアプリ、ハードウェアリーダー）で PNG をスキャンすれば、エンコードされたテキストが `"Sample"` であることを確認できます。 + +## エッジケースと一般的な落とし穴の対処 + +| 状況 | 注意点 | 推奨される対策 | +|-----------|-------------------|-----------------| +| **無効な列/行の値** | 2‑30（列）または 1‑90（行）の範囲外の値は `ArgumentException` を引き起こします。 | 割り当てる前にユーザー入力を検証するか、ライブラリにデフォルトを選択させてください。 | +| **長い入力文字列** | PDF417 は最大 1,850 文字までエンコードできますが、非常に長い文字列は必要な行数を大幅に増加させます。 | データを複数のバーコードに分割するか、必要に応じてエラー訂正レベルを上げてください。 | +| **ファイルシステムの権限** | 読み取り専用フォルダーに保存しようとすると `UnauthorizedAccessException` がスローされます。 | `Environment.CurrentDirectory` またはユーザーが書き込み可能なパスに保存し、例外は try/catch で処理してください。 | +| **NuGet パッケージが欠如** | “type or namespace name could not be found” というエラーでコンパイルが失敗します。 | `Aspose.BarCode` がインストールされていることを確認してください（`dotnet add package Aspose.BarCode`）。 | + +## サンプルの拡張 + +これで **PDF417 バーコードの作成方法** と **PNG の保存方法** が分かったので、以下の関連トピックを探求できます： + +- **Barcode generator C#**: `EncodeTypes` を `Code128`、`QR`、その他のシンボルに変更します。 +- **カスタムカラー**: `generator.Parameters.Barcode.ForegroundColor` と `BackgroundColor` を使用してブランドに合わせます。 +- **PDF への埋め込み**: PNG を PDF ライブラリ（例: iText7）と組み合わせて印刷可能な文書を作成します。 +- **動的データ**: データベースやユーザー入力からテキストを取得し、リアルタイムでバーコードを生成します。 + +## 結論 + +これで C# で **PDF417 バーコードを作成** し、結果を PNG ファイルとして保存する完全な本番対応ソリューションが手に入りました。このチュートリアルでは、プロジェクトのセットアップからレイアウトのカスタマイズまでのすべての手順をカバーし、バーコードジェネレータ C# ライブラリ使用時の一般的なエラー回避方法も示しました。 + +さまざまな列/行設定やカラー、あるいは他のバーコード形式で実験してみてください。問題が発生した場合は **PDF417 の生成方法** のセクションを再確認するか、ライブラリのドキュメントで高度な機能を調べてみてください。コーディングを楽しんで！ + +## 次に学ぶべきことは？ + +以下のチュートリアルは、本ガイドで示した手法を基にした密接に関連するトピックをカバーしています。各リソースには、ステップバイステップの解説と完全な動作コード例が含まれており、追加の API 機能を習得し、プロジェクトで代替実装アプローチを探求するのに役立ちます。 + +- [バーコード作成方法 – Aspose.BarCode を使用したコンパクト PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [PDF417 バーコード生成方法 – コンパクト PDF417 エンコーディング](/barcode/english/net/compact-pdf417-encoding/) +- [Aspose.BarCode for .NET を使用した ITF-14 の静音領域作成方法](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/japanese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..0ac610f54 --- /dev/null +++ b/barcode/japanese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,221 @@ +--- +category: general +date: 2026-08-22 +description: Aspose.BarCode を使用して C# で PDF417 バーコードを生成し、バーコードのサイズを設定し、列を調整し、コンパクトモードを有効にする方法を学びましょう。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: ja +lastmod: 2026-08-22 +og_description: Aspose.BarCode を使用して C# で PDF417 バーコードを生成します。このガイドでは、バーコードのサイズ設定、列数の制御、そして小さい画像のためにコンパクトモードを有効にする方法を示します。 +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: C#でPDF417バーコードを生成 – サイズ、列数、コンパクトモードを設定 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: C#でPDF417バーコードを生成し、バーコードのサイズを設定する方法 +url: /ja/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# で PDF417 バーコードを生成し、バーコードサイズを設定する方法 + +If you need to **generate PDF417 barcode** in a .NET application, this guide walks you through the complete process. You’ll see exactly **how to generate PDF417** with Aspose.BarCode, adjust the **set barcode size**, and produce a compact PNG that can be embedded in reports or mobile apps. + +.NET アプリケーションで **PDF417 バーコードを生成** する必要がある場合、このガイドではプロセス全体を順を追って説明します。Aspose.BarCode を使用して **PDF417 を生成** する方法、**バーコードサイズを設定** する方法、そしてレポートやモバイルアプリに埋め込めるコンパクトな PNG の作成方法が分かります。 + +Creating a barcode doesn’t require a separate graphics editor. By the end of this tutorial you will have a fully functional C# method that produces a PDF417 image with the exact dimensions you need, ready for downstream processing. + +バーコードの作成には別途のグラフィックエディタは不要です。このチュートリアルの最後までに、必要な正確なサイズの PDF417 画像を生成する完全な C# メソッドが手に入り、以降の処理にすぐ使えるようになります。 + +## 学べること + +* Aspose.BarCode ライブラリをインストールし、参照する。 +* PDF417 バーコードジェネレータを作成し、エンコードするテキストを指定する。 +* **バーコードサイズを設定** は X‑dimension と列数を構成して行う。 +* コンパクト（トランケート）モードを有効にしてシンボルを縮小する。 +* 結果を PNG ファイルとして保存する。 +* 読み取り不能なコードやサイズが大きすぎる画像など、一般的な問題のトラブルシューティングを行う。 + +### 前提条件 + +* .NET 6.0 以降（API は .NET Framework 4.6+ でも動作します）。 +* C# と Visual Studio（または任意の C# IDE）に関する基本的な知識。 +* 有効な Aspose.BarCode ライセンス（無料評価版はテストに使用可能）。 + +> **プロのコツ:** ループで多数のバーコードを生成する場合、単一の `BarcodeGenerator` インスタンスを再利用し、`CodeText` プロパティだけを変更してください。これによりメモリ割り当てが削減されます。 + +## Aspose.BarCode で PDF417 バーコードを生成する + +The first step is to instantiate the `BarcodeGenerator` for the PDF417 symbology. This object is the entry point for all barcode operations. + +最初のステップは PDF417 シンボロジー用に `BarcodeGenerator` をインスタンス化することです。このオブジェクトがすべてのバーコード操作のエントリーポイントになります。 + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*重要な理由*: `EncodeTypes.Pdf417` はライブラリに PDF417 標準を使用させることを示し、大量のデータとエラー訂正をサポートします。コンストラクタはエンコードしたいデータも受け取るため、後で別途 `CodeText` を設定する必要がなくなります。 + +## バーコードサイズと列数の設定 + +PDF417 symbols consist of rows and columns of small rectangular modules. Controlling the module width (X‑dimension) and the number of columns lets you fine‑tune the overall dimensions. + +PDF417 シンボルは小さな長方形モジュールの行と列で構成されています。モジュール幅（X‑dimension）と列数を制御することで、全体のサイズを細かく調整できます。 + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*説明*: +* **X‑dimension** (`Pixels`) は各モジュールの幅を決定します。小さい値はバーコードをコンパクトにし、大きい値は低解像度スキャナでの読み取りやすさを向上させます。 +* **Columns** は横方向のレイアウトを制御します。列数が少ないとバーコードが縦長になり、列数が多いと横長になります。これら二つの設定を組み合わせて、必要な **バーコードサイズを設定** してください。 + +## 小さなバーコードのためにコンパクトモードを有効にする + +PDF417 includes a “compact” (or truncated) mode that removes unnecessary padding and reduces the overall footprint. This is especially useful when you have limited screen real estate. + +PDF417 には不要な余白を削除し、全体の占有領域を減らす “コンパクト”（またはトランケート）モードがあります。画面スペースが限られている場合に特に有用です。 + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*なぜトランケーションを有効にするのか？* +`Truncate` が `true` の場合、ジェネレータはストップパターンと、ほとんどのスキャンシナリオで不要なエラー訂正コードワードを省略します。その結果、画像は約 15‑20 % 小さくなり、典型的な使用ケースでデータの完全性を損なうことはありません。 + +## バーコードを PNG 画像として保存する + +After configuring size and mode, write the barcode to disk. PNG is lossless, ensuring that the module edges remain sharp. + +サイズとモードを設定したら、バーコードをディスクに書き出します。PNG はロスレス形式で、モジュールのエッジが鮮明に保たれます。 + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +The file `CompactPdf417.png` will contain a crisp PDF417 symbol that matches the dimensions you set in the previous steps. + +ファイル `CompactPdf417.png` には、前のステップで設定した寸法に一致する鮮明な PDF417 シンボルが含まれます。 + +### 期待される出力 + +Opening the saved PNG should display a vertical‑oriented PDF417 barcode consisting of three columns, each module 2 px wide, and a total size of roughly **120 × 240 px** (width × height). Scanning the image with any standard PDF417 reader returns the original text “Sample text for PDF417”. + +保存した PNG を開くと、縦向きの PDF417 バーコードが表示されます。3 列で構成され、各モジュールは 2 px の幅、全体サイズはおおよそ **120 × 240 px**（幅 × 高さ）です。標準的な PDF417 リーダーで画像をスキャンすると、元のテキスト “Sample text for PDF417” が取得されます。 + +## よくある落とし穴と回避方法 + +| 症状 | 考えられる原因 | 対策 | +|---------|--------------|-----| +| バーコードが読み取れない | スキャナに対して X‑dimension が小さすぎる | `XDimension.Pixels` を 3 または 4 に増やす | +| 画像が UI に対して幅が広すぎる | 列数が多すぎる | `Pdf417.Columns` を減らすか、`Truncate` を有効にする | +| 例外 `ArgumentOutOfRangeException` | 列数が負またはゼロ | `Columns` が正の整数（最小 1）であることを確認する | +| PNG ファイルが空 | 出力パスが存在しない、または書き込み権限がない | ディレクトリが存在し、アプリに書き込み権限があるか確認する | + +> **プロのコツ:** `Save()` を呼び出す前に `barcodeGenerator.ValidateParameters()` を使用して、設定エラーを早期に検出してください。 + +## 完全な実行可能サンプル + +Below is a self‑contained console program that incorporates all the steps above. Copy it into a new C# project, restore the Aspose.BarCode NuGet package, and run it to see the result. + +以下は上記すべての手順を組み込んだ単体のコンソールプログラムです。新しい C# プロジェクトにコピーし、Aspose.BarCode の NuGet パッケージを復元して実行すると結果が確認できます。 + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**プログラムを実行**すると、実行ファイルの作業ディレクトリに `CompactPdf417.png` が生成されます。モバイルアプリ（例: “Barcode Scanner”）で画像をスキャンし、エンコードされたテキストが元の文字列と一致することを確認してください。 + +## 次のステップと関連トピック + +* **エラー訂正レベルを上げる** – ノイズの多いスキャン環境向けに `Pdf417.ErrorLevel` を調整します。 +* **向きの変更** – 横向きレイアウトが必要な場合は `Pdf417.Rotate` を `RotationAngle.Rotate90` に設定します。 +* **PDF にバーコードを埋め込む** – Aspose.PDF と Aspose.BarCode を組み合わせて、画像を直接ドキュメントに配置します。 +* **他の 2 次元バーコードを生成** – 同じ `BarcodeGenerator` クラスは DataMatrix、QR、Aztec コードもサポートしています。目的のシンボロジーに合わせて `EncodeTypes.Pdf417` を置き換えるだけです。 + +By mastering **generate PDF417 barcode** techniques, you can automate ticketing, inventory labeling, and secure data transmission across a wide range of .NET applications. + +**PDF417 バーコード生成** の技術を習得すれば、チケット発行、在庫ラベリング、データの安全な送信などを幅広い .NET アプリケーションで自動化できます。 + +## 結論 + +You now know how to **generate PDF417 barcode** in C#, precisely **set barcode size**, configure columns, enable compact mode, and save the result as a PNG. Apply these settings to fit any UI constraint or scanning requirement, and extend the approach to other barcode formats as needed. Happy coding! + +これで C# で **PDF417 バーコードを生成** し、正確に **バーコードサイズを設定**、列数を構成し、コンパクトモードを有効にして PNG として保存する方法が分かりました。これらの設定を使用して UI の制約やスキャン要件に合わせ、必要に応じて他のバーコード形式にも応用してください。コーディングを楽しんでください！ + +## 次に学ぶべきことは？ + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +以下のチュートリアルは本ガイドで示した手法を基にした、密接に関連するトピックを扱っています。各リソースには完全な動作コード例とステップバイステップの解説が含まれ、追加の API 機能を習得し、プロジェクトで代替実装アプローチを検討するのに役立ちます。 + +- [PDF417 バーコードの生成 – コンパクト PDF417 エンコーディング](/barcode/english/net/compact-pdf417-encoding/) +- [バーコードの作成 – Aspose.BarCode を使用したコンパクト PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Aspose.BarCode for .NET を使用した DataMatrix バーコード生成 – ステップバイステップガイド](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/japanese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..bad08c4f8 --- /dev/null +++ b/barcode/japanese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-08-22 +description: C#でPDF417バーコードを読み取る方法：ステップバイステップのガイドで、画像から複数のバーコードを読み取る方法とMacroPdf417の詳細を抽出する方法をカバーしています。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: ja +lastmod: 2026-08-22 +og_description: C#でPDF417バーコードを素早く読み取る方法。このチュートリアルでは、画像から複数のバーコードを読み取り、MacroPdf417の拡張情報を取得する方法を紹介します。 +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: C#でPDF417バーコードを読み取る方法 – 完全なプログラミングウォークスルー +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: C#でPDF417バーコードを読み取る方法 – 完全ガイド +url: /ja/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# で PDF417 バーコードを読む方法 – 完全ガイド + +.NET アプリケーションで **PDF417 の読み取り方法** が必要な場合、このチュートリアルはすぐに実行できるソリューションを提供します。単一画像から複数のバーコードを読み取り、完全な MacroPdf417 データセットを抽出し、コンソールに表示する方法を学びます。このアプローチは Aspose.BarCode for .NET ライブラリで動作し、数行のコードだけで実装できます。 + +画像からバーコードを読み取ることは、在庫管理システム、チケット検証、文書管理などで一般的なタスクです。本ガイドの最後までに、任意の PDF417 または MacroPdf417 バーコードをデコードし、1 枚の画像内の複数コードを処理し、MacroPdf417 が提供する拡張フィールドを理解できるようになります。 + +## 前提条件 + +- .NET 6.0 SDK 以上（コードは .NET Framework 4.7+ でもコンパイル可能） +- Visual Studio 2022 またはお好みの C# エディタ +- Aspose.BarCode for .NET NuGet パッケージ（`Install-Package Aspose.BarCode`） +- MacroPdf417 バーコードを含むサンプル画像（例：`MacroPdf417.png`） + +追加の設定は不要です。ライブラリが画像の読み込みとデコードを内部で処理します。 + +## C# で画像から PDF417 バーコードを読む方法 + +ソリューションの核心は `BarCodeReader` クラスです。画像を開き、指定したタイプのすべてのバーコードを検出し、`BarCodeResult` オブジェクトのコレクションを返します。以下のコードは完全なコンソールプログラムを示しています。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### 各行の重要ポイント + +| ステップ | 目的 | +|------|---------| +| **1️⃣ Initialize** | 画像ファイルにバインドされた `BarCodeReader` を作成し、検出を MacroPdf417 シンボルに限定することで処理速度を向上させます。 | +| **2️⃣ Iterate** | `ReadBarCodes()` は要求されたタイプに一致する **すべて** のバーコードを返すため、余分なループなしで **複数のバーコードを読み取る** ことができます。 | +| **3️⃣ Basic output** | 汎用的な `CodeTypeName` と人間が読める `CodeText` を表示します。ログ記録や簡易検証に便利です。 | +| **4️⃣ Extended data** | MacroPdf417 は追加メタデータ（ファイル ID、セグメント数、タイムスタンプ等）を保持します。`Extended.Pdf417` オブジェクトは各フィールドを直接公開するので、データパケット全体を保存または検証できます。 | + +有効な MacroPdf417 画像に対してプログラムを実行すると、以下のようなコンソール出力が得られます。 + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +この出力により、ライブラリがバーコードを正常に読み取り、テキストを抽出し、すべての MacroPdf417 フィールドを提供したことが確認できます。 + +## 1 枚の画像から複数のバーコードを読む + +実際のシナリオでは、1 つのラベルに複数の PDF417 シンボルが配置されることがよくあります。たとえば、運送業者コード、追跡番号、税関申告書が同じラベルに含まれる場合です。上記のコードブロックは既に `ReadBarCodes()` がすべての一致を列挙するため、**複数のバーコードを読み取ります**。追加設定は不要で、結果をループするだけです（例示参照）。 + +標準の PDF417（マクロなし）に限定しつつ複数コードを処理したい場合は、`DecodeType.MacroPdf417` を `DecodeType.Pdf417` に置き換えてください。残りのロジックは変更不要です。 + +## MacroPdf417 拡張データの理解 + +MacroPdf417 は通常の PDF417 仕様の拡張版です。大容量ペイロードを複数のセグメントに分割し、全体ファイルを記述する小さなヘッダーを付加します。主なフィールドは次のとおりです。 + +- **MacroPdf417FileID** – 同一ファイルのすべてのセグメントで共有される一意の識別子。 +- **MacroPdf417SegmentID** – 現在のセグメントのシーケンス番号。 +- **MacroPdf417SegmentsCount** – 期待される総セグメント数。 +- **MacroPdf417FileName** – バーコードと共に送信されるオプションのファイル名。 +- **MacroPdf417Checksum** – 完全ファイルのエラーチェック値。 +- **MacroPdf417FileSize** – 元のバイナリペイロードのサイズ。 +- **MacroPdf417TimeStamp** – バーコード生成時の ISO‑8601 タイムスタンプ。 +- **MacroPdf417Addressee / Sender** – ルーティング用のオプションテキストフィールド。 +- **MacroPdf417Terminator** – このセグメントが最終かどうかを示すフラグ。 + +すべてのセグメントを受け取ったら、`MacroPdf417SegmentID` で順序付けし、`CodeText` の値を連結して元のファイルを再構築できます。必要なフィールドが取得できれば、このロジックは簡単に実装可能です。 + +## よくある落とし穴とプロのコツ + +- **Image quality matters** – 低解像度または過度に圧縮された PNG/JPEG は検出漏れの原因となります。印刷されたバーコードは最低 300 dpi を使用してください。 +- **Mixed symbologies** – 画像に MacroPdf417 と通常の PDF417 の両方が含まれる場合は、`DecodeType` ごとにリーダーを 2 つインスタンス化するか、`DecodeType.AllSupported` を使用して `result.CodeTypeName` で結果をフィルタリングします。 +- **Memory usage** – `using` 文で `BarCodeReader` を速やかに破棄し、大きな画像バッファがメモリに残らないようにします。 +- **Thread safety** – `BarCodeReader` はスレッドセーフではありません。並列で画像をデコードする場合は、スレッドごとに別インスタンスを作成してください。 +- **Error handling** – `ReadBarCodes()` 呼び出しを try/catch で囲み、破損画像に対しては `BarCodeException` を捕捉します。 + +## 完全動作例のまとめ + +以下は新しいコンソールプロジェクトにコピーできる完全プログラムです。`using` ディレクティブ、画像パス用定数、破棄パターンをすべて含んでいます。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +`dotnet build` でコンパイルし、`dotnet run` で実行してください。コンソールは各バーコードの基本データと完全な MacroPdf417 ペイロードを出力します。 + +## 次のステップ + +- **Reconstruct multipart files** – すべてのセグメントを収集し、`MacroPdf417SegmentID` でソートして `CodeText` を連結する + +## 次に学ぶべきことは？ + +以下のチュートリアルは、本ガイドで示した手法を基にした密接に関連するトピックをカバーしています。各リソースには完全な動作コード例とステップバイステップの解説が含まれており、追加の API 機能を習得し、独自プロジェクトで代替実装アプローチを探求するのに役立ちます。 + +- [PDF417 バーコードの生成方法 – コンパクト PDF417 エンコーディング](/barcode/english/net/compact-pdf417-encoding/) +- [Java でトルコ文字を含む PDF417 バーコードを読む方法](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Java で Aspose を使用した PDF417 バーコード（中国語）](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/japanese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..b5ac16dd2 --- /dev/null +++ b/barcode/japanese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: barcode generator C# チュートリアルでは、Aspose.BarCode を使用してメタデータ付きの Macro PDF417 + バーコードを作成し、PNG として保存する方法を示しています。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: ja +lastmod: 2026-08-22 +og_description: C# のバーコードジェネレーターを使用すると、フルファイルレベルのメタデータを持つ Macro PDF417 バーコードを生成し、PNG + としてエクスポートできます。このガイドに従ってソリューションを実装してください。 +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: バーコードジェネレーター C# – Macro PDF417 バーコードをステップバイステップで作成 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Macro PDF417 用のバーコードジェネレータ C# の使用方法 +url: /ja/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Macro PDF417 用の C# バーコードジェネレータの使用方法 + +ファイルレベルのメタデータを持つ Macro PDF417 シンボルを生成できる **barcode generator C#** が必要な場合、本ガイドは完全に実行可能なソリューションを提供します。バーコードの外観設定方法、ファイル ID やセグメント数といったマクロ情報の埋め込み方法、最終的に PNG 画像として保存する手順を確認できます。 + +この例では、フル PDF417 機能をサポートする広く採用されている **C# barcode library** の Aspose.BarCode を使用します。外部サービスは不要で、.NET 6 以降で動作します。 + +## 前提条件 + +開始する前に、以下がインストールされていることを確認してください。 + +* .NET 6 SDK（またはそれ以降のバージョン） +* Visual Studio 2022、VS Code、またはその他の C# IDE +* **Aspose.BarCode** への NuGet 参照（`dotnet add package Aspose.BarCode`） + +C# の基本構文と PDF417 バーコードの概念を理解していると手順がスムーズですが、チュートリアルではすべての設定項目を詳しく説明しています。 + +## チュートリアルでカバーする内容 + +* Macro PDF417 形式の **barcode generator C#** インスタンスの初期化 +* X‑dimension や列数などのビジュアルパラメータの調整 +* Macro PDF417 のファイルレベルフィールド（file ID、segment ID、segment count、file name、checksum、file size、timestamp、addressee、sender、terminator）の設定 +* 生成したシンボルを PNG ファイルとして保存 +* 大容量ファイルやカスタムタイムスタンプなどのエッジケースへの対処法 + +この記事を読み終えると、完全に準拠した Macro PDF417 バーコードを生成できる単体プログラムが手に入ります。 + +## 手順 1: barcode generator C# インスタンスの作成 + +最初の操作は、`EncodeTypes.MacroPdf417` 列挙値とエンコードしたいテキストを指定して `BarcodeGenerator` をインスタンス化することです。コンストラクタはペイロード文字列も受け取り、マクロバーコードのデータ部分となります。 + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**重要ポイント** – `EncodeTypes.MacroPdf417` フラグにより、Aspose.BarCode はシンボルをマクロバーコードとして扱い、以降の追加フィールドが有効になります。このフラグが無いと、通常の PDF417 バーコードが生成され、ファイルレベルのメタデータは含まれません。 + +## 手順 2: 基本的なバーコード外観の調整（PDF417 ビジュアル設定） + +信頼性の高いスキャンには視認性が重要です。一般的に調整するパラメータはモジュール幅（`XDimension`）と列数です。これらの値を設定することで、サイズと可読性のバランスを取ります。 + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` は各黒/白バーの幅を制御します。**2** の値は多くのラベルプリンタで適切です。 +* `Pdf417.Columns` はバーコードが使用する列数を定義します。5 列にすると、データ容量を犠牲にせずコンパクトなシンボルが得られます。 + +## 手順 3: Macro PDF417 のファイルレベル情報の定義 + +Macro PDF417 は、巨大ファイルを複数のバーコードセグメントに分割する方法を記述するフィールドを標準 PDF417 に追加します。これらのフィールドを設定することで、スキャナ側で元ファイルを正しく再構築できます。 + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` は同一論理ファイルに属するすべてのセグメントで同一である必要があります。 +* `MacroPdf417SegmentID` は **0** から `SegmentsCount‑1` までインクリメントします。 +* `MacroPdf417SegmentsCount` はデコーダに期待するセグメント数を伝えます。 +* `MacroPdf417FileName` は任意ですが、人間が識別しやすくなるため便利です。 + +## 手順 4: 追加のマクロメタデータの設定 + +コアとなるファイル情報に加えて、仕様ではチェックサム、ファイルサイズ、タイムスタンプ、宛先、送信者、ターミネータフラグといった余分なフィールドが許可されています。これらを設定すると、データの完全性とトレーサビリティが向上します。 + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` はファイル全体の 16 ビット CCITT チェックサムを提供し、デコーダは再構築後に整合性を検証できます。 +* `MacroPdf417FileSize` は元ファイルの正確なバイト数を示す必要があります。`2^31‑1` を超える場合は 64 ビットフィールドが使用され、Aspose が自動的に処理します。 +* `MacroPdf417TimeStamp` はバーコード生成時刻を記録します。タイムゾーンの曖昧さを避けるため、UTC を使用してください。 +* `MacroPdf417Addressee` と `MacroPdf417Sender` は自由形式文字列で、ルーティング情報などを格納できます。 +* `MacroPdf417Terminator` は最終セグメントであることを示します。最後のセグメントでは `Set` にし、そうでなければデフォルトの `NotSet` のままにします。 + +**エッジケースのヒント** – ファイルサイズが 4 GB を超える場合は、コンテンツを複数のマクロセグメントに分割し、`SegmentsCount` を適切に調整してください。ライブラリはオーバーフローなしで大容量フィールドを管理します。 + +## 手順 5: バーコードを PNG 画像として保存 + +最終ステップでは、生成したシンボルをディスクに書き出します。PNG はピクセル寸法を正確に保持し、スキャンハードウェアで広くサポートされています。 + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +`YOUR_DIRECTORY` を、実行プロセスが書き込み可能な絶対パスまたは相対パスに置き換えてください。`BarCodeImageFormat.Png` 列挙値により、ロスレス出力が保証されます。 + +**PNG を選ぶ理由** – PNG のようなラスタ形式はモジュールエッジを鋭く保ち、高コントラストエッジに依存するスキャナにとって重要です。ベクタ形式が必要な場合は、`Pdf` や `Svg` も Aspose がサポートしています。 + +## 完全に実行可能なサンプル + +以下はコンソールアプリケーションにコピーできる完全プログラムです。必要な `using` ディレクティブと `Main` メソッドを含んでいます。 + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### 期待される出力 + +プログラムを実行すると、プロジェクトの作業ディレクトリに **MacroPdf417.png** という名前のファイルが作成されます。画像を開くと、埋め込まれたマクロフィールドを含むコンパクトな PDF417 バーコードが表示されます。PDF417 対応リーダー（例: ZXing、Aspose.BarCode デコーダ）でスキャンすると、元の `"Sample text"` ペイロードとマクロメタデータが取得できます。 + +## よくある質問とトラブルシューティング + +| 質問 | 回答 | +|----------|--------| +| *バーコードが対象ラベルに対して大きすぎる場合は？* | `XDimension.Pixels` を減らすか、`Pdf417.Columns` を増やしてください。両方のパラメータが全体サイズに影響します。 | +| *PNG ではなくベクタ画像を生成したい場合は？* | `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` を呼び出すとスケーラブルな出力が得られます。 | +| *スキャン後にチェックサムを検証する方法は？* | Aspose.BarCode デコーダは自動的に `MacroPdf417Checksum` を検証し、`MacroPdf417Result` オブジェクトで不一致を報告します。 | +| *ライブラリは .NET Core と互換性がありますか？* | NuGet パッケージは .NET Standard 2.0+ をサポートしており、.NET Core、.NET 5、.NET 6 以降で使用可能です。 | +| *テキストではなくバイナリデータを埋め込みたい場合は？* | バイナリペイロードを Base64 に変換するか、バイト配列を受け取る `EncodeTypes.MacroPdf417` のオーバーロードを使用してください。 | + +## 本番環境でのプロ向けヒント + +* **Cache the generator** – + +## 次に学ぶべきこと + +以下のチュートリアルは、本ガイドで示したテクニックを基にした関連トピックを扱っています。各リソースには、ステップバイステップの解説と完全なコード例が含まれており、API の追加機能習得や代替実装アプローチの探索に役立ちます。 + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/net/compact-pdf417-encoding/_index.md b/barcode/korean/net/compact-pdf417-encoding/_index.md index af4df9726..8eac2ec07 100644 --- a/barcode/korean/net/compact-pdf417-encoding/_index.md +++ b/barcode/korean/net/compact-pdf417-encoding/_index.md @@ -141,9 +141,24 @@ Compact PDF417는 높은 데이터 밀도와 견고한 오류 정정 덕분에 ## Compact PDF417 인코딩 튜토리얼 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + +### [C#에서 PDF417 바코드를 생성하고 PNG로 저장하는 방법](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + + ### [Compact PDF417 바코드 만들기](./compact-pdf417-basic-configuration/) Aspose.BarCode for .NET를 사용하여 Compact PDF417 바코드를 생성하는 방법을 배웁니다. 단계별 지침과 코드 예제가 포함된 포괄적인 가이드입니다. +### [C#에서 마이크로 PDF417 바코드 만들기 – 단계별 가이드](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +C#를 사용해 마이크로 PDF417 바코드를 생성하는 방법을 단계별로 안내합니다. + +### [Macro PDF417용 C# 바코드 생성기 사용 방법](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +C#에서 Macro PDF417 바코드를 생성하는 방법을 단계별로 안내합니다. + +### [C#에서 PDF417 바코드 읽는 방법 – 완전 가이드](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Aspose.BarCode for .NET를 사용해 C#에서 PDF417 바코드를 읽는 전체 과정과 코드 예제를 제공합니다. + ## 자주 묻는 질문 **Q: Compact PDF417 바코드에 저장할 수 있는 최대 데이터 양은 얼마인가요?** diff --git a/barcode/korean/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/korean/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..bf8ab4aaa --- /dev/null +++ b/barcode/korean/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-08-22 +description: C#에서 마이크로 PDF417 바코드를 생성하고 바코드 PNG 이미지를 만드는 방법을 배웁니다. 바코드 크기 설정 및 파일 + 저장을 포함합니다. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: ko +lastmod: 2026-08-22 +og_description: C#에서 마이크로 PDF417 바코드를 생성하고 PNG로 내보내세요. 이 가이드를 따라 바코드 크기를 설정하고 바코드 + 이미지를 빠르게 생성하세요. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: C#으로 마이크로 PDF417 바코드 생성 – 전체 코딩 튜토리얼 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: C#에서 마이크로 PDF417 바코드 만드는 방법 – 단계별 가이드 +url: /ko/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#에서 마이크로 PDF417 바코드 생성 방법 – 단계별 가이드 + +티켓팅 시스템, 재고 라벨, 모바일 스캔용 **마이크로 PDF417 바코드**를 만들어야 한다면, 이 튜토리얼이 정확히 어떻게 하는지 보여줍니다. 바코드 PNG를 생성하는 전체 C# 프로그램을 확인하고, 바코드 크기 설정 방법을 배우며, 각 구성 옵션을 이해하게 됩니다. + +이 가이드를 끝까지 따라오면 고해상도 바코드 이미지를 생성하고, X‑dimension을 맞춤 설정하며, 열 개수를 선택하고, 결과를 PNG 파일로 저장할 수 있습니다—모두 몇 줄의 코드만으로 가능합니다. + +## 필요 사항 + +- .NET 6.0 SDK 또는 그 이후 버전 (코드는 .NET Core 및 .NET Framework에서도 작동합니다) +- Visual Studio 2022 또는 C# 호환 IDE +- **Aspose.BarCode for .NET** NuGet 패키지 (`EncodeTypes.MicroPdf417`를 지원하는 라이브러리라도 가능) +- C# 구문에 대한 기본적인 이해 + +> **Pro tip:** Aspose.BarCode의 무료 커뮤니티 에디션은 개발 및 테스트에 충분합니다. 프로덕션에서는 평가 워터마크를 제거하기 위해 라이선스를 획득하세요. + +## 단계 1: 바코드 라이브러리 설치 + +프로젝트 폴더에서 터미널을 열고 다음을 실행합니다: + +```bash +dotnet add package Aspose.BarCode +``` + +이 명령은 `Aspose.BarCode` 어셈블리를 추가합니다. 이 어셈블리는 **C#에서 바코드 이미지 생성** 애플리케이션에 사용되는 `BarcodeGenerator` 클래스를 제공합니다. + +## 단계 2: 생성기 초기화 – 마이크로 PDF417 바코드 생성 + +첫 번째 실행 가능한 줄은 Micro PDF417 심볼을 사용하도록 구성된 `BarcodeGenerator` 인스턴스를 생성하고, 인코딩하려는 데이터를 제공합니다. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*왜 중요한가*: `EncodeTypes.MicroPdf417` 열거형은 라이브러리에게 PDF417의 압축 버전을 사용하도록 지시합니다. 이는 작은 라벨과 모바일 화면에 이상적입니다. + +## 단계 3: C#에서 바코드 크기 설정 방법 + +모듈 폭(X‑dimension)을 미세 조정하면 바코드의 시각적 밀도를 제어할 수 있습니다. 값이 작을수록 이미지가 더 선명해지고, 값이 클수록 멀리서 스캔하기 쉬워집니다. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **왜 크기를 설정해야 하는가**: X‑dimension을 조정하지 않으면 기본값 때문에 고 DPI에서 렌더링될 때 바코드가 흐릿하게 보일 수 있습니다. 대부분의 화면 기반 스캔에 적합한 균형은 2픽셀로 설정하는 것입니다. + +## 단계 4: 열 개수 선택 – 바코드 너비 제어 + +Micro PDF417는 1~4열을 허용합니다. 열 수가 많을수록 데이터를 가로로 압축하여 전체 이미지 너비가 줄어듭니다. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*예외 상황*: 5열을 요청하면 라이브러리가 `ArgumentOutOfRangeException`을 발생시킵니다. 항상 문서에 명시된 범위 내에서 사용하세요. + +## 단계 5: 바코드 PNG 생성 – 이미지 저장 방법 + +이제 생성된 바코드를 PNG 파일로 내보낼 수 있습니다. PNG는 무손실 품질을 유지하므로 신뢰할 수 있는 스캔에 필수적입니다. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +프로그램을 실행하면 파일 위치를 확인하는 콘솔 메시지가 표시됩니다. 결과물인 `MicroPdf417.png`는 다음과 같습니다: + +![C#로 생성된 마이크로 PDF417 바코드 스크린샷](micro-pdf417-example.png "생성된 마이크로 PDF417 바코드") + +*Image alt text*: **C#에서 생성된 마이크로 PDF417 바코드** – 차원 및 열 설정을 적용한 최종 출력 예시입니다. + +## 단계 6: 실행 및 출력 확인 + +1. 프로젝트 빌드: `dotnet build`. +2. 실행: `dotnet run`. +3. `MicroPdf417.png` 파일을 데스크톱에서 열고 모바일 바코드 스캐너 앱으로 스캔합니다. + +디코딩된 텍스트 **“Sample text”**가 표시되어야 합니다. 스캐너가 오류를 보고하면 X‑dimension과 열 개수를 다시 확인하세요—극단적인 값은 일부 장치에서 바코드가 너무 조밀해져 스캔이 어려울 수 있습니다. + +## 일반적인 변형 및 문제 해결 + +| Situation | Adjustment | +|-----------|------------| +| **저해상도 프린터용 더 큰 바코드가 필요함** | `XDimension.Pixels`를 3 또는 4로 증가시킵니다. | +| **너비는 유지하고 바코드 높이만 늘리고 싶음** | `generator.Parameters.Barcode.Pdf417.Rows`를 설정합니다 (행 범위 3‑90). | +| **루프에서 여러 바코드 생성** | 같은 `BarcodeGenerator` 인스턴스를 재사용하고 각 `Save` 전에 `CodeText`만 변경합니다. | +| **PNG 대신 JPEG로 저장** | `BarCodeImageFormat.Png`를 `BarCodeImageFormat.Jpeg`로 교체합니다. | +| **.NET Framework 4.7에서 실행** | 동일한 코드가 작동합니다; 적절한 `Aspose.BarCode.dll`을 참조하면 됩니다. | + +## 전체 소스 목록 (실행 가능) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**예상 출력** – “Sample text”로 디코딩되는 선명한 Micro PDF417 바코드가 포함된 200 × 100픽셀 PNG 파일. + +## 결론 + +이제 C#에서 **마이크로 PDF417 바코드 생성**, **바코드 크기 설정**, 그리고 **바코드 PNG 이미지 생성** 방법을 알게 되었습니다. 전체 예제는 라이브러리 설치부터 최종 파일 저장까지 필요한 모든 단계를 보여주므로, 바코드 생성을 자체 애플리케이션에 직접 삽입할 수 있습니다. + +다음으로 **Aspose.BarCode를 사용한 QR 코드 생성**, **색상 맞춤**, 혹은 **PDF 문서에 바코드 삽입**과 같은 관련 주제를 탐색해 보세요. 이들 모두 여기서 다룬 `BarcodeGenerator` 기본 개념을 기반으로 합니다. + +다양한 데이터 문자열, 열 개수, X‑dimension 값을 실험해 보면서 특정 스캔 환경에 맞게 조정해 보세요. 즐거운 코딩 되세요! + +## 다음에 배울 내용은? + +다음 튜토리얼은 이 가이드에서 시연한 기술을 기반으로 하는 밀접한 관련 주제를 다룹니다. 각 자료에는 단계별 설명이 포함된 완전한 코드 예제가 있어 추가 API 기능을 마스터하고 자체 프로젝트에서 대체 구현 방식을 탐색하는 데 도움이 됩니다. + +- [Aspose.BarCode로 Compact PDF417 바코드 생성 방법](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Compact PDF417 인코딩으로 PDF417 바코드 생성 방법](/barcode/english/net/compact-pdf417-encoding/) +- [Aspose.BarCode for .NET으로 Aztec 바코드 생성 방법](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/korean/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..a21471839 --- /dev/null +++ b/barcode/korean/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: 바코드 생성기를 사용해 C#에서 PDF417 바코드를 만드는 방법, 레이아웃 설정 및 PNG 저장을 배웁니다. 전체 코드와 + 바코드 생성기 C# 프로젝트를 위한 팁이 포함되어 있습니다. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: ko +lastmod: 2026-08-22 +og_description: 바코드 생성기를 사용해 C#에서 PDF417 바코드를 만들고 레이아웃을 맞춤 설정하며 PNG 저장 방법을 배워보세요. + 단계별 튜토리얼을 따라가세요. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: C#에서 PDF417 바코드 만들기 – PNG 생성 및 저장 완전 가이드 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: C#에서 PDF417 바코드를 생성하고 PNG로 저장하는 방법 +url: /ko/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#에서 PDF417 바코드를 생성하고 PNG로 저장하는 방법 + +C# 애플리케이션에서 **PDF417 바코드 생성**이 필요하다면, 이 튜토리얼이 정확한 단계를 보여줍니다. 바코드 생성기 C# 라이브러리를 사용해 문자열을 스캔 가능한 PDF417 이미지로 변환하고, 추가 도구 없이 PNG 파일로 저장하는 방법을 확인할 수 있습니다. + +바코드 생성은 물류, 티켓팅, 문서 관리 등에서 흔히 사용됩니다. 이 가이드를 끝까지 따라 하면 선택한 폴더에 `Pdf417Layout.png`라는 PNG 파일을 생성하는 실행 가능한 콘솔 프로그램을 만들 수 있습니다. + +## 사전 요구 사항 + +시작하기 전에 다음이 설치되어 있는지 확인하세요. + +- .NET 6.0 SDK 이상 (코드는 .NET Framework 4.7+에서도 동작합니다). +- Visual Studio 2022 또는 C# 프로젝트를 빌드할 수 있는 편집기. +- **Aspose.BarCode for .NET** NuGet 패키지(또는 호환 가능한 바코드 생성기 C# 라이브러리). + 다음 명령으로 설치합니다: + +```bash +dotnet add package Aspose.BarCode +``` + +이미지 처리 라이브러리는 필요하지 않습니다. 생성기가 PNG를 직접 작성할 수 있기 때문입니다. + +## 1단계: 새 콘솔 프로젝트 설정 + +예제가 독립적으로 동작하도록 새 콘솔 프로젝트를 만듭니다. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` 폴더에 이제 바코드 코드를 작성할 `Program.cs` 파일이 생성됩니다. + +## 2단계: 바코드 네임스페이스 가져오기 + +`Program.cs`를 열고 상단에 필요한 `using` 지시문을 추가합니다: + +```csharp +using Aspose.BarCode.Generation; +``` + +이 네임스페이스를 통해 **PNG 저장 방법**에 필요한 `BarcodeGenerator`, `EncodeTypes`, 이미지 포맷 열거형에 접근할 수 있습니다. + +## 3단계: PDF417 바코드 생성기 만들기 + +**PDF417 생성 방법**의 핵심은 `BarcodeGenerator` 클래스입니다. 인코드 타입 `EncodeTypes.Pdf417`와 인코딩할 텍스트를 전달합니다. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator`는 이제 바코드에 대한 모든 설정을 보유합니다. 기본 레이아웃도 동작하지만, 다음 단계에서 커스터마이징합니다. + +## 4단계: 바코드 레이아웃 정의(열과 행) + +PDF417은 열(2‑30)과 행(1‑90)의 수를 제어할 수 있습니다. 이 값을 조정하면 특정 스캐너에 대한 가독성을 높일 수 있습니다. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **팁:** 이 설정을 생략하면 라이브러리가 자동으로 최적값을 선택합니다. 하지만 열과 행을 고정하면 PNG를 PDF나 UI 레이아웃에 삽입할 때 예측 가능한 이미지 크기를 얻을 수 있습니다. + +## 5단계: 생성된 바코드를 PNG 이미지로 저장 + +이제 **PNG 저장 방법**을 구현하기 위해 `Save`를 호출합니다. 메서드는 대상 경로와 이미지 포맷 열거형을 인수로 받습니다. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +프로그램을 실행하면 `Pdf417Layout.png` 파일이 프로젝트의 `bin/Debug/net6.0` 폴더에 생성됩니다. + +## 전체 실행 가능한 예제 + +아래는 완전한 `Program.cs` 파일입니다. **1단계**에서 만든 프로젝트에 복사하고 `dotnet run`을 실행하세요. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### 예상 출력 + +프로그램을 실행하면 콘솔에 PNG 파일의 절대 경로가 출력되고, 파일에는 아래 이미지와 유사한 선명한 PDF417 바코드가 포함됩니다. + +![PDF417 바코드 예시 생성](image-placeholder.png "PNG로 저장된 PDF417 바코드") + +PNG 파일을 PDF417을 지원하는 스캐너(모바일 앱, 하드웨어 리더)로 스캔하면 인코딩된 텍스트가 `"Sample"`임을 확인할 수 있습니다. + +## 에지 케이스 및 일반적인 함정 처리 + +| 상황 | 주의할 점 | 권장 해결책 | +|-----------|-------------------|-----------------| +| **잘못된 열/행 값** | 2‑30(열) 또는 1‑90(행) 범위를 벗어나면 `ArgumentException`이 발생합니다. | 사용자 입력을 검증하거나 라이브러스가 기본값을 선택하도록 둡니다. | +| **큰 입력 문자열** | PDF417은 최대 1,850자를 인코딩할 수 있지만, 매우 긴 문자열은 행 수를 크게 늘립니다. | 데이터를 여러 바코드로 분할하거나 필요 시 오류 정정 레벨을 높입니다. | +| **파일 시스템 권한** | 읽기 전용 폴더에 저장하면 `UnauthorizedAccessException`이 발생합니다. | `Environment.CurrentDirectory`와 같이 쓰기 가능한 경로에 저장하고, try/catch로 예외를 처리합니다. | +| **NuGet 패키지 누락** | “type or namespace name could not be found” 오류가 발생합니다. | `Aspose.BarCode`가 설치됐는지 확인합니다(`dotnet add package Aspose.BarCode`). | + +## 예제 확장하기 + +이제 **PDF417 바코드 생성**과 **PNG 저장** 방법을 알았으니 다음 주제들을 탐색해 보세요. + +- **Barcode generator C#**: `EncodeTypes`를 `Code128`, `QR` 등 다른 심볼로 변경합니다. +- **맞춤 색상**: `generator.Parameters.Barcode.ForegroundColor`와 `BackgroundColor`를 사용해 브랜드 색에 맞춥니다. +- **PDF에 삽입**: PNG를 PDF 라이브러리(예: iText7)와 결합해 인쇄 가능한 문서를 만듭니다. +- **동적 데이터**: 데이터베이스나 사용자 입력에서 텍스트를 가져와 실시간으로 바코드를 생성합니다. + +## 결론 + +이제 C#에서 **PDF417 바코드 생성**하고 결과를 PNG 파일로 저장하는 완전하고 프로덕션 수준의 솔루션을 갖추었습니다. 프로젝트 설정부터 레이아웃 커스터마이징까지 모든 단계를 다루었으며, 바코드 생성기 C# 라이브러리를 사용할 때 흔히 발생하는 오류를 피하는 방법도 소개했습니다. + +열/행 설정, 색상, 다른 바코드 형식 등을 자유롭게 실험해 보세요. 문제가 발생하면 **PDF417 생성 방법** 섹션을 다시 확인하거나 라이브러리 문서를 참고해 고급 기능을 탐색하십시오. 즐거운 코딩 되세요! + +## 다음에 배워야 할 내용은? + + +다음 튜토리얼은 이 가이드에서 다룬 기술을 기반으로 하며, 관련 주제를 깊이 있게 다룹니다. 각 리소스는 완전한 코드 예제와 단계별 설명을 제공해 추가 API 기능을 마스터하고 프로젝트에 다양한 구현 방식을 적용하도록 돕습니다. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode Quiet Zone for ITF-14 Using Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/korean/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..816cdfcb6 --- /dev/null +++ b/barcode/korean/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-08-22 +description: Aspose.BarCode를 사용하여 C#에서 PDF417 바코드를 생성하고, 바코드 크기를 설정하며, 열을 조정하고, 컴팩트 + 모드를 활성화하는 방법을 배웁니다. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: ko +lastmod: 2026-08-22 +og_description: Aspose.BarCode를 사용하여 C#에서 PDF417 바코드를 생성합니다. 이 가이드는 바코드 크기 설정, 열 제어 + 및 작은 이미지를 위한 컴팩트 모드 활성화 방법을 보여줍니다. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: C#에서 PDF417 바코드 생성 – 크기, 열 및 컴팩트 모드 설정 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: C#에서 PDF417 바코드를 생성하고 바코드 크기 설정하는 방법 +url: /ko/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#에서 PDF417 바코드를 생성하고 바코드 크기 설정하기 + +.NET 애플리케이션에서 **PDF417 바코드 생성**이 필요하다면, 이 가이드는 전체 과정을 단계별로 안내합니다. Aspose.BarCode를 사용해 **PDF417을 생성**하고, **바코드 크기 설정**을 조정하며, 보고서나 모바일 앱에 삽입할 수 있는 컴팩트한 PNG를 만드는 방법을 정확히 확인할 수 있습니다. + +바코드 생성에 별도의 그래픽 편집기가 필요하지 않습니다. 이 튜토리얼을 마치면 원하는 정확한 크기의 PDF417 이미지를 생성하는 완전한 C# 메서드를 얻게 되며, 이후 처리에 바로 사용할 수 있습니다. + +## 배울 내용 + +* Aspose.BarCode 라이브러리 설치 및 참조 +* PDF417 바코드 생성기 생성 및 인코딩 텍스트 지정 +* X‑dimension 및 컬럼 수를 설정하여 **바코드 크기 설정** +* 심볼을 축소하는 컴팩트(축소) 모드 활성화 +* 결과를 PNG 파일로 저장 +* 읽을 수 없는 코드, 과도하게 큰 이미지 등 일반적인 문제 해결 + +### 사전 요구 사항 + +* .NET 6.0 이상 (.NET Framework 4.6+에서도 동작) +* C# 및 Visual Studio(또는 기타 C# IDE)에 대한 기본 지식 +* 유효한 Aspose.BarCode 라이선스(무료 평가판으로 테스트 가능) + +> **Pro tip:** 많은 바코드를 루프에서 생성해야 한다면 `BarcodeGenerator` 인스턴스를 하나만 재사용하고 `CodeText` 속성만 변경하세요. 메모리 할당을 크게 줄일 수 있습니다. + +## Aspose.BarCode로 PDF417 바코드 생성 + +첫 번째 단계는 PDF417 심볼리지를 위한 `BarcodeGenerator`를 인스턴스화하는 것입니다. 이 객체가 모든 바코드 작업의 진입점이 됩니다. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*왜 중요한가*: `EncodeTypes.Pdf417`은 라이브러리에게 PDF417 표준을 사용하도록 지시합니다. 이 표준은 대용량 데이터와 오류 정정을 지원합니다. 생성자에 인코딩할 데이터를 바로 전달하면 나중에 별도로 `CodeText`를 지정할 필요가 없습니다. + +## 바코드 크기 및 컬럼 수 설정 + +PDF417 심볼은 작은 직사각형 모듈의 행과 열로 구성됩니다. 모듈 너비(X‑dimension)와 컬럼 수를 제어하면 전체 치수를 미세 조정할 수 있습니다. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*설명*: +* **X‑dimension** (`Pixels`)은 각 모듈의 너비를 결정합니다. 값이 작을수록 바코드가 촘촘해지고, 값이 클수록 저해상도 스캐너에서 가독성이 높아집니다. +* **Columns**는 가로 레이아웃을 제어합니다. 컬럼 수가 적으면 바코드가 더 높아지고, 컬럼 수가 많으면 더 넓어집니다. 이 두 설정을 함께 조정해 **바코드 크기 설정**을 정확히 맞추세요. + +## 더 작은 바코드를 위한 컴팩트 모드 활성화 + +PDF417에는 불필요한 패딩을 제거하고 전체 면적을 줄이는 “컴팩트”(또는 축소) 모드가 있습니다. 화면 공간이 제한된 경우 특히 유용합니다. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*왜 축소 모드를 사용하나요?* +`Truncate`가 `true`이면 생성기가 정지 패턴과 대부분의 스캔 시나리오에 필요하지 않은 일부 오류 정정 코드워드를 생략합니다. 결과 이미지가 약 15‑20 % 정도 작아지면서 일반적인 사용에서는 데이터 무결성을 유지합니다. + +## 바코드를 PNG 이미지로 저장 + +크기와 모드를 설정한 뒤 바코드를 디스크에 기록합니다. PNG는 무손실 포맷이므로 모듈 가장자리가 선명하게 유지됩니다. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +`CompactPdf417.png` 파일에는 이전 단계에서 지정한 치수와 일치하는 선명한 PDF417 심볼이 포함됩니다. + +### 예상 출력 + +저장된 PNG를 열면 세 개의 컬럼으로 구성된 수직 방향 PDF417 바코드가 표시됩니다. 각 모듈은 2 px 너비이며 전체 크기는 대략 **120 × 240 px**(가로 × 세로)입니다. 표준 PDF417 리더로 이미지를 스캔하면 원본 텍스트 “Sample text for PDF417”가 반환됩니다. + +## 흔히 겪는 문제와 해결 방법 + +| Symptom | Likely cause | Fix | +|---------|--------------|-----| +| 바코드가 읽히지 않음 | 스캐너에 비해 X‑dimension이 너무 작음 | `XDimension.Pixels`를 3 또는 4로 증가 | +| 이미지가 UI에 비해 너무 넓음 | 컬럼 수가 과다 설정 | `Pdf417.Columns`를 줄이거나 `Truncate` 활성화 | +| `ArgumentOutOfRangeException` 예외 | 컬럼 수가 음수이거나 0 | `Columns`를 양의 정수(최소 1)로 설정 | +| PNG 파일이 비어 있음 | 출력 경로가 존재하지 않거나 쓰기 권한 부족 | 디렉터리 존재 여부와 앱의 쓰기 권한 확인 | + +> **Pro tip:** `Save()` 호출 전에 `barcodeGenerator.ValidateParameters()`를 사용해 구성 오류를 미리 감지하세요. + +## 전체 실행 가능한 예제 + +아래는 앞서 설명한 모든 단계를 포함한 독립 실행형 콘솔 프로그램입니다. 새 C# 프로젝트에 복사하고 Aspose.BarCode NuGet 패키지를 복원한 뒤 실행하면 결과를 확인할 수 있습니다. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**프로그램 실행** 시 실행 파일 작업 디렉터리에 `CompactPdf417.png`가 생성됩니다. 모바일 앱(예: “Barcode Scanner”)으로 이미지를 스캔해 인코딩된 텍스트가 원본 문자열과 일치하는지 확인하세요. + +## 다음 단계 및 관련 주제 + +* **오류 정정 수준 높이기** – 환경이 스캔 노이즈가 많을 경우 `Pdf417.ErrorLevel`을 조정 +* **방향 변경** – 가로 레이아웃이 필요하면 `Pdf417.Rotate`를 `RotationAngle.Rotate90`으로 설정 +* **PDF에 바코드 삽입** – Aspose.PDF와 Aspose.BarCode를 결합해 이미지를 문서에 직접 배치 +* **다른 2‑D 바코드 생성** – 동일 `BarcodeGenerator` 클래스로 DataMatrix, QR, Aztec 코드도 지원; `EncodeTypes.Pdf417`을 원하는 심볼리티로 교체하면 됨 + +**PDF417 바코드 생성** 기술을 마스터하면 티켓 발행, 재고 라벨링, 보안 데이터 전송 등을 다양한 .NET 애플리케이션에서 자동화할 수 있습니다. + +## 결론 + +이제 C#에서 **PDF417 바코드 생성** 방법, 정확한 **바코드 크기 설정**, 컬럼 조정, 컴팩트 모드 활성화, PNG 저장까지 전체 과정을 알게 되었습니다. 이러한 설정을 활용해 UI 제약이나 스캔 요구 사항에 맞게 바코드를 최적화하고, 필요에 따라 다른 바코드 형식에도 적용해 보세요. 즐거운 코딩 되세요! + +## 다음에 배워야 할 내용 + +다음 튜토리얼은 이 가이드에서 다룬 기술을 기반으로 하며, 추가 API 기능을 마스터하고 프로젝트에 다양한 구현 방식을 적용하는 데 도움이 됩니다. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/korean/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..85d46a8b3 --- /dev/null +++ b/barcode/korean/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: C#에서 PDF417 바코드를 읽는 방법에 대한 단계별 가이드로, 이미지에서 여러 바코드를 읽고 MacroPdf417 세부 + 정보를 추출하는 내용을 포함합니다. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: ko +lastmod: 2026-08-22 +og_description: C#에서 PDF417 바코드를 빠르게 읽는 방법. 이 튜토리얼에서는 이미지에서 여러 바코드를 읽고 MacroPdf417 + 확장 정보를 가져오는 방법을 보여줍니다. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: C#에서 PDF417 바코드를 읽는 방법 – 전체 프로그래밍 가이드 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: C#에서 PDF417 바코드를 읽는 방법 – 완전 가이드 +url: /ko/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#에서 PDF417 바코드 읽는 방법 – 완전 가이드 + +.NET 애플리케이션에서 **PDF417을 읽는 방법**이 필요하다면, 이 튜토리얼은 바로 실행할 수 있는 솔루션을 제공합니다. 단일 이미지에서 여러 바코드를 읽고, 전체 MacroPdf417 데이터 세트를 추출하며, 콘솔에 표시하는 방법을 배울 수 있습니다. 이 접근 방식은 Aspose.BarCode for .NET 라이브러리와 함께 작동하며 몇 줄의 코드만 필요합니다. + +이미지에서 바코드를 읽는 것은 재고 관리 시스템, 티켓 검증, 문서 관리 등에서 흔히 수행되는 작업입니다. 이 가이드를 마치면 PDF417 또는 MacroPdf417 바코드를 디코딩하고, 한 사진에 여러 코드를 처리하며, MacroPdf417가 제공하는 확장 필드를 이해할 수 있게 됩니다. + +## 사전 요구 사항 + +- .NET 6.0 SDK 또는 그 이후 버전 (코드는 .NET Framework 4.7+에서도 컴파일됩니다) +- Visual Studio 2022 또는 선호하는 C# 편집기 +- Aspose.BarCode for .NET NuGet 패키지 (`Install-Package Aspose.BarCode`) +- MacroPdf417 바코드가 포함된 샘플 이미지 (예: `MacroPdf417.png`) + +추가 설정이 필요하지 않습니다; 라이브러리가 이미지 로드와 디코딩을 내부적으로 처리합니다. + +## C#에서 이미지로부터 PDF417 바코드 읽는 방법 + +솔루션의 핵심은 `BarCodeReader` 클래스입니다. 이 클래스는 이미지를 열고, 지정된 유형의 모든 바코드를 감지한 뒤 `BarCodeResult` 객체 컬렉션을 반환합니다. 아래 코드는 완전한 콘솔 프로그램을 보여줍니다. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### 각 라인이 중요한 이유 + +| Step | Purpose | +|------|---------| +| **1️⃣ Initialize** | 이미지 파일에 바인딩된 `BarCodeReader`를 생성하고, MacroPdf417 심볼만 감지하도록 제한하여 처리 속도를 높입니다. | +| **2️⃣ Iterate** | `ReadBarCodes()`는 요청된 유형과 일치하는 **모든** 바코드를 반환하므로, 추가 루프 없이 **여러 바코드 읽기**가 가능합니다. | +| **3️⃣ Basic output** | `CodeTypeName`과 사람이 읽을 수 있는 `CodeText`를 표시합니다. 로그 기록이나 빠른 검증에 유용합니다. | +| **4️⃣ Extended data** | MacroPdf417는 추가 메타데이터(파일 ID, 세그먼트 수, 타임스탬프 등)를 포함합니다. `Extended.Pdf417` 객체는 각 필드를 직접 노출하므로 전체 데이터 패킷을 저장하거나 검증할 수 있습니다. | + +유효한 MacroPdf417 이미지를 대상으로 프로그램을 실행하면 다음과 유사한 콘솔 출력이 나타납니다. + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +출력 결과는 라이브러리가 바코드를 성공적으로 읽고 텍스트를 추출했으며, 모든 MacroPdf417 필드를 제공했음을 확인시켜 줍니다. + +## 단일 이미지에서 여러 바코드 읽기 + +많은 실제 시나리오에서는 하나의 라벨에 여러 PDF417 심볼이 배치됩니다—예를 들어 운송업체 코드, 추적 번호, 세관 신고서가 포함된 운송 명세서가 그렇습니다. 위의 코드 블록은 `ReadBarCodes()`가 모든 일치 항목을 열거형으로 반환하기 때문에 이미 **여러 바코드 읽기**를 수행합니다. 추가 설정이 필요하지 않으며, 결과를 순회하기만 하면 됩니다. + +표준 PDF417(비매크로)만 읽으면서도 여러 코드를 처리하고 싶다면 `DecodeType.MacroPdf417`를 `DecodeType.Pdf417`로 교체하면 됩니다. 나머지 로직은 그대로 유지됩니다. + +## MacroPdf417 확장 데이터 이해 + +MacroPdf417는 일반 PDF417 사양의 확장판입니다. 큰 페이로드를 여러 세그먼트로 나누고 전체 파일을 설명하는 작은 헤더를 추가합니다. 가장 중요한 필드는 다음과 같습니다. + +- **MacroPdf417FileID** – 동일 파일의 모든 세그먼트가 공유하는 고유 식별자. +- **MacroPdf417SegmentID** – 현재 세그먼트의 순번. +- **MacroPdf417SegmentsCount** – 예상되는 전체 세그먼트 수. +- **MacroPdf417FileName** – 바코드와 함께 전송되는 선택적 파일 이름. +- **MacroPdf417Checksum** – 전체 파일에 대한 오류 검증 값. +- **MacroPdf417FileSize** – 원본 바이너리 페이로드의 크기. +- **MacroPdf417TimeStamp** – 바코드가 생성된 ISO‑8601 형식 타임스탬프. +- **MacroPdf417Addressee / Sender** – 라우팅을 위한 선택적 텍스트 필드. +- **MacroPdf417Terminator** – 이 세그먼트가 마지막인지 여부를 나타냅니다. + +모든 세그먼트를 수신하면 `MacroPdf417SegmentID` 순으로 정렬하고 `CodeText` 값을 연결하여 원본 파일을 재구성할 수 있습니다. 필요한 필드가 확보되면 이 로직은 구현이 매우 간단합니다. + +## 일반적인 함정 및 전문가 팁 + +- **Image quality matters** – 저해상도 또는 과도하게 압축된 PNG/JPEG 파일은 감지를 놓칠 수 있습니다. 인쇄된 바코드의 경우 최소 300 dpi를 사용하세요. +- **Mixed symbologies** – 이미지에 MacroPdf417와 일반 PDF417가 모두 포함된 경우, 각각 `DecodeType`에 대해 두 개의 리더를 인스턴스화하거나 `DecodeType.AllSupported`를 사용한 뒤 `result.CodeTypeName`으로 결과를 필터링하세요. +- **Memory usage** – `using` 문을 통해 `BarCodeReader`를 즉시 해제하면 큰 이미지 버퍼가 메모리에 남는 것을 방지할 수 있습니다. +- **Thread safety** – `BarCodeReader`는 스레드‑안전하지 않습니다. 병렬로 이미지를 디코딩할 경우 스레드당 별도 인스턴스를 생성하세요. +- **Error handling** – `ReadBarCodes()` 호출을 try/catch 블록으로 감싸 `BarCodeException`을 잡아 손상된 이미지를 처리하세요. + +## 전체 작업 예제 요약 + +아래는 새 콘솔 프로젝트에 복사해 넣을 수 있는 완전한 프로그램입니다. 모든 `using` 지시문, 이미지 경로 상수, 그리고 해제 패턴을 포함하고 있습니다. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +`dotnet build`로 컴파일하고 `dotnet run`으로 실행하세요. 콘솔은 각 바코드의 기본 데이터와 전체 MacroPdf417 페이로드를 출력합니다. + +## 다음 단계 + +- **멀티파트 파일 재구성** – 모든 세그먼트를 수집하고 `MacroPdf417SegmentID`로 정렬한 뒤 `CodeText`를 연결합니다. + +## 다음에 배워야 할 내용은? + +다음 튜토리얼은 이 가이드에서 시연한 기술을 기반으로 하는 밀접한 주제를 다룹니다. 각 리소스는 완전한 코드 예제와 단계별 설명을 제공하여 추가 API 기능을 마스터하고 자체 프로젝트에서 대체 구현 방식을 탐색하는 데 도움이 됩니다. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Read PDF417 Barcodes with Turkish Characters in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [How to Use Aspose for PDF417 Barcode (Chinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/korean/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..192b3f7e2 --- /dev/null +++ b/barcode/korean/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-08-22 +description: barcode generator C# 튜토리얼에서는 메타데이터가 포함된 Macro PDF417 바코드를 생성하고 Aspose.BarCode를 + 사용하여 PNG로 저장하는 방법을 보여줍니다. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: ko +lastmod: 2026-08-22 +og_description: barcode generator C#를 사용하면 전체 파일 수준 메타데이터가 포함된 Macro PDF417 바코드를 생성하고 + PNG로 내보낼 수 있습니다. 이 가이드를 따라 솔루션을 구현하세요. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: 바코드 생성기 C# – 매크로 PDF417 바코드 단계별 생성 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Macro PDF417용 C# 바코드 생성기 사용 방법 +url: /ko/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Macro PDF417용 C# 바코드 생성기 사용 방법 + +파일‑레벨 메타데이터를 포함한 Macro PDF417 심볼을 생성할 수 있는 **barcode generator C#**가 필요하다면, 이 가이드는 완전한 실행 가능한 솔루션을 제공합니다. 바코드 외관을 구성하고, 파일 ID와 세그먼트 수와 같은 매크로 정보를 삽입한 뒤, 최종적으로 PNG 이미지로 저장하는 과정을 확인할 수 있습니다. + +예제는 전체 PDF417 기능을 지원하는 널리 사용되는 **C# barcode library**인 Aspose.BarCode 라이브러리를 사용합니다. 외부 서비스가 필요 없으며, 코드는 .NET 6 이상에서 동작합니다. + +## Prerequisites + +시작하기 전에 다음이 설치되어 있는지 확인하세요. + +* .NET 6 SDK(또는 이후 버전) +* Visual Studio 2022, VS Code 또는 기타 C# IDE +* **Aspose.BarCode**에 대한 NuGet 참조(`dotnet add package Aspose.BarCode`) + +C# 기본 문법과 PDF417 바코드 개념을 알고 있으면 단계 진행이 수월하지만, 튜토리얼에서는 모든 설정 옵션을 자세히 설명합니다. + +## What the tutorial covers + +* Macro PDF417 형식에 대한 **barcode generator C#** 인스턴스 초기화 +* X‑dimension 및 열 개수와 같은 시각적 파라미터 조정 +* Macro PDF417 파일‑레벨 필드 제공: 파일 ID, 세그먼트 ID, 세그먼트 수, 파일 이름, 체크섬, 파일 크기, 타임스탬프, 수신인, 발신인, 종료 플래그 +* 생성된 심볼을 PNG 파일로 저장 +* 대용량 파일이나 사용자 정의 타임스탬프와 같은 엣지 케이스 처리 팁 + +이 글을 끝까지 읽으면 완전한 Macro PDF417 바코드를 생성하는 독립 실행형 프로그램을 만들 수 있습니다. + +## Step 1: Create the barcode generator C# instance + +첫 번째 작업은 `EncodeTypes.MacroPdf417` 열거값과 인코딩할 텍스트를 사용해 `BarcodeGenerator`를 인스턴스화하는 것입니다. 생성자는 페이로드 문자열도 받으며, 이는 매크로 바코드의 데이터 부분이 됩니다. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Why this matters** – `EncodeTypes.MacroPdf417` 플래그는 Aspose.BarCode에게 심볼을 매크로 바코드로 처리하도록 지시하여, 이후에 사용할 추가 필드를 활성화합니다. 이 플래그가 없으면 라이브러리는 파일‑레벨 메타데이터가 없는 일반 PDF417 바코드만 생성합니다. + +## Step 2: Adjust basic barcode appearance (PDF417 visual settings) + +시각적 선명도는 안정적인 스캔에 필수적입니다. 흔히 조정하는 파라미터는 모듈 폭(`XDimension`)과 열 개수입니다. 이 값을 적절히 설정하면 크기와 가독성 사이의 균형을 맞출 수 있습니다. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels`는 각 검은색/흰색 막대의 폭을 제어합니다. **2** 값은 대부분의 라벨 프린터에 적합합니다. +* `Pdf417.Columns`는 바코드가 사용할 열 수를 정의합니다. 5열은 데이터 용량을 크게 희생하지 않으면서도 컴팩트한 심볼을 제공합니다. + +## Step 3: Define Macro PDF417 file‑level information + +Macro PDF417는 표준 PDF417에 대용량 파일을 여러 바코드 세그먼트로 나누는 방식을 설명하는 필드를 추가합니다. 이러한 필드를 제공하면 하위 스캐너가 원본 파일을 재구성할 수 있습니다. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID`는 동일한 논리 파일에 속하는 모든 세그먼트에서 동일해야 합니다. +* `MacroPdf417SegmentID`는 **0**부터 `SegmentsCount‑1`까지 증가합니다. +* `MacroPdf417SegmentsCount`는 디코더에게 기대해야 할 세그먼트 수를 알려줍니다. +* `MacroPdf417FileName`은 선택 사항이지만 사람에게 파일을 식별하기 쉽게 해줍니다. + +## Step 4: Set additional macro metadata + +핵심 파일 정보 외에도 사양에서는 체크섬, 파일 크기, 타임스탬프, 수신인, 발신인, 종료 플래그와 같은 추가 필드를 허용합니다. 이러한 필드를 채우면 데이터 무결성과 추적성을 향상시킬 수 있습니다. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum`은 전체 파일에 대한 16‑bit CCITT 체크섬을 제공하며, 디코더가 재구성 후 무결성을 검증할 수 있습니다. +* `MacroPdf417FileSize`는 원본 파일의 정확한 바이트 수를 반영해야 합니다. `2^31‑1`보다 큰 값은 64‑bit 필드가 필요하며, Aspose가 자동으로 처리합니다. +* `MacroPdf417TimeStamp`는 바코드가 생성된 시점을 기록합니다. 시간대 모호성을 피하려면 UTC를 사용하세요. +* `MacroPdf417Addressee`와 `MacroPdf417Sender`는 라우팅 정보를 저장할 수 있는 자유 형식 문자열입니다. +* `MacroPdf417Terminator`는 이 세그먼트가 마지막임을 나타냅니다. 마지막 조각에서는 `Set`으로 설정하고, 그렇지 않으면 기본값(`NotSet`)을 그대로 두세요. + +**Edge‑case tip** – 파일 크기가 4 GB를 초과하면 내용을 여러 매크로 세그먼트로 나누고 `SegmentsCount`를 그에 맞게 조정하세요. 라이브러리는 오버플로 없이 큰 크기 필드를 자동으로 관리합니다. + +## Step 5: Save the barcode as a PNG image + +마지막 단계에서는 생성된 심볼을 디스크에 저장합니다. PNG는 정확한 픽셀 차원을 유지하며 스캔 하드웨어에서 널리 지원됩니다. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +`YOUR_DIRECTORY`를 실행 프로세스가 쓰기 가능한 절대 경로나 상대 경로로 교체하세요. `BarCodeImageFormat.Png` 열거값은 손실 없는 출력을 보장합니다. + +**Why PNG?** – PNG와 같은 래스터 형식은 모듈 가장자리를 선명하게 유지하므로 고대비 가장지를 필요로 하는 스캐너에 필수적입니다. 벡터 형식이 필요하면 Aspose는 `Pdf`와 `Svg`도 지원합니다. + +## Full runnable example + +아래는 콘솔 애플리케이션에 복사해 넣을 수 있는 전체 프로그램입니다. 필요한 `using` 지시문과 `Main` 메서드를 포함하고 있습니다. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Expected output + +프로그램을 실행하면 프로젝트 작업 디렉터리에 **MacroPdf417.png** 파일이 생성됩니다. 이미지를 열면 매크로 필드가 삽입된 컴팩트 PDF417 바코드가 표시됩니다. PDF417‑호환 리더(예: ZXing, Aspose.BarCode 디코더)로 스캔하면 원본 `"Sample text"` 페이로드와 매크로 메타데이터가 반환됩니다. + +## Common questions and troubleshooting + +| Question | Answer | +|----------|--------| +| *What if the barcode is too large for the target label?* | `XDimension.Pixels`를 줄이거나 `Pdf417.Columns`를 늘리세요. 두 파라미터 모두 전체 크기에 영향을 줍니다. | +| *Can I generate a vector image instead of PNG?* | 예. `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);`를 호출하면 확장 가능한 출력이 생성됩니다. | +| *How do I verify the checksum after scanning?* | Aspose.BarCode 디코더가 `MacroPdf417Checksum`을 자동으로 검증하고, `MacroPdf417Result` 객체에 불일치를 보고합니다. | +| *Is the library compatible with .NET Core?* | NuGet 패키지는 .NET Standard 2.0+를 지원하므로 .NET Core, .NET 5, .NET 6 및 이후 버전과 호환됩니다. | +| *What if I need to embed binary data instead of text?* | 바이너리 페이로드를 Base64로 변환하거나, 바이트 배열을 받는 `EncodeTypes.MacroPdf417` 오버로드를 사용하세요. | + +## Pro tips for production use + +* **Cache the generator** – + + +## What Should You Learn Next? + + +다음 튜토리얼들은 이 가이드에서 다룬 기술을 기반으로 하며, 단계별 설명과 완전한 코드 예제를 포함합니다. 이를 통해 추가 API 기능을 마스터하고 프로젝트에 다양한 구현 방식을 적용할 수 있습니다. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/net/compact-pdf417-encoding/_index.md b/barcode/polish/net/compact-pdf417-encoding/_index.md index afe410866..a09811e23 100644 --- a/barcode/polish/net/compact-pdf417-encoding/_index.md +++ b/barcode/polish/net/compact-pdf417-encoding/_index.md @@ -141,9 +141,20 @@ Wysoka gęstość danych i solidna korekcja błędów Compact PDF417 sprawiają, ## Samouczki kodowania Compact PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + ### [Tworzenie kodów kreskowych Compact PDF417](./compact-pdf417-basic-configuration/) Dowiedz się, jak generować kody kreskowe Compact PDF417 przy użyciu Aspose.BarCode dla .NET. Kompleksowy przewodnik z instrukcjami krok po kroku i przykładami kodu. +### [Jak stworzyć mikro kod PDF417 w C# – przewodnik krok po kroku](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [Jak używać generatora kodów kreskowych w C# dla Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [Jak odczytać kody kreskowe PDF417 w C# – kompletny przewodnik](./how-to-read-pdf417-barcodes-in-c-complete-guide/) + +### [Jak utworzyć kod kreskowy PDF417 w C# i zapisać go jako PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + ## Najczęściej zadawane pytania **Q:** Jaka jest maksymalna ilość danych, które mogę przechowywać w kodzie Compact PDF417? diff --git a/barcode/polish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/polish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..67f181364 --- /dev/null +++ b/barcode/polish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Dowiedz się, jak stworzyć mikro kod kreskowy PDF417 w C# i wygenerować + obraz PNG kodu kreskowego. Zawiera ustawianie wymiarów kodu kreskowego oraz zapisywanie + pliku. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: pl +lastmod: 2026-08-22 +og_description: Utwórz mikrokod PDF417 w C# i wyeksportuj go jako PNG. Skorzystaj + z tego przewodnika, aby ustawić wymiary kodu kreskowego i szybko wygenerować obraz + kodu. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Utwórz mikro kod kreskowy PDF417 w C# – pełny samouczek programistyczny +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Jak stworzyć mikro kod kreskowy PDF417 w C# – przewodnik krok po kroku +url: /pl/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak utworzyć mikro‑kod PDF417 w C# – przewodnik krok po kroku + +Jeśli potrzebujesz **utworzyć mikro‑kod PDF417** dla systemu biletowego, etykiety inwentarzowej lub skanowania mobilnego, ten tutorial pokaże Ci dokładnie, jak to zrobić. Zobaczysz kompletny program w C#, który generuje plik PNG z kodem kreskowym, nauczysz się ustawiać wymiary kodu oraz zrozumiesz każdą opcję konfiguracji. + +Po zakończeniu tego przewodnika będziesz w stanie wygenerować wysokiej rozdzielczości obraz kodu kreskowego, dostosować wymiar X, wybrać liczbę kolumn i zapisać wynik jako plik PNG — wszystko przy użyciu kilku linii kodu. + +## Czego będziesz potrzebować + +- .NET 6.0 SDK lub nowszy (kod działa z .NET Core i .NET Framework) +- Visual Studio 2022 lub dowolne IDE kompatybilne z C# +- Pakiet NuGet **Aspose.BarCode for .NET** (lub dowolna biblioteka obsługująca `EncodeTypes.MicroPdf417`) +- Podstawowa znajomość składni C# + +> **Pro tip:** Darmowa edycja community Aspose.BarCode wystarczy do rozwoju i testów. W wersji produkcyjnej należy uzyskać licencję, aby usunąć znak wodny oceny. + +## Krok 1: Zainstaluj bibliotekę kodów kreskowych + +Otwórz terminal w folderze projektu i uruchom: + +```bash +dotnet add package Aspose.BarCode +``` + +Spowoduje to dodanie zestawu `Aspose.BarCode`, który udostępnia klasę `BarcodeGenerator` używaną do **create barcode image C#** aplikacji. + +## Krok 2: Zainicjuj generator – utwórz mikro‑kod PDF417 + +Pierwsza wykonywalna linia tworzy instancję `BarcodeGenerator` skonfigurowaną dla symboliki Micro PDF417 i podaje dane, które mają zostać zakodowane. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Dlaczego to ważne*: Enum `EncodeTypes.MicroPdf417` informuje bibliotekę, że ma używać kompaktowej wersji PDF417, co jest idealne dla małych etykiet i ekranów mobilnych. + +## Krok 3: Jak ustawić wymiary kodu kreskowego w C# + +Dostrajanie szerokości modułu (wymiar X) kontroluje gęstość wizualną kodu. Mniejsza wartość daje ostrzejszy obraz, większa ułatwia skanowanie z większej odległości. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Dlaczego warto ustawiać wymiary**: Bez zmiany wymiaru X domyślna wartość może spowodować, że kod będzie wyglądał na rozmyty przy renderowaniu w wysokim DPI. Ustawienie go na 2 piksele to dobre wyważenie dla większości skanowań ekranowych. + +## Krok 4: Wybierz liczbę kolumn – kontrola szerokości kodu + +Micro PDF417 dopuszcza od 1 do 4 kolumn. Więcej kolumn kompresuje dane w poziomie, zmniejszając ogólną szerokość obrazu. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Przypadek brzegowy*: Jeśli zażądasz 5 kolumn, biblioteka zgłosi `ArgumentOutOfRangeException`. Zawsze pozostawaj w dokumentowanym zakresie. + +## Krok 5: Jak wygenerować PNG kodu kreskowego – zapis obrazu + +Teraz możesz wyeksportować wygenerowany kod do pliku PNG. PNG zachowuje jakość bezstratną, co jest niezbędne do niezawodnego skanowania. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Po uruchomieniu programu zobaczysz komunikat w konsoli potwierdzający lokalizację pliku. Powstały plik `MicroPdf417.png` wygląda tak: + +![Screenshot showing a generated micro PDF417 barcode created with C#](micro-pdf417-example.png "Generated micro PDF417 barcode") + +*Tekst alternatywny obrazu*: **micro PDF417 barcode generated in C#** – prezentuje końcowy wynik po zastosowaniu wymiarów i ustawień kolumn. + +## Krok 6: Uruchom i zweryfikuj wynik + +1. Zbuduj projekt: `dotnet build`. +2. Uruchom: `dotnet run`. +3. Otwórz `MicroPdf417.png` na pulpicie i zeskanuj go aplikacją mobilną do skanowania kodów kreskowych. + +Powinieneś zobaczyć odkodowany tekst **„Sample text”**. Jeśli skaner zgłosi błąd, sprawdź ponownie wymiar X i liczbę kolumn – skrajne wartości mogą sprawić, że kod będzie zbyt gęsty dla niektórych urządzeń. + +## Typowe warianty i rozwiązywanie problemów + +| Sytuacja | Dostosowanie | +|-----------|------------| +| **Potrzeba większego kodu dla drukarek o niskiej rozdzielczości** | Zwiększ `XDimension.Pixels` do 3 lub 4. | +| **Chcesz wyższy kod bez zmiany szerokości** | Ustaw `generator.Parameters.Barcode.Pdf417.Rows` (zakres wierszy 3‑90). | +| **Generowanie wielu kodów w pętli** | Ponownie użyj tej samej instancji `BarcodeGenerator` i zmieniaj tylko `CodeText` przed każdym `Save`. | +| **Zapis jako JPEG zamiast PNG** | Zamień `BarCodeImageFormat.Png` na `BarCodeImageFormat.Jpeg`. | +| **Uruchamianie na .NET Framework 4.7** | Ten sam kod działa; wystarczy odwołać się do odpowiedniego `Aspose.BarCode.dll`. | + +## Pełny listing źródłowy (do uruchomienia) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Oczekiwany wynik** – plik PNG o wymiarach 200 × 100 pikseli zawierający wyraźny mikro‑kod PDF417, który dekoduje się jako „Sample text”. + +## Podsumowanie + +Teraz wiesz, jak **create micro PDF417 barcode** w C#, **set barcode dimensions** oraz **generate a barcode PNG**. Pełny przykład demonstruje każdy niezbędny krok – od instalacji biblioteki po zapis końcowego pliku – dzięki czemu możesz wbudować generowanie kodów kreskowych bezpośrednio w własnych aplikacjach. + +Następnie eksploruj pokrewne tematy, takie jak **creating QR codes with Aspose.BarCode**, **customizing colors** czy **embedding barcodes in PDF documents**. Wszystkie te zagadnienia opierają się na tych samych podstawach `BarcodeGenerator`, które omówiliśmy. + +Śmiało eksperymentuj z różnymi ciągami danych, liczbą kolumn i wartościami wymiaru X, aby dopasować je do swojego środowiska skanowania. Powodzenia w kodowaniu! + +## Co powinieneś nauczyć się dalej? + +Poniższe tutoriale obejmują tematy ściśle powiązane, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne, działające przykłady kodu oraz wyjaśnienia krok po kroku, pomagające opanować dodatkowe funkcje API i poznać alternatywne podejścia implementacyjne w własnych projektach. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/polish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..8c27cfbd3 --- /dev/null +++ b/barcode/polish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,203 @@ +--- +category: general +date: 2026-08-22 +description: Dowiedz się, jak stworzyć kod kreskowy PDF417 w C# przy użyciu generatora + kodów kreskowych, ustawić układ i zapisać jako PNG. Zawiera pełny kod oraz wskazówki + do projektów generatora kodów kreskowych w C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: pl +lastmod: 2026-08-22 +og_description: Utwórz kod kreskowy PDF417 w C# przy użyciu generatora kodów kreskowych, + dostosuj układ i dowiedz się, jak zapisać PNG. Postępuj zgodnie z tym samouczkiem + krok po kroku. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Tworzenie kodu kreskowego PDF417 w C# – pełny przewodnik po generowaniu + i zapisywaniu PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Jak utworzyć kod kreskowy PDF417 w C# i zapisać go jako PNG +url: /pl/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak utworzyć kod kreskowy PDF417 w C# i zapisać go jako PNG + +Jeśli potrzebujesz **utworzyć kod kreskowy PDF417** w aplikacji C#, ten tutorial pokaże Ci dokładne kroki. Zobaczysz, jak biblioteka generatora kodów kreskowych C# może zamienić dowolny ciąg znaków w skanowalny obraz PDF417 oraz jak zapisać pliki PNG bez dodatkowych narzędzi. + +Generowanie kodów kreskowych jest powszechne w logistyce, biletowaniu i zarządzaniu dokumentami. Po zakończeniu tego przewodnika będziesz mieć działający program konsolowy, który tworzy plik PNG o nazwie `Pdf417Layout.png` w wybranym folderze. + +## Wymagania wstępne + +Zanim rozpoczniesz, upewnij się, że masz: + +- .NET 6.0 SDK lub nowszy zainstalowany (kod działa również z .NET Framework 4.7+). +- Visual Studio 2022 lub dowolny edytor, który potrafi budować projekty C#. +- Pakiet NuGet **Aspose.BarCode for .NET** (lub dowolna kompatybilna biblioteka generatora kodów kreskowych C#). + Zainstaluj go za pomocą: + +```bash +dotnet add package Aspose.BarCode +``` + +Nie są wymagane dodatkowe biblioteki do przetwarzania obrazów, ponieważ generator może zapisywać PNG bezpośrednio. + +## Krok 1: Utwórz nowy projekt konsolowy + +Utwórz nowy projekt konsolowy, aby przykład był samodzielny. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Folder `Pdf417Demo` zawiera teraz plik `Program.cs`, w którym napiszesz kod generujący kod kreskowy. + +## Krok 2: Zaimportuj przestrzeń nazw kodu kreskowego + +Otwórz `Program.cs` i dodaj wymaganą dyrektywę `using` na początku: + +```csharp +using Aspose.BarCode.Generation; +``` + +Ta przestrzeń nazw daje dostęp do `BarcodeGenerator`, `EncodeTypes` oraz wyliczenia formatu obrazu potrzebnego do **jak zapisać PNG**. + +## Krok 3: Utwórz generator kodu kreskowego PDF417 + +Rdzeniem **jak wygenerować PDF417** jest klasa `BarcodeGenerator`. Przekaż typ kodowania `EncodeTypes.Pdf417` oraz tekst, który ma zostać zakodowany. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` zawiera teraz wszystkie ustawienia kodu kreskowego. Domyślny układ działa, ale w następnym kroku go dostosujemy. + +## Krok 4: Zdefiniuj układ kodu kreskowego (kolumny i wiersze) + +PDF417 pozwala kontrolować liczbę kolumn (2‑30) i wierszy (1‑90). Dostosowanie tych wartości może poprawić czytelność dla konkretnych skanerów. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Porada:** Jeśli pominiesz te ustawienia, biblioteka automatycznie wybierze optymalne wartości. Jednak ustalenie stałych kolumn i wierszy zapewnia przewidywalne wymiary obrazu, co jest przydatne przy osadzaniu PNG w PDF lub układzie UI. + +## Krok 5: Zapisz wygenerowany kod kreskowy jako obraz PNG + +Teraz odpowiedz na pytanie **jak zapisać PNG** wywołując `Save`. Metoda przyjmuje ścieżkę docelową oraz wyliczenie formatu obrazu. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Plik `Pdf417Layout.png` pojawia się w folderze projektu `bin/Debug/net6.0` po uruchomieniu programu. + +## Pełny działający przykład + +Poniżej znajduje się kompletny plik `Program.cs`. Skopiuj go do projektu utworzonego w **Kroku 1** i uruchom `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Oczekiwany wynik + +Po uruchomieniu programu konsola wypisuje pełną ścieżkę do pliku PNG, a plik zawiera wyraźny kod kreskowy PDF417, który wygląda podobnie do obrazu poniżej. + +![przykład tworzenia kodu kreskowego PDF417](image-placeholder.png "Kod kreskowy PDF417 zapisany jako PNG") + +Możesz zeskanować PNG dowolnym skanerem kompatybilnym z PDF417 (aplikacje mobilne, czytniki sprzętowe), aby zweryfikować, że zakodowany tekst to `"Sample"`. + +## Obsługa przypadków brzegowych i typowych pułapek + +| Sytuacja | Na co zwrócić uwagę | Zalecane rozwiązanie | +|-----------|-------------------|-----------------| +| **Nieprawidłowe wartości kolumn/wierszy** | Wartości poza zakresem 2‑30 (kolumn) lub 1‑90 (wierszy) powodują `ArgumentException`. | Zweryfikuj dane wejściowe użytkownika przed przypisaniem lub pozwól bibliotece wybrać wartości domyślne. | +| **Długie ciągi wejściowe** | PDF417 może zakodować do 1 850 znaków, ale bardzo długie ciągi znacznie zwiększają liczbę wymaganych wierszy. | Podziel dane na wiele kodów kreskowych lub użyj wyższego poziomu korekcji błędów, jeśli to konieczne. | +| **Uprawnienia systemu plików** | Zapisywanie do folderu tylko do odczytu powoduje `UnauthorizedAccessException`. | Zapisz do `Environment.CurrentDirectory` lub ścieżki zapisywalnej przez użytkownika i obsłuż wyjątki przy pomocy try/catch. | +| **Brak pakietu NuGet** | Kompilacja nie powodzi się z komunikatem „type or namespace name could not be found”. | Upewnij się, że `Aspose.BarCode` jest zainstalowany (`dotnet add package Aspose.BarCode`). | + +## Rozszerzanie przykładu + +Teraz, gdy wiesz **jak utworzyć kod kreskowy PDF417** i **jak zapisać PNG**, możesz zgłębić następujące powiązane tematy: + +- **Barcode generator C#**: Zmień `EncodeTypes` na `Code128`, `QR` lub inne symbologie. +- **Custom colors**: Użyj `generator.Parameters.Barcode.ForegroundColor` i `BackgroundColor`, aby dopasować kolory do marki. +- **Embedding in PDFs**: Połącz PNG z biblioteką PDF (np. iText7), aby tworzyć dokumenty do druku. +- **Dynamic data**: Pobierz tekst z bazy danych lub wejścia użytkownika, aby generować kody kreskowe w locie. + +## Podsumowanie + +Masz teraz kompletną, gotową do produkcji rozwiązanie do **utworzenia kodu kreskowego PDF417** w C# i zapisania wyniku jako plik PNG. Tutorial omówił każdy krok, od konfiguracji projektu po dostosowanie układu, oraz wskazał, jak unikać typowych błędów przy używaniu biblioteki generatora kodów kreskowych C#. + +Śmiało eksperymentuj z różnymi ustawieniami kolumn/wierszy, kolorami lub nawet innymi formatami kodów kreskowych. Jeśli napotkasz problemy, wróć do sekcji **jak wygenerować PDF417** lub zapoznaj się z dokumentacją biblioteki, aby poznać zaawansowane funkcje. Szczęśliwego kodowania! + +## Co powinieneś nauczyć się dalej? + +Poniższe tutoriale obejmują ściśle powiązane tematy, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne działające przykłady kodu z wyjaśnieniami krok po kroku, aby pomóc Ci opanować dodatkowe funkcje API i odkrywać alternatywne podejścia implementacyjne w własnych projektach. + +- [Jak utworzyć kod kreskowy – Compact PDF417 z Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Jak wygenerować kod kreskowy PDF417 – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Jak utworzyć strefę ciszy kodu kreskowego dla ITF-14 przy użyciu Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/polish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..5a7dabd58 --- /dev/null +++ b/barcode/polish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,196 @@ +--- +category: general +date: 2026-08-22 +description: Dowiedz się, jak generować kod kreskowy PDF417 w C# przy użyciu Aspose.BarCode, + ustawiać rozmiar kodu, regulować kolumny i włączać tryb kompaktowy. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: pl +lastmod: 2026-08-22 +og_description: Generuj kod kreskowy PDF417 w C# przy użyciu Aspose.BarCode. Ten przewodnik + pokazuje, jak ustawić rozmiar kodu, kontrolować liczbę kolumn oraz włączyć tryb + kompaktowy, aby uzyskać mniejszy obraz. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Generowanie kodu kreskowego PDF417 w C# – ustaw rozmiar, kolumny i tryb + kompaktowy +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Jak wygenerować kod kreskowy PDF417 w C# i ustawić jego rozmiar +url: /pl/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak wygenerować kod kreskowy PDF417 w C# i ustawić rozmiar kodu kreskowego + +Jeśli potrzebujesz **wygenerować kod kreskowy PDF417** w aplikacji .NET, ten przewodnik przeprowadzi Cię przez cały proces. Zobaczysz dokładnie **jak wygenerować PDF417** przy użyciu Aspose.BarCode, jak dostosować **rozmiar kodu kreskowego**, oraz jak stworzyć skompresowany PNG, który można osadzić w raportach lub aplikacjach mobilnych. + +Tworzenie kodu kreskowego nie wymaga osobnego edytora graficznego. Po zakończeniu tego samouczka będziesz mieć w pełni funkcjonalną metodę w C#, która generuje obraz PDF417 o dokładnych wymiarach, które potrzebujesz, gotowy do dalszego przetwarzania. + +## Czego się nauczysz + +* Zainstaluj i odwołaj się do biblioteki Aspose.BarCode. +* Utwórz generator kodu kreskowego PDF417 i określ kodowany tekst. +* **Ustaw rozmiar kodu kreskowego** poprzez konfigurację wymiaru X i liczby kolumn. +* Włącz tryb kompaktowy (przycięty), aby zmniejszyć symbol. +* Zapisz wynik jako plik PNG. +* Rozwiąż typowe problemy, takie jak nieczytelne kody i zbyt duże obrazy. + +### Wymagania wstępne + +* .NET 6.0 lub nowszy (API działa również z .NET Framework 4.6+). +* Podstawowa znajomość C# i Visual Studio (lub dowolnego IDE C#). +* Ważna licencja Aspose.BarCode (darmowa wersja ewaluacyjna działa do testów). + +> **Pro tip:** Jeśli planujesz generować wiele kodów kreskowych w pętli, ponownie używaj jednej instancji `BarcodeGenerator` i zmieniaj jedynie właściwość `CodeText`. To zmniejsza alokacje pamięci. + +## Generowanie kodu kreskowego PDF417 przy użyciu Aspose.BarCode + +Pierwszym krokiem jest utworzenie instancji `BarcodeGenerator` dla symboliki PDF417. Ten obiekt jest punktem wejścia dla wszystkich operacji na kodach kreskowych. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Dlaczego to ważne*: `EncodeTypes.Pdf417` informuje bibliotekę, aby użyła standardu PDF417, który obsługuje duże wolumeny danych i korekcję błędów. Konstruktor przyjmuje również dane do zakodowania, eliminując potrzebę późniejszego oddzielnego przypisania `CodeText`. + +## Ustaw rozmiar kodu kreskowego i liczbę kolumn + +Symbole PDF417 składają się z wierszy i kolumn małych prostokątnych modułów. Kontrolowanie szerokości modułu (wymiar X) i liczby kolumn pozwala precyzyjnie dostroić całkowite wymiary. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Wyjaśnienie*: +* **X‑dimension** (`Pixels`) określa, jak szeroki jest każdy moduł. Mniejsze wartości tworzą bardziej zwartą kod kreskowy, podczas gdy większe wartości zwiększają czytelność na skanerach o niskiej rozdzielczości. +* **Columns** kontrolują układ poziomy. Mniej kolumn sprawia, że kod kreskowy jest wyższy; więcej kolumn sprawia, że jest szerszy. Dostosuj te dwa ustawienia razem, aby uzyskać dokładny **rozmiar kodu kreskowego**, którego potrzebujesz. + +## Włącz tryb kompaktowy dla mniejszego kodu kreskowego + +PDF417 zawiera tryb „compact” (lub przycięty), który usuwa niepotrzebne wypełnienie i zmniejsza ogólny rozmiar. Jest to szczególnie przydatne, gdy masz ograniczoną przestrzeń ekranu. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Dlaczego włączyć przycinanie?* Gdy `Truncate` jest ustawione na `true`, generator pomija wzorzec stopu oraz niektóre słowa korekcji błędów, które nie są wymagane w większości scenariuszy skanowania. Powstały obraz jest o około 15‑20 % mniejszy, nie poświęcając integralności danych w typowych zastosowaniach. + +## Zapisz kod kreskowy jako obraz PNG + +Po skonfigurowaniu rozmiaru i trybu, zapisz kod kreskowy na dysk. PNG jest bezstratny, zapewniając ostre krawędzie modułów. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Plik `CompactPdf417.png` będzie zawierał wyraźny symbol PDF417, który odpowiada wymiarom ustawionym w poprzednich krokach. + +### Oczekiwany wynik + +Otwarcie zapisanego pliku PNG powinno wyświetlić pionowo‑zorientowany kod kreskowy PDF417 składający się z trzech kolumn, każdy moduł ma szerokość 2 px, a całkowity rozmiar wynosi około **120 × 240 px** (szerokość × wysokość). Zeskanowanie obrazu dowolnym standardowym czytnikiem PDF417 zwróci oryginalny tekst „Sample text for PDF417”. + +## Typowe pułapki i jak ich unikać + +| Objaw | Prawdopodobna przyczyna | Rozwiązanie | +|---------|--------------|-----| +| Kod kreskowy jest nieczytelny | Wymiar X jest zbyt mały dla skanera | Zwiększ `XDimension.Pixels` do 3 lub 4 | +| Obraz jest zbyt szeroki dla interfejsu UI | Ustawiono zbyt wiele kolumn | Zredukuj `Pdf417.Columns` lub włącz `Truncate` | +| Wyjątek `ArgumentOutOfRangeException` | Ujemna lub zerowa liczba kolumn | Upewnij się, że `Columns` jest dodatnią liczbą całkowitą (minimum 1) | +| Plik PNG jest pusty | Ścieżka wyjściowa nie istnieje lub brak uprawnień do zapisu | Sprawdź, czy katalog istnieje i aplikacja ma prawa do zapisu | + +> **Pro tip:** Użyj `barcodeGenerator.ValidateParameters()` przed wywołaniem `Save()`, aby wcześnie wykryć błędy konfiguracji. + +## Pełny, działający przykład + +Poniżej znajduje się samodzielny program konsolowy, który zawiera wszystkie powyższe kroki. Skopiuj go do nowego projektu C#, przywróć pakiet NuGet Aspose.BarCode i uruchom, aby zobaczyć wynik. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Uruchomienie programu** tworzy `CompactPdf417.png` w katalogu roboczym pliku wykonywalnego. Zeskanuj obraz aplikacją mobilną (np. „Barcode Scanner”), aby zweryfikować, że zakodowany tekst odpowiada źródłowemu ciągowi. + +## Kolejne kroki i powiązane tematy + +* **Zwiększ poziom korekcji błędów** – dostosuj `Pdf417.ErrorLevel` dla środowisk z szumem skanowania. +* **Zmień orientację** – ustaw `Pdf417.Rotate` na `RotationAngle.Rotate90`, jeśli potrzebny jest układ poziomy. +* **Osadź kod kreskowy w PDF** – połącz Aspose.PDF z Aspose.BarCode, aby umieścić obraz bezpośrednio w dokumencie. +* **Generuj inne kody 2‑D** – klasa `BarcodeGenerator` obsługuje DataMatrix, QR i kody Aztec; wystarczy zamienić `EncodeTypes.Pdf417` na żądaną symbolikę. + +Teraz wiesz, jak **wygenerować kod kreskowy PDF417** w C#, precyzyjnie **ustawić rozmiar kodu kreskowego**, skonfigurować kolumny, włączyć tryb kompaktowy i zapisać wynik jako PNG. Zastosuj te ustawienia, aby dopasować się do dowolnych ograniczeń UI lub wymagań skanowania, i rozszerz podejście na inne formaty kodów kreskowych w razie potrzeby. Szczęśliwego kodowania! + +## Co powinieneś się nauczyć dalej? + +Poniższe samouczki obejmują ściśle powiązane tematy, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne działające przykłady kodu oraz szczegółowe wyjaśnienia, aby pomóc Ci opanować dodatkowe funkcje API i odkrywać alternatywne podejścia w własnych projektach. + +- [Jak wygenerować kod kreskowy PDF417 – Kompaktowe kodowanie PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Jak utworzyć kod kreskowy – Kompaktowy PDF417 z Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Jak wygenerować kody DataMatrix przy użyciu Aspose.BarCode dla .NET – Przewodnik krok po kroku](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/polish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..3d48b70dd --- /dev/null +++ b/barcode/polish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: Jak odczytywać kody kreskowe PDF417 w C# w przewodniku krok po kroku, + obejmującym odczyt wielu kodów z obrazu oraz wyodrębnianie szczegółów MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: pl +lastmod: 2026-08-22 +og_description: Jak szybko odczytywać kody kreskowe PDF417 w C#. Ten samouczek pokazuje, + jak odczytać wiele kodów z obrazu i uzyskać rozszerzone informacje MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Jak odczytać kody kreskowe PDF417 w C# – pełny przewodnik programistyczny +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Jak odczytać kody kreskowe PDF417 w C# – kompletny przewodnik +url: /pl/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak odczytać kody kreskowe PDF417 w C# – kompletny przewodnik + +Jeśli potrzebujesz **jak odczytać PDF417** w aplikacji .NET, ten tutorial dostarcza gotowe rozwiązanie do uruchomienia. Nauczysz się, jak odczytać wiele kodów kreskowych z jednego obrazu, wyodrębnić pełny zestaw danych MacroPdf417 i wyświetlić go w konsoli. Podejście działa z biblioteką Aspose.BarCode for .NET i wymaga tylko kilku linii kodu. + +Odczytywanie kodów kreskowych z obrazu to powszechne zadanie w systemach inwentaryzacji, weryfikacji biletów i zarządzaniu dokumentami. Po zakończeniu tego przewodnika będziesz w stanie zdekodować dowolny kod PDF417 lub MacroPdf417, obsłużyć kilka kodów na jednym obrazie oraz zrozumieć rozszerzone pola, które dostarcza MacroPdf417. + +## Wymagania wstępne + +- .NET 6.0 SDK lub nowszy (kod kompiluje się również z .NET Framework 4.7+) +- Visual Studio 2022 lub dowolny edytor C#, którego używasz +- Pakiet NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Przykładowy obraz zawierający kod MacroPdf417 (np. `MacroPdf417.png`) + +Nie wymagana jest dodatkowa konfiguracja; biblioteka wewnętrznie obsługuje wczytywanie obrazu i dekodowanie. + +## Jak odczytać kody kreskowe PDF417 z obrazu w C# + +Kluczowym elementem rozwiązania jest klasa `BarCodeReader`. Otwiera ona obraz, wykrywa wszystkie kody kreskowe określonego typu i zwraca kolekcję obiektów `BarCodeResult`. Poniższy kod przedstawia kompletny program konsolowy. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Dlaczego każdy wiersz ma znaczenie + +| Krok | Cel | +|------|-----| +| **1️⃣ Initialize** | Tworzy `BarCodeReader` powiązany z plikiem obrazu i ogranicza wykrywanie do symbologii MacroPdf417, co przyspiesza przetwarzanie. | +| **2️⃣ Iterate** | `ReadBarCodes()` zwraca **wszystkie** kody kreskowe pasujące do żądanego typu, umożliwiając **odczyt wielu kodów** bez dodatkowych pętli. | +| **3️⃣ Basic output** | Wyświetla ogólną nazwę typu `CodeTypeName` oraz czytelny dla człowieka `CodeText`. Jest to przydatne do logowania lub szybkiej weryfikacji. | +| **4️⃣ Extended data** | MacroPdf417 zawiera dodatkowe metadane (identyfikator pliku, liczba segmentów, znaczniki czasu itp.). Obiekt `Extended.Pdf417` udostępnia każde pole bezpośrednio, dzięki czemu możesz przechowywać lub weryfikować cały pakiet danych. | + +Uruchomienie programu na prawidłowym obrazie MacroPdf417 generuje w konsoli wyjście podobne do poniższego: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Wyjście potwierdza, że biblioteka pomyślnie odczytała kod kreskowy, wyodrębniła tekst i udostępniła wszystkie pola MacroPdf417. + +## Odczytywanie wielu kodów kreskowych z jednego obrazu + +W wielu rzeczywistych scenariuszach na jednej etykiecie umieszczonych jest kilka symboli PDF417 — pomyśl o liście przewozowej zawierającej kod przewoźnika, numer śledzenia i deklarację celną. Powyższy blok kodu już **odczytuje wiele kodów kreskowych**, ponieważ `ReadBarCodes()` zwraca enumerację wszystkich dopasowań. Nie wymagana jest dodatkowa konfiguracja; wystarczy przejść pętlą po wynikach, jak pokazano. + +Jeśli chcesz ograniczyć czytnik do standardowego PDF417 (bez makra), a jednocześnie obsługiwać kilka kodów, zamień `DecodeType.MacroPdf417` na `DecodeType.Pdf417`. Reszta logiki pozostaje niezmieniona. + +## Zrozumienie rozszerzonych danych MacroPdf417 + +MacroPdf417 to rozszerzenie standardowej specyfikacji PDF417. Dzieli duże ładunki na wiele segmentów i dodaje mały nagłówek opisujący cały plik. Najważniejsze pola to: + +- **MacroPdf417FileID** – unikalny identyfikator współdzielony przez wszystkie segmenty tego samego pliku. +- **MacroPdf417SegmentID** – numer kolejny bieżącego segmentu. +- **MacroPdf417SegmentsCount** – łączna liczba oczekiwanych segmentów. +- **MacroPdf417FileName** – opcjonalna nazwa pliku przesyłana wraz z kodem kreskowym. +- **MacroPdf417Checksum** – wartość kontrolna służąca do sprawdzania błędów całego pliku. +- **MacroPdf417FileSize** – rozmiar oryginalnego binarnego ładunku. +- **MacroPdf417TimeStamp** – znacznik czasu w formacie ISO‑8601, kiedy kod został wygenerowany. +- **MacroPdf417Addressee / Sender** – opcjonalne pola tekstowe służące do routingu. +- **MacroPdf417Terminator** – wskazuje, czy dany segment jest ostatnim. + +Gdy otrzymasz wszystkie segmenty, możesz odtworzyć oryginalny plik, sortując je według `MacroPdf417SegmentID` i łącząc wartości `CodeText`. Ta logika jest prosta do zaimplementowania, gdy pola są dostępne. + +## Częste pułapki i profesjonalne wskazówki + +- **Image quality matters** – niska rozdzielczość lub silnie skompresowane pliki PNG/JPEG mogą powodować pominięcie wykryć. Używaj DPI co najmniej 300 dpi dla drukowanych kodów. +- **Mixed symbologies** – jeśli obraz zawiera zarówno MacroPdf417, jak i zwykły PDF417, utwórz dwa czytniki (po jednym dla każdego `DecodeType`) lub użyj `DecodeType.AllSupported` i przefiltruj wyniki po `result.CodeTypeName`. +- **Memory usage** – instrukcja `using` natychmiast zwalnia `BarCodeReader`, zapobiegając pozostawaniu dużych buforów obrazu w pamięci. +- **Thread safety** – `BarCodeReader` nie jest bezpieczny wątkowo. Twórz osobną instancję na każdy wątek, jeśli dekodujesz obrazy równolegle. +- **Error handling** – otocz wywołanie `ReadBarCodes()` blokiem try/catch, aby przechwycić `BarCodeException` w przypadku uszkodzonych obrazów. + +## Pełny działający przykład – podsumowanie + +Poniżej znajduje się kompletny program, który możesz skopiować do nowego projektu konsolowego. Zawiera wszystkie dyrektywy `using`, stałą określającą ścieżkę do obrazu oraz wzorzec zwalniania zasobów. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Kompiluj poleceniem `dotnet build` i uruchom `dotnet run`. Konsola wypisze podstawowe dane każdego kodu oraz pełny ładunek MacroPdf417. + +## Następne kroki + +- **Reconstruct multipart files** – zbierz wszystkie segmenty, posortuj je według `MacroPdf417SegmentID` i połącz `CodeText` aby + +## Co powinieneś się nauczyć dalej? + +Poniższe tutoriale obejmują ściśle powiązane tematy, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne działające przykłady kodu wraz z krok po kroku wyjaśnieniami, pomagając opanować dodatkowe funkcje API i odkrywać alternatywne podejścia implementacyjne w własnych projektach. + +- [Jak wygenerować kod kreskowy PDF417 – kompaktowe kodowanie PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Jak odczytać kody kreskowe PDF417 z tureckimi znakami w Javie](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Jak używać Aspose do kodu kreskowego PDF417 (chiński) w Javie](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/polish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..5fdc02fb7 --- /dev/null +++ b/barcode/polish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,224 @@ +--- +category: general +date: 2026-08-22 +description: Samouczek generatora kodów kreskowych w C# pokazuje, jak utworzyć kod + Macro PDF417 z metadanymi i zapisać go jako PNG przy użyciu Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: pl +lastmod: 2026-08-22 +og_description: generator kodów kreskowych C# umożliwia tworzenie kodu Macro PDF417 + z pełnymi metadanymi na poziomie pliku i eksportowanie go jako PNG. Postępuj zgodnie + z tym przewodnikiem, aby wdrożyć rozwiązanie. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: generator kodów kreskowych C# – twórz kody Macro PDF417 krok po kroku +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Jak używać generatora kodów kreskowych C# dla Macro PDF417 +url: /pl/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak używać generatora kodów kreskowych C# dla Macro PDF417 + +Jeśli potrzebujesz **generatora kodów kreskowych C#**, który może generować symbol Macro PDF417 z metadanymi na poziomie pliku, ten przewodnik zapewnia kompletną, gotową do uruchomienia rozwiązanie. Zobaczysz, jak skonfigurować wygląd kodu kreskowego, osadzić informacje makro, takie jak identyfikator pliku i liczba segmentów, oraz ostatecznie zapisać wynik jako obraz PNG. + +Przykład wykorzystuje bibliotekę Aspose.BarCode, powszechnie stosowaną **bibliotekę kodów kreskowych C#**, która obsługuje pełny zestaw funkcji PDF417. Nie są wymagane żadne zewnętrzne usługi, a kod działa z .NET 6 lub nowszym. + +## Prerequisites + +* .NET 6 SDK (lub nowsza wersja) zainstalowany. +* Visual Studio 2022, VS Code lub inne środowisko IDE C#. +* Odwołanie NuGet do **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Zrozumienie podstawowej składni C# oraz koncepcji kodów kreskowych PDF417 pomoże Ci śledzić kolejne kroki, ale sam poradnik wyjaśnia każdą opcję konfiguracji szczegółowo. + +## What the tutorial covers + +* Inicjalizacja instancji **generatora kodów kreskowych C#** dla formatu Macro PDF417. +* Dostosowanie parametrów wizualnych, takich jak wymiar X i liczba kolumn. +* Podanie pól na poziomie pliku Macro PDF417: identyfikator pliku, identyfikator segmentu, liczba segmentów, nazwa pliku, suma kontrolna, rozmiar pliku, znacznik czasu, adresat, nadawca oraz znacznik zakończenia. +* Zapis wygenerowanego symbolu jako plik PNG. +* Wskazówki dotyczące obsługi przypadków brzegowych, takich jak duże rozmiary plików lub własne znaczniki czasu. + +Po zakończeniu tego artykułu będziesz mieć samodzielny program, który generuje w pełni zgodny kod Macro PDF417. + +## Step 1: Create the barcode generator C# instance + +Pierwszą operacją jest utworzenie instancji `BarcodeGenerator` z wartością wyliczenia `EncodeTypes.MacroPdf417` oraz tekstem, który chcesz zakodować. Konstruktor przyjmuje także ciąg ładunku, który staje się częścią danych makro kodu kreskowego. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Dlaczego to ważne** – Flaga `EncodeTypes.MacroPdf417` informuje Aspose.BarCode, aby traktował symbol jako kod makro, umożliwiając dodatkowe pola, które pojawią się później. Bez tej flagi biblioteka wygenerowałaby zwykły kod PDF417 bez metadanych na poziomie pliku. + +## Step 2: Adjust basic barcode appearance (PDF417 visual settings) + +Czytelność wizualna jest kluczowa dla niezawodnego skanowania. Dwa powszechne parametry to szerokość modułu (`XDimension`) oraz liczba kolumn. Ustawienie tych wartości równoważy rozmiar i czytelność. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` kontroluje szerokość każdego czarnego/białego paska. Wartość **2** sprawdza się w większości drukarek etykiet. +* `Pdf417.Columns` określa, ile kolumn użyje kod kreskowy. Pięć kolumn tworzy kompaktowy symbol bez utraty pojemności danych. + +## Step 3: Define Macro PDF417 file‑level information + +Macro PDF417 rozszerza standardowy format PDF417 o pola opisujące, jak duży plik jest podzielony na wiele segmentów kodu kreskowego. Dostarczenie tych pól zapewnia, że skanery po stronie odbiorcy mogą odtworzyć oryginalny plik. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` musi być taki sam dla każdego segmentu należącego do tego samego logicznego pliku. +* `MacroPdf417SegmentID` zwiększa się od **0** do `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` informuje dekoder, ile części ma się spodziewać. +* `MacroPdf417FileName` jest opcjonalny, ale przydatny do identyfikacji czytelnej dla człowieka. + +## Step 4: Set additional macro metadata + +Poza podstawowymi informacjami o pliku, specyfikacja dopuszcza dodatkowe pola, takie jak suma kontrolna, rozmiar pliku, znacznik czasu, adresat, nadawca oraz flaga zakończenia. Wypełnienie tych pól zwiększa integralność danych i ich śledzenie. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` dostarcza 16‑bitową sumę kontrolną CCITT dla całego pliku; dekoder może zweryfikować integralność po odtworzeniu. +* `MacroPdf417FileSize` powinien odzwierciedlać dokładną liczbę bajtów oryginalnego pliku; wartości większe niż `2^31‑1` wymagają pola 64‑bitowego, które Aspose obsługuje automatycznie. +* `MacroPdf417TimeStamp` rejestruje moment generowania kodu kreskowego. Używaj UTC, aby uniknąć niejasności stref czasowych. +* `MacroPdf417Addressee` i `MacroPdf417Sender` to dowolne ciągi znaków, które mogą przechowywać informacje o trasie. +* `MacroPdf417Terminator` sygnalizuje, że jest to ostatni segment; ustaw go na `Set` dla ostatniego fragmentu, w przeciwnym razie pozostaw domyślne (`NotSet`). + +**Wskazówka w przypadku brzegowym** – Jeśli rozmiar pliku przekracza 4 GB, podziel zawartość na wiele segmentów makro i odpowiednio dostosuj `SegmentsCount`. Biblioteka poradzi sobie z polem dużego rozmiaru bez przepełnienia. + +## Step 5: Save the barcode as a PNG image + +Ostatni krok zapisuje wygenerowany symbol na dysku. PNG zachowuje dokładne wymiary pikseli i jest szeroko wspierany przez sprzęt skanujący. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Zastąp `YOUR_DIRECTORY` ścieżką absolutną lub względną, do której proces wykonujący może zapisywać. Enum `BarCodeImageFormat.Png` zapewnia wyjście bezstratne. + +**Dlaczego PNG?** – Format rastrowy, taki jak PNG, utrzymuje ostre krawędzie modułów, co jest niezbędne dla skanerów opierających się na wysokim kontraście krawędzi. Jeśli potrzebujesz formatu wektorowego, Aspose obsługuje także `Pdf` i `Svg`. + +## Full runnable example + +Poniżej znajduje się kompletny program, który możesz skopiować do aplikacji konsolowej. Zawiera niezbędne dyrektywy `using` oraz metodę `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Expected output + +Uruchomienie programu tworzy plik o nazwie **MacroPdf417.png** w katalogu roboczym projektu. Otworzenie obrazu pokazuje kompaktowy kod PDF417 z osadzonymi polami makro. Skanowanie obrazu przy użyciu czytnika kompatybilnego z PDF417 (np. ZXing, dekoder Aspose.BarCode) zwraca oryginalny ładunek `"Sample text"` wraz z metadanymi makro. + +## Common questions and troubleshooting + +| Question | Answer | +|----------|--------| +| *Co zrobić, jeśli kod kreskowy jest zbyt duży dla docelowej etykiety?* | Zmniejsz `XDimension.Pixels` lub zwiększ `Pdf417.Columns`. Oba parametry wpływają na ogólny rozmiar. | +| *Czy mogę wygenerować obraz wektorowy zamiast PNG?* | Tak. Wywołaj `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` aby uzyskać skalowalny wynik. | +| *Jak zweryfikować sumę kontrolną po skanowaniu?* | Dekoder Aspose.BarCode automatycznie weryfikuje `MacroPdf417Checksum` i zgłasza niezgodności w obiekcie `MacroPdf417Result`. | +| *Czy biblioteka jest kompatybilna z .NET Core?* | Pakiet NuGet obsługuje .NET Standard 2.0+, co obejmuje .NET Core, .NET 5, .NET 6 i nowsze. | +| *Co zrobić, jeśli muszę osadzić dane binarne zamiast tekstu?* | Konwertuj binarny ładunek na Base64 lub użyj przeciążenia `EncodeTypes.MacroPdf417`, które przyjmuje tablicę bajtów. | + +## Pro tips for production use + +* **Cache'uj generator** – + +## What Should You Learn Next? + +Poniższe samouczki obejmują ściśle powiązane tematy, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne, działające przykłady kodu wraz z instrukcjami krok po kroku, aby pomóc Ci opanować dodatkowe funkcje API i odkrywać alternatywne podejścia implementacyjne w własnych projektach. + +- [Jak utworzyć kod kreskowy – Compact PDF417 z Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Jak odczytać kod kreskowy z PDF w Javie przy użyciu Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Utwórz kod kreskowy Codabar z Aspose.Barcode – API generatora i czytnika](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/net/compact-pdf417-encoding/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/_index.md index 54a67d8a7..835bee10e 100644 --- a/barcode/portuguese/net/compact-pdf417-encoding/_index.md +++ b/barcode/portuguese/net/compact-pdf417-encoding/_index.md @@ -76,7 +76,7 @@ Se você está procurando um guia claro, passo a passo, sobre **como gerar códi A Codificação Compacta PDF417 é um código de barras 2‑D de alta capacidade que armazena grandes quantidades de dados em uma área compacta. Ela organiza as informações em linhas e colunas de codewords, aplicando correção de erros Reed‑Solomon para manter os dados legíveis mesmo que parte do símbolo esteja danificada. Como remove preenchimentos desnecessários, o símbolo resultante é menor que um PDF417 padrão, mantendo a mesma robustez. -O formato pode codificar até **~2 KB de texto ou dados binários**, dependendo do nível de correção de erro escolhido, tornando‑o ideal para cenários onde o espaço é escasso. +O formato pode codificar até **~2 KB de texto ou dados binários**, dependendo do nível de correção de erro escolhido, tornando‑lo ideal para cenários onde o espaço é escasso. ## Por que Usar Compact PDF417 com Aspose.BarCode para .NET? @@ -141,9 +141,21 @@ A alta densidade de dados e a robusta correção de erro do Compact PDF417 o tor - **Exceções de Licença:** Em ambiente de teste, o código de barras gerado pode incluir uma marca d'água. Aplique uma licença válida para removê‑la. ## Tutoriais de Codificação Compacta PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + +### [Como criar código de barras PDF417 em C# e salvá-lo como PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + ### [Creating Compact PDF417 Barcodes](./compact-pdf417-basic-configuration/) Aprenda a gerar códigos de barras Compact PDF417 usando Aspose.BarCode para .NET. Guia abrangente com instruções passo a passo e exemplos de código. +### [Como criar código de barras micro PDF417 em C# – guia passo a passo](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Aprenda a gerar códigos de barras micro PDF417 em C# com Aspose.BarCode, passo a passo. + +### [Como usar um gerador de código de barras C# para Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Aprenda a gerar códigos de barras Macro PDF417 usando o gerador de código de barras em C# com Aspose.BarCode. + +### [Como ler códigos de barras PDF417 em C# – guia completo](./how-to-read-pdf417-barcodes-in-c-complete-guide/) + ## Perguntas Frequentes **Q: Qual é a quantidade máxima de dados que posso armazenar em um código de barras Compact PDF417?** diff --git a/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..419940273 --- /dev/null +++ b/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Aprenda a criar um código de barras micro PDF417 em C# e gerar uma imagem + PNG do código de barras. Inclui definir as dimensões do código de barras e salvar + o arquivo. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: pt +lastmod: 2026-08-22 +og_description: Crie um código de barras micro PDF417 em C# e exporte-o como PNG. + Siga este guia para definir as dimensões do código de barras e gerar rapidamente + uma imagem do código de barras. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Crie código de barras micro PDF417 em C# – tutorial completo de codificação +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Como criar código de barras micro PDF417 em C# – guia passo a passo +url: /pt/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como criar código de barras micro PDF417 em C# – guia passo a passo + +Se você precisa **criar código de barras micro PDF417** para um sistema de bilhetagem, etiqueta de inventário ou leitura móvel, este tutorial mostra exatamente como fazer. Você verá o programa completo em C# que gera um PNG de código de barras, aprenderá a definir as dimensões do código de barras e entenderá cada opção de configuração. + +Ao final deste guia você será capaz de gerar uma imagem de código de barras em alta resolução, personalizar a dimensão X, escolher a quantidade de colunas e salvar o resultado como um arquivo PNG — tudo com poucas linhas de código. + +## O que você precisará + +- .NET 6.0 SDK ou superior (o código funciona com .NET Core e .NET Framework) +- Visual Studio 2022 ou qualquer IDE compatível com C# +- O pacote NuGet **Aspose.BarCode for .NET** (ou qualquer biblioteca que suporte `EncodeTypes.MicroPdf417`) +- Familiaridade básica com a sintaxe C# + +> **Dica profissional:** A edição comunitária gratuita do Aspose.BarCode é suficiente para desenvolvimento e testes. Para produção, obtenha uma licença para remover as marcas d'água de avaliação. + +## Etapa 1: Instalar a biblioteca de código de barras + +Abra um terminal na pasta do seu projeto e execute: + +```bash +dotnet add package Aspose.BarCode +``` + +Isso adiciona o assembly `Aspose.BarCode`, que fornece a classe `BarcodeGenerator` usada para **criar imagens de código de barras C#**. + +## Etapa 2: Inicializar o gerador – criar código de barras micro PDF417 + +A primeira linha executável cria uma instância de `BarcodeGenerator` configurada para a simbologia Micro PDF417 e fornece os dados que você deseja codificar. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Por que isso importa*: O enum `EncodeTypes.MicroPdf417` indica à biblioteca que deve usar a versão compacta do PDF417, ideal para etiquetas pequenas e telas móveis. + +## Etapa 3: Como definir as dimensões do código de barras em C# + +Ajustar a largura do módulo (dimensão X) controla a densidade visual do código de barras. Um valor menor produz uma imagem mais nítida, enquanto um valor maior facilita a leitura à distância. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Por que você deve definir dimensões**: Sem ajustar a dimensão X, o valor padrão pode gerar um código de barras que parece borrado quando renderizado em DPI alto. Definir para 2 pixels é um bom equilíbrio para a maioria das leituras baseadas em tela. + +## Etapa 4: Escolher o número de colunas – controlando a largura do código de barras + +O Micro PDF417 permite entre 1 e 4 colunas. Mais colunas comprimem os dados horizontalmente, reduzindo a largura total da imagem. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Caso extremo*: Se você solicitar 5 colunas, a biblioteca lançará uma `ArgumentOutOfRangeException`. Sempre permaneça dentro do intervalo documentado. + +## Etapa 5: Como gerar PNG do código de barras – salvando a imagem + +Agora você pode exportar o código de barras gerado para um arquivo PNG. PNG preserva qualidade sem perdas, o que é essencial para leituras confiáveis. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Ao executar o programa, você verá uma mensagem no console confirmando o local do arquivo. O `MicroPdf417.png` resultante se parece com isto: + +![Captura de tela mostrando um código de barras micro PDF417 gerado com C#](micro-pdf417-example.png "Código de barras micro PDF417 gerado") + +*Texto alternativo da imagem*: **código de barras micro PDF417 gerado em C#** – demonstra a saída final após aplicar as dimensões e configurações de coluna. + +## Etapa 6: Executar e verificar a saída + +1. Compile o projeto: `dotnet build`. +2. Execute: `dotnet run`. +3. Abra `MicroPdf417.png` na sua área de trabalho e escaneie-o com um aplicativo de leitura de códigos de barras móvel. + +Você deverá ver o texto **“Sample text”** decodificado. Se o leitor relatar um erro, verifique novamente a dimensão X e a contagem de colunas – valores extremos podem tornar o código de barras denso demais para alguns dispositivos. + +## Variações comuns e solução de problemas + +| Situação | Ajuste | +|-----------|------------| +| **Precisa de um código de barras maior para impressoras de baixa resolução** | Aumente `XDimension.Pixels` para 3 ou 4. | +| **Deseja um código de barras mais alto sem mudar a largura** | Defina `generator.Parameters.Barcode.Pdf417.Rows` (intervalo de linhas 3‑90). | +| **Gerando múltiplos códigos de barras em um loop** | Reutilize a mesma instância de `BarcodeGenerator` e altere apenas `CodeText` antes de cada `Save`. | +| **Salvando como JPEG em vez de PNG** | Substitua `BarCodeImageFormat.Png` por `BarCodeImageFormat.Jpeg`. | +| **Executando no .NET Framework 4.7** | O mesmo código funciona; basta referenciar o `Aspose.BarCode.dll` apropriado. | + +## Listagem completa do código (executável) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Saída esperada** – um arquivo PNG de 200 × 100 pixels contendo um código de barras Micro PDF417 nítido que decodifica para “Sample text”. + +## Conclusão + +Agora você sabe como **criar código de barras micro PDF417** em C#, **definir dimensões do código de barras** e **gerar uma imagem PNG** do código de barras. O exemplo completo demonstra cada passo necessário — da instalação da biblioteca ao salvamento do arquivo final — para que você possa incorporar a geração de códigos de barras diretamente em suas próprias aplicações. + +Em seguida, explore tópicos relacionados como **criar códigos QR com Aspose.BarCode**, **personalizar cores** ou **incorporar códigos de barras em documentos PDF**. Cada um desses se baseia nos mesmos fundamentos do `BarcodeGenerator` abordados aqui. + +Sinta-se à vontade para experimentar diferentes strings de dados, contagens de colunas e valores de dimensão X para adequar ao seu ambiente de leitura específico. Boa codificação! + +## O que você deve aprender a seguir? + +Os tutoriais a seguir cobrem tópicos intimamente relacionados que ampliam as técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens alternativas de implementação em seus próprios projetos. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..00b07d9cf --- /dev/null +++ b/barcode/portuguese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Aprenda como criar código de barras PDF417 em C# com um gerador de códigos + de barras, definir o layout e salvar em PNG. Inclui código completo e dicas para + projetos de gerador de códigos de barras em C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: pt +lastmod: 2026-08-22 +og_description: Crie código de barras PDF417 em C# usando um gerador de códigos de + barras, personalize o layout e aprenda como salvar em PNG. Siga este tutorial passo + a passo. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Criar código de barras PDF417 em C# – guia completo para gerar e salvar + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Como criar código de barras PDF417 em C# e salvá‑lo como PNG +url: /pt/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como criar código de barras PDF417 em C# e salvá-lo como PNG + +Se você precisa **criar código de barras PDF417** em uma aplicação C#, este tutorial mostra os passos exatos. Você verá como uma biblioteca geradora de códigos de barras C# pode transformar qualquer string em uma imagem PDF417 escaneável e como salvar arquivos PNG sem ferramentas adicionais. + +Gerar códigos de barras é comum em logística, bilhetagem e gerenciamento de documentos. Ao final deste guia você terá um programa de console executável que produz um arquivo PNG chamado `Pdf417Layout.png` na pasta que você escolher. + +## Pré-requisitos + +- .NET 6.0 SDK ou posterior instalado (o código também funciona com .NET Framework 4.7+). +- Visual Studio 2022 ou qualquer editor que possa compilar projetos C#. +- O pacote NuGet **Aspose.BarCode for .NET** (ou qualquer biblioteca geradora de códigos de barras C# compatível). + Instale-o com: + +```bash +dotnet add package Aspose.BarCode +``` + +Nenhuma biblioteca adicional de processamento de imagem é necessária porque o gerador pode gravar PNG diretamente. + +## Etapa 1: Configurar um novo projeto de console + +Crie um novo projeto de console para que o exemplo permaneça autocontido. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +A pasta `Pdf417Demo` agora contém um arquivo `Program.cs` onde escreveremos o código do código de barras. + +## Etapa 2: Importar o namespace do código de barras + +Abra `Program.cs` e adicione a diretiva `using` necessária no topo: + +```csharp +using Aspose.BarCode.Generation; +``` + +Este namespace fornece acesso a `BarcodeGenerator`, `EncodeTypes` e ao enum de formato de imagem necessário para **como salvar PNG**. + +## Etapa 3: Criar o gerador de código de barras PDF417 + +O núcleo de **como gerar PDF417** é a classe `BarcodeGenerator`. Passe o tipo de codificação `EncodeTypes.Pdf417` e o texto que deseja codificar. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` agora contém todas as configurações do código de barras. O layout padrão funciona, mas vamos personalizá-lo na próxima etapa. + +## Etapa 4: Definir o layout do código de barras (colunas e linhas) + +PDF417 permite controlar o número de colunas (2‑30) e linhas (1‑90). Ajustar esses valores pode melhorar a legibilidade para scanners específicos. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Dica profissional:** Se você omitir essas configurações, a biblioteca escolhe valores ótimos automaticamente. No entanto, fixar colunas e linhas fornece dimensões de imagem previsíveis, o que é útil ao incorporar o PNG em um PDF ou em um layout de UI. + +## Etapa 5: Salvar o código de barras gerado como imagem PNG + +Agora responda **como salvar PNG** chamando `Save`. O método aceita o caminho de destino e o enum de formato de imagem. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +O arquivo `Pdf417Layout.png` aparece na pasta `bin/Debug/net6.0` do projeto após executar o programa. + +## Exemplo completo executável + +Abaixo está o arquivo `Program.cs` completo. Copie-o para o projeto criado na **Etapa 1** e execute `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Saída esperada + +Ao executar o programa, o console imprime o caminho absoluto do arquivo PNG, e o arquivo contém um código de barras PDF417 nítido que se parece com a imagem abaixo. + +![exemplo de criação de código de barras PDF417](image-placeholder.png "Código de barras PDF417 salvo como PNG") + +Você pode escanear o PNG com qualquer scanner compatível com PDF417 (apps móveis, leitores de hardware) para verificar que o texto codificado é `"Sample"`. + +## Tratamento de casos extremos e armadilhas comuns + +| Situação | O que observar | Correção recomendada | +|-----------|-------------------|-----------------| +| **Valores de coluna/linha inválidos** | Valores fora do intervalo 2‑30 (colunas) ou 1‑90 (linhas) causam um `ArgumentException`. | Valide a entrada do usuário antes de atribuir, ou deixe a biblioteca escolher os padrões. | +| **Strings de entrada grandes** | PDF417 pode codificar até 1.850 caracteres, mas strings muito longas aumentam drasticamente o número de linhas necessárias. | Divida os dados em múltiplos códigos de barras ou use um nível de correção de erro mais alto, se necessário. | +| **Permissões de sistema de arquivos** | Salvar em uma pasta somente leitura gera um `UnauthorizedAccessException`. | Grave em `Environment.CurrentDirectory` ou em um caminho gravável pelo usuário, e trate exceções com try/catch. | +| **Pacote NuGet ausente** | A compilação falha com “type or namespace name could not be found”. | Certifique-se de que `Aspose.BarCode` está instalado (`dotnet add package Aspose.BarCode`). | + +## Expandindo o exemplo + +Agora que você sabe **como criar código de barras PDF417** e **como salvar PNG**, pode explorar esses tópicos relacionados: + +- **Barcode generator C#**: Alterar o `EncodeTypes` para `Code128`, `QR` ou outras simbologias. +- **Cores personalizadas**: Use `generator.Parameters.Barcode.ForegroundColor` e `BackgroundColor` para combinar com a identidade visual. +- **Incorporação em PDFs**: Combine o PNG com uma biblioteca PDF (por exemplo, iText7) para criar documentos imprimíveis. +- **Dados dinâmicos**: Recupere o texto de um banco de dados ou entrada do usuário para gerar códigos de barras em tempo real. + +## Conclusão + +Agora você tem uma solução completa e pronta para produção para **criar código de barras PDF417** em C# e salvar o resultado como um arquivo PNG. O tutorial cobriu cada passo, desde a configuração do projeto até a personalização do layout, e destacou como evitar erros comuns ao usar uma biblioteca geradora de códigos de barras C#. + +Sinta-se à vontade para experimentar diferentes configurações de coluna/linha, cores ou até mesmo outros formatos de código de barras. Se encontrar algum problema, revise a seção **como gerar PDF417** ou explore a documentação da biblioteca para recursos avançados. Feliz codificação! + +## O que você deve aprender a seguir? + +Os tutoriais a seguir abordam tópicos estreitamente relacionados que se baseiam nas técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá-lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [Como criar código de barras – PDF417 compacto com Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Como gerar código de barras PDF417 – Codificação PDF417 compacto](/barcode/english/net/compact-pdf417-encoding/) +- [Como criar zona silenciosa de código de barras para ITF-14 usando Aspose.BarCode para .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..618da1fad --- /dev/null +++ b/barcode/portuguese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Aprenda como gerar código de barras PDF417 em C# com Aspose.BarCode, + definir o tamanho do código de barras, ajustar as colunas e habilitar o modo compacto. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: pt +lastmod: 2026-08-22 +og_description: Gere código de barras PDF417 em C# com Aspose.BarCode. Este guia mostra + como definir o tamanho do código de barras, controlar as colunas e habilitar o modo + compacto para uma imagem menor. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Gerar código de barras PDF417 em C# – definir tamanho, colunas e modo compacto +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Como gerar código de barras PDF417 em C# e definir o tamanho do código de barras +url: /pt/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como gerar código de barras PDF417 em C# e definir o tamanho do código de barras + +Se você precisa **gerar código de barras PDF417** em uma aplicação .NET, este guia o conduzirá por todo o processo. Você verá exatamente **como gerar PDF417** com Aspose.BarCode, ajustar o **tamanho do código de barras**, e produzir um PNG compacto que pode ser incorporado em relatórios ou aplicativos móveis. + +Criar um código de barras não requer um editor gráfico separado. Ao final deste tutorial você terá um método C# totalmente funcional que produz uma imagem PDF417 com as dimensões exatas que você precisa, pronta para processamento posterior. + +## O que você aprenderá + +* Instalar e referenciar a biblioteca Aspose.BarCode. +* Criar um gerador de código de barras PDF417 e especificar o texto codificado. +* **Definir o tamanho do código de barras** configurando a X‑dimension e a contagem de colunas. +* Habilitar o modo compacto (truncado) para reduzir o símbolo. +* Salvar o resultado como um arquivo PNG. +* Solucionar problemas comuns, como códigos ilegíveis e imagens excessivamente grandes. + +### Pré-requisitos + +* .NET 6.0 ou posterior (a API funciona também com .NET Framework 4.6+). +* Familiaridade básica com C# e Visual Studio (ou qualquer IDE C#). +* Uma licença válida do Aspose.BarCode (a avaliação gratuita funciona para testes). + +> **Dica profissional:** Se você planeja gerar muitos códigos de barras em um loop, reutilize uma única instância de `BarcodeGenerator` e altere apenas a propriedade `CodeText`. Isso reduz as alocações de memória. + +## Gerar código de barras PDF417 com Aspose.BarCode + +O primeiro passo é instanciar o `BarcodeGenerator` para a simbologia PDF417. Este objeto é o ponto de entrada para todas as operações de código de barras. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Por que isso importa*: `EncodeTypes.Pdf417` indica à biblioteca que deve usar o padrão PDF417, que suporta grandes volumes de dados e correção de erros. O construtor também aceita os dados que você deseja codificar, eliminando a necessidade de uma atribuição separada de `CodeText` posteriormente. + +## Definir tamanho do código de barras e contagem de colunas + +Os símbolos PDF417 consistem em linhas e colunas de pequenos módulos retangulares. Controlar a largura do módulo (X‑dimension) e o número de colunas permite ajustar finamente as dimensões gerais. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explicação*: +* **X‑dimension** (`Pixels`) determina quão largo cada módulo é. Valores menores produzem um código de barras mais compacto, enquanto valores maiores aumentam a legibilidade em scanners de baixa resolução. +* **Columns** controla o layout horizontal. Menos colunas tornam o código de barras mais alto; mais colunas o tornam mais largo. Ajuste essas duas configurações juntas para alcançar o **tamanho do código de barras** exato que você precisa. + +## Habilitar modo compacto para um código de barras menor + +O PDF417 inclui um modo “compacto” (ou truncado) que remove preenchimentos desnecessários e reduz a área total. Isso é especialmente útil quando você tem espaço de tela limitado. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Por que habilitar a truncagem?* +Quando `Truncate` está `true`, o gerador omite o padrão de parada e alguns codewords de correção de erro que não são necessários na maioria dos cenários de leitura. A imagem resultante fica aproximadamente 15‑20 % menor sem sacrificar a integridade dos dados para casos de uso típicos. + +## Salvar o código de barras como imagem PNG + +Depois de configurar o tamanho e o modo, grave o código de barras no disco. PNG é sem perdas, garantindo que as bordas dos módulos permaneçam nítidas. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +O arquivo `CompactPdf417.png` conterá um símbolo PDF417 nítido que corresponde às dimensões que você definiu nas etapas anteriores. + +### Saída esperada + +Abrir o PNG salvo deve exibir um código de barras PDF417 orientado verticalmente, consistindo de três colunas, cada módulo com 2 px de largura, e um tamanho total de aproximadamente **120 × 240 px** (largura × altura). Ler a imagem com qualquer leitor padrão de PDF417 retorna o texto original “Sample text for PDF417”. + +## Armadilhas comuns e como evitá‑las + +| Sintoma | Causa provável | Correção | +|---------|----------------|----------| +| Código de barras ilegível | X‑dimension muito pequena para o scanner | Aumente `XDimension.Pixels` para 3 ou 4 | +| Imagem muito larga para a UI | Muitas colunas definidas | Reduza `Pdf417.Columns` ou habilite `Truncate` | +| Exceção `ArgumentOutOfRangeException` | Contagem de colunas negativa ou zero | Garanta que `Columns` seja um inteiro positivo (mínimo 1) | +| Arquivo PNG está vazio | Caminho de saída não existe ou falta permissão de gravação | Verifique se o diretório existe e se o aplicativo tem direitos de gravação | + +> **Dica profissional:** Use `barcodeGenerator.ValidateParameters()` antes de chamar `Save()` para capturar erros de configuração antecipadamente. + +## Exemplo completo e executável + +Abaixo está um programa de console autônomo que incorpora todas as etapas acima. Copie-o para um novo projeto C#, restaure o pacote NuGet Aspose.BarCode e execute-o para ver o resultado. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Executar o programa** produz `CompactPdf417.png` no diretório de trabalho do executável. Leia a imagem com um aplicativo móvel (por exemplo, “Barcode Scanner”) para verificar se o texto codificado corresponde à string de origem. + +## Próximos passos e tópicos relacionados + +* **Aumentar o nível de correção de erro** – ajuste `Pdf417.ErrorLevel` para ambientes com leituras ruidosas. +* **Alterar a orientação** – defina `Pdf417.Rotate` para `RotationAngle.Rotate90` se precisar de um layout horizontal. +* **Incorporar o código de barras em um PDF** – combine Aspose.PDF com Aspose.BarCode para colocar a imagem diretamente em um documento. +* **Gerar outros códigos de barras 2‑D** – a mesma classe `BarcodeGenerator` suporta códigos DataMatrix, QR e Aztec; basta trocar `EncodeTypes.Pdf417` pela simbologia desejada. + +Ao dominar as técnicas de **gerar código de barras PDF417**, você pode automatizar bilhetagem, rotulagem de inventário e transmissão segura de dados em uma ampla gama de aplicações .NET. + +## Conclusão + +Agora você sabe como **gerar código de barras PDF417** em C#, definir **precisamente o tamanho do código de barras**, configurar colunas, habilitar o modo compacto e salvar o resultado como PNG. Aplique essas configurações para atender a qualquer restrição de UI ou requisito de leitura, e estenda a abordagem para outros formatos de código de barras conforme necessário. Boa codificação! + +## O que você deve aprender a seguir? + +Os tutoriais a seguir abordam tópicos estreitamente relacionados que se baseiam nas técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [Como gerar código de barras PDF417 – Codificação Compacta PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Como criar código de barras – PDF417 Compacto com Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Como gerar códigos de barras DataMatrix usando Aspose.BarCode para .NET – Guia passo a passo](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..bd8f6cdff --- /dev/null +++ b/barcode/portuguese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-08-22 +description: Como ler códigos de barras PDF417 em C# com um guia passo a passo, abordando + como ler vários códigos de barras de uma imagem e extrair detalhes do MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: pt +lastmod: 2026-08-22 +og_description: Como ler códigos de barras PDF417 em C# rapidamente. Este tutorial + mostra como ler vários códigos de barras a partir de uma imagem e recuperar as informações + estendidas MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Como ler códigos de barras PDF417 em C# – tutorial completo de programação +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Como ler códigos de barras PDF417 em C# – guia completo +url: /pt/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como ler códigos de barras PDF417 em C# – guia completo + +Se você precisa **como ler PDF417** barras em uma aplicação .NET, este tutorial oferece uma solução pronta‑para‑executar. Você aprenderá a ler vários códigos de barras a partir de uma única imagem, extrair o conjunto completo de dados MacroPdf417 e exibi-lo no console. A abordagem funciona com a biblioteca Aspose.BarCode for .NET e requer apenas algumas linhas de código. + +Ler códigos de barras de uma imagem é uma tarefa comum em sistemas de inventário, validação de ingressos e gerenciamento de documentos. Ao final deste guia você será capaz de decodificar qualquer código de barras PDF417 ou MacroPdf417, manipular vários códigos em uma única foto e entender os campos estendidos que o MacroPdf417 fornece. + +## Pré‑requisitos + +- .NET 6.0 SDK ou posterior (o código também compila com .NET Framework 4.7+) +- Visual Studio 2022 ou qualquer editor C# que você prefira +- Pacote NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Uma imagem de exemplo que contenha um código de barras MacroPdf417 (por exemplo, `MacroPdf417.png`) + +Nenhuma configuração adicional é necessária; a biblioteca lida com o carregamento e a decodificação da imagem internamente. + +## Como ler códigos de barras PDF417 de uma imagem em C# + +O núcleo da solução é a classe `BarCodeReader`. Ela abre a imagem, detecta todos os códigos de barras do tipo especificado e devolve uma coleção de objetos `BarCodeResult`. O código a seguir mostra um programa de console completo. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Por que cada linha importa + +| Etapa | Propósito | +|------|-----------| +| **1️⃣ Initialize** | Cria um `BarCodeReader` vinculado ao arquivo de imagem e restringe a detecção à simbologia MacroPdf417, o que acelera o processamento. | +| **2️⃣ Iterate** | `ReadBarCodes()` devolve **todos** os códigos de barras que correspondem ao tipo solicitado, permitindo que você **leia vários códigos de barras** sem loops extras. | +| **3️⃣ Basic output** | Exibe o genérico `CodeTypeName` e o `CodeText` legível por humanos. Isso é útil para registro ou validação rápida. | +| **4️⃣ Extended data** | MacroPdf417 transporta metadados adicionais (ID do arquivo, contagem de segmentos, timestamps, etc.). O objeto `Extended.Pdf417` expõe cada campo diretamente, para que você possa armazenar ou verificar o pacote de dados completo. | + +Executar o programa com uma imagem MacroPdf417 válida produz uma saída no console semelhante ao seguinte: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +A saída confirma que a biblioteca leu o código de barras com sucesso, extraiu o texto e forneceu todos os campos MacroPdf417. + +## Lendo vários códigos de barras de uma única imagem + +Muitos cenários reais colocam vários símbolos PDF417 em um rótulo — pense em um manifesto de envio que contém um código de transportadora, um número de rastreamento e uma declaração aduaneira. O mesmo bloco de código acima já **leu vários códigos de barras** porque `ReadBarCodes()` devolve um enumerável com todas as correspondências. Nenhuma configuração adicional é necessária; basta percorrer os resultados, como demonstrado. + +Se você quiser limitar o leitor ao PDF417 padrão (não‑macro) enquanto ainda manipula vários códigos, substitua `DecodeType.MacroPdf417` por `DecodeType.Pdf417`. O restante da lógica permanece inalterado. + +## Entendendo os dados estendidos do MacroPdf417 + +MacroPdf417 é uma extensão da especificação PDF417 regular. Ele divide cargas úteis grandes em múltiplos segmentos e adiciona um pequeno cabeçalho que descreve o arquivo inteiro. Os campos mais relevantes são: + +- **MacroPdf417FileID** – um identificador único compartilhado por todos os segmentos do mesmo arquivo. +- **MacroPdf417SegmentID** – o número de sequência do segmento atual. +- **MacroPdf417SegmentsCount** – número total de segmentos esperados. +- **MacroPdf417FileName** – nome de arquivo opcional transmitido com o código de barras. +- **MacroPdf417Checksum** – valor de verificação de erro para o arquivo completo. +- **MacroPdf417FileSize** – tamanho da carga binária original. +- **MacroPdf417TimeStamp** – timestamp ISO‑8601 quando o código de barras foi gerado. +- **MacroPdf417Addressee / Sender** – campos textuais opcionais para roteamento. +- **MacroPdf417Terminator** – indica se este segmento é o final. + +Quando você recebe todos os segmentos, pode reconstruir o arquivo original ordenando‑os por `MacroPdf417SegmentID` e concatenando os valores de `CodeText`. Essa lógica é simples de implementar assim que os campos estiverem disponíveis. + +## Armadilhas comuns e dicas profissionais + +- **A qualidade da imagem importa** – arquivos PNG/JPEG de baixa resolução ou fortemente comprimidos podem causar detecções perdidas. Use pelo menos 300 dpi para códigos de barras impressos. +- **Simbologias mistas** – se a imagem contiver tanto MacroPdf417 quanto PDF417 regular, instancie dois leitores (um para cada `DecodeType`) ou use `DecodeType.AllSupported` e filtre os resultados por `result.CodeTypeName`. +- **Uso de memória** – a instrução `using` descarta o `BarCodeReader` rapidamente, evitando que grandes buffers de imagem permaneçam na memória. +- **Segurança de threads** – `BarCodeReader` não é thread‑safe. Crie uma instância separada por thread se você decodificar imagens em paralelo. +- **Tratamento de erros** – envolva a chamada `ReadBarCodes()` em um bloco try/catch para capturar `BarCodeException` em imagens corrompidas. + +## Recapitulação do exemplo completo em funcionamento + +Abaixo está o programa completo que você pode copiar para um novo projeto de console. Ele inclui todas as diretivas `using`, uma constante para o caminho da imagem e o padrão de descarte. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compile com `dotnet build` e execute com `dotnet run`. O console imprime os dados básicos de cada código de barras e o payload completo do MacroPdf417. + +## Próximos passos + +- **Reconstruct multipart files** – collect all segments, sort by `MacroPdf417SegmentID`, and concatenate `CodeText` to + +## O que você deve aprender a seguir? + +Os tutoriais a seguir abordam tópicos intimamente relacionados que se baseiam nas técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [Como gerar código de barras PDF417 – Codificação Compacta PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Como ler códigos de barras PDF417 com caracteres turcos em Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Como usar Aspose para código de barras PDF417 (Chinês) em Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/portuguese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..6b6a74e6c --- /dev/null +++ b/barcode/portuguese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-08-22 +description: O tutorial de gerador de código de barras em C# mostra como criar um + código de barras Macro PDF417 com metadados e salvá-lo como PNG usando o Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: pt +lastmod: 2026-08-22 +og_description: O gerador de código de barras C# permite que você produza um código + de barras Macro PDF417 com metadados completos a nível de arquivo e o exporte como + PNG. Siga este guia para implementar a solução. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: gerador de código de barras C# – crie códigos de barras Macro PDF417 passo + a passo +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Como usar um gerador de código de barras C# para Macro PDF417 +url: /pt/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como usar um gerador de código de barras C# para Macro PDF417 + +Se você precisa de um **barcode generator C#** que possa gerar um símbolo Macro PDF417 com metadados a nível de arquivo, este guia fornece uma solução completa, pronta‑para‑executar. Você verá como configurar a aparência do código de barras, incorporar informações macro como ID do arquivo e contagem de segmentos e, finalmente, salvar o resultado como uma imagem PNG. + +O exemplo usa a biblioteca Aspose.BarCode, uma **C# barcode library** amplamente adotada que suporta o conjunto completo de recursos do PDF417. Nenhum serviço externo é necessário, e o código funciona com .NET 6 ou posterior. + +## Pré-requisitos + +* .NET 6 SDK (ou qualquer versão posterior) instalado. +* Visual Studio 2022, VS Code ou outra IDE C#. +* Uma referência NuGet ao **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Entender a sintaxe básica de C# e o conceito de códigos de barras PDF417 ajudará a seguir as etapas, mas o tutorial explica cada opção de configuração em detalhes. + +## O que o tutorial cobre + +* Inicializando uma instância de **barcode generator C#** para o formato Macro PDF417. +* Ajustando parâmetros visuais como X‑dimension e contagem de colunas. +* Fornecendo campos a nível de arquivo do Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender e terminator. +* Salvando o símbolo gerado como um arquivo PNG. +* Dicas para lidar com casos extremos, como arquivos grandes ou timestamps personalizados. + +Ao final deste artigo, você terá um programa autônomo que produz um código de barras Macro PDF417 totalmente compatível. + +## Etapa 1: Criar a instância do barcode generator C# + +A primeira operação é instanciar `BarcodeGenerator` com o valor enum `EncodeTypes.MacroPdf417` e o texto que você deseja codificar. O construtor também aceita a string de payload, que se torna a parte de dados do código de barras macro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Por que isso importa** – A flag `EncodeTypes.MacroPdf417` indica ao Aspose.BarCode que o símbolo deve ser tratado como um código de barras macro, habilitando os campos extras que se seguem. Sem essa flag, a biblioteca geraria um código de barras PDF417 regular sem metadados a nível de arquivo. + +## Etapa 2: Ajustar a aparência básica do código de barras (configurações visuais do PDF417) + +A clareza visual é crucial para a leitura confiável. Dois parâmetros comuns são a largura do módulo (`XDimension`) e o número de colunas. Definir esses valores equilibra tamanho e legibilidade. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` controla a largura de cada barra preta/branca. Um valor de **2** funciona bem para a maioria das impressoras de etiquetas. +* `Pdf417.Columns` define quantas colunas o código de barras usará. Cinco colunas produzem um símbolo compacto sem sacrificar a capacidade de dados. + +## Etapa 3: Definir informações a nível de arquivo do Macro PDF417 + +Macro PDF417 estende o formato padrão PDF417 com campos que descrevem como um arquivo grande é dividido em vários segmentos de código de barras. Fornecer esses campos garante que scanners posteriores possam reconstruir o arquivo original. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` deve ser o mesmo para cada segmento pertencente ao mesmo arquivo lógico. +* `MacroPdf417SegmentID` incrementa de **0** até `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` informa ao decodificador quantas peças esperar. +* `MacroPdf417FileName` é opcional, mas útil para identificação legível por humanos. + +## Etapa 4: Definir metadados macro adicionais + +Além das informações básicas do arquivo, a especificação permite campos extras como checksum, tamanho do arquivo, timestamp, addressee, sender e uma flag terminator. Preencher esses campos melhora a integridade dos dados e a rastreabilidade. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` fornece um checksum CCITT de 16 bits para todo o arquivo; o decodificador pode verificar a integridade após a reconstrução. +* `MacroPdf417FileSize` deve refletir a contagem exata de bytes do arquivo original; valores maiores que `2^31‑1` requerem um campo de 64 bits, que o Aspose trata automaticamente. +* `MacroPdf417TimeStamp` registra quando o código de barras foi gerado. Use UTC para evitar ambiguidades de fuso horário. +* `MacroPdf417Addressee` e `MacroPdf417Sender` são strings de formato livre que podem armazenar informações de roteamento. +* `MacroPdf417Terminator` sinaliza que este é o segmento final; defina como `Set` para a última peça, caso contrário deixe o padrão (`NotSet`). + +**Dica para caso extremo** – Se o tamanho do seu arquivo exceder 4 GB, divida o conteúdo em vários segmentos macro e ajuste `SegmentsCount` conforme necessário. A biblioteca gerenciará o campo de tamanho grande sem overflow. + +## Etapa 5: Salvar o código de barras como imagem PNG + +A etapa final grava o símbolo gerado no disco. PNG preserva as dimensões exatas dos pixels e é amplamente suportado por hardware de leitura. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Substitua `YOUR_DIRECTORY` por um caminho absoluto ou relativo onde o processo em execução possa gravar. O enum `BarCodeImageFormat.Png` garante saída sem perdas. + +**Por que PNG?** – Formatos raster como PNG mantêm as bordas dos módulos nítidas, o que é essencial para scanners que dependem de bordas de alto contraste. Se precisar de um formato vetorial, o Aspose também suporta `Pdf` e `Svg`. + +## Exemplo completo executável + +Abaixo está o programa completo que você pode copiar para uma aplicação console. Ele inclui as diretivas `using` necessárias e um método `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Saída esperada + +Executar o programa cria um arquivo chamado **MacroPdf417.png** no diretório de trabalho do projeto. Abrir a imagem exibe um código de barras PDF417 compacto com os campos macro incorporados. Ler a imagem com um leitor compatível com PDF417 (por exemplo, ZXing, decodificador Aspose.BarCode) devolve o payload original `"Sample text"` juntamente com os metadados macro. + +## Perguntas comuns e solução de problemas + +| Pergunta | Resposta | +|----------|----------| +| *E se o código de barras for muito grande para a etiqueta alvo?* | Reduza `XDimension.Pixels` ou aumente `Pdf417.Columns`. Ambos os parâmetros afetam o tamanho geral. | +| *Posso gerar uma imagem vetorial em vez de PNG?* | Sim. Chame `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` para saída escalável. | +| *Como verifico o checksum após a leitura?* | O decodificador Aspose.BarCode valida automaticamente `MacroPdf417Checksum` e relata divergências no objeto `MacroPdf417Result`. | +| *A biblioteca é compatível com .NET Core?* | O pacote NuGet suporta .NET Standard 2.0+, que cobre .NET Core, .NET 5, .NET 6 e versões posteriores. | +| *E se eu precisar incorporar dados binários em vez de texto?* | Converta o payload binário para Base64 ou use a sobrecarga `EncodeTypes.MacroPdf417` que aceita um array de bytes. | + +## Dicas profissionais para uso em produção + +* **Cache o gerador** – + +## O que você deve aprender a seguir? + +Os tutoriais a seguir abordam tópicos estreitamente relacionados que se baseiam nas técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/net/compact-pdf417-encoding/_index.md b/barcode/russian/net/compact-pdf417-encoding/_index.md index 62c8d68fa..64e42e325 100644 --- a/barcode/russian/net/compact-pdf417-encoding/_index.md +++ b/barcode/russian/net/compact-pdf417-encoding/_index.md @@ -85,8 +85,8 @@ Compact PDF417 Encoding — это высокоёмкостный 2‑D штри Прежде чем перейти к коду, рассмотрим основы: -- **Структура данных:** Информация делится на кодовые слова, которые затем располагаются в строки и столбцы. -- **Коррекция ошибок:** PDF417 использует коррекцию ошибок Рида‑Соломона; вы можете выбрать уровень от **0 до 8**. Более высокие уровни увеличивают избыточность, что полезно в суровых условиях, например, при промышленном сканировании. +- **Структура данных:** Информация делится на кодовые слова, которые затем располагаются в строки и столбцы. +- **Коррекция ошибок:** PDF417 использует коррекцию ошибок Рида‑Соломона; вы можете выбрать уровень от **0 до 8**. Более высокие уровни увеличивают избыточность, что полезно в суровых условиях, например, при промышленном сканировании. - **Компактный режим:** Убирает лишние отступы, получая меньший штрих‑код без потери читаемости. ### Опции коррекции ошибок PDF417 @@ -128,22 +128,34 @@ generator.Save("compact-pdf417.png", BarCodeImageFormat.Png); Высокая плотность данных и надёжная коррекция ошибок делают Compact PDF417 подходящим для широкого спектра приложений, где пространство ограничено, а надёжность критична. Ниже перечислены несколько типичных сценариев, где эта символика приносит ощутимые выгоды, включая логистику, билеты, мобильные интерфейсы и маркировку промышленного оборудования. -- **Отгрузка и логистика:** Кодирование номеров отслеживания, партийных идентификаторов и маршрутизации на небольших этикетках. -- **Билеты:** Хранение информации о событии, номеров мест и данных безопасности на компактных билетах. -- **Мобильные приложения:** Отображение штрих‑кодов на экранах с ограниченным пространством пикселей. +- **Отгрузка и логистика:** Кодирование номеров отслеживания, партийных идентификаторов и маршрутизации на небольших этикетках. +- **Билеты:** Хранение информации о событии, номеров мест и данных безопасности на компактных билетах. +- **Мобильные приложения:** Отображение штрих‑кодов на экранах с ограниченным пространством пикселей. - **Промышленная автоматизация:** Внедрение диагностических данных на панелях оборудования, где важна прочность. ## Распространённые проблемы и решения -- **Слишком длинные данные:** Если ввод превышает максимальную ёмкость для выбранного уровня коррекции, разбейте данные или уменьшите уровень коррекции. -- **Не читаются сканы:** Обеспечьте достаточный контраст между цветом переднего и заднего плана; избегайте градиентов. +- **Слишком длинные данные:** Если ввод превышает максимальную ёмкость для выбранного уровня коррекции, разбейте данные или уменьшите уровень коррекции. +- **Не читаются сканы:** Обеспечьте достаточный контраст между цветом переднего и заднего плана; избегайте градиентов. - **Лицензионные исключения:** В пробной версии сгенерированный штрих‑код может содержать водяной знак. Примените действующую лицензию, чтобы убрать его. ## Учебные материалы по кодированию Compact PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + ### [Создание Compact PDF417 штрих‑кодов](./compact-pdf417-basic-configuration/) Узнайте, как генерировать Compact PDF417 штрих‑коды с помощью Aspose.BarCode для .NET. Полное руководство с пошаговыми инструкциями и примерами кода. +### [Как создать микроштрих‑код PDF417 в C# – пошаговое руководство](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [Как использовать генератор штрих‑кода C# для Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [Как считывать штрих‑коды PDF417 в C# – полное руководство](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Полное руководство по чтению штрих‑кодов PDF417 в C# с использованием Aspose.BarCode, включая примеры кода и настройку параметров. + +### [Как создать штрих‑код PDF417 в C# и сохранить его как PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) + ## Часто задаваемые вопросы **В: Какой максимальный объём данных можно хранить в Compact PDF417 штрих‑коде?** diff --git a/barcode/russian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/russian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..5f4d95f7f --- /dev/null +++ b/barcode/russian/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-08-22 +description: Узнайте, как создать микробаркод micro PDF417 на C# и сгенерировать PNG‑изображение + штрихкода. Включает настройку размеров штрихкода и сохранение файла. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: ru +lastmod: 2026-08-22 +og_description: Создайте микробаркод PDF417 на C# и экспортируйте его в PNG. Следуйте + этому руководству, чтобы задать размеры штрихкода и быстро сгенерировать его изображение. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Создание микроштрихкода PDF417 в C# – полный учебник по программированию +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Как создать микроштрих‑код PDF417 в C# — пошаговое руководство +url: /ru/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как создать микробаркод Micro PDF417 в C# – пошаговое руководство + +Если вам нужно **создать микробаркод Micro PDF417** для системы билетов, этикетки инвентаря или мобильного сканирования, это руководство покажет, как это сделать. Вы увидите полностью готовую программу на C#, генерирующую PNG‑изображение баркода, узнаете, как задавать размеры баркода, и поймёте каждую опцию конфигурации. + +К концу этого руководства вы сможете генерировать изображение баркода высокого разрешения, настраивать X‑размер, выбирать количество столбцов и сохранять результат в файл PNG — всё это несколькими строками кода. + +## Что понадобится + +- .NET 6.0 SDK или новее (код работает с .NET Core и .NET Framework) +- Visual Studio 2022 или любой IDE, поддерживающий C# +- NuGet‑пакет **Aspose.BarCode for .NET** (или любая библиотека, поддерживающая `EncodeTypes.MicroPdf417`) +- Базовые знания синтаксиса C# + +> **Pro tip:** Бесплатная community‑версия Aspose.BarCode достаточно для разработки и тестирования. Для продакшна получите лицензию, чтобы убрать водяные знаки оценки. + +## Шаг 1: Установите библиотеку баркодов + +Откройте терминал в папке проекта и выполните: + +```bash +dotnet add package Aspose.BarCode +``` + +Это добавит сборку `Aspose.BarCode`, предоставляющую класс `BarcodeGenerator`, используемый для **создания изображений баркодов C#**. + +## Шаг 2: Инициализируйте генератор – создайте микробаркод Micro PDF417 + +Первая исполняемая строка создаёт экземпляр `BarcodeGenerator`, настроенный для символьного набора Micro PDF417, и передаёт данные, которые нужно закодировать. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Почему это важно*: Перечисление `EncodeTypes.MicroPdf417` указывает библиотеке использовать компактную версию PDF417, что идеально подходит для небольших этикеток и мобильных экранов. + +## Шаг 3: Как задать размеры баркода в C# + +Точная настройка ширины модуля (X‑размер) контролирует визуальную плотность баркода. Меньшее значение даёт более чёткое изображение, большее — упрощает сканирование с расстояния. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Почему стоит задавать размеры**: Без изменения X‑размера значение по умолчанию может привести к размытости баркода при рендеринге с высоким DPI. Установка в 2 пикселя — хороший компромисс для большинства сканирований с экрана. + +## Шаг 4: Выбор количества столбцов – управление шириной баркода + +Micro PDF417 допускает от 1 до 4 столбцов. Большее количество столбцов сжимает данные по горизонтали, уменьшая общую ширину изображения. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Особый случай*: При запросе 5 столбцов библиотека бросит `ArgumentOutOfRangeException`. Всегда оставайтесь в пределах документированного диапазона. + +## Шаг 5: Как сгенерировать PNG‑баркод – сохранение изображения + +Теперь можно экспортировать сгенерированный баркод в файл PNG. PNG сохраняет качество без потерь, что критично для надёжного сканирования. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +При запуске программы в консоли появится сообщение, подтверждающее путь к файлу. Полученный `MicroPdf417.png` выглядит так: + +![Скриншот, показывающий сгенерированный микробаркод Micro PDF417, созданный с помощью C#](micro-pdf417-example.png "Сгенерированный микробаркод Micro PDF417") + +*Текст альтернативы изображения*: **микробаркод micro PDF417, сгенерированный в C#** – демонстрирует окончательный результат после применения размеров и настроек столбцов. + +## Шаг 6: Запустите и проверьте результат + +1. Сборка проекта: `dotnet build`. +2. Выполнение: `dotnet run`. +3. Откройте `MicroPdf417.png` на рабочем столе и отсканируйте его мобильным приложением‑сканером баркодов. + +Вы должны увидеть декодированный текст **«Sample text»**. Если сканер выдаёт ошибку, проверьте X‑размер и количество столбцов — экстремальные значения могут сделать баркод слишком плотным для некоторых устройств. + +## Распространённые варианты и устранение неполадок + +| Ситуация | Корректировка | +|-----------|------------| +| **Нужен более крупный баркод для принтеров низкого разрешения** | Увеличьте `XDimension.Pixels` до 3 или 4. | +| **Хотите более высокий баркод без изменения ширины** | Установите `generator.Parameters.Barcode.Pdf417.Rows` (диапазон строк 3‑90). | +| **Генерация нескольких баркодов в цикле** | Переиспользуйте один экземпляр `BarcodeGenerator` и меняйте только `CodeText` перед каждым `Save`. | +| **Сохранение в JPEG вместо PNG** | Замените `BarCodeImageFormat.Png` на `BarCodeImageFormat.Jpeg`. | +| **Запуск на .NET Framework 4.7** | Тот же код работает; просто подключите соответствующий `Aspose.BarCode.dll`. | + +## Полный листинг исходного кода (рабочий) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Ожидаемый результат** – PNG‑файл размером 200 × 100 пикселей с чётким микробаркодом Micro PDF417, который декодируется как «Sample text». + +## Заключение + +Теперь вы знаете, как **создать микробаркод Micro PDF417 в C#**, **задать размеры баркода** и **сгенерировать PNG‑изображение баркода**. Полный пример демонстрирует каждый необходимый шаг — от установки библиотеки до сохранения финального файла — чтобы вы могли встроить генерацию баркодов непосредственно в свои приложения. + +Далее изучайте связанные темы, такие как **создание QR‑кодов с Aspose.BarCode**, **настройка цветов** или **встраивание баркодов в PDF‑документы**. Все они опираются на те же фундаментальные возможности `BarcodeGenerator`, рассмотренные здесь. + +Экспериментируйте с различными строками данных, количеством столбцов и значениями X‑размера, подбирая оптимальные параметры под вашу среду сканирования. Приятного кодинга! + +## Что изучать дальше? + +Следующие руководства охватывают тесно связанные темы, которые развивают техники, продемонстрированные в этом руководстве. Каждый ресурс содержит полностью работающие примеры кода с пошаговыми объяснениями, помогающими освоить дополнительные возможности API и исследовать альтернативные подходы в ваших проектах. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/russian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..0c25c3e53 --- /dev/null +++ b/barcode/russian/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Узнайте, как создать штрих‑код PDF417 в C# с помощью генератора штрих‑кодов, + настроить макет и сохранить PNG. Включает полный код и советы для проектов генератора + штрих‑кодов на C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: ru +lastmod: 2026-08-22 +og_description: Создайте штрих‑код PDF417 на C# с помощью генератора штрих‑кодов, + настройте макет и узнайте, как сохранить PNG. Следуйте этому пошаговому руководству. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Создание штрихкода PDF417 в C# — полное руководство по генерации и сохранению + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Как создать штрих‑код PDF417 в C# и сохранить его в формате PNG +url: /ru/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как создать PDF417 barcode в C# и сохранить его как PNG + +Если вам нужно **create PDF417 barcode** в приложении C#, этот учебник покажет вам точные шаги. Вы увидите, как библиотека barcode generator C# может преобразовать любую строку в сканируемое изображение PDF417 и как сохранить PNG‑файлы без дополнительных инструментов. + +Создание штрих‑кодов широко используется в логистике, билетных системах и управлении документами. К концу этого руководства у вас будет рабочая консольная программа, которая создаст PNG‑файл с именем `Pdf417Layout.png` в выбранной вами папке. + +## Prerequisites + +Прежде чем начать, убедитесь, что у вас есть: + +- .NET 6.0 SDK или более поздняя версия (код также работает с .NET Framework 4.7+). +- Visual Studio 2022 или любой редактор, способный собирать проекты C#. +- Пакет NuGet **Aspose.BarCode for .NET** (или любая совместимая barcode generator C# library). + Установите его с помощью: + +```bash +dotnet add package Aspose.BarCode +``` + +Дополнительные библиотеки для обработки изображений не требуются, поскольку генератор может записывать PNG напрямую. + +## Step 1: Set up a new console project + +Создайте новый консольный проект, чтобы пример оставался автономным. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Папка `Pdf417Demo` теперь содержит файл `Program.cs`, в который мы добавим код генерации штрих‑кода. + +## Step 2: Import the barcode namespace + +Откройте `Program.cs` и добавьте необходимую директиву `using` в начале файла: + +```csharp +using Aspose.BarCode.Generation; +``` + +Это пространство имён предоставляет доступ к `BarcodeGenerator`, `EncodeTypes` и перечислению форматов изображений, необходимому для **how to save PNG**. + +## Step 3: Create the PDF417 barcode generator + +Ядром **how to generate PDF417** является класс `BarcodeGenerator`. Передайте тип кодирования `EncodeTypes.Pdf417` и текст, который нужно закодировать. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` теперь содержит все настройки штрих‑кода. По умолчанию макет работает, но мы настроим его в следующем шаге. + +## Step 4: Define the barcode layout (columns and rows) + +PDF417 позволяет управлять количеством столбцов (2‑30) и строк (1‑90). Настройка этих значений может улучшить читаемость для конкретных сканеров. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro tip:** Если опустить эти настройки, библиотека автоматически выберет оптимальные значения. Однако фиксированные столбцы и строки дают предсказуемые размеры изображения, что удобно при встраивании PNG в PDF или пользовательский интерфейс. + +## Step 5: Save the generated barcode as a PNG image + +Теперь ответьте на **how to save PNG**, вызвав `Save`. Метод принимает целевой путь и перечисление формата изображения. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Файл `Pdf417Layout.png` появится в папке проекта `bin/Debug/net6.0` после выполнения программы. + +## Full runnable example + +Ниже приведён полный файл `Program.cs`. Скопируйте его в проект, созданный в **Step 1**, и запустите `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Expected output + +При запуске программы консоль выведет абсолютный путь к PNG‑файлу, а файл будет содержать чёткий штрих‑код PDF417, похожий на изображение ниже. + +![пример создания PDF417 barcode](image-placeholder.png "Штрих‑код PDF417, сохранённый как PNG") + +Вы можете отсканировать PNG любым совместимым сканером PDF417 (мобильные приложения, аппаратные считыватели), чтобы убедиться, что закодированный текст — `"Sample"`. + +## Handling edge cases and common pitfalls + +| Ситуация | На что обратить внимание | Рекомендуемое решение | +|-----------|--------------------------|-----------------------| +| **Недопустимые значения столбцов/строк** | Значения вне диапазона 2‑30 (столбцы) или 1‑90 (строки) вызывают `ArgumentException`. | Проверяйте ввод пользователя перед присвоением или позволяйте библиотеке выбирать значения по умолчанию. | +| **Большие входные строки** | PDF417 может кодировать до 1 850 символов, но очень длинные строки резко увеличивают количество требуемых строк. | Разделите данные на несколько штрих‑кодов или используйте более высокий уровень коррекции ошибок при необходимости. | +| **Разрешения файловой системы** | Сохранение в папку только для чтения приводит к `UnauthorizedAccessException`. | Записывайте в `Environment.CurrentDirectory` или в путь, доступный пользователю, и обрабатывайте исключения с помощью try/catch. | +| **Отсутствует пакет NuGet** | Компиляция завершается ошибкой «type or namespace name could not be found». | Убедитесь, что установлен `Aspose.BarCode` (`dotnet add package Aspose.BarCode`). | + +## Extending the example + +Теперь, когда вы знаете **how to create PDF417 barcode** и **how to save PNG**, вы можете изучить связанные темы: + +- **Barcode generator C#**: измените `EncodeTypes` на `Code128`, `QR` или другие символьные наборы. +- **Custom colors**: используйте `generator.Parameters.Barcode.ForegroundColor` и `BackgroundColor`, чтобы подобрать цвета под фирменный стиль. +- **Embedding in PDFs**: объедините PNG с библиотекой PDF (например, iText7), чтобы создавать печатные документы. +- **Dynamic data**: получайте текст из базы данных или ввода пользователя для генерации штрих‑кодов «на лету». + +## Conclusion + +Теперь у вас есть полное, готовое к использованию решение для **create PDF417 barcode** в C# и сохранения результата в PNG‑файл. Руководство охватило каждый шаг от настройки проекта до настройки макета и показало, как избежать типичных ошибок при работе с barcode generator C# library. + +Экспериментируйте с различными настройками столбцов/строк, цветами или даже другими форматами штрих‑кодов. Если возникнут проблемы, вернитесь к разделу **how to generate PDF417** или изучите документацию библиотеки для продвинутых возможностей. Приятного кодинга! + +## What Should You Learn Next? + +Следующие учебники охватывают тесно связанные темы, которые развивают техники, продемонстрированные в этом руководстве. Каждый ресурс включает полностью работающие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы в собственных проектах. + +- [Как создать штрих‑код – Compact PDF417 с Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Как генерировать штрих‑код PDF417 – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Как создать Quiet Zone для штрих‑кода ITF-14 с использованием Aspose.BarCode для .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/russian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..ac5f63b5b --- /dev/null +++ b/barcode/russian/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Узнайте, как генерировать штрих‑код PDF417 в C# с помощью Aspose.BarCode, + задавать размер штрих‑кода, регулировать количество столбцов и включать компактный + режим. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: ru +lastmod: 2026-08-22 +og_description: Создайте штрих‑код PDF417 на C# с помощью Aspose.BarCode. Это руководство + показывает, как задать размер штрих‑кода, управлять колонками и включить компактный + режим для получения меньшего изображения. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Создание штрих‑кода PDF417 в C# – установка размера, количества столбцов + и компактного режима +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Как сгенерировать штрих‑код PDF417 в C# и установить размер штрих‑кода +url: /ru/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как генерировать PDF417 barcode в C# и задать размер штрих‑кода + +Если вам нужно **генерировать PDF417 barcode** в приложении .NET, это руководство проведет вас через весь процесс. Вы увидите точно **как генерировать PDF417** с помощью Aspose.BarCode, настроите **set barcode size**, и создадите компактный PNG, который можно встроить в отчёты или мобильные приложения. + +Создание штрих‑кода не требует отдельного графического редактора. К концу этого руководства у вас будет полностью рабочий метод C#, который генерирует изображение PDF417 с точными размерами, необходимыми вам, готовое для дальнейшей обработки. + +## Что вы узнаете + +* Установить и подключить библиотеку Aspose.BarCode. +* Создать PDF417 barcode generator и указать кодируемый текст. +* **Set barcode size** путем настройки X‑dimension и количества столбцов. +* Включить компактный (усечённый) режим для уменьшения символа. +* Сохранить результат в файл PNG. +* Устранить распространённые проблемы, такие как нечитаемые коды и слишком большие изображения. + +### Требования + +* .NET 6.0 или новее (API также работает с .NET Framework 4.6+). +* Базовое знакомство с C# и Visual Studio (или любой IDE для C#). +* Действительная лицензия Aspose.BarCode (бесплатная оценочная версия подходит для тестирования). + +> **Pro tip:** Если вы планируете генерировать множество штрих‑кодов в цикле, переиспользуйте один экземпляр `BarcodeGenerator` и меняйте только свойство `CodeText`. Это уменьшает выделения памяти. + +## Генерация PDF417 barcode с помощью Aspose.BarCode + +Первый шаг — создать экземпляр `BarcodeGenerator` для символьного набора PDF417. Этот объект является точкой входа для всех операций со штрих‑кодами. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Почему это важно*: `EncodeTypes.Pdf417` указывает библиотеке использовать стандарт PDF417, который поддерживает большие объёмы данных и коррекцию ошибок. Конструктор также принимает данные, которые вы хотите закодировать, устраняя необходимость отдельного присваивания `CodeText` позже. + +## Установка размера штрих‑кода и количества столбцов + +Символы PDF417 состоят из строк и столбцов небольших прямоугольных модулей. Управление шириной модуля (X‑dimension) и количеством столбцов позволяет точно настроить общие размеры. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Объяснение*: +* **X‑dimension** (`Pixels`) определяет ширину каждого модуля. Меньшие значения дают более плотный штрих‑код, а большие значения повышают читаемость на сканерах с низким разрешением. +* **Columns** управляют горизонтальной компоновкой. Меньшее количество столбцов делает штрих‑код выше; больше столбцов — шире. Настраивая эти два параметра вместе, вы достигаете точного **set barcode size**, который вам нужен. + +## Включение компактного режима для уменьшения штрих‑кода + +PDF417 включает «compact» (или truncated) режим, который удаляет лишние отступы и уменьшает общий размер. Это особенно полезно, когда экранное пространство ограничено. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Почему включать усечение?* +Когда `Truncate` равно `true`, генератор опускает стоп‑шаблон и некоторые коды коррекции ошибок, которые не требуются в большинстве сценариев сканирования. Получаемое изображение примерно на 15‑20 % меньше, не жертвуя целостностью данных в типичных случаях использования. + +## Сохранение штрих‑кода как PNG‑изображения + +После настройки размера и режима запишите штрих‑код на диск. PNG — без потерь, что гарантирует чёткие границы модулей. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Файл `CompactPdf417.png` будет содержать чёткий символ PDF417, соответствующий размерам, заданным на предыдущих шагах. + +### Ожидаемый результат + +Открытие сохранённого PNG должно показать вертикально ориентированный PDF417 barcode, состоящий из трёх столбцов, каждый модуль шириной 2 px, и общий размер примерно **120 × 240 px** (ширина × высота). Сканирование изображения любым стандартным считывателем PDF417 возвращает исходный текст «Sample text for PDF417». + +## Распространённые подводные камни и как их избежать + +| Symptom | Likely cause | Fix | +|---------|--------------|-----| +| Штрих‑код нечитаем | X‑dimension слишком маленькая для сканера | Увеличьте `XDimension.Pixels` до 3 или 4 | +| Изображение слишком широкое для UI | Установлено слишком много столбцов | Уменьшите `Pdf417.Columns` или включите `Truncate` | +| Исключение `ArgumentOutOfRangeException` | Отрицательное или нулевое количество столбцов | Убедитесь, что `Columns` — положительное целое (минимум 1) | +| PNG‑файл пустой | Путь вывода не существует или нет прав на запись | Проверьте, что каталог существует и приложение имеет права на запись | + +> **Pro tip:** Используйте `barcodeGenerator.ValidateParameters()` перед вызовом `Save()`, чтобы заранее обнаружить ошибки конфигурации. + +## Полный, исполняемый пример + +Ниже представлена автономная консольная программа, включающая все шаги выше. Скопируйте её в новый проект C#, восстановите пакет NuGet Aspose.BarCode и запустите, чтобы увидеть результат. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Running the program** создаёт `CompactPdf417.png` в рабочем каталоге исполняемого файла. Сканируйте изображение мобильным приложением (например, «Barcode Scanner»), чтобы убедиться, что закодированный текст соответствует исходной строке. + +## Следующие шаги и связанные темы + +* **Increase error correction level** – настройте `Pdf417.ErrorLevel` для условий с шумными сканированиями. +* **Change orientation** – установите `Pdf417.Rotate` в `RotationAngle.Rotate90`, если нужен горизонтальный макет. +* **Embed the barcode in a PDF** – комбинируйте Aspose.PDF с Aspose.BarCode, чтобы разместить изображение непосредственно в документе. +* **Generate other 2‑D barcodes** – тот же класс `BarcodeGenerator` поддерживает DataMatrix, QR и Aztec коды; просто замените `EncodeTypes.Pdf417` на нужную символьную схему. + +Освоив техники **generate PDF417 barcode**, вы сможете автоматизировать билеты, маркировку инвентаря и безопасную передачу данных в широком спектре приложений .NET. + +## Заключение + +Теперь вы знаете, как **generate PDF417 barcode** в C#, точно **set barcode size**, настроить столбцы, включить компактный режим и сохранить результат в PNG. Применяйте эти настройки, чтобы соответствовать любым ограничениям UI или требованиям сканирования, и при необходимости расширяйте подход на другие форматы штрих‑кодов. Счастливого кодинга! + +## Что вам стоит изучить дальше? + +Следующие руководства охватывают тесно связанные темы, которые развивают техники, продемонстрированные в этом руководстве. Каждый ресурс включает полные рабочие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы к реализации в ваших проектах. + +- [Как генерировать PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [Как создать Barcode – Compact PDF417 с Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Как генерировать DataMatrix штрих‑коды с помощью Aspose.BarCode для .NET – пошаговое руководство](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/russian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..0dece29f3 --- /dev/null +++ b/barcode/russian/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: Как считывать штрихкоды PDF417 в C# с пошаговым руководством, охватывающим + чтение нескольких штрихкодов с изображения и извлечение деталей MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: ru +lastmod: 2026-08-22 +og_description: Как быстро считывать штрихкоды PDF417 в C#. Этот учебник покажет, + как считывать несколько штрихкодов с изображения и получать расширенную информацию + MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Как читать штрихкоды PDF417 в C# – полное пошаговое руководство +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Как считывать штрихкоды PDF417 в C# — полное руководство +url: /ru/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как читать штрихкоды PDF417 в C# – полное руководство + +Если вам нужно **как читать PDF417** штрихкоды в приложении .NET, этот учебник предоставляет готовое решение. Вы узнаете, как считывать несколько штрихкодов с одного изображения, извлекать полный набор данных MacroPdf417 и выводить их в консоль. Подход работает с библиотекой Aspose.BarCode for .NET и требует всего несколько строк кода. + +Считывание штрихкодов с изображения — распространённая задача в системах учёта, проверке билетов и управлении документами. К концу этого руководства вы сможете декодировать любой штрихкод PDF417 или MacroPdf417, обрабатывать несколько кодов на одной картинке и понимать расширенные поля, которые предоставляет MacroPdf417. + +## Предварительные требования + +- .NET 6.0 SDK или новее (код также компилируется с .NET Framework 4.7+) +- Visual Studio 2022 или любой другой редактор C# +- NuGet‑пакет Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Пример изображения, содержащего штрихкод MacroPdf417 (например, `MacroPdf417.png`) + +Дополнительная настройка не требуется; библиотека самостоятельно загружает изображение и выполняет декодирование. + +## Как читать штрихкоды PDF417 с изображения в C# + +Ядром решения является класс `BarCodeReader`. Он открывает изображение, обнаруживает все штрихкоды указанного типа и возвращает коллекцию объектов `BarCodeResult`. Ниже показан полный консольный пример. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Почему важна каждая строка + +| Шаг | Назначение | +|------|------------| +| **1️⃣ Initialize** | Создаёт `BarCodeReader`, привязанный к файлу изображения, и ограничивает обнаружение символьным набором MacroPdf417, что ускоряет обработку. | +| **2️⃣ Iterate** | `ReadBarCodes()` возвращает **все** штрихкоды, соответствующие запрошенному типу, позволяя **читать несколько штрихкодов** без дополнительных циклов. | +| **3️⃣ Basic output** | Выводит общее `CodeTypeName` и читаемый человеком `CodeText`. Это полезно для журналирования или быстрой проверки. | +| **4️⃣ Extended data** | MacroPdf417 содержит дополнительные метаданные (ID файла, количество сегментов, метки времени и т.д.). Объект `Extended.Pdf417` предоставляет каждое поле напрямую, чтобы вы могли сохранить или проверить весь пакет данных. | + +Запуск программы с корректным изображением MacroPdf417 выдаёт консольный вывод, похожий на следующий: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Вывод подтверждает, что библиотека успешно прочитала штрихкод, извлекла текст и предоставила все поля MacroPdf417. + +## Чтение нескольких штрихкодов с одного изображения + +Во многих реальных сценариях на одной этикетке размещается несколько символов PDF417 — например, в транспортной накладной могут быть код перевозчика, номер отслеживания и таможенная декларация. Приведённый выше блок кода уже **читает несколько штрихкодов**, потому что `ReadBarCodes()` возвращает перечисление всех совпадений. Дополнительная настройка не требуется; достаточно пройтись по результатам, как показано в примере. + +Если нужно ограничить чтение только стандартным PDF417 (не macro), замените `DecodeType.MacroPdf417` на `DecodeType.Pdf417`. Остальная логика остаётся без изменений. + +## Понимание расширенных данных MacroPdf417 + +MacroPdf417 — это расширение обычной спецификации PDF417. Оно разбивает большие полезные нагрузки на несколько сегментов и добавляет небольшой заголовок, описывающий весь файл. Наиболее важные поля: + +- **MacroPdf417FileID** – уникальный идентификатор, общий для всех сегментов одного файла. +- **MacroPdf417SegmentID** – порядковый номер текущего сегмента. +- **MacroPdf417SegmentsCount** – общее количество ожидаемых сегментов. +- **MacroPdf417FileName** – необязательное имя файла, передаваемое со штрихкодом. +- **MacroPdf417Checksum** – контрольное значение для полного файла. +- **MacroPdf417FileSize** – размер исходной бинарной полезной нагрузки. +- **MacroPdf417TimeStamp** – метка времени в формате ISO‑8601, когда штрихкод был сгенерирован. +- **MacroPdf417Addressee / Sender** – необязательные текстовые поля для маршрутизации. +- **MacroPdf417Terminator** – указывает, является ли данный сегмент последним. + +Получив все сегменты, вы можете восстановить оригинальный файл, упорядочив их по `MacroPdf417SegmentID` и конкатенировав значения `CodeText`. Эта логика проста в реализации, как только поля доступны. + +## Распространённые подводные камни и профессиональные советы + +- **Качество изображения имеет значение** – изображения с низким разрешением или сильно сжатые PNG/JPEG могут приводить к пропуску обнаружения. Используйте минимум 300 dpi для печатных штрихкодов. +- **Смешанные символьные наборы** – если изображение содержит как MacroPdf417, так и обычный PDF417, создайте два считывателя (по одному для каждого `DecodeType`) или используйте `DecodeType.AllSupported` и отфильтруйте результаты по `result.CodeTypeName`. +- **Использование памяти** – оператор `using` сразу освобождает `BarCodeReader`, предотвращая удерживание больших буферов изображений в памяти. +- **Потокобезопасность** – `BarCodeReader` не является потокобезопасным. Создавайте отдельный экземпляр для каждого потока при параллельной обработке изображений. +- **Обработка ошибок** – оберните вызов `ReadBarCodes()` в блок try/catch, чтобы перехватывать `BarCodeException` для повреждённых изображений. + +## Полный рабочий пример в обзоре + +Ниже приведена полная программа, которую можно скопировать в новый консольный проект. В ней указаны все директивы `using`, константа пути к изображению и шаблон освобождения ресурсов. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Соберите проект командой `dotnet build` и запустите `dotnet run`. Консоль выведет базовые данные каждого штрихкода и полный полезный набор MacroPdf417. + +## Следующие шаги + +- **Восстановление многосегментных файлов** – собрать все сегменты, отсортировать их по `MacroPdf417SegmentID` и конкатенировать `CodeText` для получения оригинального файла. + +## Что изучать дальше? + + +Следующие учебники охватывают тесно связанные темы, построенные на техниках, продемонстрированных в этом руководстве. Каждый ресурс включает полностью рабочие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы в собственных проектах. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Read PDF417 Barcodes with Turkish Characters in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [How to Use Aspose for PDF417 Barcode (Chinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/russian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..c23e86ded --- /dev/null +++ b/barcode/russian/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-08-22 +description: Учебник по генератору штрихкодов на C# показывает, как создать штрихкод + Macro PDF417 с метаданными и сохранить его в формате PNG с помощью Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: ru +lastmod: 2026-08-22 +og_description: Генератор штрихкодов C# позволяет создавать штрихкод Macro PDF417 + с полными метаданными уровня файла и экспортировать его в PNG. Следуйте этому руководству, + чтобы реализовать решение. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: Генератор штрихкодов C# – пошаговое создание Macro PDF417 штрихкодов +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Как использовать генератор штрихкодов C# для Macro PDF417 +url: /ru/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как использовать генератор штрих‑кодов C# для Macro PDF417 + +Если вам нужен **генератор штрих‑кодов C#**, способный создавать символ Macro PDF417 с метаданными уровня файла, это руководство предоставляет готовое решение, готовое к запуску. Вы увидите, как настроить внешний вид штрих‑кода, внедрить макро‑информацию, такую как идентификатор файла и количество сегментов, и, наконец, сохранить результат в виде PNG‑изображения. + +В примере используется библиотека Aspose.BarCode, широко применяемая **C# barcode library**, поддерживающая полный набор функций PDF417. Внешние сервисы не требуются, код работает с .NET 6 и новее. + +## Требования + +Прежде чем начать, убедитесь, что у вас есть: + +* .NET 6 SDK (или более поздняя версия) установлен. +* Visual Studio 2022, VS Code или другая IDE для C#. +* Ссылка NuGet на **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Базовое понимание синтаксиса C# и концепции штрих‑кодов PDF417 поможет вам следовать инструкциям, но в руководстве подробно объяснены все параметры конфигурации. + +## Что покрывается в руководстве + +* Инициализация экземпляра **генератора штрих‑кодов C#** для формата Macro PDF417. +* Настройка визуальных параметров, таких как X‑размер и количество колонок. +* Передача полей уровня файла Macro PDF417: идентификатор файла, идентификатор сегмента, количество сегментов, имя файла, контрольная сумма, размер файла, метка времени, получатель, отправитель и флаг завершения. +* Сохранение сгенерированного символа в PNG‑файл. +* Советы по обработке граничных случаев, таких как большие размеры файлов или пользовательские метки времени. + +По завершении этой статьи у вас будет автономная программа, генерирующая полностью совместимый штрих‑код Macro PDF417. + +## Шаг 1: Создать экземпляр генератора штрих‑кодов C# + +Первой операцией является создание `BarcodeGenerator` с перечислением `EncodeTypes.MacroPdf417` и текстом, который вы хотите закодировать. Конструктор также принимает строку полезной нагрузки, которая становится данными макро‑штрих‑кода. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Почему это важно** – Флаг `EncodeTypes.MacroPdf417` сообщает Aspose.BarCode рассматривать символ как макро‑штрих‑код, включая дополнительные поля, описанные ниже. Без этого флага библиотека создала бы обычный PDF417 без метаданных уровня файла. + +## Шаг 2: Настроить базовый внешний вид штрих‑кода (визуальные параметры PDF417) + +Визуальная чёткость критична для надёжного сканирования. Два часто используемых параметра – ширина модуля (`XDimension`) и количество колонок. Их настройка позволяет сбалансировать размер и читаемость. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` управляет шириной каждой чёрной/белой полосы. Значение **2** хорошо подходит для большинства этикеточных принтеров. +* `Pdf417.Columns` определяет, сколько колонок будет использовать штрих‑код. Пять колонок дают компактный символ без потери ёмкости данных. + +## Шаг 3: Определить информацию уровня файла Macro PDF417 + +Macro PDF417 расширяет стандартный формат PDF417 полями, описывающими, как большой файл разбивается на несколько сегментов штрих‑кода. Заполнение этих полей гарантирует, что сканеры смогут восстановить исходный файл. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` должен быть одинаковым для всех сегментов, принадлежащих одному логическому файлу. +* `MacroPdf417SegmentID` увеличивается от **0** до `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` сообщает декодеру, сколько частей ожидать. +* `MacroPdf417FileName` необязателен, но полезен для человекочитаемой идентификации. + +## Шаг 4: Установить дополнительные макро‑метаданные + +Помимо основной информации о файле, спецификация допускает дополнительные поля, такие как контрольная сумма, размер файла, метка времени, получатель, отправитель и флаг завершения. Заполнение этих полей повышает целостность данных и их прослеживаемость. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` предоставляет 16‑битную контрольную сумму CCITT для всего файла; декодер может проверить целостность после восстановления. +* `MacroPdf417FileSize` должен точно отражать количество байтов оригинального файла; значения больше `2^31‑1` требуют 64‑битного поля, которое Aspose обрабатывает автоматически. +* `MacroPdf417TimeStamp` фиксирует время создания штрих‑кода. Используйте UTC, чтобы избежать неоднозначности часовых поясов. +* `MacroPdf417Addressee` и `MacroPdf417Sender` – произвольные строки, в которых можно хранить информацию о маршрутизации. +* `MacroPdf417Terminator` сигнализирует, что это последний сегмент; установите его в `Set` для последней части, иначе оставьте значение по умолчанию (`NotSet`). + +**Совет для граничных случаев** – Если размер вашего файла превышает 4 ГБ, разбейте содержимое на несколько макросегментов и скорректируйте `SegmentsCount` соответственно. Библиотека управляет полем большого размера без переполнения. + +## Шаг 5: Сохранить штрих‑код как PNG‑изображение + +Последний шаг записывает сгенерированный символ на диск. PNG сохраняет точные пиксельные размеры и широко поддерживается сканирующим оборудованием. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Замените `YOUR_DIRECTORY` на абсолютный или относительный путь, в который процесс может записать файл. Перечисление `BarCodeImageFormat.Png` гарантирует безпотерянный вывод. + +**Почему PNG?** – Растровые форматы, такие как PNG, сохраняют резкие границы модулей, что важно для сканеров, полагающихся на контрастные края. Если нужен векторный формат, Aspose также поддерживает `Pdf` и `Svg`. + +## Полный пример, готовый к запуску + +Ниже представлена полная программа, которую можно скопировать в консольное приложение. В ней включены необходимые директивы `using` и метод `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Ожидаемый результат + +Запуск программы создаёт файл **MacroPdf417.png** в рабочем каталоге проекта. Открытие изображения показывает компактный PDF417‑штрих‑код с внедрёнными макро‑полями. Сканирование изображения совместимым считывателем PDF417 (например, ZXing, декодером Aspose.BarCode) возвращает исходную строку `"Sample text"` вместе с макро‑метаданными. + +## Часто задаваемые вопросы и устранение неполадок + +| Вопрос | Ответ | +|----------|--------| +| *Что делать, если штрих‑код слишком велик для целевой этикетки?* | Уменьшите `XDimension.Pixels` или увеличьте `Pdf417.Columns`. Оба параметра влияют на общий размер. | +| *Можно ли генерировать векторное изображение вместо PNG?* | Да. Вызовите `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` для масштабируемого вывода. | +| *Как проверить контрольную сумму после сканирования?* | Декодер Aspose.BarCode автоматически валидирует `MacroPdf417Checksum` и сообщает о несоответствиях в объекте `MacroPdf417Result`. | +| *Совместима ли библиотека с .NET Core?* | Пакет NuGet поддерживает .NET Standard 2.0+, что покрывает .NET Core, .NET 5, .NET 6 и более новые версии. | +| *Что если нужно внедрить бинарные данные вместо текста?* | Преобразуйте бинарный payload в Base64 или используйте перегрузку `EncodeTypes.MacroPdf417`, принимающую массив байтов. | + +## Профессиональные советы для продакшн‑использования + +* **Кешировать генератор** – + + +## Что следует изучить дальше? + + +Следующие руководства охватывают близкие темы, расширяющие техники, продемонстрированные в этом руководстве. Каждый ресурс содержит полностью рабочие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы в ваших проектах. + +- [Как создать штрих‑код – Compact PDF417 с Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Как считывать штрих‑коды из PDF на Java с помощью Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Создание штрих‑кода Codabar с Aspose.Barcode – API генератора и считывателя](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/net/compact-pdf417-encoding/_index.md b/barcode/spanish/net/compact-pdf417-encoding/_index.md index dda665700..57094bf0c 100644 --- a/barcode/spanish/net/compact-pdf417-encoding/_index.md +++ b/barcode/spanish/net/compact-pdf417-encoding/_index.md @@ -170,8 +170,13 @@ Aprende a generar códigos de barras Compact PDF417 usando Aspose.BarCode para . ## Tutoriales relacionados - [Cómo crear código de barras – Compact PDF417 con Aspose.BarCode](/barcode/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cómo generar código de barras PDF417 en C# y establecer el tamaño del código de barras](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +- [Cómo crear código de barras PDF417 en C# y guardarlo como PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +- [Cómo crear código de barras micro PDF417 en C# – guía paso a paso](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) - [Tutoriales y ejemplos completos de Aspose.BarCode para .NET](/barcode/net/) - [Cómo crear código de barras Aztec con corrección de errores en .NET](/barcode/net/aztec-barcode-encoding/aztec-error-level-example/) +- [Cómo usar un generador de códigos de barras C# para Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +- [Cómo leer códigos de barras PDF417 en C# – guía completa](./how-to-read-pdf417-barcodes-in-c-complete-guide/) {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/barcode/spanish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/spanish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..02b3547b5 --- /dev/null +++ b/barcode/spanish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,215 @@ +--- +category: general +date: 2026-08-22 +description: Aprende a crear códigos de barras micro PDF417 en C# y generar una imagen + PNG del código de barras. Incluye configurar las dimensiones del código de barras + y guardar el archivo. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: es +lastmod: 2026-08-22 +og_description: Crea un código de barras micro PDF417 en C# y expórtalo como PNG. + Sigue esta guía para establecer las dimensiones del código de barras y generar una + imagen de código de barras rápidamente. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Crear código de barras micro PDF417 en C# – tutorial completo de codificación +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Cómo crear un código de barras micro PDF417 en C# – guía paso a paso +url: /es/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo crear un código de barras micro PDF417 en C# – guía paso a paso + +Si necesitas **crear un código de barras micro PDF417** para un sistema de tickets, una etiqueta de inventario o escaneo móvil, este tutorial te muestra exactamente cómo hacerlo. Verás el programa completo en C# que genera un PNG del código de barras, aprenderás a establecer las dimensiones del código y comprenderás cada opción de configuración. + +Al final de esta guía podrás generar una imagen de código de barras de alta resolución, personalizar la X‑dimensión, elegir el número de columnas y guardar el resultado como un archivo PNG, todo con unas pocas líneas de código. + +## Lo que necesitarás + +- .NET 6.0 SDK o posterior (el código funciona con .NET Core y .NET Framework) +- Visual Studio 2022 o cualquier IDE compatible con C# +- El paquete NuGet **Aspose.BarCode for .NET** (o cualquier biblioteca que soporte `EncodeTypes.MicroPdf417`) +- Familiaridad básica con la sintaxis de C# + +> **Consejo:** La edición comunitaria gratuita de Aspose.BarCode es suficiente para desarrollo y pruebas. Para producción, obtén una licencia para eliminar las marcas de agua de evaluación. + +## Paso 1: Instalar la biblioteca de códigos de barras + +Abre una terminal en la carpeta de tu proyecto y ejecuta: + +```bash +dotnet add package Aspose.BarCode +``` + +Esto agrega el ensamblado `Aspose.BarCode`, que proporciona la clase `BarcodeGenerator` utilizada para **crear aplicaciones de imagen de código de barras en C#**. + +## Paso 2: Inicializar el generador – crear código de barras micro PDF417 + +La primera línea ejecutable crea una instancia de `BarcodeGenerator` configurada para la simbología Micro PDF417 y suministra los datos que deseas codificar. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Por qué es importante*: El enumerado `EncodeTypes.MicroPdf417` indica a la biblioteca que use la versión compacta de PDF417, ideal para etiquetas pequeñas y pantallas móviles. + +## Paso 3: Cómo establecer las dimensiones del código de barras en C# + +Ajustar finamente el ancho del módulo (X‑dimensión) controla la densidad visual del código de barras. Un valor más pequeño produce una imagen más nítida, mientras que un valor mayor facilita la lectura a distancia. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Por qué deberías establecer dimensiones**: Sin ajustar la X‑dimensión, el valor predeterminado puede producir un código de barras que se ve borroso al renderizarse a alta DPI. Establecerlo en 2 píxeles es un buen equilibrio para la mayoría de los escaneos basados en pantalla. + +## Paso 4: Elegir el número de columnas – controlar el ancho del código de barras + +Micro PDF417 permite entre 1 y 4 columnas. Más columnas comprimen los datos horizontalmente, reduciendo el ancho total de la imagen. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Caso límite*: Si solicitas 5 columnas la biblioteca lanza una `ArgumentOutOfRangeException`. Mantente siempre dentro del rango documentado. + +## Paso 5: Cómo generar un PNG del código de barras – guardar la imagen + +Ahora puedes exportar el código de barras generado a un archivo PNG. PNG conserva calidad sin pérdidas, lo cual es esencial para un escaneo fiable. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Al ejecutar el programa, verás un mensaje en la consola confirmando la ubicación del archivo. El `MicroPdf417.png` resultante se ve así: + +![Captura de pantalla que muestra un código de barras micro PDF417 generado con C#](micro-pdf417-example.png "Código de barras micro PDF417 generado") + +*Texto alternativo de la imagen*: **código de barras micro PDF417 generado en C#** – muestra la salida final después de aplicar las dimensiones y la configuración de columnas. + +## Paso 6: Ejecutar y verificar la salida + +1. Compila el proyecto: `dotnet build`. +2. Ejecuta: `dotnet run`. +3. Abre `MicroPdf417.png` en tu escritorio y escanéalo con una aplicación móvil de escáner de códigos de barras. + +Deberías ver el texto **“Sample text”** decodificado. Si el escáner informa un error, verifica la X‑dimensión y el número de columnas – valores extremos pueden hacer que el código sea demasiado denso para algunos dispositivos. + +## Variaciones comunes y solución de problemas + +| Situación | Ajuste | +|-----------|--------| +| **Necesitas un código de barras más grande para impresoras de baja resolución** | Aumenta `XDimension.Pixels` a 3 o 4. | +| **Quieres un código de barras más alto sin cambiar el ancho** | Establece `generator.Parameters.Barcode.Pdf417.Rows` (rango de filas 3‑90). | +| **Generar varios códigos de barras en un bucle** | Reutiliza la misma instancia de `BarcodeGenerator` y solo cambia `CodeText` antes de cada `Save`. | +| **Guardar como JPEG en lugar de PNG** | Reemplaza `BarCodeImageFormat.Png` por `BarCodeImageFormat.Jpeg`. | +| **Ejecutar en .NET Framework 4.7** | El mismo código funciona; solo referencia el `Aspose.BarCode.dll` apropiado. | + +## Listado completo del código fuente (ejecutable) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Salida esperada** – un archivo PNG de 200 × 100 píxeles que contiene un código de barras Micro PDF417 nítido que decodifica “Sample text”. + +## Conclusión + +Ahora sabes cómo **crear un código de barras micro PDF417** en C#, **establecer las dimensiones del código** y **generar una imagen PNG del código de barras**. El ejemplo completo muestra cada paso necesario, desde la instalación de la biblioteca hasta el guardado del archivo final, para que puedas integrar la generación de códigos de barras directamente en tus propias aplicaciones. + +A continuación, explora temas relacionados como **crear códigos QR con Aspose.BarCode**, **personalizar colores** o **incorporar códigos de barras en documentos PDF**. Cada uno de ellos se basa en los mismos fundamentos de `BarcodeGenerator` presentados aquí. + +Siéntete libre de experimentar con distintas cadenas de datos, números de columnas y valores de X‑dimensión para adaptarlos a tu entorno de escaneo específico. ¡Feliz codificación! + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que amplían las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y explicaciones paso a paso para ayudarte a dominar funciones adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Cómo crear códigos de barras – PDF417 compacto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cómo generar códigos de barras PDF417 – Codificación PDF417 compacto](/barcode/english/net/compact-pdf417-encoding/) +- [Cómo crear códigos de barras Aztec con Aspose.BarCode para .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/spanish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..7b7b67dd9 --- /dev/null +++ b/barcode/spanish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Aprende a crear códigos de barras PDF417 en C# con un generador de códigos + de barras, configurar el diseño y guardar en PNG. Incluye código completo y consejos + para proyectos de generador de códigos de barras en C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: es +lastmod: 2026-08-22 +og_description: Crea un código de barras PDF417 en C# usando un generador de códigos + de barras, personaliza el diseño y aprende cómo guardar PNG. Sigue este tutorial + paso a paso. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Crear código de barras PDF417 en C# – guía completa para generar y guardar + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cómo crear un código de barras PDF417 en C# y guardarlo como PNG +url: /es/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo crear un código de barras PDF417 en C# y guardarlo como PNG + +Si necesitas **crear un código de barras PDF417** en una aplicación C#, este tutorial te muestra los pasos exactos. Verás cómo una biblioteca generadora de códigos de barras C# puede convertir cualquier cadena en una imagen PDF417 escaneable y cómo guardar archivos PNG sin herramientas adicionales. + +Generar códigos de barras es común en logística, emisión de boletos y gestión de documentos. Al final de esta guía tendrás un programa de consola ejecutable que produce un archivo PNG llamado `Pdf417Layout.png` en la carpeta que elijas. + +## Requisitos previos + +- .NET 6.0 SDK o posterior instalado (el código también funciona con .NET Framework 4.7+). +- Visual Studio 2022 o cualquier editor que pueda compilar proyectos C#. +- El paquete NuGet **Aspose.BarCode for .NET** (o cualquier biblioteca generadora de códigos de barras C# compatible). + Instálalo con: + +```bash +dotnet add package Aspose.BarCode +``` + +No se requieren bibliotecas adicionales de procesamiento de imágenes porque el generador puede escribir PNG directamente. + +## Paso 1: Configurar un nuevo proyecto de consola + +Crea un nuevo proyecto de consola para que el ejemplo sea autónomo. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +La carpeta `Pdf417Demo` ahora contiene un archivo `Program.cs` donde escribiremos el código del código de barras. + +## Paso 2: Importar el espacio de nombres del código de barras + +Abre `Program.cs` y agrega la directiva `using` requerida al inicio: + +```csharp +using Aspose.BarCode.Generation; +``` + +Este espacio de nombres te brinda acceso a `BarcodeGenerator`, `EncodeTypes` y al enum de formato de imagen necesario para **cómo guardar PNG**. + +## Paso 3: Crear el generador de código de barras PDF417 + +El núcleo de **cómo generar PDF417** es la clase `BarcodeGenerator`. Pasa el tipo de codificación `EncodeTypes.Pdf417` y el texto que deseas codificar. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` ahora contiene todas las configuraciones del código de barras. El diseño predeterminado funciona, pero lo personalizaremos en el siguiente paso. + +## Paso 4: Definir el diseño del código de barras (columnas y filas) + +PDF417 te permite controlar el número de columnas (2‑30) y filas (1‑90). Ajustar estos valores puede mejorar la legibilidad para escáneres específicos. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Consejo profesional:** Si omites estas configuraciones, la biblioteca elige valores óptimos automáticamente. Sin embargo, fijar columnas y filas te brinda dimensiones de imagen predecibles, lo cual es útil cuando incrustas el PNG en un PDF o en un diseño de UI. + +## Paso 5: Guardar el código de barras generado como una imagen PNG + +Ahora responde **cómo guardar PNG** llamando a `Save`. El método acepta la ruta de destino y el enum de formato de imagen. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +El archivo `Pdf417Layout.png` aparece en la carpeta `bin/Debug/net6.0` del proyecto después de ejecutar el programa. + +## Ejemplo completo ejecutable + +A continuación se muestra el archivo `Program.cs` completo. Cópialo en el proyecto creado en **Paso 1** y ejecuta `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Salida esperada + +Al ejecutar el programa, la consola muestra la ruta absoluta al archivo PNG, y el archivo contiene un código de barras PDF417 claro que se parece a la imagen a continuación. + +![ejemplo de creación de código de barras PDF417](image-placeholder.png "Código de barras PDF417 guardado como PNG") + +Puedes escanear el PNG con cualquier escáner compatible con PDF417 (aplicaciones móviles, lectores de hardware) para verificar que el texto codificado es `"Sample"`. + +## Manejo de casos límite y errores comunes + +| Situación | Qué observar | Solución recomendada | +|-----------|--------------|----------------------| +| **Valores de columna/fila no válidos** | Valores fuera del rango 2‑30 (columnas) o 1‑90 (filas) provocan una `ArgumentException`. | Valida la entrada del usuario antes de asignar, o permite que la biblioteca elija valores predeterminados. | +| **Cadenas de entrada largas** | PDF417 puede codificar hasta 1.850 caracteres, pero las cadenas muy largas aumentan dramáticamente el número de filas requeridas. | Divide los datos en varios códigos de barras o usa un nivel de corrección de errores más alto si es necesario. | +| **Permisos del sistema de archivos** | Guardar en una carpeta de solo lectura lanza una `UnauthorizedAccessException`. | Escribe en `Environment.CurrentDirectory` o en una ruta con permisos de escritura para el usuario, y maneja las excepciones con try/catch. | +| **Paquete NuGet faltante** | La compilación falla con “type or namespace name could not be found”. | Asegúrate de que `Aspose.BarCode` esté instalado (`dotnet add package Aspose.BarCode`). | + +## Extender el ejemplo + +Ahora que sabes **cómo crear un código de barras PDF417** y **cómo guardar PNG**, puedes explorar estos temas relacionados: + +- **Generador de códigos de barras C#**: Cambia `EncodeTypes` a `Code128`, `QR` u otras simbologías. +- **Colores personalizados**: Usa `generator.Parameters.Barcode.ForegroundColor` y `BackgroundColor` para coincidir con la marca. +- **Incrustar en PDFs**: Combina el PNG con una biblioteca PDF (p.ej., iText7) para crear documentos imprimibles. +- **Datos dinámicos**: Obtén el texto de una base de datos o entrada del usuario para generar códigos de barras al instante. + +## Conclusión + +Ahora tienes una solución completa y lista para producción para **crear un código de barras PDF417** en C# y guardar el resultado como un archivo PNG. El tutorial cubrió cada paso, desde la configuración del proyecto hasta la personalización del diseño, y destacó cómo evitar errores comunes al usar una biblioteca generadora de códigos de barras C#. + +Siéntete libre de experimentar con diferentes configuraciones de columnas/filas, colores o incluso otros formatos de códigos de barras. Si encuentras algún problema, revisita la sección **cómo generar PDF417** o explora la documentación de la biblioteca para funciones avanzadas. ¡Feliz codificación! + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que se basan en las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y funcionales con explicaciones paso a paso para ayudarte a dominar funciones adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Cómo crear código de barras – PDF417 compacto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cómo generar código de barras PDF417 – Codificación PDF417 compacto](/barcode/english/net/compact-pdf417-encoding/) +- [Cómo crear zona silenciosa del código de barras para ITF-14 usando Aspose.BarCode para .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/spanish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..262e4a344 --- /dev/null +++ b/barcode/spanish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: Aprende cómo generar códigos de barras PDF417 en C# con Aspose.BarCode, + establecer el tamaño del código de barras, ajustar las columnas y habilitar el modo + compacto. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: es +lastmod: 2026-08-22 +og_description: Genera códigos de barras PDF417 en C# con Aspose.BarCode. Esta guía + muestra cómo establecer el tamaño del código de barras, controlar las columnas y + habilitar el modo compacto para una imagen más pequeña. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Generar código de barras PDF417 en C# – establecer tamaño, columnas y modo + compacto +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Cómo generar un código de barras PDF417 en C# y establecer su tamaño +url: /es/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo generar código de barras PDF417 en C# y establecer el tamaño del código de barras + +Si necesitas **generar código de barras PDF417** en una aplicación .NET, esta guía te lleva a través del proceso completo. Verás exactamente **cómo generar PDF417** con Aspose.BarCode, ajustar el **tamaño del código de barras**, y producir un PNG compacto que puede incrustarse en informes o aplicaciones móviles. + +Crear un código de barras no requiere un editor gráfico separado. Al final de este tutorial tendrás un método C# totalmente funcional que produce una imagen PDF417 con las dimensiones exactas que necesitas, lista para el procesamiento posterior. + +## Lo que aprenderás + +* Instalar y referenciar la biblioteca Aspose.BarCode. +* Crear un generador de código de barras PDF417 y especificar el texto codificado. +* **Establecer el tamaño del código de barras** configurando la X‑dimensión y la cantidad de columnas. +* Habilitar el modo compacto (truncado) para reducir el símbolo. +* Guardar el resultado como un archivo PNG. +* Solucionar problemas comunes como códigos ilegibles e imágenes demasiado grandes. + +### Requisitos previos + +* .NET 6.0 o posterior (la API también funciona con .NET Framework 4.6+). +* Familiaridad básica con C# y Visual Studio (o cualquier IDE de C#). +* Una licencia válida de Aspose.BarCode (la evaluación gratuita sirve para pruebas). + +> **Consejo profesional:** Si planeas generar muchos códigos de barras en un bucle, reutiliza una única instancia de `BarcodeGenerator` y solo cambia la propiedad `CodeText`. Esto reduce las asignaciones de memoria. + +## Generar código de barras PDF417 con Aspose.BarCode + +El primer paso es instanciar el `BarcodeGenerator` para la simbología PDF417. Este objeto es el punto de entrada para todas las operaciones de códigos de barras. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Por qué es importante*: `EncodeTypes.Pdf417` indica a la biblioteca que use el estándar PDF417, que soporta grandes volúmenes de datos y corrección de errores. El constructor también acepta los datos que deseas codificar, eliminando la necesidad de una asignación separada de `CodeText` más adelante. + +## Establecer el tamaño del código de barras y la cantidad de columnas + +Los símbolos PDF417 consisten en filas y columnas de pequeños módulos rectangulares. Controlar el ancho del módulo (X‑dimensión) y la cantidad de columnas te permite afinar las dimensiones generales. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explicación*: +* **X‑dimension** (`Pixels`) determina cuán ancho es cada módulo. Valores más pequeños producen un código de barras más compacto, mientras que valores más grandes aumentan la legibilidad en escáneres de baja resolución. +* **Columns** controla el diseño horizontal. Menos columnas hacen que el código de barras sea más alto; más columnas lo hacen más ancho. Ajusta estas dos configuraciones juntas para lograr el **tamaño del código de barras** exacto que necesitas. + +## Habilitar el modo compacto para un código de barras más pequeño + +PDF417 incluye un modo “compacto” (o truncado) que elimina el relleno innecesario y reduce la huella total. Esto es especialmente útil cuando dispones de espacio de pantalla limitado. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*¿Por qué habilitar la truncación?* +Cuando `Truncate` es `true`, el generador omite el patrón de parada y algunos codewords de corrección de errores que no son necesarios para la mayoría de los escenarios de escaneo. La imagen resultante es aproximadamente un 15‑20 % más pequeña sin sacrificar la integridad de los datos para casos de uso típicos. + +## Guardar el código de barras como una imagen PNG + +Después de configurar el tamaño y el modo, escribe el código de barras en disco. PNG es sin pérdida, garantizando que los bordes de los módulos permanezcan nítidos. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +El archivo `CompactPdf417.png` contendrá un símbolo PDF417 nítido que coincide con las dimensiones que configuraste en los pasos anteriores. + +### Resultado esperado + +Abrir el PNG guardado debería mostrar un código de barras PDF417 orientado verticalmente que consiste en tres columnas, cada módulo de 2 px de ancho, y un tamaño total de aproximadamente **120 × 240 px** (ancho × alto). Escanear la imagen con cualquier lector estándar de PDF417 devuelve el texto original “Sample text for PDF417”. + +## Errores comunes y cómo evitarlos + +| Síntoma | Causa probable | Solución | +|---------|----------------|----------| +| El código de barras es ilegible | X‑dimension demasiado pequeña para el escáner | Incrementar `XDimension.Pixels` a 3 o 4 | +| La imagen es demasiado ancha para la UI | Se establecieron demasiadas columnas | Reducir `Pdf417.Columns` o habilitar `Truncate` | +| Excepción `ArgumentOutOfRangeException` | Conteo de columnas negativo o cero | Asegurarse de que `Columns` sea un entero positivo (mínimo 1) | +| El archivo PNG está vacío | La ruta de salida no existe o carece de permisos de escritura | Verificar que el directorio exista y la aplicación tenga derechos de escritura | + +> **Consejo profesional:** Usa `barcodeGenerator.ValidateParameters()` antes de llamar a `Save()` para detectar errores de configuración temprano. + +## Ejemplo completo y ejecutable + +A continuación se muestra un programa de consola autónomo que incorpora todos los pasos anteriores. Cópialo en un nuevo proyecto C#, restaura el paquete NuGet de Aspose.BarCode y ejecútalo para ver el resultado. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Ejecutar el programa** produce `CompactPdf417.png` en el directorio de trabajo del ejecutable. Escanea la imagen con una aplicación móvil (p. ej., “Barcode Scanner”) para verificar que el texto codificado coincide con la cadena original. + +## Próximos pasos y temas relacionados + +* **Incrementar el nivel de corrección de errores** – ajustar `Pdf417.ErrorLevel` para entornos con escaneos ruidosos. +* **Cambiar la orientación** – establecer `Pdf417.Rotate` a `RotationAngle.Rotate90` si necesitas un diseño horizontal. +* **Incrustar el código de barras en un PDF** – combinar Aspose.PDF con Aspose.BarCode para colocar la imagen directamente en un documento. +* **Generar otros códigos de barras 2‑D** – la misma clase `BarcodeGenerator` soporta códigos DataMatrix, QR y Aztec; solo cambia `EncodeTypes.Pdf417` por la simbología deseada. + +Al dominar las técnicas para **generar código de barras PDF417**, puedes automatizar la emisión de boletos, el etiquetado de inventario y la transmisión segura de datos en una amplia gama de aplicaciones .NET. + +## Conclusión + +Ahora sabes cómo **generar código de barras PDF417** en C#, establecer **precisamente el tamaño del código de barras**, configurar columnas, habilitar el modo compacto y guardar el resultado como PNG. Aplica estas configuraciones para adaptarse a cualquier restricción de UI o requisito de escaneo, y extiende el enfoque a otros formatos de códigos de barras según sea necesario. ¡Feliz codificación! + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que se basan en las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y funcionales con explicaciones paso a paso para ayudarte a dominar características adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Cómo generar código de barras PDF417 – Codificación Compacta PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Cómo crear código de barras – PDF417 compacto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cómo generar códigos de barras DataMatrix usando Aspose.BarCode para .NET – Guía paso a paso](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/spanish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..ac6a4b289 --- /dev/null +++ b/barcode/spanish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-08-22 +description: Cómo leer códigos de barras PDF417 en C# con una guía paso a paso, cubriendo + cómo leer varios códigos de barras de una imagen y extraer los detalles de MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: es +lastmod: 2026-08-22 +og_description: Cómo leer códigos de barras PDF417 en C# rápidamente. Este tutorial + te muestra cómo leer varios códigos de barras de una imagen y obtener la información + extendida MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Cómo leer códigos de barras PDF417 en C# – guía completa de programación +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Cómo leer códigos de barras PDF417 en C# – guía completa +url: /es/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo leer códigos de barras PDF417 en C# – guía completa + +Si necesitas **cómo leer PDF417** en una aplicación .NET, este tutorial te brinda una solución lista para ejecutar. Aprenderás a leer varios códigos de barras de una sola imagen, extraer el conjunto completo de datos MacroPdf417 y mostrarlos en la consola. El enfoque funciona con la biblioteca Aspose.BarCode for .NET y requiere solo unas pocas líneas de código. + +Leer códigos de barras a partir de una imagen es una tarea común en sistemas de inventario, validación de tickets y gestión de documentos. Al final de esta guía podrás decodificar cualquier código de barras PDF417 o MacroPdf417, manejar varios códigos en una sola foto y comprender los campos extendidos que proporciona MacroPdf417. + +## Prerrequisitos + +- SDK .NET 6.0 o posterior (el código también compila con .NET Framework 4.7+) +- Visual Studio 2022 o cualquier editor de C# que prefieras +- Paquete NuGet Aspose.BarCode for .NET (`Install-Package Aspose.BarCode`) +- Una imagen de muestra que contenga un código de barras MacroPdf417 (p. ej., `MacroPdf417.png`) + +No se requiere configuración adicional; la biblioteca maneja la carga y decodificación de la imagen internamente. + +## Cómo leer códigos de barras PDF417 a partir de una imagen en C# + +El núcleo de la solución es la clase `BarCodeReader`. Abre la imagen, detecta todos los códigos de barras del tipo especificado y devuelve una colección de objetos `BarCodeResult`. El siguiente código muestra un programa de consola completo. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Por qué cada línea es importante + +| Paso | Propósito | +|------|-----------| +| **1️⃣ Initialize** | Crea un `BarCodeReader` vinculado al archivo de imagen y restringe la detección a la simbología MacroPdf417, lo que acelera el procesamiento. | +| **2️⃣ Iterate** | `ReadBarCodes()` devuelve **todos** los códigos de barras que coinciden con el tipo solicitado, permitiéndote **leer varios códigos de barras** sin bucles adicionales. | +| **3️⃣ Basic output** | Muestra el `CodeTypeName` genérico y el `CodeText` legible por humanos. Esto es útil para registro o validación rápida. | +| **4️⃣ Extended data** | MacroPdf417 lleva metadatos adicionales (ID de archivo, recuento de segmentos, marcas de tiempo, etc.). El objeto `Extended.Pdf417` expone cada campo directamente, para que puedas almacenar o verificar todo el paquete de datos. | + +Ejecutar el programa con una imagen MacroPdf417 válida produce una salida en consola similar a la siguiente: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +La salida confirma que la biblioteca leyó correctamente el código de barras, extrajo el texto y proporcionó cada campo de MacroPdf417. + +## Lectura de varios códigos de barras a partir de una sola imagen + +Muchos escenarios del mundo real colocan varios símbolos PDF417 en una etiqueta—piensa en un manifiesto de envío que contiene un código de transportista, un número de seguimiento y una declaración de aduanas. El mismo bloque de código anterior ya **lee varios códigos de barras** porque `ReadBarCodes()` devuelve un enumerable con todas las coincidencias. No se necesita configuración adicional; solo tienes que iterar sobre los resultados, como se muestra. + +Si deseas limitar el lector a PDF417 estándar (no macro) mientras manejas varios códigos, reemplaza `DecodeType.MacroPdf417` por `DecodeType.Pdf417`. El resto de la lógica permanece sin cambios. + +## Comprensión de los datos extendidos de MacroPdf417 + +MacroPdf417 es una extensión de la especificación PDF417 regular. Divide cargas útiles grandes en varios segmentos y añade un pequeño encabezado que describe todo el archivo. Los campos más relevantes son: + +- **MacroPdf417FileID** – un identificador único compartido por todos los segmentos del mismo archivo. +- **MacroPdf417SegmentID** – el número de secuencia del segmento actual. +- **MacroPdf417SegmentsCount** – número total de segmentos esperados. +- **MacroPdf417FileName** – nombre de archivo opcional transmitido con el código de barras. +- **MacroPdf417Checksum** – valor de verificación de errores para el archivo completo. +- **MacroPdf417FileSize** – tamaño de la carga binaria original. +- **MacroPdf417TimeStamp** – marca de tiempo ISO‑8601 cuando se generó el código de barras. +- **MacroPdf417Addressee / Sender** – campos de texto opcionales para el enrutamiento. +- **MacroPdf417Terminator** – indica si este segmento es el final. + +Cuando recibas todos los segmentos, puedes reconstruir el archivo original ordenándolos por `MacroPdf417SegmentID` y concatenando los valores de `CodeText`. Esta lógica es sencilla de implementar una vez que tienes los campos disponibles. + +## Trucos comunes y consejos profesionales + +- **Image quality matters** – los archivos PNG/JPEG de baja resolución o fuertemente comprimidos pueden provocar detecciones fallidas. Usa al menos 300 dpi para códigos de barras impresos. +- **Mixed symbologies** – si la imagen contiene tanto MacroPdf417 como PDF417 regular, instancia dos lectores (uno para cada `DecodeType`) o usa `DecodeType.AllSupported` y filtra los resultados por `result.CodeTypeName`. +- **Memory usage** – la instrucción `using` elimina rápidamente el `BarCodeReader`, evitando que grandes búferes de imagen permanezcan en memoria. +- **Thread safety** – `BarCodeReader` no es seguro para subprocesos. Crea una instancia separada por subproceso si decodificas imágenes en paralelo. +- **Error handling** – envuelve la llamada a `ReadBarCodes()` en un bloque try/catch para capturar `BarCodeException` en caso de imágenes corruptas. + +## Recapitulación del ejemplo completo funcionando + +A continuación tienes el programa completo que puedes copiar en un nuevo proyecto de consola. Incluye todas las directivas `using`, una constante para la ruta de la imagen y el patrón de disposición. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Compila con `dotnet build` y ejecuta con `dotnet run`. La consola imprime los datos básicos de cada código de barras y la carga completa de MacroPdf417. + +## Próximos pasos + +- **Reconstruir archivos multipartes** – recopila todos los segmentos, ordénalos por `MacroPdf417SegmentID` y concatena `CodeText` to + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que amplían las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos con explicaciones paso a paso para ayudarte a dominar funciones adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Cómo generar código de barras PDF417 – Codificación Compacta PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [Cómo leer códigos de barras PDF417 con caracteres turcos en Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Cómo usar Aspose para código de barras PDF417 (chino) en Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/spanish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..607ad5caf --- /dev/null +++ b/barcode/spanish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-08-22 +description: El tutorial del generador de códigos de barras en C# muestra cómo crear + un código de barras Macro PDF417 con metadatos y guardarlo como PNG usando Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: es +lastmod: 2026-08-22 +og_description: El generador de códigos de barras C# le permite crear un código de + barras Macro PDF417 con metadatos a nivel de archivo completos y exportarlo como + PNG. Siga esta guía para implementar la solución. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: generador de códigos de barras C# – crea códigos de barras Macro PDF417 + paso a paso +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cómo usar un generador de códigos de barras C# para Macro PDF417 +url: /es/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo usar un generador de códigos de barras C# para Macro PDF417 + +Si necesita un **barcode generator C#** que pueda generar un símbolo Macro PDF417 con metadatos a nivel de archivo, esta guía le proporciona una solución completa y lista para ejecutar. Verá cómo configurar la apariencia del código de barras, incrustar información macro como el ID del archivo y el recuento de segmentos, y finalmente guardar el resultado como una imagen PNG. + +El ejemplo utiliza la biblioteca Aspose.BarCode, una **C# barcode library** ampliamente adoptada que soporta el conjunto completo de funciones PDF417. No se requieren servicios externos, y el código funciona con .NET 6 o posterior. + +## Requisitos previos + +Antes de comenzar, asegúrese de contar con: + +* SDK de .NET 6 (o cualquier versión posterior) instalado. +* Visual Studio 2022, VS Code, u otro IDE de C#. +* Una referencia NuGet a **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Comprender la sintaxis básica de C# y el concepto de códigos de barras PDF417 le ayudará a seguir los pasos, pero el tutorial explica cada opción de configuración en detalle. + +## Qué cubre el tutorial + +* Inicializar una instancia de **barcode generator C#** para el formato Macro PDF417. +* Ajustar parámetros visuales como X‑dimension y el recuento de columnas. +* Proporcionar los campos a nivel de archivo de Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender y terminator. +* Guardar el símbolo generado como un archivo PNG. +* Consejos para manejar casos límite como tamaños de archivo grandes o marcas de tiempo personalizadas. + +Al final de este artículo tendrá un programa autónomo que produce un código de barras Macro PDF417 totalmente conforme. + +## Paso 1: Crear la instancia del barcode generator C# + +La primera operación es instanciar `BarcodeGenerator` con el valor enum `EncodeTypes.MacroPdf417` y el texto que desea codificar. El constructor también acepta la cadena de carga útil, que se convierte en la porción de datos del código macro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Por qué es importante** – La bandera `EncodeTypes.MacroPdf417` indica a Aspose.BarCode que trate el símbolo como un código macro, habilitando los campos adicionales que siguen. Sin esta bandera, la biblioteca generaría un código PDF417 regular sin metadatos a nivel de archivo. + +## Paso 2: Ajustar la apariencia básica del código de barras (configuraciones visuales PDF417) + +La claridad visual es crucial para un escaneo fiable. Dos parámetros comunes son el ancho del módulo (`XDimension`) y el número de columnas. Ajustar estos valores equilibra el tamaño y la legibilidad. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` controla el ancho de cada barra negra/blanca. Un valor de **2** funciona bien para la mayoría de impresoras de etiquetas. +* `Pdf417.Columns` define cuántas columnas usará el código de barras. Cinco columnas producen un símbolo compacto sin sacrificar la capacidad de datos. + +## Paso 3: Definir la información a nivel de archivo de Macro PDF417 + +Macro PDF417 amplía el formato estándar PDF417 con campos que describen cómo un archivo grande se divide en varios segmentos de código de barras. Proporcionar estos campos asegura que los escáneres posteriores puedan reconstruir el archivo original. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` debe ser el mismo para cada segmento que pertenezca al mismo archivo lógico. +* `MacroPdf417SegmentID` se incrementa de **0** a `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` indica al decodificador cuántas piezas esperar. +* `MacroPdf417FileName` es opcional pero útil para una identificación legible por humanos. + +## Paso 4: Establecer metadatos macro adicionales + +Más allá de la información básica del archivo, la especificación permite campos extra como checksum, file size, timestamp, addressee, sender y una bandera terminator. Completar estos campos mejora la integridad y trazabilidad de los datos. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` proporciona un checksum CCITT de 16 bits para todo el archivo; el decodificador puede verificar la integridad después de la reconstrucción. +* `MacroPdf417FileSize` debe reflejar el recuento exacto de bytes del archivo original; valores mayores que `2^31‑1` requieren un campo de 64 bits, que Aspose maneja automáticamente. +* `MacroPdf417TimeStamp` registra cuándo se generó el código de barras. Use UTC para evitar ambigüedades de zona horaria. +* `MacroPdf417Addressee` y `MacroPdf417Sender` son cadenas de texto libre que pueden almacenar información de enrutamiento. +* `MacroPdf417Terminator` indica que este es el segmento final; configúrelo a `Set` para la última pieza, de lo contrario deje el valor predeterminado (`NotSet`). + +**Consejo para casos límite** – Si el tamaño de su archivo supera los 4 GB, divida el contenido en varios segmentos macro y ajuste `SegmentsCount` en consecuencia. La biblioteca gestionará el campo de gran tamaño sin desbordamiento. + +## Paso 5: Guardar el código de barras como una imagen PNG + +El paso final escribe el símbolo generado en disco. PNG conserva las dimensiones exactas de píxeles y es ampliamente soportado por el hardware de escaneo. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Reemplace `YOUR_DIRECTORY` con una ruta absoluta o relativa a la que el proceso en ejecución pueda escribir. El enum `BarCodeImageFormat.Png` garantiza una salida sin pérdidas. + +**¿Por qué PNG?** – Los formatos raster como PNG mantienen los bordes de los módulos nítidos, lo cual es esencial para los escáneres que dependen de bordes de alto contraste. Si necesita un formato vectorial, Aspose también soporta `Pdf` y `Svg`. + +## Ejemplo completo ejecutable + +A continuación se muestra el programa completo que puede copiar en una aplicación de consola. Incluye las directivas `using` necesarias y un método `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Salida esperada + +Ejecutar el programa crea un archivo llamado **MacroPdf417.png** en el directorio de trabajo del proyecto. Al abrir la imagen se muestra un código PDF417 compacto con los campos macro incrustados. Escanear la imagen con un lector compatible con PDF417 (p. ej., ZXing, decodificador Aspose.BarCode) devuelve la carga útil original `"Sample text"` junto con los metadatos macro. + +## Preguntas comunes y solución de problemas + +| Pregunta | Respuesta | +|----------|-----------| +| *¿Qué pasa si el código de barras es demasiado grande para la etiqueta objetivo?* | Reduzca `XDimension.Pixels` o aumente `Pdf417.Columns`. Ambos parámetros afectan el tamaño total. | +| *¿Puedo generar una imagen vectorial en lugar de PNG?* | Sí. Llame a `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` para una salida escalable. | +| *¿Cómo verifico el checksum después de escanear?* | El decodificador Aspose.BarCode valida automáticamente `MacroPdf417Checksum` y reporta discrepancias en el objeto `MacroPdf417Result`. | +| *¿Es la biblioteca compatible con .NET Core?* | El paquete NuGet soporta .NET Standard 2.0+, lo que cubre .NET Core, .NET 5, .NET 6 y versiones posteriores. | +| *¿Qué pasa si necesito incrustar datos binarios en lugar de texto?* | Convierta la carga binaria a Base64 o use la sobrecarga `EncodeTypes.MacroPdf417` que acepta un arreglo de bytes. | + +## Consejos profesionales para uso en producción + +* **Cache the generator** – + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que se basan en las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y funcionales con explicaciones paso a paso para ayudarle a dominar funciones adicionales de la API y explorar enfoques de implementación alternativos en sus propios proyectos. + +- [Cómo crear un código de barras – PDF417 compacto con Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cómo leer códigos de barras de PDF en Java usando Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Crear código de barras Codabar con Aspose.Barcode – API de generador y lector](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/net/compact-pdf417-encoding/_index.md b/barcode/swedish/net/compact-pdf417-encoding/_index.md index 12fa2c39d..fa5754b34 100644 --- a/barcode/swedish/net/compact-pdf417-encoding/_index.md +++ b/barcode/swedish/net/compact-pdf417-encoding/_index.md @@ -141,9 +141,21 @@ Compact PDF417:s höga datadensitet och robusta felkorrigering gör den lämplig ## Compact PDF417‑kodningshandledningar +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + +### [Hur man skapar PDF417‑streckkod i C# och sparar den som PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Lär dig hur du genererar en PDF417‑streckkod i C# och sparar den som PNG‑fil. + ### [Skapa Compact PDF417‑streckkoder](./compact-pdf417-basic-configuration/) Lär dig hur du genererar Compact PDF417‑streckkoder med Aspose.BarCode för .NET. Omfattande guide med steg‑för‑steg‑instruktioner och kodexempel. +### [Hur man skapar micro PDF417‑streckkod i C# – steg‑för‑steg‑guide](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [Hur man använder en streckkodsgenerator i C# för Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [Hur man läser PDF417‑streckkoder i C# – komplett guide](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Lär dig hur du läser PDF417‑streckkoder i C# med Aspose.BarCode, inklusive kodexempel och felsökning. + ## Vanliga frågor **Q: Vad är den maximala mängden data jag kan lagra i en Compact PDF417‑streckkod?** diff --git a/barcode/swedish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/swedish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..e8ee21a85 --- /dev/null +++ b/barcode/swedish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,217 @@ +--- +category: general +date: 2026-08-22 +description: Lär dig hur du skapar en micro PDF417‑streckkod i C# och genererar en + streckkod som PNG‑bild. Inkluderar att ställa in streckkodens dimensioner och spara + filen. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: sv +lastmod: 2026-08-22 +og_description: Skapa mikro‑PDF417‑streckkod i C# och exportera den som PNG. Följ + den här guiden för att ställa in streckkodens dimensioner och snabbt generera en + streckkodsbild. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Skapa mikro‑PDF417‑streckkod i C# – fullständig kodningshandledning +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Hur du skapar en mikro‑PDF417‑streckkod i C# – steg‑för‑steg‑guide +url: /sv/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man skapar micro PDF417 streckkod i C# – steg‑för‑steg guide + +Om du behöver **skapa micro PDF417 streckkod** för ett biljettsystem, lageretikett eller mobilskanning, visar den här handledningen exakt hur. Du får se det kompletta C#‑programmet som genererar en streckkod‑PNG, lära dig hur du ställer in streckkodsdimensioner och förstå varje konfigurationsalternativ. + +När du är klar med den här guiden kan du generera en högupplöst streckkodsbild, anpassa X‑dimensionen, välja kolumnantal och spara resultatet som en PNG‑fil – allt med några få kodrader. + +## Vad du behöver + +- .NET 6.0 SDK eller senare (koden fungerar med .NET Core och .NET Framework) +- Visual Studio 2022 eller någon annan C#‑kompatibel IDE +- **Aspose.BarCode for .NET** NuGet‑paketet (eller något bibliotek som stödjer `EncodeTypes.MicroPdf417`) +- Grundläggande kunskap om C#‑syntax + +> **Proffstips:** Den fria community‑editionen av Aspose.BarCode räcker för utveckling och testning. För produktion, skaffa en licens för att ta bort evalueringsvattenstämplar. + +## Steg 1: Installera streckkodsbiblioteket + +Öppna en terminal i din projektmapp och kör: + +```bash +dotnet add package Aspose.BarCode +``` + +Det här lägger till `Aspose.BarCode`‑assemblyn, som tillhandahåller `BarcodeGenerator`‑klassen som används för att **skapa streckkodsbild C#**‑applikationer. + +## Steg 2: Initiera generatorn – skapa micro PDF417 streckkod + +Den första handlingsbara raden skapar en `BarcodeGenerator`‑instans konfigurerad för Micro PDF417‑symbologi och levererar den data du vill koda. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Varför detta är viktigt*: `EncodeTypes.MicroPdf417`‑enumet talar om för biblioteket att använda den kompakta versionen av PDF417, vilket är idealiskt för små etiketter och mobila skärmar. + +## Steg 3: Hur man ställer in streckkodsdimensioner i C# + +Finjustering av modulbredden (X‑dimension) styr den visuella densiteten i streckkoden. Ett mindre värde ger en skarpare bild, medan ett större värde gör streckkoden lättare att skanna på avstånd. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Varför du bör ställa in dimensioner**: Utan att justera X‑dimensionen kan standardvärdet ge en streckkod som ser suddig ut när den renderas med hög DPI. Att sätta den till 2 pixlar är en bra balans för de flesta skärmbaserade skanningar. + +## Steg 4: Välj antal kolumner – kontroll av streckkodens bredd + +Micro PDF417 tillåter mellan 1 och 4 kolumner. Fler kolumner komprimerar data horisontellt och minskar den totala bildbredden. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Särskilt fall*: Om du begär 5 kolumner kastar biblioteket ett `ArgumentOutOfRangeException`. Håll dig alltid inom det dokumenterade intervallet. + +## Steg 5: Hur man genererar barcode PNG – sparar bilden + +Nu kan du exportera den genererade streckkoden till en PNG‑fil. PNG bevarar förlustfri kvalitet, vilket är avgörande för pålitlig skanning. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +När du kör programmet ser du ett konsolmeddelande som bekräftar filens plats. Den resulterande `MicroPdf417.png` ser ut så här: + +![Screenshot showing a generated micro PDF417 barcode created with C#](micro-pdf417-example.png "Generated micro PDF417 barcode") + +*Bild‑alt‑text*: **micro PDF417 streckkod genererad i C#** – visar det slutgiltiga resultatet efter att dimensioner och kolumninställningar har tillämpats. + +## Steg 6: Kör och verifiera resultatet + +1. Bygg projektet: `dotnet build`. +2. Kör: `dotnet run`. +3. Öppna `MicroPdf417.png` på ditt skrivbord och skanna den med en mobil streckkodsläsare. + +Du bör se texten **“Sample text”** avkodas. Om skannern rapporterar ett fel, dubbelkolla X‑dimensionen och kolumnantalet – extrema värden kan göra streckkoden för tät för vissa enheter. + +## Vanliga variationer och felsökning + +| Situation | Justering | +|-----------|------------| +| **Behöver en större streckkod för lågupplösta skrivare** | Öka `XDimension.Pixels` till 3 eller 4. | +| **Vill ha en högre streckkod utan att ändra bredden** | Ställ in `generator.Parameters.Barcode.Pdf417.Rows` (radintervall 3‑90). | +| **Generera flera streckkoder i en loop** | Återanvänd samma `BarcodeGenerator`‑instans och ändra bara `CodeText` innan varje `Save`. | +| **Spara som JPEG istället för PNG** | Byt ut `BarCodeImageFormat.Png` mot `BarCodeImageFormat.Jpeg`. | +| **Kör på .NET Framework 4.7** | Samma kod fungerar; referera bara till rätt `Aspose.BarCode.dll`. | + +## Fullständig källkod (körbar) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Förväntat resultat** – en 200 × 100‑pixel PNG‑fil som innehåller en skarp Micro PDF417 streckkod som avkodas till “Sample text”. + +## Slutsats + +Du vet nu hur du **skapar micro PDF417 streckkod** i C#, **ställer in streckkodsdimensioner** och **genererar en streckkod PNG**‑bild. Det kompletta exemplet demonstrerar varje nödvändigt steg – från bibliotekinstallation till sparande av den slutgiltiga filen – så att du kan integrera streckkodsgenerering direkt i dina egna applikationer. + +Nästa steg är att utforska relaterade ämnen som **att skapa QR‑koder med Aspose.BarCode**, **anpassa färger**, eller **bädda in streckkoder i PDF‑dokument**. Alla dessa bygger på samma `BarcodeGenerator`‑grundprinciper som behandlats här. + +Känn dig fri att experimentera med olika datasträngar, kolumnantal och X‑dimension‑värden för att passa just din skanningsmiljö. Lycka till med kodningen! + + +## Vad bör du lära dig härnäst? + + +Följande handledningar täcker nära besläktade ämnen som bygger på teknikerna som demonstrerats i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/swedish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..9847ae1ec --- /dev/null +++ b/barcode/swedish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,197 @@ +--- +category: general +date: 2026-08-22 +description: Lär dig hur du skapar PDF417‑streckkod i C# med en streckkodsgenerator, + ställer in layout och sparar som PNG. Inkluderar fullständig kod och tips för streckkodsgenerator‑C#‑projekt. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: sv +lastmod: 2026-08-22 +og_description: Skapa PDF417‑streckkod i C# med en streckkodsgenerator, anpassa layouten + och lär dig hur du sparar PNG. Följ denna steg‑för‑steg‑handledning. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Skapa PDF417-streckkod i C# – komplett guide för att generera och spara + PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hur man skapar PDF417‑streckkod i C# och sparar den som PNG +url: /sv/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man skapar PDF417 streckkod i C# och sparar den som PNG + +Om du behöver **skapa PDF417 streckkod** i en C#‑applikation visar den här handledningen de exakta stegen. Du kommer att se hur ett barcode generator C#‑bibliotek kan omvandla vilken sträng som helst till en avläsbar PDF417‑bild och hur du sparar PNG‑filer utan extra verktyg. + +Att generera streckkoder är vanligt inom logistik, biljettförsäljning och dokumenthantering. I slutet av den här guiden har du ett körbart konsolprogram som producerar en PNG‑fil med namnet `Pdf417Layout.png` i den mapp du väljer. + +## Förutsättningar + +- .NET 6.0 SDK eller senare installerat (koden fungerar även med .NET Framework 4.7+). +- Visual Studio 2022 eller någon editor som kan bygga C#‑projekt. +- **Aspose.BarCode for .NET** NuGet‑paketet (eller något kompatibelt barcode generator C#‑bibliotek). + Installera det med: + +```bash +dotnet add package Aspose.BarCode +``` + +Inga extra bildbehandlingsbibliotek krävs eftersom generatorn kan skriva PNG direkt. + +## Steg 1: Skapa ett nytt konsolprojekt + +Skapa ett nytt konsolprojekt så att exemplet förblir självständigt. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo`‑mappen innehåller nu en `Program.cs`‑fil där vi kommer att skriva streckkodskoden. + +## Steg 2: Importera barcode‑namnutrymmet + +Öppna `Program.cs` och lägg till den nödvändiga `using`‑direktivet högst upp: + +```csharp +using Aspose.BarCode.Generation; +``` + +Detta namnutrymme ger dig åtkomst till `BarcodeGenerator`, `EncodeTypes` och bildformat‑enumet som behövs för **hur man sparar PNG**. + +## Steg 3: Skapa PDF417 barcode‑generatorn + +Kärnan i **hur man genererar PDF417** är `BarcodeGenerator`‑klassen. Skicka in kodningstypen `EncodeTypes.Pdf417` och den text du vill koda. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` innehåller nu alla inställningar för streckkoden. Standardlayouten fungerar, men vi kommer att anpassa den i nästa steg. + +## Steg 4: Definiera streckkodslayouten (kolumner och rader) + +PDF417 låter dig styra antalet kolumner (2‑30) och rader (1‑90). Att justera dessa värden kan förbättra läsbarheten för specifika skannrar. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Proffstips:** Om du utelämnar dessa inställningar väljer biblioteket automatiskt optimala värden. Att fastställa kolumner och rader ger dig förutsägbara bilddimensioner, vilket är användbart när du bäddar in PNG‑filen i en PDF eller ett UI‑layout. + +## Steg 5: Spara den genererade streckkoden som en PNG‑bild + +Nu svarar du på **hur man sparar PNG** genom att anropa `Save`. Metoden accepterar målvägen och bildformat‑enumet. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Filen `Pdf417Layout.png` visas i projektets `bin/Debug/net6.0`‑mapp efter att du har kört programmet. + +## Fullt körbart exempel + +Nedan är den kompletta `Program.cs`‑filen. Kopiera den till projektet som skapades i **Steg 1** och kör `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Förväntad output + +När du kör programmet skriver konsolen ut den absoluta sökvägen till PNG‑filen, och filen innehåller en tydlig PDF417‑streckkod som ser liknande ut som bilden nedan. + +![exempel på skapad PDF417 streckkod](image-placeholder.png "PDF417 streckkod sparad som PNG") + +## Hantera kantfall och vanliga fallgropar + +| Situation | Vad att se upp för | Rekommenderad åtgärd | +|-----------|-------------------|---------------------| +| **Ogiltiga kolumn-/radvärden** | Värden utanför intervallet 2‑30 (kolumner) eller 1‑90 (rader) orsakar ett `ArgumentException`. | Validera användarens inmatning innan du tilldelar, eller låt biblioteket välja standardvärden. | +| **Stora inmatningssträngar** | PDF417 kan koda upp till 1 850 tecken, men mycket långa strängar ökar antalet rader kraftigt. | Dela upp data i flera streckkoder eller använd en högre felkorrigeringsnivå om det behövs. | +| **Fil‑systembehörigheter** | Att spara till en skrivskyddad mapp kastar ett `UnauthorizedAccessException`. | Skriv till `Environment.CurrentDirectory` eller en mapp som är skrivbar för användaren, och hantera undantag med try/catch. | +| **Saknat NuGet‑paket** | Kompileringen misslyckas med “type or namespace name could not be found”. | Säkerställ att `Aspose.BarCode` är installerat (`dotnet add package Aspose.BarCode`). | + +## Utöka exemplet + +Nu när du vet **hur man skapar PDF417 streckkod** och **hur man sparar PNG**, kan du utforska dessa relaterade ämnen: + +- **Barcode generator C#**: Ändra `EncodeTypes` till `Code128`, `QR` eller andra symboler. +- **Anpassade färger**: Använd `generator.Parameters.Barcode.ForegroundColor` och `BackgroundColor` för att matcha varumärket. +- **Bädda in i PDF‑filer**: Kombinera PNG‑filen med ett PDF‑bibliotek (t.ex. iText7) för att skapa utskrivbara dokument. +- **Dynamisk data**: Hämta texten från en databas eller användarinmatning för att generera streckkoder i realtid. + +## Slutsats + +Du har nu en komplett, produktionsklar lösning för **att skapa PDF417 streckkod** i C# och spara resultatet som en PNG‑fil. Handledningen täckte varje steg från projektuppsättning till layoutanpassning, och den belyste hur man undviker vanliga fel när man använder ett barcode generator C#‑bibliotek. + +Känn dig fri att experimentera med olika kolumn-/radinställningar, färger eller till och med andra streckkodformat. Om du stöter på problem, gå tillbaka till avsnittet **hur man genererar PDF417** eller utforska bibliotekets dokumentation för avancerade funktioner. Lycka till med kodandet! + +## Vad bör du lära dig härnäst? + +Följande handledningar täcker närbesläktade ämnen som bygger på teknikerna som demonstrerats i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [Hur man skapar streckkod – Compact PDF417 med Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hur man genererar PDF417 streckkod – Compact PDF417 kodning](/barcode/english/net/compact-pdf417-encoding/) +- [Hur man skapar streckkodens tysta zon för ITF-14 med Aspose.BarCode för .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/swedish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..3dfae76bc --- /dev/null +++ b/barcode/swedish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Lär dig hur du genererar PDF417‑streckkod i C# med Aspose.BarCode, ställer + in streckkodens storlek, justerar kolumner och aktiverar kompakt läge. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: sv +lastmod: 2026-08-22 +og_description: Generera PDF417‑streckkod i C# med Aspose.BarCode. Denna guide visar + hur du ställer in streckkodens storlek, kontrollerar kolumner och aktiverar kompakt + läge för en mindre bild. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Generera PDF417-streckkod i C# – ställ in storlek, kolumner och kompakt + läge +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Hur man genererar PDF417‑streckkod i C# och ställer in streckkodens storlek +url: /sv/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man genererar PDF417‑streckkod i C# och ställer in streckkodsstorlek + +Om du behöver **generera PDF417‑streckkod** i en .NET‑applikation, guidar den här artikeln dig genom hela processen. Du får se exakt **hur man genererar PDF417** med Aspose.BarCode, justerar **set barcode size**, och skapar en kompakt PNG som kan bäddas in i rapporter eller mobilappar. + +Att skapa en streckkod kräver ingen separat grafikredigerare. I slutet av den här tutorialen har du en fullt fungerande C#‑metod som producerar en PDF417‑bild med exakt de dimensioner du behöver, klar för vidare bearbetning. + +## Vad du kommer att lära dig + +* Installera och referera Aspose.BarCode‑biblioteket. +* Skapa en PDF417‑streckkodsgenerator och ange den kodade texten. +* **Set barcode size** genom att konfigurera X‑dimension och kolumnantal. +* Aktivera kompakt (trunkerad) läge för att minska symbolen. +* Spara resultatet som en PNG‑fil. +* Felsök vanliga problem som oläsliga koder och för stora bilder. + +### Förutsättningar + +* .NET 6.0 eller senare (API‑et fungerar även med .NET Framework 4.6+). +* Grundläggande kunskap om C# och Visual Studio (eller någon annan C#‑IDE). +* En giltig Aspose.BarCode‑licens (den fria utvärderingsversionen fungerar för testning). + +> **Pro tip:** Om du planerar att generera många streckkoder i en loop, återanvänd en enda `BarcodeGenerator`‑instans och ändra bara `CodeText`‑egenskapen. Detta minskar minnesallokeringar. + +## Generera PDF417‑streckkod med Aspose.BarCode + +Det första steget är att instansiera `BarcodeGenerator` för PDF417‑symbologi. Detta objekt är ingångspunkten för alla streckkodsåtgärder. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Varför detta är viktigt*: `EncodeTypes.Pdf417` talar om för biblioteket att använda PDF417‑standarden, som stödjer stora datamängder och felkorrigering. Konstruktorn accepterar också den data du vill koda, vilket eliminerar behovet av en separat `CodeText`‑tilldelning senare. + +## Ställ in streckkodsstorlek och kolumnantal + +PDF417‑symboler består av rader och kolumner av små rektangulära moduler. Genom att kontrollera modulbredden (X‑dimension) och antalet kolumner kan du finjustera de totala dimensionerna. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Förklaring*: +* **X‑dimension** (`Pixels`) bestämmer hur bred varje modul är. Mindre värden ger en tätare streckkod, medan större värden ökar läsbarheten på lågupplösta skannrar. +* **Columns** styr den horisontella layouten. Färre kolumner gör streckkoden högre; fler kolumner gör den bredare. Justera dessa två inställningar tillsammans för att uppnå exakt **set barcode size** som du behöver. + +## Aktivera kompakt läge för en mindre streckkod + +PDF417 innehåller ett “compact” (eller trunkerat) läge som tar bort onödig utfyllnad och minskar den totala fotavtrycket. Detta är särskilt användbart när du har begränsat skärmutrymme. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Varför aktivera trunkering?* +När `Truncate` är `true` utelämnar generatorn stoppmönstret och vissa felkorrigeringskodord som inte krävs för de flesta skanningsscenario. Den resulterande bilden blir ungefär 15‑20 % mindre utan att offra dataintegriteten för typiska användningsfall. + +## Spara streckkoden som en PNG‑bild + +Efter att ha konfigurerat storlek och läge, skriv streckkoden till disk. PNG är förlustfri, vilket säkerställer att modulernas kanter förblir skarpa. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Filen `CompactPdf417.png` kommer att innehålla en skarp PDF417‑symbol som matchar de dimensioner du angav i föregående steg. + +### Förväntat resultat + +När du öppnar den sparade PNG‑filen bör du se en vertikalt orienterad PDF417‑streckkod bestående av tre kolumner, varje modul 2 px bred, och en total storlek på ungefär **120 × 240 px** (bredd × höjd). Att skanna bilden med någon standard‑PDF417‑läsare returnerar den ursprungliga texten “Sample text for PDF417”. + +## Vanliga fallgropar och hur du undviker dem + +| Symptom | Trolig orsak | Åtgärd | +|---------|--------------|-------| +| Streckkoden är oläslig | X‑dimension för liten för skannern | Öka `XDimension.Pixels` till 3 eller 4 | +| Bilden är för bred för UI | För många kolumner angivna | Minska `Pdf417.Columns` eller aktivera `Truncate` | +| Undantag `ArgumentOutOfRangeException` | Negativt eller noll kolumnantal | Säkerställ att `Columns` är ett positivt heltal (minst 1) | +| PNG‑filen är tom | Utskriftsvägen finns inte eller saknar skrivbehörighet | Verifiera att katalogen finns och att appen har skrivrättigheter | + +> **Pro tip:** Använd `barcodeGenerator.ValidateParameters()` innan du anropar `Save()` för att fånga konfigurationsfel tidigt. + +## Fullt körbart exempel + +Nedan finns ett självständigt konsolprogram som innehåller alla stegen ovan. Kopiera det till ett nytt C#‑projekt, återställ Aspose.BarCode‑NuGet‑paketet, och kör det för att se resultatet. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**När programmet körs** skapas `CompactPdf417.png` i programmets arbetskatalog. Skanna bilden med en mobilapp (t.ex. “Barcode Scanner”) för att verifiera att den kodade texten matchar källsträngen. + +## Nästa steg och relaterade ämnen + +* **Öka felkorrigeringsnivån** – justera `Pdf417.ErrorLevel` för miljöer med brusiga skanningar. +* **Ändra orientering** – sätt `Pdf417.Rotate` till `RotationAngle.Rotate90` om du behöver en horisontell layout. +* **Bädda in streckkoden i en PDF** – kombinera Aspose.PDF med Aspose.BarCode för att placera bilden direkt i ett dokument. +* **Generera andra 2‑D‑streckkoder** – samma `BarcodeGenerator`‑klass stödjer DataMatrix, QR och Aztec; byt bara `EncodeTypes.Pdf417` mot önskad symbologi. + +Genom att behärska **generate PDF417 barcode**‑tekniker kan du automatisera biljetthantering, lageretikettering och säker datatransmission i ett brett spektrum av .NET‑applikationer. + +## Slutsats + +Du vet nu hur du **genererar PDF417‑streckkod** i C#, exakt **set barcode size**, konfigurerar kolumner, aktiverar kompakt läge och sparar resultatet som en PNG. Använd dessa inställningar för att passa alla UI‑begränsningar eller skanningskrav, och utvidga metoden till andra streckkodformat vid behov. Lycka till med kodningen! + +## Vad bör du lära dig härnäst? + +De följande tutorialerna behandlar närliggande ämnen som bygger på teknikerna som demonstrerats i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementeringsmetoder i dina egna projekt. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/swedish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..ec365162b --- /dev/null +++ b/barcode/swedish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: Hur man läser PDF417‑streckkoder i C# med en steg‑för‑steg‑guide, som + täcker hur man läser flera streckkoder från en bild och extraherar MacroPdf417‑detaljer. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: sv +lastmod: 2026-08-22 +og_description: Hur man läser PDF417‑streckkoder i C# snabbt. Denna handledning visar + hur du läser flera streckkoder från en bild och hämtar utökad information från MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Hur man läser PDF417‑streckkoder i C# – fullständig programmeringsgenomgång +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Hur man läser PDF417‑streckkoder i C# – komplett guide +url: /sv/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man läser PDF417‑streckkoder i C# – komplett guide + +Om du behöver **hur man läser PDF417** staplar i en .NET‑applikation, ger den här handledningen dig en färdig‑till‑körning‑lösning. Du kommer att lära dig hur du läser flera streckkoder från en enda bild, extraherar hela MacroPdf417‑datamängden och visar den i konsolen. Tillvägagångssättet fungerar med Aspose.BarCode för .NET‑biblioteket och kräver bara några få rader kod. + +Att läsa streckkoder från en bild är en vanlig uppgift i lagerhanteringssystem, biljettvalidering och dokumenthantering. I slutet av den här guiden kommer du att kunna avkoda vilken PDF417‑ eller MacroPdf417‑streckkod som helst, hantera flera koder i en bild och förstå de utökade fält som MacroPdf417 tillhandahåller. + +## Förutsättningar + +- .NET 6.0 SDK eller senare (koden kompileras också med .NET Framework 4.7+) +- Visual Studio 2022 eller någon C#‑redigerare du föredrar +- Aspose.BarCode for .NET NuGet‑paket (`Install-Package Aspose.BarCode`) +- En exempelbild som innehåller en MacroPdf417‑streckkod (t.ex. `MacroPdf417.png`) + +Ingen ytterligare konfiguration krävs; biblioteket hanterar bildladdning och avkodning internt. + +## Så läser du PDF417‑streckkoder från en bild i C# + +Kärnan i lösningen är klassen `BarCodeReader`. Den öppnar bilden, upptäcker alla streckkoder av den angivna typen och returnerar en samling av `BarCodeResult`‑objekt. Följande kod visar ett komplett konsolprogram. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Varför varje rad är viktig + +| Steg | Syfte | +|------|-------| +| **1️⃣ Initialize** | Skapar en `BarCodeReader` bunden till bildfilen och begränsar detektering till MacroPdf417‑symbologi, vilket snabbar upp bearbetningen. | +| **2️⃣ Iterate** | `ReadBarCodes()` returnerar **alla** streckkoder som matchar den begärda typen, vilket gör att du kan **läsa flera streckkoder** utan extra loopar. | +| **3️⃣ Basic output** | Visar det generiska `CodeTypeName` och den mänskligt läsbara `CodeText`. Detta är användbart för loggning eller snabb validering. | +| **4️⃣ Extended data** | MacroPdf417 bär med sig ytterligare metadata (fil‑ID, segmentantal, tidsstämplar osv.). `Extended.Pdf417`‑objektet exponerar varje fält direkt, så du kan lagra eller verifiera hela datapaketet. | + +Att köra programmet mot en giltig MacroPdf417‑bild ger konsolutdata som liknar följande: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Utdata bekräftar att biblioteket framgångsrikt läste streckkoden, extraherade texten och levererade varje MacroPdf417‑fält. + +## Läsa flera streckkoder från en enda bild + +Många verkliga scenarier placerar flera PDF417‑symboler på en etikett – tänk på ett fraktmanifest som innehåller en transportörskod, ett spårningsnummer och en tulldeklaration. Samma kodblock ovan **läser redan flera streckkoder** eftersom `ReadBarCodes()` returnerar en enumerabel av alla matchningar. Ingen extra konfiguration behövs; du behöver bara loopa igenom resultaten, som demonstrerat. + +Om du vill begränsa läsaren till standard‑PDF417 (icke‑macro) men ändå hantera flera koder, ersätt `DecodeType.MacroPdf417` med `DecodeType.Pdf417`. Resten av logiken förblir oförändrad. + +## Förstå MacroPdf417 utökade data + +MacroPdf417 är en utökning av den vanliga PDF417‑specifikationen. Den delar stora nyttolaster i flera segment och lägger till ett litet huvud som beskriver hela filen. De mest relevanta fälten är: + +- **MacroPdf417FileID** – ett unikt identifierare som delas av alla segment av samma fil. +- **MacroPdf417SegmentID** – sekvensnumret för det aktuella segmentet. +- **MacroPdf417SegmentsCount** – totalt förväntat antal segment. +- **MacroPdf417FileName** – valfritt filnamn som överförs med streckkoden. +- **MacroPdf417Checksum** – felkontrollvärde för hela filen. +- **MacroPdf417FileSize** – storlek på den ursprungliga binära nyttolasten. +- **MacroPdf417TimeStamp** – ISO‑8601‑tidsstämpel när streckkoden genererades. +- **MacroPdf417Addressee / Sender** – valfria textfält för routing. +- **MacroPdf417Terminator** – indikerar om detta segment är det sista. + +När du har mottagit alla segment kan du rekonstruera den ursprungliga filen genom att sortera dem efter `MacroPdf417SegmentID` och concatenera `CodeText`‑värdena. Denna logik är enkel att implementera när du har fälten tillgängliga. + +## Vanliga fallgropar och pro‑tips + +- **Image quality matters** – lågupplösta eller kraftigt komprimerade PNG/JPEG‑filer kan leda till missade detekteringar. Använd minst 300 dpi för tryckta streckkoder. +- **Mixed symbologies** – om bilden innehåller både MacroPdf417 och vanlig PDF417, skapa två läsare (en för varje `DecodeType`) eller använd `DecodeType.AllSupported` och filtrera resultat efter `result.CodeTypeName`. +- **Memory usage** – `using`‑satsen disponerar `BarCodeReader` omedelbart, vilket förhindrar att stora bildbuffertar ligger kvar i minnet. +- **Thread safety** – `BarCodeReader` är inte trådsäker. Skapa en separat instans per tråd om du avkodar bilder parallellt. +- **Error handling** – omslut anropet till `ReadBarCodes()` med ett try/catch‑block för att fånga `BarCodeException` vid korrupta bilder. + +## Fullständig fungerande exempel‑sammanfattning + +Nedan är det kompletta programmet som du kan kopiera in i ett nytt konsolprojekt. Det inkluderar alla `using`‑direktiv, en konstant för bildsökvägen och disposeringsmönstret. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Kompilera med `dotnet build` och kör med `dotnet run`. Konsolen skriver ut varje streckkods grunddata samt hela MacroPdf417‑payloaden. + +## Nästa steg + +- **Reconstruct multipart files** – collect all segments, sort by `MacroPdf417SegmentID`, and concatenate `CodeText` to + +## Vad bör du lära dig härnäst? + +Följande handledningar täcker närbesläktade ämnen som bygger vidare på teknikerna som demonstrerats i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [Hur man genererar PDF417‑streckkod – kompakt PDF417‑kodning](/barcode/english/net/compact-pdf417-encoding/) +- [Hur man läser PDF417‑streckkoder med turkiska tecken i Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Hur man använder Aspose för PDF417‑streckkod (kinesiska) i Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/swedish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..f93dc3f7e --- /dev/null +++ b/barcode/swedish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-08-22 +description: barcode generator C#‑handledning visar hur man skapar en Macro PDF417‑streckkod + med metadata och sparar den som PNG med Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: sv +lastmod: 2026-08-22 +og_description: barcode generator C# låter dig skapa en Macro PDF417‑streckkod med + fullständig filnivåmetadata och exportera den som PNG. Följ den här guiden för att + implementera lösningen. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: streckkodsgenerator C# – skapa Macro PDF417‑streckkoder steg för steg +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Hur man använder en streckkodsgenerator i C# för Macro PDF417 +url: /sv/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Så använder du en barcode‑generator C# för Macro PDF417 + +Om du behöver en **barcode generator C#** som kan skapa en Macro PDF417‑symbol med metadata på filnivå, ger den här guiden en komplett, färdig‑att‑köra‑lösning. Du får se hur du konfigurerar streckkodens utseende, bäddar in makroinformation såsom fil‑ID och segmentantal, och slutligen sparar resultatet som en PNG‑bild. + +Exemplet använder Aspose.BarCode‑biblioteket, ett allmänt använt **C# barcode library** som stödjer hela PDF417‑funktionsuppsättningen. Inga externa tjänster krävs, och koden fungerar med .NET 6 eller senare. + +## Förutsättningar + +Innan du börjar, se till att du har: + +* .NET 6 SDK (eller någon senare version) installerad. +* Visual Studio 2022, VS Code eller någon annan C#‑IDE. +* En NuGet‑referens till **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Att förstå grundläggande C#‑syntax och konceptet med PDF417‑streckkoder hjälper dig att följa stegen, men tutorialen förklarar varje konfigurationsalternativ i detalj. + +## Vad tutorialen täcker + +* Initiering av en **barcode generator C#**‑instans för Macro PDF417‑formatet. +* Justering av visuella parametrar såsom X‑dimension och kolumnantal. +* Tillhandahållande av Macro PDF417‑fält på filnivå: fil‑ID, segment‑ID, segmentantal, filnamn, kontrollsumma, filstorlek, tidsstämpel, mottagare, avsändare och terminator. +* Sparande av den genererade symbolen som en PNG‑fil. +* Tips för att hantera kantfall som stora filstorlekar eller anpassade tidsstämplar. + +När du har läst hela artikeln har du ett självständigt program som producerar en fullt kompatibel Macro PDF417‑streckkod. + +## Steg 1: Skapa barcode‑generator C#‑instansen + +Den första operationen är att instansiera `BarcodeGenerator` med enum‑värdet `EncodeTypes.MacroPdf417` och den text du vill koda. Konstruktorn accepterar också payload‑strängen, som blir datadelen av makrostreckkoden. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Varför detta är viktigt** – Flaggan `EncodeTypes.MacroPdf417` talar om för Aspose.BarCode att behandla symbolen som en makrostreckkod, vilket aktiverar de extra fält som följer. Utan denna flagga skulle biblioteket generera en vanlig PDF417‑streckkod utan metadata på filnivå. + +## Steg 2: Justera grundläggande streckkodens utseende (PDF417‑visuella inställningar) + +Visuell klarhet är avgörande för pålitlig avläsning. Två vanliga parametrar är modulbredd (`XDimension`) och antalet kolumner. Att sätta dessa värden balanserar storlek och läsbarhet. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` styr bredden på varje svart/vit stapel. Ett värde på **2** fungerar bra för de flesta etikett‑skrivare. +* `Pdf417.Columns` definierar hur många kolumner streckkoden ska använda. Fem kolumner ger en kompakt symbol utan att offra datakapacitet. + +## Steg 3: Definiera Macro PDF417‑information på filnivå + +Macro PDF417 utökar standard‑PDF417‑formatet med fält som beskriver hur en stor fil delas upp i flera streckkodsegment. Att ange dessa fält säkerställer att mottagande skannrar kan återkonstruera den ursprungliga filen. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` måste vara samma för varje segment som tillhör samma logiska fil. +* `MacroPdf417SegmentID` ökas från **0** till `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` talar om för avkodaren hur många delar som förväntas. +* `MacroPdf417FileName` är valfritt men hjälpsamt för mänsklig identifiering. + +## Steg 4: Ange ytterligare makro‑metadata + +Utöver den grundläggande filinformationen tillåter specifikationen extra fält såsom kontrollsumma, filstorlek, tidsstämpel, mottagare, avsändare och en terminator‑flagga. Att fylla i dessa fält förbättrar dataintegritet och spårbarhet. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` ger en 16‑bit CCITT‑kontrollsumma för hela filen; avkodaren kan verifiera integriteten efter återuppbyggnad. +* `MacroPdf417FileSize` bör motsvara exakt byte‑antal i den ursprungliga filen; värden större än `2^31‑1` kräver ett 64‑bit‑fält, vilket Aspose hanterar automatiskt. +* `MacroPdf417TimeStamp` registrerar när streckkoden genererades. Använd UTC för att undvika tidszons‑ambiguitet. +* `MacroPdf417Addressee` och `MacroPdf417Sender` är fria textsträngar som kan lagra routningsinformation. +* `MacroPdf417Terminator` signalerar att detta är det sista segmentet; sätt den till `Set` för den sista delen, annars lämna standard (`NotSet`). + +**Tips för kantfall** – Om din filstorlek överstiger 4 GB, dela innehållet i flera makrosegment och justera `SegmentsCount` därefter. Biblioteket hanterar det stora fältet utan overflow. + +## Steg 5: Spara streckkoden som en PNG‑bild + +Det sista steget skriver den genererade symbolen till disk. PNG bevarar de exakta pixel‑dimensionerna och stöds brett av skannings‑hardware. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Byt ut `YOUR_DIRECTORY` mot en absolut eller relativ sökväg som den körande processen kan skriva till. Enum‑värdet `BarCodeImageFormat.Png` säkerställer förlustfri output. + +**Varför PNG?** – Rasterformat som PNG håller modul‑kanterna skarpa, vilket är viktigt för skannrar som förlitar sig på högkontrast‑kanter. Om du behöver ett vektorformat stödjer Aspose även `Pdf` och `Svg`. + +## Fullt körbart exempel + +Nedan är hela programmet som du kan kopiera in i en konsolapplikation. Det innehåller nödvändiga `using`‑direktiv och en `Main`‑metod. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Förväntad output + +När programmet körs skapas en fil med namnet **MacroPdf417.png** i projektets arbetskatalog. Att öppna bilden visar en kompakt PDF417‑streckkod med de inbäddade makrofälten. Skannar du bilden med en PDF417‑kompatibel läsare (t.ex. ZXing, Aspose.BarCode‑decoder) får du tillbaka den ursprungliga `"Sample text"`‑payloaden samt makro‑metadata. + +## Vanliga frågor och felsökning + +| Fråga | Svar | +|----------|--------| +| *Vad gör jag om streckkoden blir för stor för den avsedda etiketten?* | Minska `XDimension.Pixels` eller öka `Pdf417.Columns`. Båda parametrarna påverkar den totala storleken. | +| *Kan jag generera en vektorbild istället för PNG?* | Ja. Anropa `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` för skalbar output. | +| *Hur verifierar jag kontrollsumman efter skanning?* | Aspose.BarCode‑decodern validerar automatiskt `MacroPdf417Checksum` och rapporterar avvikelser i `MacroPdf417Result`‑objektet. | +| *Är biblioteket kompatibelt med .NET Core?* | NuGet‑paketet stödjer .NET Standard 2.0+, vilket täcker .NET Core, .NET 5, .NET 6 och senare. | +| *Vad gör jag om jag måste bädda in binär data istället för text?* | Konvertera den binära payloaden till Base64 eller använd `EncodeTypes.MacroPdf417`‑överladdningen som accepterar en byte‑array. | + +## Pro‑tips för produktionsanvändning + +* **Cachea generatorn** – + + +## Vad bör du lära dig härnäst? + + +Följande tutorials behandlar närliggande ämnen som bygger vidare på teknikerna i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [Hur man skapar streckkod – Compact PDF417 med Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Hur man läser streckkod från PDF i Java med Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Skapa Codabar‑streckkod med Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/net/compact-pdf417-encoding/_index.md b/barcode/thai/net/compact-pdf417-encoding/_index.md index a27522cbe..c9a60aee8 100644 --- a/barcode/thai/net/compact-pdf417-encoding/_index.md +++ b/barcode/thai/net/compact-pdf417-encoding/_index.md @@ -141,9 +141,23 @@ Compact PDF417’s high data density and robust error correction make it suitabl ## บทแนะนำการเข้ารหัส Compact PDF417 +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + +### [วิธีสร้างบาร์โค้ด PDF417 ด้วย C# และบันทึกเป็น PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +เรียนรู้วิธีสร้างบาร์โค้ด PDF417 ด้วย C# และบันทึกเป็นไฟล์ PNG + ### [สร้างบาร์โค้ด Compact PDF417](./compact-pdf417-basic-configuration/) Learn how to generate Compact PDF417 barcodes using Aspose.BarCode for .NET. Comprehensive guide with step‑by‑step instructions and code examples. +### [วิธีสร้างบาร์โค้ด micro PDF417 ด้วย C# – คู่มือขั้นตอนโดยละเอียด](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +เรียนรู้วิธีสร้างบาร์โค้ด micro PDF417 ด้วย C# อย่างละเอียด + +### [วิธีใช้ตัวสร้างบาร์โค้ด C# สำหรับ Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [วิธีอ่านบาร์โค้ด PDF417 ด้วย C# – คู่มือฉบับสมบูรณ์](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +เรียนรู้วิธีอ่านบาร์โค้ด PDF417 ใน C# อย่างละเอียดด้วย Aspose.BarCode + ## คำถามที่พบบ่อย **Q: What is the maximum amount of data I can store in a Compact PDF417 barcode?** diff --git a/barcode/thai/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/thai/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..9c35c63d8 --- /dev/null +++ b/barcode/thai/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,212 @@ +--- +category: general +date: 2026-08-22 +description: เรียนรู้วิธีสร้างบาร์โค้ด micro PDF417 ด้วย C# และสร้างภาพบาร์โค้ด PNG + รวมถึงการตั้งค่าขนาดบาร์โค้ดและการบันทึกไฟล์ +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: th +lastmod: 2026-08-22 +og_description: สร้างบาร์โค้ด micro PDF417 ด้วย C# และส่งออกเป็นไฟล์ PNG ทำตามคู่มือนี้เพื่อกำหนดขนาดบาร์โค้ดและสร้างภาพบาร์โค้ดอย่างรวดเร็ว +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: สร้างบาร์โค้ด micro PDF417 ด้วย C# – บทเรียนการเขียนโค้ดเต็มรูปแบบ +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: วิธีสร้างบาร์โค้ด micro PDF417 ใน C# – คู่มือแบบขั้นตอนต่อขั้นตอน +url: /th/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีสร้างบาร์โค้ด micro PDF417 ด้วย C# – คู่มือขั้นตอนโดยละเอียด + +หากคุณต้องการ **สร้างบาร์โค้ด micro PDF417** สำหรับระบบตั๋ว, ป้ายสินค้าคงคลัง, หรือการสแกนบนมือถือ, บทแนะนำนี้จะแสดงวิธีทำอย่างละเอียด คุณจะได้เห็นโปรแกรม C# ฉบับเต็มที่สร้างไฟล์ PNG ของบาร์โค้ด, เรียนรู้วิธีตั้งค่าขนาดบาร์โค้ด, และทำความเข้าใจแต่ละตัวเลือกการกำหนดค่า + +เมื่ออ่านจบบทแนะนำนี้คุณจะสามารถสร้างภาพบาร์โค้ดความละเอียดสูง, ปรับค่า X‑dimension, เลือกจำนวนคอลัมน์, และบันทึกผลลัพธ์เป็นไฟล์ PNG – ทั้งหมดด้วยไม่กี่บรรทัดของโค้ด + +## สิ่งที่คุณต้องมี + +- .NET 6.0 SDK หรือใหม่กว่า (โค้ดทำงานได้กับ .NET Core และ .NET Framework) +- Visual Studio 2022 หรือ IDE ที่รองรับ C# +- แพคเกจ NuGet **Aspose.BarCode for .NET** (หรือไลบรารีใด ๆ ที่สนับสนุน `EncodeTypes.MicroPdf417`) +- ความคุ้นเคยพื้นฐานกับไวยากรณ์ C# + +> **เคล็ดลับ:** รุ่น community edition ฟรีของ Aspose.BarCode เพียงพอสำหรับการพัฒนาและทดสอบ หากนำไปใช้ในผลิตภัณฑ์จริงควรซื้อไลเซนส์เพื่อเอา watermark การประเมินผลออก + +## ขั้นตอนที่ 1: ติดตั้งไลบรารีบาร์โค้ด + +เปิดเทอร์มินัลในโฟลเดอร์โปรเจกต์ของคุณและรัน: + +```bash +dotnet add package Aspose.BarCode +``` + +คำสั่งนี้จะเพิ่ม assembly `Aspose.BarCode` ซึ่งให้คลาส `BarcodeGenerator` ที่ใช้ **สร้างภาพบาร์โค้ด C#** ในแอปพลิเคชันของคุณ + +## ขั้นตอนที่ 2: เริ่มต้นตัวสร้าง – สร้างบาร์โค้ด micro PDF417 + +บรรทัดแรกที่ทำงานได้สร้างอินสแตนซ์ `BarcodeGenerator` ที่กำหนดให้ใช้สัญลักษณ์ Micro PDF417 และใส่ข้อมูลที่คุณต้องการเข้ารหัส + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*ทำไมจึงสำคัญ*: enum `EncodeTypes.MicroPdf417` บอกไลบรารีให้ใช้เวอร์ชันกะทัดรัดของ PDF417 ซึ่งเหมาะกับป้ายขนาดเล็กและหน้าจอมือถือ + +## ขั้นตอนที่ 3: วิธีตั้งค่าขนาดบาร์โค้ดใน C# + +การปรับความกว้างของโมดูล (X‑dimension) จะควบคุมความหนาแน่นของบาร์โค้ด ค่าที่เล็กลงให้ภาพคมชัดมากขึ้น, ค่าที่ใหญ่ขึ้นทำให้บาร์โค้ดอ่านได้ง่ายจากระยะไกล + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **ทำไมต้องตั้งค่าขนาด**: หากไม่ปรับ X‑dimension ค่าเริ่มต้นอาจทำให้บาร์โค้ดดูเบลอเมื่อเรนเดอร์ที่ DPI สูง การตั้งค่าเป็น 2 พิกเซลเป็นสมดุลที่ดีสำหรับการสแกนบนหน้าจอส่วนใหญ่ + +## ขั้นตอนที่ 4: เลือกจำนวนคอลัมน์ – ควบคุมความกว้างของบาร์โค้ด + +Micro PDF417 รองรับตั้งแต่ 1 ถึง 4 คอลัมน์ คอลัมน์มากขึ้นจะบีบข้อมูลในแนวนอน, ลดความกว้างของภาพโดยรวม + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*กรณีขอบ*: หากคุณระบุ 5 คอลัมน์ ไลบรารีจะโยน `ArgumentOutOfRangeException` ควรอยู่ในช่วงที่ระบุในเอกสารเท่านั้น + +## ขั้นตอนที่ 5: วิธีสร้าง PNG ของบาร์โค้ด – บันทึกภาพ + +ตอนนี้คุณสามารถส่งออกบาร์โค้ดที่สร้างเป็นไฟล์ PNG ได้แล้ว PNG จะรักษาคุณภาพแบบ lossless ซึ่งจำเป็นต่อการสแกนที่เชื่อถือได้ + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +เมื่อรันโปรแกรม คุณจะเห็นข้อความในคอนโซลยืนยันตำแหน่งไฟล์ `MicroPdf417.png` ที่สร้างขึ้น จะมีลักษณะดังนี้: + +![ภาพหน้าจอแสดงบาร์โค้ด micro PDF417 ที่สร้างด้วย C#](micro-pdf417-example.png "บาร์โค้ด micro PDF417 ที่สร้างแล้ว") + +*ข้อความแทนภาพ*: **บาร์โค้ด micro PDF417 ที่สร้างด้วย C#** – แสดงผลลัพธ์สุดท้ายหลังจากปรับค่า X‑dimension และจำนวนคอลัมน์ + +## ขั้นตอนที่ 6: รันและตรวจสอบผลลัพธ์ + +1. สร้างโปรเจกต์: `dotnet build` +2. เรียกใช้: `dotnet run` +3. เปิดไฟล์ `MicroPdf417.png` บนเดสก์ท็อปและสแกนด้วยแอปสแกนบาร์โค้ดบนมือถือ + +คุณควรเห็นข้อความ **“Sample text”** ถูกถอดรหัส หากสแกนเจอข้อผิดพลาด ให้ตรวจสอบ X‑dimension และจำนวนคอลัมน์อีกครั้ง – ค่าที่สุดขีดอาจทำให้บาร์โค้ดหนาเกินไปสำหรับอุปกรณ์บางรุ่น + +## ความแปรผันทั่วไปและการแก้ไขปัญหา + +| สถานการณ์ | การปรับแต่ง | +|-----------|------------| +| **ต้องการบาร์โค้ดขนาดใหญ่สำหรับเครื่องพิมพ์ความละเอียดต่ำ** | เพิ่มค่า `XDimension.Pixels` เป็น 3 หรือ 4 | +| **ต้องการบาร์โค้ดสูงขึ้นโดยไม่เปลี่ยนความกว้าง** | ตั้งค่า `generator.Parameters.Barcode.Pdf417.Rows` (ช่วงแถว 3‑90) | +| **สร้างบาร์โค้ดหลายรายการในลูป** | ใช้อินสแตนซ์ `BarcodeGenerator` เดียวกันและเปลี่ยน `CodeText` ก่อนแต่ละ `Save` | +| **บันทึกเป็น JPEG แทน PNG** | แทนที่ `BarCodeImageFormat.Png` ด้วย `BarCodeImageFormat.Jpeg` | +| **รันบน .NET Framework 4.7** | โค้ดเดียวกันทำงานได้; เพียงแค่อ้างอิง `Aspose.BarCode.dll` ที่เหมาะกับเวอร์ชันนั้น | + +## รายการโค้ดเต็ม (พร้อมรัน) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**ผลลัพธ์ที่คาดหวัง** – ไฟล์ PNG ขนาด 200 × 100 พิกเซล ที่มีบาร์โค้ด Micro PDF417 คมชัดและถอดรหัสได้เป็น “Sample text” + +## สรุป + +ตอนนี้คุณรู้วิธี **สร้างบาร์โค้ด micro PDF417 ด้วย C#**, **ตั้งค่าขนาดบาร์โค้ด**, และ **สร้างภาพ PNG ของบาร์โค้ด** ตัวอย่างเต็มแสดงขั้นตอนทั้งหมด – ตั้งแต่การติดตั้งไลบรารีจนถึงการบันทึกไฟล์สุดท้าย – เพื่อให้คุณสามารถฝังการสร้างบาร์โค้ดลงในแอปพลิเคชันของคุณได้โดยตรง + +ต่อไปลองสำรวจหัวข้อที่เกี่ยวข้องเช่น **การสร้าง QR code ด้วย Aspose.BarCode**, **การปรับสี**, หรือ **การฝังบาร์โค้ดในเอกสาร PDF** ทั้งหมดอิงจากพื้นฐาน `BarcodeGenerator` ที่อธิบายไว้ในที่นี้ + +อย่ากลัวที่จะทดลองเปลี่ยนสตริงข้อมูล, จำนวนคอลัมน์, และค่า X‑dimension เพื่อให้เหมาะกับสภาพแวดล้อมการสแกนของคุณเอง ขอให้สนุกกับการเขียนโค้ด! + +## สิ่งที่คุณควรเรียนต่อไป + +บทแนะนำต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคที่แสดงในคู่มือนี้ แต่ละแหล่งข้อมูลมีโค้ดทำงานเต็มรูปแบบพร้อมคำอธิบายขั้นตอนเพื่อช่วยให้คุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจแนวทางการทำงานอื่น ๆ ในโปรเจกต์ของคุณ + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to create Aztec barcode with Aspose.BarCode for .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/thai/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..1e9707b6e --- /dev/null +++ b/barcode/thai/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,198 @@ +--- +category: general +date: 2026-08-22 +description: เรียนรู้วิธีสร้างบาร์โค้ด PDF417 ด้วย C# โดยใช้ตัวสร้างบาร์โค้ด ตั้งค่าเลย์เอาต์ + และบันทึกเป็น PNG รวมโค้ดเต็มและเคล็ดลับสำหรับโครงการตัวสร้างบาร์โค้ด C# +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: th +lastmod: 2026-08-22 +og_description: สร้างบาร์โค้ด PDF417 ด้วย C# โดยใช้ตัวสร้างบาร์โค้ด ปรับแต่งเลย์เอาต์ + และเรียนรู้วิธีบันทึกเป็น PNG ทำตามบทเรียนขั้นตอนต่อขั้นตอนนี้ +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: สร้างบาร์โค้ด PDF417 ด้วย C# – คู่มือเต็มสำหรับการสร้างและบันทึก PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: วิธีสร้างบาร์โค้ด PDF417 ด้วย C# และบันทึกเป็น PNG +url: /th/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีสร้างบาร์โค้ด PDF417 ด้วย C# และบันทึกเป็น PNG + +หากคุณต้องการ **สร้างบาร์โค้ด PDF417** ในแอปพลิเคชัน C# นี้ การสอนนี้จะแสดงขั้นตอนที่แน่นอน คุณจะได้เห็นว่าไลบรารีสร้างบาร์โค้ด C# สามารถแปลงสตริงใด ๆ ให้เป็นภาพ PDF417 ที่สแกนได้อย่างไรและวิธีบันทึกไฟล์ PNG โดยไม่ต้องใช้เครื่องมือเพิ่มเติม + +การสร้างบาร์โค้ดเป็นเรื่องปกติในโลจิสติกส์ การจำหน่ายบัตร และการจัดการเอกสาร เมื่อจบคู่มือนี้คุณจะมีโปรแกรมคอนโซลที่สามารถรันได้ซึ่งสร้างไฟล์ PNG ชื่อ `Pdf417Layout.png` ในโฟลเดอร์ที่คุณเลือก + +## สิ่งที่ต้องเตรียมก่อน + +- .NET 6.0 SDK หรือรุ่นที่ใหม่กว่า (โค้ดนี้ยังทำงานกับ .NET Framework 4.7+ ด้วย) +- Visual Studio 2022 หรือเครื่องมือแก้ไขใด ๆ ที่สามารถสร้างโปรเจกต์ C# ได้ +- แพคเกจ NuGet **Aspose.BarCode for .NET** (หรือไลบรารีสร้างบาร์โค้ด C# ที่เข้ากันได้) + ติดตั้งด้วย: + +```bash +dotnet add package Aspose.BarCode +``` + +ไม่จำเป็นต้องใช้ไลบรารีประมวลผลภาพเพิ่มเติม เนื่องจากตัวสร้างสามารถเขียน PNG ได้โดยตรง + +## ขั้นตอนที่ 1: ตั้งค่าโปรเจกต์คอนโซลใหม่ + +สร้างโปรเจกต์คอนโซลใหม่เพื่อให้ตัวอย่างเป็นอิสระและไม่พึ่งพาอื่น + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +โฟลเดอร์ `Pdf417Demo` ตอนนี้มีไฟล์ `Program.cs` ที่เราจะเขียนโค้ดบาร์โค้ด + +## ขั้นตอนที่ 2: นำเข้าเนมสเปซของบาร์โค้ด + +เปิดไฟล์ `Program.cs` แล้วเพิ่มคำสั่ง `using` ที่จำเป็นที่ส่วนบนของไฟล์ + +```csharp +using Aspose.BarCode.Generation; +``` + +เนมสเปซนี้ให้คุณเข้าถึง `BarcodeGenerator`, `EncodeTypes` และ enum ของรูปแบบภาพที่จำเป็นสำหรับ **วิธีบันทึก PNG** + +## ขั้นตอนที่ 3: สร้างตัวสร้างบาร์โค้ด PDF417 + +หัวใจของ **วิธีสร้าง PDF417** คือคลาส `BarcodeGenerator` ให้ส่งประเภทการเข้ารหัส `EncodeTypes.Pdf417` และข้อความที่ต้องการเข้ารหัส + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` ตอนนี้เก็บการตั้งค่าทั้งหมดของบาร์โค้ด การจัดวางค่าเริ่มต้นทำงานได้ แต่เราจะปรับแต่งในขั้นตอนต่อไป + +## ขั้นตอนที่ 4: กำหนดการจัดวางบาร์โค้ด (คอลัมน์และแถว) + +PDF417 อนุญาตให้คุณควบคุมจำนวนคอลัมน์ (2‑30) และแถว (1‑90) การปรับค่าต่าง ๆ นี้สามารถเพิ่มความอ่านง่ายสำหรับสแกนเนอร์บางรุ่น + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **เคล็ดลับ:** หากคุณละเว้นการตั้งค่าเหล่านี้ ไลบรารีจะเลือกค่าที่เหมาะสมโดยอัตโนมัติ อย่างไรก็ตาม การกำหนดคอลัมน์และแถวอย่างตายตัวจะทำให้คุณได้ขนาดภาพที่คาดเดาได้ ซึ่งมีประโยชน์เมื่อคุณฝัง PNG ลงใน PDF หรือเลย์เอาต์ UI + +## ขั้นตอนที่ 5: บันทึกบาร์โค้ดที่สร้างเป็นภาพ PNG + +ตอนนี้ตอบ **วิธีบันทึก PNG** โดยเรียก `Save` เมธอดนี้รับพาธเป้าหมายและ enum ของรูปแบบภาพ + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +ไฟล์ `Pdf417Layout.png` จะปรากฏในโฟลเดอร์ `bin/Debug/net6.0` ของโปรเจกต์หลังจากคุณรันโปรแกรม + +## ตัวอย่างที่สามารถรันได้เต็มรูปแบบ + +ด้านล่างเป็นไฟล์ `Program.cs` ฉบับเต็ม คัดลอกไปยังโปรเจกต์ที่สร้างใน **ขั้นตอน 1** แล้วรัน `dotnet run` + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### ผลลัพธ์ที่คาดหวัง + +เมื่อคุณรันโปรแกรม คอนโซลจะแสดงพาธเต็มของไฟล์ PNG และไฟล์นั้นจะมีบาร์โค้ด PDF417 ที่ชัดเจนซึ่งคล้ายกับภาพด้านล่าง + +![ตัวอย่างการสร้างบาร์โค้ด PDF417](image-placeholder.png "บาร์โค้ด PDF417 ที่บันทึกเป็น PNG") + +คุณสามารถสแกนไฟล์ PNG ด้วยสแกนเนอร์ที่รองรับ PDF417 ใด ๆ (แอปมือถือ, เครื่องอ่านฮาร์ดแวร์) เพื่อยืนยันว่าข้อความที่เข้ารหัสคือ `"Sample"`. + +## การจัดการกรณีขอบและข้อผิดพลาดทั่วไป + +| สถานการณ์ | สิ่งที่ควรระวัง | วิธีแก้แนะนำ | +|-----------|-------------------|-----------------| +| **ค่าคอลัมน์/แถวไม่ถูกต้อง** | ค่าที่อยู่นอกช่วง 2‑30 (คอลัมน์) หรือ 1‑90 (แถว) จะทำให้เกิด `ArgumentException`. | ตรวจสอบอินพุตของผู้ใช้ก่อนกำหนดค่า หรือให้ไลบรารีเลือกค่าเริ่มต้น. | +| **สตริงอินพุตยาว** | PDF417 สามารถเข้ารหัสได้สูงสุด 1,850 ตัวอักษร แต่สตริงที่ยาวมากจะทำให้จำนวนแถวที่ต้องการเพิ่มขึ้นอย่างมาก. | แบ่งข้อมูลเป็นหลายบาร์โค้ดหรือใช้ระดับการแก้ไขข้อผิดพลาดที่สูงขึ้นหากจำเป็น. | +| **สิทธิ์ระบบไฟล์** | การบันทึกลงโฟลเดอร์ที่อ่าน‑อย่างเท่านั้นจะทำให้เกิด `UnauthorizedAccessException`. | บันทึกไปยัง `Environment.CurrentDirectory` หรือพาธที่ผู้ใช้สามารถเขียนได้ และจัดการข้อยกเว้นด้วย try/catch. | +| **ไม่มีแพคเกจ NuGet** | การคอมไพล์ล้มเหลวด้วยข้อความ “type or namespace name could not be found”. | ตรวจสอบว่าได้ติดตั้ง `Aspose.BarCode` (`dotnet add package Aspose.BarCode`). | + +## การขยายตัวอย่าง + +เมื่อคุณรู้แล้วว่า **วิธีสร้างบาร์โค้ด PDF417** และ **วิธีบันทึก PNG** คุณสามารถสำรวจหัวข้อที่เกี่ยวข้องต่อไปนี้ + +- **Barcode generator C#**: เปลี่ยน `EncodeTypes` เป็น `Code128`, `QR` หรือสัญลักษณ์อื่น ๆ +- **Custom colors**: ใช้ `generator.Parameters.Barcode.ForegroundColor` และ `BackgroundColor` เพื่อให้ตรงกับแบรนด์ +- **Embedding in PDFs**: ผสาน PNG กับไลบรารี PDF (เช่น iText7) เพื่อสร้างเอกสารที่พิมพ์ได้ +- **Dynamic data**: ดึงข้อความจากฐานข้อมูลหรืออินพุตของผู้ใช้เพื่อสร้างบาร์โค้ดแบบเรียลไทม์ + +## สรุป + +ตอนนี้คุณมีโซลูชันที่ครบถ้วนและพร้อมใช้งานในระดับผลิตสำหรับ **การสร้างบาร์โค้ด PDF417** ด้วย C# และบันทึกผลลัพธ์เป็นไฟล์ PNG คู่มือนี้ครอบคลุมทุกขั้นตอนตั้งแต่การตั้งค่าโปรเจกต์จนถึงการปรับแต่งการจัดวาง และเน้นวิธีหลีกเลี่ยงข้อผิดพลาดทั่วไปเมื่อใช้ไลบรารีสร้างบาร์โค้ด C# + +อย่าลังเลที่จะทดลองตั้งค่าคอลัมน์/แถว สี หรือแม้กระทั่งรูปแบบบาร์โค้ดอื่น ๆ หากพบปัญหาใด ๆ ให้กลับไปดูส่วน **วิธีสร้าง PDF417** อีกครั้งหรือสำรวจเอกสารของไลบรารีเพื่อเรียนรู้ฟีเจอร์ขั้นสูง ขอให้สนุกกับการเขียนโค้ด! + +## สิ่งที่คุณควรเรียนต่อไป + +บทแนะนำต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคที่แสดงในคู่มือนี้ แต่ละแหล่งข้อมูลมีตัวอย่างโค้ดที่ทำงานได้เต็มรูปแบบพร้อมคำอธิบายทีละขั้นตอนเพื่อช่วยให้คุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจวิธีการนำไปใช้แบบอื่นในโปรเจกต์ของคุณ + +- [วิธีสร้างบาร์โค้ด – Compact PDF417 ด้วย Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [วิธีสร้างบาร์โค้ด PDF417 – การเข้ารหัส Compact PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [วิธีสร้าง Quiet Zone ของบาร์โค้ด ITF-14 ด้วย Aspose.BarCode for .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/thai/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..859152a6e --- /dev/null +++ b/barcode/thai/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,199 @@ +--- +category: general +date: 2026-08-22 +description: เรียนรู้วิธีสร้างบาร์โค้ด PDF417 ด้วย C# และ Aspose.BarCode ตั้งขนาดบาร์โค้ด + ปรับคอลัมน์ และเปิดใช้งานโหมดคอมแพคท์. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: th +lastmod: 2026-08-22 +og_description: สร้างบาร์โค้ด PDF417 ด้วย C# และ Aspose.BarCode คู่มือนี้แสดงวิธีตั้งขนาดบาร์โค้ด + ควบคุมคอลัมน์ และเปิดใช้งานโหมดบีบอัดเพื่อให้ได้ภาพที่เล็กลง +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: สร้างบาร์โค้ด PDF417 ด้วย C# – ตั้งขนาด, คอลัมน์, และโหมดคอมแพคท์ +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: วิธีสร้างบาร์โค้ด PDF417 ใน C# และตั้งขนาดบาร์โค้ด +url: /th/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีสร้างบาร์โค้ด PDF417 ใน C# และตั้งขนาดบาร์โค้ด + +หากคุณต้องการ **generate PDF417 barcode** ในแอปพลิเคชัน .NET คู่มือนี้จะพาคุณผ่านกระบวนการทั้งหมด คุณจะได้เห็นอย่างชัดเจน **how to generate PDF417** ด้วย Aspose.BarCode, ปรับ **set barcode size**, และสร้างไฟล์ PNG แบบกะทัดรัดที่สามารถฝังในรายงานหรือแอปมือถือได้ + +การสร้างบาร์โค้ดไม่จำเป็นต้องใช้โปรแกรมแก้ไขกราฟิกแยกต่างหาก เมื่อจบบทเรียนนี้คุณจะมีเมธอด C# ที่ทำงานเต็มรูปแบบซึ่งสร้างภาพ PDF417 ด้วยขนาดที่คุณต้องการ พร้อมสำหรับการประมวลผลต่อไป + +## สิ่งที่คุณจะได้เรียนรู้ + +* ติดตั้งและอ้างอิงไลบรารี Aspose.BarCode +* สร้าง PDF417 barcode generator และระบุข้อความที่ต้องเข้ารหัส +* **Set barcode size** โดยกำหนด X‑dimension และจำนวนคอลัมน์ +* เปิดใช้งานโหมดคอมแพคท์ (truncated) เพื่อลดขนาดสัญลักษณ์ +* บันทึกผลลัพธ์เป็นไฟล์ PNG +* แก้ไขปัญหาทั่วไป เช่น บาร์โค้ดอ่านไม่ออกหรือภาพขนาดใหญ่เกินไป + +### ข้อกำหนดเบื้องต้น + +* .NET 6.0 หรือใหม่กว่า (API ยังทำงานกับ .NET Framework 4.6+ ด้วย) +* ความคุ้นเคยพื้นฐานกับ C# และ Visual Studio (หรือ IDE C# ใดก็ได้) +* ไลเซนส์ Aspose.BarCode ที่ถูกต้อง (รุ่นทดลองฟรีใช้สำหรับทดสอบได้) + +> **Pro tip:** หากคุณวางแผนจะสร้างบาร์โค้ดหลาย ๆ ตัวในลูป ให้ใช้ `BarcodeGenerator` ตัวเดียวและเปลี่ยนเฉพาะคุณสมบัติ `CodeText` เท่านั้น วิธีนี้จะลดการจัดสรรหน่วยความจำ + +## สร้างบาร์โค้ด PDF417 ด้วย Aspose.BarCode + +ขั้นตอนแรกคือการสร้างอินสแตนซ์ของ `BarcodeGenerator` สำหรับสัญลักษณ์ PDF417 วัตถุนี้เป็นจุดเริ่มต้นสำหรับการทำงานกับบาร์โค้ดทั้งหมด + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Why this matters*: `EncodeTypes.Pdf417` บอกไลบรารีให้ใช้มาตรฐาน PDF417 ซึ่งรองรับปริมาณข้อมูลมากและการแก้ไขข้อผิดพลาด ตัวสร้างยังรับข้อมูลที่คุณต้องการเข้ารหัสโดยตรง ทำให้ไม่ต้องกำหนด `CodeText` แยกภายหลัง + +## ตั้งค่าขนาดบาร์โค้ดและจำนวนคอลัมน์ + +สัญลักษณ์ PDF417 ประกอบด้วยแถวและคอลัมน์ของโมดูลสี่เหลี่ยมเล็ก ๆ การควบคุมความกว้างของโมดูล (X‑dimension) และจำนวนคอลัมน์ช่วยให้คุณปรับขนาดโดยละเอียด + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explanation*: +* **X‑dimension** (`Pixels`) กำหนดความกว้างของแต่ละโมดูล ค่าเล็กทำให้บาร์โค้ดกระชับมากขึ้น ค่าใหญ่ช่วยให้สแกนเนอร์ความละเอียดต่ำอ่านได้ง่ายขึ้น +* **Columns** ควบคุมการจัดวางแนวนอน คอลัมน์น้อยทำให้บาร์โค้ดสูงขึ้น; คอลัมน์มากทำให้กว้างขึ้น ปรับสองค่าพร้อมกันเพื่อให้ได้ **set barcode size** ที่ต้องการอย่างแม่นยำ + +## เปิดใช้งานโหมดคอมแพคท์เพื่อบาร์โค้ดที่เล็กลง + +PDF417 มีโหมด “compact” (หรือ truncated) ที่ลบพื้นที่ว่างที่ไม่จำเป็นและลดขนาดโดยรวม ซึ่งเหมาะอย่างยิ่งเมื่อหน้าจอมีพื้นที่จำกัด + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Why enable truncation?* +เมื่อ `Truncate` เป็น `true` ตัวสร้างจะละเว้นรูปแบบหยุดและบางโค้ดแก้ไขข้อผิดพลาดที่ไม่จำเป็นสำหรับการสแกนส่วนใหญ่ ผลลัพธ์จะเล็กลงประมาณ 15‑20 % โดยไม่เสียความสมบูรณ์ของข้อมูลในกรณีใช้งานทั่วไป + +## บันทึกบาร์โค้ดเป็นภาพ PNG + +หลังจากกำหนดขนาดและโหมดแล้ว ให้เขียนบาร์โค้ดลงดิสก์ PNG เป็นรูปแบบ lossless ทำให้ขอบโมดูลคมชัด + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +ไฟล์ `CompactPdf417.png` จะมีสัญลักษณ์ PDF417 ที่คมชัดตรงกับขนาดที่คุณตั้งค่าในขั้นตอนก่อนหน้า + +### ผลลัพธ์ที่คาดหวัง + +การเปิด PNG ที่บันทึกไว้ควรแสดงบาร์โค้ด PDF417 แนวตั้งที่ประกอบด้วยสามคอลัมน์ โมดูลแต่ละตัวกว้าง 2 px และขนาดรวมประมาณ **120 × 240 px** (กว้าง × สูง) การสแกนภาพด้วยโปรแกรมอ่าน PDF417 ใด ๆ จะคืนข้อความต้นฉบับ “Sample text for PDF417” + +## ข้อผิดพลาดทั่วไปและวิธีหลีกเลี่ยง + +| อาการ | สาเหตุที่เป็นไปได้ | วิธีแก้ | +|---------|--------------|-----| +| บาร์โค้ดอ่านไม่ออก | X‑dimension เล็กเกินไปสำหรับสแกนเนอร์ | เพิ่ม `XDimension.Pixels` เป็น 3 หรือ 4 | +| ภาพกว้างเกินไปสำหรับ UI | ตั้งค่าคอลัมน์มากเกินไป | ลด `Pdf417.Columns` หรือเปิดใช้งาน `Truncate` | +| ข้อยกเว้น `ArgumentOutOfRangeException` | จำนวนคอลัมน์เป็นค่าลบหรือศูนย์ | ตรวจสอบให้ `Columns` เป็นจำนวนเต็มบวก (ขั้นต่ำ 1) | +| ไฟล์ PNG ว่างเปล่า | เส้นทางออกไม่มีหรือไม่มีสิทธิ์เขียน | ตรวจสอบว่าไดเรกทอรีมีอยู่และแอปมีสิทธิ์เขียน | + +> **Pro tip:** ใช้ `barcodeGenerator.ValidateParameters()` ก่อนเรียก `Save()` เพื่อจับข้อผิดพลาดการกำหนดค่าตั้งแต่แรก + +## ตัวอย่างเต็มที่สามารถรันได้ + +ด้านล่างเป็นโปรแกรมคอนโซลแบบ self‑contained ที่รวมทุกขั้นตอนที่กล่าวมา คัดลอกไปยังโปรเจกต์ C# ใหม่, เรียกคืนแพคเกจ NuGet ของ Aspose.BarCode, แล้วรันเพื่อดูผลลัพธ์ + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Running the program** จะสร้าง `CompactPdf417.png` ในไดเรกทอรีทำงานของไฟล์ executable สแกนภาพด้วยแอปมือถือ (เช่น “Barcode Scanner”) เพื่อยืนยันว่าข้อความที่เข้ารหัสตรงกับสตริงต้นฉบับ + +## ขั้นตอนต่อไปและหัวข้อที่เกี่ยวข้อง + +* **Increase error correction level** – ปรับ `Pdf417.ErrorLevel` สำหรับสภาพแวดล้อมที่สแกนมีสัญญาณรบกวน +* **Change orientation** – ตั้งค่า `Pdf417.Rotate` เป็น `RotationAngle.Rotate90` หากต้องการจัดวางแนวนอน +* **Embed the barcode in a PDF** – ผสาน Aspose.PDF กับ Aspose.BarCode เพื่อวางภาพลงในเอกสารโดยตรง +* **Generate other 2‑D barcodes** – คลาส `BarcodeGenerator` เดียวกันรองรับ DataMatrix, QR, และ Aztec; เพียงเปลี่ยน `EncodeTypes.Pdf417` เป็นสัญลักษณ์ที่ต้องการ + +โดยการเชี่ยวชาญเทคนิค **generate PDF417 barcode** คุณสามารถทำระบบตั๋วอัตโนมัติ, ป้ายสินค้า, และการส่งข้อมูลที่ปลอดภัยในแอปพลิเคชัน .NET หลากหลายประเภท + +## สรุป + +คุณได้เรียนรู้วิธี **generate PDF417 barcode** ใน C#, ตั้งค่า **set barcode size** อย่างแม่นยำ, กำหนดคอลัมน์, เปิดโหมดคอมแพคท์, และบันทึกผลเป็น PNG นำการตั้งค่าเหล่านี้ไปใช้เพื่อให้เข้ากับข้อจำกัด UI หรือความต้องการสแกนใด ๆ และขยายวิธีการไปยังรูปแบบบาร์โค้ดอื่น ๆ ตามต้องการ Happy coding! + +## สิ่งที่คุณควรเรียนต่อไป? + +บทแนะนำต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคในคู่มือนี้ แต่ละแหล่งรวมตัวอย่างโค้ดทำงานเต็มรูปแบบพร้อมคำอธิบายขั้นตอนเพื่อช่วยคุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจวิธีการทำงานทางเลือกในโปรเจกต์ของคุณ + +- [วิธีสร้างบาร์โค้ด PDF417 – การเข้ารหัส Compact PDF417](/barcode/english/net/compact-pdf417-encoding/) +- [วิธีสร้างบาร์โค้ด – Compact PDF417 ด้วย Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [วิธีสร้างบาร์โค้ด DataMatrix ด้วย Aspose.BarCode สำหรับ .NET – คู่มือขั้นตอนโดยละเอียด](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/thai/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..4ab728283 --- /dev/null +++ b/barcode/thai/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: วิธีอ่านบาร์โค้ด PDF417 ด้วย C# พร้อมคู่มือขั้นตอนโดยละเอียด ครอบคลุมการอ่านบาร์โค้ดหลายรายการจากภาพและการดึงรายละเอียด + MacroPdf417 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: th +lastmod: 2026-08-22 +og_description: วิธีอ่านบาร์โค้ด PDF417 ด้วย C# อย่างรวดเร็ว บทเรียนนี้จะแสดงวิธีอ่านบาร์โค้ดหลายรายการจากภาพและดึงข้อมูลขยายของ + MacroPdf417 +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: วิธีอ่านบาร์โค้ด PDF417 ด้วย C# – คู่มือการเขียนโปรแกรมเต็มรูปแบบ +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: วิธีอ่านบาร์โค้ด PDF417 ด้วย C# – คู่มือเต็ม +url: /th/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีอ่านบาร์โค้ด PDF417 ด้วย C# – คู่มือฉบับสมบูรณ์ + +หากคุณต้องการ **วิธีอ่าน PDF417** ในแอปพลิเคชัน .NET นี้ จะให้โซลูชันที่พร้อมใช้งาน คุณจะได้เรียนรู้วิธีอ่านบาร์โค้ดหลายรายการจากภาพเดียว, ดึงชุดข้อมูล MacroPdf417 ทั้งหมด, และแสดงผลในคอนโซล วิธีการนี้ทำงานร่วมกับไลบรารี Aspose.BarCode for .NET และต้องใช้เพียงไม่กี่บรรทัดของโค้ด + +การอ่านบาร์โค้ดจากภาพเป็นงานทั่วไปในระบบสินค้าคงคลัง, การตรวจสอบบัตร, และการจัดการเอกสาร เมื่อจบคู่มือคุณจะสามารถถอดรหัสบาร์โค้ด PDF417 หรือ MacroPdf417 ใดก็ได้, จัดการหลายโค้ดในภาพเดียว, และเข้าใจฟิลด์ขยายที่ MacroPdf417 ให้มา + +## ข้อกำหนดเบื้องต้น + +- .NET 6.0 SDK หรือใหม่กว่า (โค้ดนี้ยังคอมไพล์ได้กับ .NET Framework 4.7+) +- Visual Studio 2022 หรือโปรแกรมแก้ไข C# ใดที่คุณชอบ +- Aspose.BarCode for .NET NuGet package (`Install-Package Aspose.BarCode`) +- ตัวอย่างภาพที่มีบาร์โค้ด MacroPdf417 (เช่น `MacroPdf417.png`) + +ไม่ต้องกำหนดค่าพิเศษเพิ่มเติม; ไลบรารีจะจัดการการโหลดภาพและการถอดรหัสภายใน + +## วิธีอ่านบาร์โค้ด PDF417 จากภาพใน C# + +แกนหลักของโซลูชันคือคลาส `BarCodeReader` มันจะเปิดภาพ, ตรวจจับบาร์โค้ดทั้งหมดของประเภทที่ระบุ, และคืนคอลเลกชันของอ็อบเจ็กต์ `BarCodeResult` โค้ดต่อไปนี้แสดงโปรแกรมคอนโซลเต็มรูปแบบ + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### ทำไมแต่ละบรรทัดจึงสำคัญ + +| ขั้นตอน | วัตถุประสงค์ | +|------|---------| +| **1️⃣ Initialize** | สร้าง `BarCodeReader` ที่ผูกกับไฟล์ภาพและจำกัดการตรวจจับให้เฉพาะสัญลักษณ์ MacroPdf417 ซึ่งช่วยเร่งการประมวลผล | +| **2️⃣ Iterate** | `ReadBarCodes()` คืนค่า **ทั้งหมด** ของบาร์โค้ดที่ตรงกับประเภทที่ร้องขอ, ทำให้คุณ **อ่านหลายบาร์โค้ด** ได้โดยไม่ต้องวนลูปเพิ่ม | +| **3️⃣ Basic output** | แสดง `CodeTypeName` ทั่วไปและ `CodeText` ที่มนุษย์อ่านได้ ซึ่งมีประโยชน์สำหรับการบันทึกหรือการตรวจสอบอย่างรวดเร็ว | +| **4️⃣ Extended data** | MacroPdf417 มีเมตาดาต้าเพิ่มเติม (ไฟล์ ID, จำนวนส่วน, เวลา, ฯลฯ) `Extended.Pdf417` เปิดเผยแต่ละฟิลด์โดยตรง, ทำให้คุณสามารถเก็บหรือยืนยันข้อมูลชุดเต็มได้ | + +การรันโปรแกรมกับภาพ MacroPdf417 ที่ถูกต้องจะสร้างผลลัพธ์ในคอนโซลคล้ายกับตัวอย่างต่อไปนี้ + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +ผลลัพธ์ยืนยันว่าไลบรารีอ่านบาร์โค้ดสำเร็จ, ดึงข้อความออกมา, และให้ข้อมูลทุกฟิลด์ของ MacroPdf417 + +## การอ่านบาร์โค้ดหลายรายการจากภาพเดียว + +หลายสถานการณ์จริงจะวางสัญลักษณ์ PDF417 หลายตัวบนฉลากเดียว—เช่น ใบรายการขนส่งที่มีรหัสผู้ขนส่ง, หมายเลขติดตาม, และการประกาศศุลกากร โค้ดบล็อกเดียวกันข้างต้นได้ **อ่านหลายบาร์โค้ด** แล้วเพราะ `ReadBarCodes()` คืนค่า enumerable ของผลลัพธ์ทั้งหมด ไม่ต้องกำหนดค่าเพิ่มเติม; เพียงแค่วนลูปผ่านผลลัพธ์ตามที่แสดง + +หากต้องการจำกัดตัวอ่านให้เป็น PDF417 มาตรฐาน (ไม่ใช่ macro) แต่ยังต้องจัดการหลายโค้ด, ให้เปลี่ยน `DecodeType.MacroPdf417` เป็น `DecodeType.Pdf417` ส่วนตรรกะที่เหลือคงเดิม + +## ทำความเข้าใจข้อมูลขยายของ MacroPdf417 + +MacroPdf417 เป็นส่วนขยายของสเปค PDF417 ปกติ มันแบ่งข้อมูลขนาดใหญ่เป็นหลายส่วนและเพิ่มส่วนหัวเล็ก ๆ ที่อธิบายไฟล์ทั้งหมด ฟิลด์ที่สำคัญที่สุดมีดังนี้ + +- **MacroPdf417FileID** – ตัวระบุที่ไม่ซ้ำกันซึ่งใช้ร่วมกันระหว่างทุกส่วนของไฟล์เดียวกัน +- **MacroPdf417SegmentID** – หมายเลขลำดับของส่วนปัจจุบัน +- **MacroPdf417SegmentsCount** – จำนวนส่วนทั้งหมดที่คาดว่าจะมี +- **MacroPdf417FileName** – ชื่อไฟล์ทางเลือกที่ส่งมาพร้อมบาร์โค้ด +- **MacroPdf417Checksum** – ค่าตรวจสอบข้อผิดพลาดสำหรับไฟล์เต็ม +- **MacroPdf417FileSize** – ขนาดของข้อมูลไบนารีดั้งเดิม +- **MacroPdf417TimeStamp** – เวลาแบบ ISO‑8601 เมื่อบาร์โค้ดถูกสร้าง +- **MacroPdf417Addressee / Sender** – ฟิลด์ข้อความทางเลือกสำหรับการกำหนดเส้นทาง +- **MacroPdf417Terminator** – ระบุว่าส่วนนี้เป็นส่วนสุดท้ายหรือไม่ + +เมื่อคุณได้รับทุกส่วนแล้ว สามารถสร้างไฟล์ต้นฉบับใหม่โดยจัดลำดับตาม `MacroPdf417SegmentID` แล้วต่อค่า `CodeText` เข้าด้วยกัน ตรรกะนี้ทำได้ง่ายเมื่อคุณมีฟิลด์เหล่านี้พร้อมใช้งาน + +## ข้อผิดพลาดทั่วไปและเคล็ดลับระดับมืออาชีพ + +- **Image quality matters** – ไฟล์ PNG/JPEG ที่ความละเอียดต่ำหรือบีบอัดมากเกินไปอาจทำให้ตรวจจับไม่ครบ ใช้ DPI อย่างน้อย 300 dpi สำหรับบาร์โค้ดที่พิมพ์ +- **Mixed symbologies** – หากภาพมีทั้ง MacroPdf417 และ PDF417 ปกติ ให้สร้างตัวอ่านสองตัว (หนึ่งสำหรับแต่ละ `DecodeType`) หรือใช้ `DecodeType.AllSupported` แล้วกรองผลลัพธ์ด้วย `result.CodeTypeName` +- **Memory usage** – คำสั่ง `using` จะทำลาย `BarCodeReader` อย่างรวดเร็ว ป้องกันไม่ให้บัฟเฟอร์ภาพขนาดใหญ่ค้างในหน่วยความจำ +- **Thread safety** – `BarCodeReader` ไม่ปลอดภัยต่อการทำงานหลายเธรด สร้างอินสแตนซ์แยกสำหรับแต่ละเธรดหากต้องถอดรหัสภาพพร้อมกัน +- **Error handling** – ห่อการเรียก `ReadBarCodes()` ด้วยบล็อก try/catch เพื่อดักจับ `BarCodeException` สำหรับภาพที่เสียหาย + +## สรุปตัวอย่างทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมเต็มที่คุณสามารถคัดลอกไปใส่ในโปรเจกต์คอนโซลใหม่ได้ รวมคำสั่ง `using` ทั้งหมด, ค่าคงที่สำหรับเส้นทางภาพ, และรูปแบบการปล่อยทรัพยากร + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +คอมไพล์ด้วย `dotnet build` และรันด้วย `dotnet run` คอนโซลจะพิมพ์ข้อมูลพื้นฐานของบาร์โค้ดแต่ละรายการและข้อมูล MacroPdf417 เต็มชุด + +## ขั้นตอนต่อไป + +- **สร้างไฟล์หลายส่วนใหม่** – รวบรวมทุกส่วน, เรียงตาม `MacroPdf417SegmentID`, และต่อ `CodeText` เพื่อ + +## สิ่งที่คุณควรเรียนต่อไปคืออะไร? + +บทแนะนำต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคที่แสดงในคู่มือนี้ แต่ละแหล่งรวมตัวอย่างโค้ดทำงานเต็มรูปแบบพร้อมคำอธิบายทีละขั้นตอน เพื่อช่วยให้คุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจแนวทางการทำงานทางเลือกในโปรเจกต์ของคุณเอง + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Read PDF417 Barcodes with Turkish Characters in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [How to Use Aspose for PDF417 Barcode (Chinese) in Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/thai/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..c1c7ae0a8 --- /dev/null +++ b/barcode/thai/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,226 @@ +--- +category: general +date: 2026-08-22 +description: บทเรียนการสร้างบาร์โค้ดด้วย C# แสดงวิธีสร้างบาร์โค้ด Macro PDF417 พร้อมเมตาดาต้าและบันทึกเป็น + PNG ด้วย Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: th +lastmod: 2026-08-22 +og_description: เครื่องสร้างบาร์โค้ด C# ช่วยให้คุณสร้างบาร์โค้ด Macro PDF417 พร้อมเมตาดาต้าระดับไฟล์เต็มรูปแบบและส่งออกเป็น + PNG. ปฏิบัติตามคำแนะนำนี้เพื่อดำเนินการแก้ไข. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: เครื่องสร้างบาร์โค้ด C# – สร้างบาร์โค้ด Macro PDF417 ทีละขั้นตอน +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: วิธีใช้ตัวสร้างบาร์โค้ด C# สำหรับ Macro PDF417 +url: /th/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีใช้ตัวสร้างบาร์โค้ด C# สำหรับ Macro PDF417 + +หากคุณต้องการ **ตัวสร้างบาร์โค้ด C#** ที่สามารถสร้างสัญลักษณ์ Macro PDF417 พร้อมเมตาดาต้าระดับไฟล์ คำแนะนำนี้จะให้โซลูชันที่สมบูรณ์และพร้อมใช้งาน คุณจะได้เห็นวิธีกำหนดลักษณะของบาร์โค้ด ฝังข้อมูลแมโครเช่นไฟล์ ID และจำนวนส่วนย่อย และสุดท้ายบันทึกผลลัพธ์เป็นไฟล์ PNG + +ตัวอย่างใช้ไลบรารี Aspose.BarCode ซึ่งเป็น **C# barcode library** ที่ได้รับความนิยมและรองรับคุณสมบัติเต็มของ PDF417 ไม่ต้องพึ่งบริการภายนอก และโค้ดทำงานได้กับ .NET 6 หรือใหม่กว่า + +## ข้อกำหนดเบื้องต้น + +ก่อนเริ่มทำงาน ให้แน่ใจว่าคุณมี: + +* .NET 6 SDK (หรือเวอร์ชันที่ใหม่กว่า) ติดตั้งอยู่ +* Visual Studio 2022, VS Code หรือ IDE สำหรับ C# อื่น ๆ +* การอ้างอิง NuGet ไปยัง **Aspose.BarCode** (`dotnet add package Aspose.BarCode`) + +การเข้าใจไวยากรณ์พื้นฐานของ C# และแนวคิดของบาร์โค้ด PDF417 จะช่วยให้ตามขั้นตอนได้ง่ายขึ้น แต่บทแนะนำนี้อธิบายตัวเลือกการกำหนดค่าทั้งหมดอย่างละเอียด + +## สิ่งที่บทแนะนำครอบคลุม + +* การสร้างอินสแตนซ์ **barcode generator C#** สำหรับรูปแบบ Macro PDF417 +* การปรับพารามิเตอร์ภาพเช่น X‑dimension และจำนวนคอลัมน์ +* การกำหนดฟิลด์ระดับไฟล์ของ Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender, และ terminator +* การบันทึกสัญลักษณ์ที่สร้างเป็นไฟล์ PNG +* เคล็ดลับการจัดการกรณีขอบเช่นไฟล์ขนาดใหญ่หรือ timestamp ที่กำหนดเอง + +เมื่ออ่านจบบทความนี้ คุณจะมีโปรแกรมที่ทำงานอิสระซึ่งสร้างบาร์โค้ด Macro PDF417 ที่เป็นไปตามมาตรฐานอย่างเต็มรูปแบบ + +## ขั้นตอนที่ 1: สร้างอินสแตนซ์ barcode generator C# + +การดำเนินการแรกคือการสร้าง `BarcodeGenerator` ด้วยค่า enum `EncodeTypes.MacroPdf417` และข้อความที่ต้องการเข้ารหัส ตัวสร้างยังรับสตริง payload ซึ่งจะเป็นส่วนข้อมูลของบาร์โค้ดแมโคร + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**ทำไมจึงสำคัญ** – ธง `EncodeTypes.MacroPdf417` บอกให้ Aspose.BarCode ปฏิบัติต่อสัญลักษณ์ว่าเป็นบาร์โค้ดแมโคร เพื่อเปิดใช้งานฟิลด์เพิ่มเติม หากไม่มีธงนี้ ไลบรารีจะสร้างบาร์โค้ด PDF417 ปกติที่ไม่มีเมตาดาต้าระดับไฟล์ + +## ขั้นตอนที่ 2: ปรับลักษณะบาร์โค้ดพื้นฐาน (การตั้งค่า PDF417) + +ความคมชัดของภาพเป็นสิ่งสำคัญสำหรับการสแกนที่เชื่อถือได้ พารามิเตอร์ที่พบบ่อยสองอย่างคือความกว้างของโมดูล (`XDimension`) และจำนวนคอลัมน์ การตั้งค่าค่าทั้งสองนี้ช่วยสมดุลระหว่างขนาดและความอ่านง่าย + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` ควบคุมความกว้างของแต่ละบาร์สีดำ/ขาว ค่า **2** ทำงานได้ดีกับเครื่องพิมพ์ฉลากส่วนใหญ่ +* `Pdf417.Columns` กำหนดจำนวนคอลัมน์ที่บาร์โค้ดจะใช้ คอลัมน์ห้าคอลัมน์ให้สัญลักษณ์ที่กระชับโดยไม่ลดความจุข้อมูล + +## ขั้นตอนที่ 3: กำหนดข้อมูลระดับไฟล์ของ Macro PDF417 + +Macro PDF417 ขยายรูปแบบ PDF417 มาตรฐานด้วยฟิลด์ที่อธิบายการแบ่งไฟล์ขนาดใหญ่เป็นหลายส่วน การกำหนดฟิลด์เหล่านี้ทำให้สแกนเนอร์ที่ต่อมาสามารถประกอบไฟล์เดิมได้ + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` ต้องเหมือนกันสำหรับทุกส่วนที่เป็นของไฟล์เดียวกัน +* `MacroPdf417SegmentID` เพิ่มขึ้นจาก **0** ถึง `SegmentsCount‑1` +* `MacroPdf417SegmentsCount` บอก decoder ว่าต้องคาดหวังกี่ส่วน +* `MacroPdf417FileName` เป็นฟิลด์เสริมที่เป็นประโยชน์สำหรับการระบุด้วยข้อความที่มนุษย์อ่านได้ + +## ขั้นตอนที่ 4: ตั้งค่าเมตาดาต้าแมโครเพิ่มเติม + +นอกเหนือจากข้อมูลไฟล์หลัก สเปคยังอนุญาตฟิลด์เสริมเช่น checksum, file size, timestamp, addressee, sender, และ terminator การเติมฟิลด์เหล่านี้ช่วยเพิ่มความสมบูรณ์ของข้อมูลและความสามารถในการติดตาม + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` ให้ค่า 16‑bit CCITT checksum สำหรับไฟล์ทั้งหมด; decoder สามารถตรวจสอบความสมบูรณ์หลังการประกอบไฟล์ได้ +* `MacroPdf417FileSize` ควรสะท้อนจำนวนไบต์ที่แน่นอนของไฟล์ต้นฉบับ; ค่าที่ใหญ่กว่า `2^31‑1` ต้องใช้ฟิลด์ 64‑bit ซึ่ง Aspose จัดการให้โดยอัตโนมัติ +* `MacroPdf417TimeStamp` บันทึกเวลาที่บาร์โค้ดถูกสร้าง ใช้ UTC เพื่อหลีกเลี่ยงความสับสนของโซนเวลา +* `MacroPdf417Addressee` และ `MacroPdf417Sender` เป็นสตริงแบบอิสระที่สามารถเก็บข้อมูลการส่งต่อได้ +* `MacroPdf417Terminator` บ่งบอกว่านี่เป็นส่วนสุดท้าย; ตั้งเป็น `Set` สำหรับส่วนสุดท้าย มิฉะนั้นให้ใช้ค่าเริ่มต้น (`NotSet`) + +**เคล็ดลับกรณีขอบ** – หากขนาดไฟล์ของคุณเกิน 4 GB ให้แบ่งเนื้อหาเป็นหลายส่วนแมโครและปรับ `SegmentsCount` ให้สอดคล้อง ไลบรารีจะจัดการฟิลด์ขนาดใหญ่โดยไม่เกิด overflow + +## ขั้นตอนที่ 5: บันทึกบาร์โค้ดเป็นไฟล์ PNG + +ขั้นตอนสุดท้ายคือการเขียนสัญลักษณ์ที่สร้างลงดิสก์ PNG รักษาขนาดพิกเซลที่แน่นอนและได้รับการสนับสนุนอย่างกว้างขวางโดยอุปกรณ์สแกน + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +แทนที่ `YOUR_DIRECTORY` ด้วยพาธแบบ absolute หรือ relative ที่กระบวนการทำงานสามารถเขียนได้ enum `BarCodeImageFormat.Png` ทำให้ผลลัพธ์เป็นแบบ lossless + +**ทำไมต้อง PNG?** – รูปแบบ raster อย่าง PNG ทำให้ขอบโมดูลคมชัด ซึ่งจำเป็นสำหรับสแกนเนอร์ที่พึ่งพาขอบคอนทราสต์สูง หากต้องการรูปแบบเวกเตอร์ Aspose ยังรองรับ `Pdf` และ `Svg` อีกด้วย + +## ตัวอย่างที่สามารถรันได้เต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมทั้งหมดที่คุณสามารถคัดลอกไปใส่ในแอปพลิเคชันคอนโซล รวมถึง `using` directives ที่จำเป็นและเมธอด `Main` + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### ผลลัพธ์ที่คาดหวัง + +เมื่อรันโปรแกรมจะสร้างไฟล์ชื่อ **MacroPdf417.png** ในไดเรกทอรีทำงานของโปรเจกต์ การเปิดภาพจะแสดงบาร์โค้ด PDF417 แบบกระชับพร้อมฟิลด์แมโครที่ฝังอยู่ การสแกนภาพด้วยรีดเดอร์ที่รองรับ PDF417 (เช่น ZXing, Aspose.BarCode decoder) จะคืน payload `"Sample text"` ดั้งเดิมพร้อมเมตาดาต้าแมโคร + +## คำถามที่พบบ่อยและการแก้ไขปัญหา + +| Question | Answer | +|----------|--------| +| *What if the barcode is too large for the target label?* | Reduce `XDimension.Pixels` or increase `Pdf417.Columns`. Both parameters affect overall size. | +| *Can I generate a vector image instead of PNG?* | Yes. Call `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` for scalable output. | +| *How do I verify the checksum after scanning?* | The Aspose.BarCode decoder automatically validates `MacroPdf417Checksum` and reports mismatches in the `MacroPdf417Result` object. | +| *Is the library compatible with .NET Core?* | The NuGet package supports .NET Standard 2.0+, which covers .NET Core, .NET 5, .NET 6, and later. | +| *What if I need to embed binary data instead of text?* | Convert the binary payload to Base64 or use the `EncodeTypes.MacroPdf417` overload that accepts a byte array. | + +## เคล็ดลับระดับมืออาชีพสำหรับการใช้งานในผลิตภัณฑ์ + +* **Cache the generator** – + + +## คุณควรเรียนรู้อะไรต่อไป? + +บทแนะนำต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคที่แสดงในคู่มือนี้ แต่ละแหล่งรวมตัวอย่างโค้ดที่ทำงานได้เต็มรูปแบบพร้อมคำอธิบายทีละขั้นตอน เพื่อช่วยให้คุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจแนวทางการทำงานอื่น ๆ ในโครงการของคุณเอง + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/net/compact-pdf417-encoding/_index.md b/barcode/turkish/net/compact-pdf417-encoding/_index.md index 8524d9dfc..602750475 100644 --- a/barcode/turkish/net/compact-pdf417-encoding/_index.md +++ b/barcode/turkish/net/compact-pdf417-encoding/_index.md @@ -102,7 +102,7 @@ var generator = new BarcodeGenerator(EncodeTypes.Pdf417Compact, "Your data here" ``` ### Adım 2: Hata Düzeltmeyi Yapılandırma (İsteğe Bağlı) -`Pdf417ErrorCorrectionLevel` özelliği, PDF417 barkodları için Reed‑Solomon hata düzeltme seviyesini tanımlar. +`Pdf417ErrorCorrectionLevel` özelliği, PDF417 barkodları için Reed‑Solomon hata‑düzeltme seviyesini tanımlar. ```csharp generator.Parameters.Barcode.Pdf417.Pdf417ErrorCorrectionLevel = Pdf417ErrorCorrectionLevel.Level5; ``` @@ -139,9 +139,22 @@ Compact PDF417'nin yüksek veri yoğunluğu ve sağlam hata düzeltmesi, alanın - **Lisans İstisnaları:** Deneme ortamında oluşturulan barkod bir filigran içerebilir. Filigranı kaldırmak için geçerli bir lisans uygulayın. ## Compact PDF417 Kodlama Eğitimleri +### [How to generate PDF417 barcode in C# and set barcode size](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) + + ### [Compact PDF417 Barkodları Oluşturma](./compact-pdf417-basic-configuration/) Aspose.BarCode for .NET kullanarak Compact PDF417 barkodları nasıl oluşturulur öğrenin. Adım adım talimatlar ve kod örnekleri içeren kapsamlı bir rehber. +### [C#'ta micro PDF417 barkodu nasıl oluşturulur – adım adım rehber](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) + +### [Macro PDF417 için C# barcode üreteci nasıl kullanılır](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) + +### [C#'ta PDF417 barkodlarını okuma – tam rehber](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Aspose.BarCode for .NET ile PDF417 barkodlarını okuma adımlarını öğrenin. + +### [C#'ta PDF417 barkodu oluşturma ve PNG olarak kaydetme](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Aspose.BarCode for .NET kullanarak PDF417 barkodunu oluşturup PNG formatında kaydedin. + ## Sıkça Sorulan Sorular **S: Compact PDF417 barkodunda saklayabileceğim maksimum veri miktarı nedir?** diff --git a/barcode/turkish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/turkish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..f763fc266 --- /dev/null +++ b/barcode/turkish/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,214 @@ +--- +category: general +date: 2026-08-22 +description: C#'ta mikro PDF417 barkod oluşturmayı ve barkod PNG görüntüsü üretmeyi + öğrenin. Barkod boyutlarını ayarlamayı ve dosyayı kaydetmeyi içerir. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: tr +lastmod: 2026-08-22 +og_description: C# ile mikro PDF417 barkod oluşturun ve PNG olarak dışa aktarın. Barkod + boyutlarını ayarlamak ve hızlı bir şekilde barkod resmi üretmek için bu kılavuzu + izleyin. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: C#'ta mikro PDF417 barkodu oluşturma – tam kodlama öğreticisi +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: C#'ta mikro PDF417 barkod nasıl oluşturulur – adım adım rehber +url: /tr/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#'ta micro PDF417 barkod nasıl oluşturulur – adım adım rehber + +Biletleme sistemi, envanter etiketi veya mobil tarama için **micro PDF417 barkod oluşturmanız** gerekiyorsa, bu öğretici size tam olarak nasıl yapılacağını gösterir. Barkod PNG'si üreten tam C# programını görecek, barkod boyutlarını nasıl ayarlayacağınızı öğrenecek ve her yapılandırma seçeneğini anlayacaksınız. + +Bu rehberin sonunda yüksek çözünürlüklü bir barkod görüntüsü oluşturabilecek, X‑boyutunu özelleştirebilecek, sütun sayısını seçebilecek ve sonucu bir PNG dosyası olarak kaydedebileceksiniz—bütün bunlar birkaç satır kodla. + +## Gereksinimler + +- .NET 6.0 SDK veya daha yeni (kod .NET Core ve .NET Framework ile çalışır) +- Visual Studio 2022 veya herhangi bir C# uyumlu IDE +- **Aspose.BarCode for .NET** NuGet paketi (veya `EncodeTypes.MicroPdf417`'ı destekleyen herhangi bir kütüphane) +- C# sözdizimi hakkında temel bilgi + +> **Pro tip:** Aspose.BarCode'un ücretsiz topluluk sürümü geliştirme ve test için yeterlidir. Üretim ortamı için, değerlendirme filigranlarını kaldırmak amacıyla bir lisans edinin. + +## Adım 1: Barkod kütüphanesini kurun + +Proje klasörünüzde bir terminal açın ve şu komutu çalıştırın: + +```bash +dotnet add package Aspose.BarCode +``` + +`Aspose.BarCode` derlemesini ekler; bu derleme, **C#'ta barkod görüntüsü oluşturmak** için kullanılan `BarcodeGenerator` sınıfını sağlar. + +## Adım 2: Üreteci başlatın – micro PDF417 barkod oluşturun + +İlk uygulanabilir satır, Micro PDF417 sembolojisi için yapılandırılmış bir `BarcodeGenerator` örneği oluşturur ve kodlamak istediğiniz veriyi sağlar. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Neden önemli*: `EncodeTypes.MicroPdf417` enum'u, kütüphaneye PDF417'nin sıkıştırılmış sürümünü kullanmasını söyler; bu, küçük etiketler ve mobil ekranlar için idealdir. + +## Adım 3: C#'ta barkod boyutlarını nasıl ayarlarsınız + +Modül genişliğini (X‑boyutu) ince ayar yapmak, barkodun görsel yoğunluğunu kontrol eder. Daha küçük bir değer daha keskin bir görüntü verirken, daha büyük bir değer barkodun uzaktan taranmasını kolaylaştırır. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +**Neden boyutları ayarlamalısınız**: X‑boyutu ayarlamazsanız, varsayılan değer yüksek DPI'da render edildiğinde bulanık bir barkod üretebilir. Çoğu ekran tabanlı tarama için 2 piksel ayarlamak iyi bir dengedir. + +## Adım 4: Sütun sayısını seçin – barkod genişliğini kontrol edin + +Micro PDF417 1 ile 4 arasında sütun sayısına izin verir. Daha fazla sütun veriyi yatay olarak sıkıştırır ve toplam görüntü genişliğini azaltır. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Köşe durumu*: 5 sütun talep ederseniz kütüphane bir `ArgumentOutOfRangeException` fırlatır. Her zaman belgelenen aralık içinde kalın. + +## Adım 5: Barkod PNG'si nasıl oluşturulur – görüntüyü kaydetme + +Şimdi oluşturulan barkodu bir PNG dosyasına dışa aktarabilirsiniz. PNG, kayıpsız kaliteyi korur; bu, güvenilir tarama için esastır. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Programı çalıştırdığınızda, dosya konumunu onaylayan bir konsol mesajı göreceksiniz. Oluşan `MicroPdf417.png` şu şekilde görünür: + +![C# ile oluşturulmuş bir micro PDF417 barkodunun ekran görüntüsü](micro-pdf417-example.png "Oluşturulmuş micro PDF417 barkodu") + +*Görsel alt metni*: **C#'ta oluşturulmuş micro PDF417 barkodu** – boyut ve sütun ayarları uygulandıktan sonra son çıktıyı gösterir. + +## Adım 6: Çıktıyı çalıştırın ve doğrulayın + +1. Projeyi derleyin: `dotnet build`. +2. Çalıştırın: `dotnet run`. +3. Masaüstünüzde `MicroPdf417.png` dosyasını açın ve bir mobil barkod tarayıcı uygulamasıyla tarayın. + +Metnin **“Sample text”** olarak çözüldüğünü görmelisiniz. Tarayıcı bir hata bildiriyorsa, X‑boyutunu ve sütun sayısını tekrar kontrol edin – aşırı değerler barkodu bazı cihazlar için çok yoğun hâle getirebilir. + +## Yaygın varyasyonlar ve sorun giderme + +| Durum | Ayar | +|-----------|------------| +| **Düşük çözünürlüklü yazıcılar için daha büyük bir barkod gerek** | `XDimension.Pixels` değerini 3 veya 4'e artırın. | +| **Genişliği değiştirmeden daha uzun bir barkod istiyorsunuz** | `generator.Parameters.Barcode.Pdf417.Rows` ayarlayın (satır aralığı 3‑90). | +| **Bir döngüde birden fazla barkod oluşturma** | Aynı `BarcodeGenerator` örneğini yeniden kullanın ve her `Save` işleminden önce sadece `CodeText`'i değiştirin. | +| **PNG yerine JPEG olarak kaydetme** | `BarCodeImageFormat.Png` yerine `BarCodeImageFormat.Jpeg` kullanın. | +| **.NET Framework 4.7 üzerinde çalıştırma** | Aynı kod çalışır; sadece uygun `Aspose.BarCode.dll` dosyasına referans verin. | + +## Tam kaynak kodu (çalıştırılabilir) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Beklenen çıktı** – “Sample text” olarak çözülen net bir Micro PDF417 barkodu içeren 200 × 100 piksel PNG dosyası. + +## Sonuç + +Artık C#'ta **micro PDF417 barkod oluşturmayı**, **barkod boyutlarını ayarlamayı** ve **barkod PNG görüntüsü üretmeyi** biliyorsunuz. Tam örnek, kütüphane kurulumundan son dosyanın kaydedilmesine kadar gereken her adımı gösterir; böylece barkod üretimini doğrudan kendi uygulamalarınıza entegre edebilirsiniz. + +Sonra, **Aspose.BarCode ile QR kodları oluşturma**, **renk özelleştirme** veya **PDF belgelerine barkod yerleştirme** gibi ilgili konuları keşfedin. Bunların her biri burada ele alınan aynı `BarcodeGenerator` temelleri üzerine inşa edilmiştir. + +Farklı veri dizileri, sütun sayıları ve X‑boyutu değerleriyle denemeler yapmaktan çekinmeyin; böylece kendi tarama ortamınıza uygun hale getirebilirsiniz. Kodlamanın tadını çıkarın! + +## Sonra Ne Öğrenmelisiniz? + +Aşağıdaki öğreticiler, bu rehberde gösterilen tekniklere dayanan ve yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini öğrenmenize ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olmak için adım adım açıklamalar içeren tam çalışan kod örnekleri sunar. + +- [Compact PDF417 ile Barkod Oluşturma – Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [PDF417 Barkod Oluşturma – Compact PDF417 Kodlaması](/barcode/english/net/compact-pdf417-encoding/) +- [Aspose.BarCode for .NET ile Aztec barkod oluşturma](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/turkish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..5424ef7cd --- /dev/null +++ b/barcode/turkish/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,202 @@ +--- +category: general +date: 2026-08-22 +description: C#'ta bir barkod oluşturucu ile PDF417 barkodu nasıl oluşturacağınızı, + düzeni ayarlamayı ve PNG olarak kaydetmeyi öğrenin. Tam kod ve C# barkod oluşturucu + projeleri için ipuçları içerir. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: tr +lastmod: 2026-08-22 +og_description: C#'ta bir barkod oluşturucu kullanarak PDF417 barkodu oluşturun, düzeni + özelleştirin ve PNG olarak nasıl kaydedileceğini öğrenin. Bu adım adım öğreticiyi + izleyin. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: C#'ta PDF417 barkod oluşturma – PNG oluşturma ve kaydetme için tam rehber +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: C#'te PDF417 barkodu nasıl oluşturulur ve PNG olarak kaydedilir +url: /tr/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#'ta PDF417 barkod nasıl oluşturulur ve PNG olarak kaydedilir + +C# uygulamasında **PDF417 barkod oluşturmanız** gerekiyorsa, bu öğretici size tam adımları gösterir. Bir barcode generator C# library'nin herhangi bir dizeyi taranabilir bir PDF417 görüntüsüne nasıl dönüştürebileceğini ve PNG dosyalarını ek araçlar olmadan nasıl kaydedebileceğinizi göreceksiniz. + +Barkod oluşturma, lojistik, biletleme ve belge yönetiminde yaygındır. Bu rehberin sonunda, seçtiğiniz klasörde `Pdf417Layout.png` adlı bir PNG dosyası üreten çalıştırılabilir bir konsol programına sahip olacaksınız. + +## Önkoşullar + +Başlamadan önce şunların yüklü olduğundan emin olun: + +- .NET 6.0 SDK veya daha yeni bir sürümünün yüklü olması (kod .NET Framework 4.7+ ile de çalışır). +- Visual Studio 2022 veya C# projelerini derleyebilen herhangi bir editör. +- **Aspose.BarCode for .NET** NuGet paketi (veya uyumlu herhangi bir barcode generator C# library). + Şu komutla kurun: + +```bash +dotnet add package Aspose.BarCode +``` + +Ekstra görüntü işleme kütüphanelerine gerek yoktur çünkü jeneratör PNG'yi doğrudan yazabilir. + +## Adım 1: Yeni bir konsol projesi oluşturun + +Örneğin bağımsız kalması için yeni bir konsol projesi oluşturun. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +`Pdf417Demo` klasörü artık barcode kodunu yazacağımız bir `Program.cs` dosyası içeriyor. + +## Adım 2: Barcode ad alanını içe aktarın + +`Program.cs` dosyasını açın ve üstte gerekli `using` yönergesini ekleyin: + +```csharp +using Aspose.BarCode.Generation; +``` + +Bu ad alanı, **PNG nasıl kaydedilir** için gerekli olan `BarcodeGenerator`, `EncodeTypes` ve görüntü formatı enum'ına erişim sağlar. + +## Adım 3: PDF417 barcode jeneratörünü oluşturun + +**PDF417 nasıl oluşturulur** sorusunun çekirdeği `BarcodeGenerator` sınıfıdır. Encode tipini `EncodeTypes.Pdf417` ve kodlamak istediğiniz metni geçin. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` artık barkodun tüm ayarlarını tutuyor. Varsayılan düzen çalışır, ancak bir sonraki adımda özelleştireceğiz. + +## Adım 4: Barcode düzenini tanımlayın (sütunlar ve satırlar) + +PDF417, sütun sayısını (2‑30) ve satır sayısını (1‑90) kontrol etmenize izin verir. Bu değerleri ayarlamak, belirli tarayıcılar için okunabilirliği artırabilir. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Pro ipucu:** Bu ayarları atladığınızda, kütüphane otomatik olarak optimal değerleri seçer. Ancak, sütun ve satırları sabitlemek, PNG'yi bir PDF'ye veya UI düzenine gömdüğünüzde faydalı olan öngörülebilir görüntü boyutları sağlar. + +## Adım 5: Oluşturulan barkodu PNG görüntüsü olarak kaydedin + +Şimdi **PNG nasıl kaydedilir** sorusunu `Save` metodunu çağırarak yanıtlayın. Metot hedef yolu ve görüntü formatı enum'ını kabul eder. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +Programı çalıştırdıktan sonra `Pdf417Layout.png` dosyası projenin `bin/Debug/net6.0` klasöründe görünür. + +## Tam çalıştırılabilir örnek + +Aşağıda tam `Program.cs` dosyası yer alıyor. **Adım 1**'de oluşturduğunuz projeye kopyalayın ve `dotnet run` komutunu çalıştırın. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Beklenen çıktı + +Programı çalıştırdığınızda, konsol PNG dosyasının tam yolunu yazdırır ve dosya aşağıdaki görüntüye benzer net bir PDF417 barkod içerir. + +![PDF417 barkod oluşturma örneği](image-placeholder.png "PNG olarak kaydedilen PDF417 barkodu") + +PNG'yi herhangi bir PDF417‑uyumlu tarayıcı (mobil uygulamalar, donanım okuyucular) ile tarayarak kodlanan metnin `"Sample"` olduğunu doğrulayabilirsiniz. + +## Kenar durumları ve yaygın tuzakların ele alınması + +| Durum | Dikkat edilmesi gereken | Önerilen çözüm | +|-----------|-------------------|-----------------| +| **Geçersiz sütun/satır değerleri** | 2‑30 (sütun) veya 1‑90 (satır) aralığının dışındaki değerler `ArgumentException` hatasına neden olur. | Kullanıcı girişini atamadan önce doğrulayın veya kütüphanenin varsayılanları seçmesine izin verin. | +| **Uzun giriş dizeleri** | PDF417, 1.850 karaktere kadar kodlayabilir, ancak çok uzun dizeler gerekli satır sayısını büyük ölçüde artırır. | Veriyi birden fazla barkoda bölün veya gerekirse daha yüksek hata düzeltme seviyesi kullanın. | +| **Dosya sistemi izinleri** | Yalnızca okunabilir bir klasöre kaydetmek `UnauthorizedAccessException` hatası fırlatır. | `Environment.CurrentDirectory` veya kullanıcı tarafından yazılabilir bir yola yazın ve istisnaları try/catch ile yönetin. | +| **Eksik NuGet paketi** | Derleme, “type or namespace name could not be found” hatasıyla başarısız olur. | `Aspose.BarCode`'un yüklü olduğundan emin olun (`dotnet add package Aspose.BarCode`). | + +## Örneği genişletmek + +Artık **PDF417 barkod nasıl oluşturulur** ve **PNG nasıl kaydedilir** bildiğinize göre, aşağıdaki ilgili konuları keşfedebilirsiniz: + +- **Barcode generator C#**: `EncodeTypes`'ı `Code128`, `QR` veya diğer sembolojilere değiştirin. +- **Özel renkler**: `generator.Parameters.Barcode.ForegroundColor` ve `BackgroundColor`'ı marka renklerine uyacak şekilde kullanın. +- **PDF'lere gömme**: PNG'yi bir PDF kütüphanesi (ör. iText7) ile birleştirerek yazdırılabilir belgeler oluşturun. +- **Dinamik veri**: Metni bir veritabanından veya kullanıcı girişinden alarak barkodları anlık olarak oluşturun. + +## Sonuç + +Artık C#'ta **PDF417 barkod oluşturma** ve sonucu PNG dosyası olarak kaydetme konusunda eksiksiz, üretim‑hazır bir çözüme sahipsiniz. Öğretici, proje kurulumundan düzen özelleştirmesine kadar her adımı kapsadı ve bir barcode generator C# library kullanırken yaygın hatalardan nasıl kaçınılacağını vurguladı. + +Farklı sütun/satır ayarları, renkler veya hatta diğer barkod formatlarıyla denemeler yapmaktan çekinmeyin. Herhangi bir sorunla karşılaşırsanız, **PDF417 nasıl oluşturulur** bölümüne geri dönün veya gelişmiş özellikler için kütüphanenin belgelerini inceleyin. Kodlamanın tadını çıkarın! + +## Sonra Ne Öğrenmelisiniz? + +Aşağıdaki öğreticiler, bu rehberde gösterilen tekniklere dayanan yakın konuları kapsar. Her kaynak, ek API özelliklerini öğrenmenize ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olmak için adım adım açıklamalı tam çalışan kod örnekleri içerir. + +- [Barcode Nasıl Oluşturulur – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [PDF417 Barcode Nasıl Oluşturulur – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [ITF-14 için Barcode Sessiz Bölgesi Nasıl Oluşturulur – Aspose.BarCode for .NET Kullanarak](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/turkish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..b2390b9b7 --- /dev/null +++ b/barcode/turkish/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Aspose.BarCode ile C#’ta PDF417 barkod oluşturmayı, barkod boyutunu ayarlamayı, + sütunları düzenlemeyi ve kompakt modu etkinleştirmeyi öğrenin. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: tr +lastmod: 2026-08-22 +og_description: C# ile Aspose.BarCode kullanarak PDF417 barkod oluşturun. Bu kılavuz, + barkod boyutunu ayarlamayı, sütunları kontrol etmeyi ve daha küçük bir görüntü için + kompakt modu etkinleştirmeyi gösterir. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: C#'ta PDF417 barkod oluşturma – boyut, sütun ve kompakt modu ayarlama +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: C#'ta PDF417 barkodu nasıl oluşturulur ve barkod boyutu nasıl ayarlanır +url: /tr/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#'ta PDF417 barkodu nasıl oluşturulur ve barkod boyutu nasıl ayarlanır + +Bir .NET uygulamasında **PDF417 barkodu oluşturmanız** gerekiyorsa, bu kılavuz size sürecin tamamını gösterir. Aspose.BarCode ile **PDF417 nasıl oluşturulur**, **barkod boyutu nasıl ayarlanır** ve raporlara ya da mobil uygulamalara gömülebilecek kompakt bir PNG nasıl üretilir, adım adım göreceksiniz. + +Barkod oluşturmak ayrı bir grafik editörü gerektirmez. Bu öğreticinin sonunda, ihtiyacınız olan tam boyutlarda bir PDF417 resmi üreten, aşağı akışta kullanılmaya hazır tam işlevsel bir C# yönteminize sahip olacaksınız. + +## Öğrenecekleriniz + +* Aspose.BarCode kütüphanesini kurma ve referans ekleme. +* PDF417 barkod üreticisi oluşturma ve kodlanacak metni belirleme. +* X‑dimension ve sütun sayısını yapılandırarak **barkod boyutunu ayarlama**. +* Sembolü küçültmek için kompakt (kısaltılmış) modu etkinleştirme. +* Sonucu PNG dosyası olarak kaydetme. +* Okunamayan kodlar ve aşırı büyük görüntüler gibi yaygın sorunları giderme. + +### Önkoşullar + +* .NET 6.0 veya üzeri (API, .NET Framework 4.6+ ile de çalışır). +* C# ve Visual Studio (veya herhangi bir C# IDE) hakkında temel bilgi. +* Geçerli bir Aspose.BarCode lisansı (ücretsiz değerlendirme sürümü test için yeterlidir). + +> **Pro tip:** Bir döngü içinde birden çok barkod oluşturacaksanız, tek bir `BarcodeGenerator` örneğini yeniden kullanın ve yalnızca `CodeText` özelliğini değiştirin. Bu, bellek tahsislerini azaltır. + +## Aspose.BarCode ile PDF417 barkodu oluşturma + +İlk adım, PDF417 sembolü için `BarcodeGenerator` nesnesini başlatmaktır. Bu nesne, tüm barkod işlemleri için giriş noktasıdır. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Neden önemli*: `EncodeTypes.Pdf417` kütüphaneye PDF417 standardını kullanmasını söyler; bu standart büyük veri hacimleri ve hata düzeltme desteği sunar. Yapıcı ayrıca kodlamak istediğiniz veriyi de alır, böylece daha sonra ayrı bir `CodeText` atamasına gerek kalmaz. + +## Barkod boyutu ve sütun sayısını ayarlama + +PDF417 sembolleri, küçük dikdörtgen modüllerden oluşan satır ve sütunlardan meydana gelir. Modül genişliğini (X‑dimension) ve sütun sayısını kontrol ederek genel boyutları hassas bir şekilde ayarlayabilirsiniz. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Açıklama*: +* **X‑dimension** (`Pixels`) her bir modülün ne kadar geniş olacağını belirler. Daha küçük değerler daha sıkı bir barkod üretirken, daha büyük değerler düşük çözünürlüklü tarayıcılarda okunabilirliği artırır. +* **Columns** yatay yerleşimi kontrol eder. Daha az sütun barkodu daha uzun, daha çok sütun ise daha geniş yapar. Bu iki ayarı birlikte değiştirerek ihtiyacınız olan **barkod boyutunu ayarlamış** olursunuz. + +## Daha küçük bir barkod için kompakt modu etkinleştirme + +PDF417, gereksiz boşlukları kaldıran ve genel alanı azaltan bir “compact” (veya truncated) modu içerir. Bu, ekran alanı sınırlı olduğunda özellikle faydalıdır. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Neden kısaltma etkinleştirilmeli?* +`Truncate` `true` olduğunda, üretici durdurma desenini ve çoğu tarama senaryosu için gerekli olmayan bazı hata‑düzeltme kod kelimelerini atlar. Ortaya çıkan görüntü, veri bütünlüğünden ödün vermeden yaklaşık %15‑20 daha küçüktür. + +## Barkodu PNG olarak kaydetme + +Boyut ve modu yapılandırdıktan sonra barkodu diske yazın. PNG kayıpsızdır, böylece modül kenarları keskin kalır. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +`CompactPdf417.png` dosyası, önceki adımlarda belirlediğiniz boyutlara uyan net bir PDF417 sembolü içerecektir. + +### Beklenen çıktı + +Kaydedilen PNG’yi açtığınızda, her bir modül 2 px genişliğinde olmak üzere üç sütunlu, dikey yönlendirilmiş bir PDF417 barkodu görmelisiniz; toplam boyut yaklaşık **120 × 240 px** (genişlik × yükseklik) olacaktır. Görüntüyü herhangi bir standart PDF417 okuyucu ile taradığınızda, “Sample text for PDF417” metni geri dönecektir. + +## Yaygın tuzaklar ve nasıl önlenir + +| Belirti | Muhtemel neden | Çözüm | +|---------|----------------|------| +| Barkod okunamıyor | Tarayıcı için X‑dimension çok küçük | `XDimension.Pixels` değerini 3 veya 4 yapın | +| Görüntü UI’da çok geniş | Çok fazla sütun ayarlanmış | `Pdf417.Columns` değerini azaltın veya `Truncate` etkinleştirin | +| `ArgumentOutOfRangeException` hatası | Sütun sayısı negatif ya da sıfır | `Columns` değerinin pozitif bir tam sayı (minimum 1) olduğundan emin olun | +| PNG dosyası boş | Çıktı yolu yok ya da yazma izni eksik | Dizin var mı kontrol edin ve uygulamanın yazma izni olduğundan emin olun | + +> **Pro tip:** `Save()` çağırmadan önce `barcodeGenerator.ValidateParameters()` kullanarak yapılandırma hatalarını erken yakalayabilirsiniz. + +## Tam, çalıştırılabilir örnek + +Aşağıda, yukarıdaki tüm adımları içeren bağımsız bir konsol programı yer alıyor. Yeni bir C# projesine kopyalayın, Aspose.BarCode NuGet paketini restore edin ve sonucu görmek için çalıştırın. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Programı çalıştırmak**, çalıştırılabilirin çalışma dizininde `CompactPdf417.png` oluşturur. Görüntüyü bir mobil uygulama (ör. “Barcode Scanner”) ile tarayarak kodlanmış metnin kaynak dizeyle aynı olduğunu doğrulayın. + +## Sonraki adımlar ve ilgili konular + +* **Hata düzeltme seviyesini artırma** – gürültülü taramalarda `Pdf417.ErrorLevel` ayarını değiştirin. +* **Yönlendirmeyi değiştirme** – yatay bir düzen gerekiyorsa `Pdf417.Rotate` değerini `RotationAngle.Rotate90` yapın. +* **Barkodu bir PDF’e gömme** – Aspose.PDF ile Aspose.BarCode’u birleştirerek resmi doğrudan belgeye yerleştirin. +* **Diğer 2‑D barkodları oluşturma** – aynı `BarcodeGenerator` sınıfı DataMatrix, QR ve Aztec kodlarını da destekler; sadece `EncodeTypes.Pdf417` yerine istediğiniz sembolü kullanın. + +**PDF417 barkodu oluşturma** tekniklerini ustalaşarak, biletleme, envanter etiketleme ve güvenli veri iletimi gibi geniş bir .NET uygulama yelpazesinde otomasyonu sağlayabilirsiniz. + +## Sonuç + +Artık C#’ta **PDF417 barkodu nasıl oluşturulur**, **barkod boyutu nasıl tam olarak ayarlanır**, sütunlar nasıl yapılandırılır, kompakt mod nasıl etkinleştirilir ve sonuç PNG olarak nasıl kaydedilir, biliyorsunuz. Bu ayarları herhangi bir UI kısıtlamasına veya tarama gereksinimine uyacak şekilde uygulayın ve gerektiğinde diğer barkod formatlarına da genişletin. Kodlamanın tadını çıkarın! + +## Sonraki Öğrenmeniz Gerekenler + +Aşağıdaki öğreticiler, bu kılavuzda gösterilen tekniklere dayanan ve yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini öğrenmenize ve projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olacak tam çalışan kod örnekleri ve adım adım açıklamalar içerir. + +- [How to Generate PDF417 Barcode – Compact PDF417 Encoding](/barcode/english/net/compact-pdf417-encoding/) +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/turkish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..137c3ceee --- /dev/null +++ b/barcode/turkish/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-08-22 +description: C#'ta PDF417 barkodlarını nasıl okuyacağınızı adım adım bir kılavuzla + öğrenin; bir görüntüden birden fazla barkodu okuma ve MacroPdf417 ayrıntılarını + çıkarma konularını kapsar. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: tr +lastmod: 2026-08-22 +og_description: C#'ta PDF417 barkodlarını hızlıca nasıl okursunuz. Bu öğreticide, + bir görüntüden birden fazla barkodu nasıl okuyacağınızı ve MacroPdf417 genişletilmiş + bilgilerini nasıl alacağınızı gösteriyoruz. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: C#'ta PDF417 barkodlarını nasıl okuyabilirsiniz – tam programlama rehberi +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: C#'ta PDF417 barkodlarını okuma – tam rehber +url: /tr/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# PDF417 barkodlarını C#'ta nasıl okuyabilirsiniz – tam rehber + +Eğer bir .NET uygulamasında **PDF417 barkodlarını nasıl okuyacağınızı** öğrenmeniz gerekiyorsa, bu öğretici size çalıştırmaya hazır bir çözüm sunar. Tek bir görüntüden birden fazla barkodu nasıl okuyacağınızı, tam MacroPdf417 veri kümesini nasıl çıkaracağınızı ve konsolda nasıl görüntüleyeceğinizi öğreneceksiniz. Yaklaşım Aspose.BarCode for .NET kütüphanesiyle çalışır ve sadece birkaç satır kod gerektirir. + +Görüntüden barkod okumak, envanter sistemleri, bilet doğrulama ve belge yönetimi gibi alanlarda yaygın bir görevdir. Bu rehberin sonunda herhangi bir PDF417 veya MacroPdf417 barkodunu çözebilecek, bir resimdeki birden fazla kodu işleyebilecek ve MacroPdf417'nin sağladığı genişletilmiş alanları anlayabileceksiniz. + +## Önkoşullar + +- .NET 6.0 SDK veya daha yenisi (kod ayrıca .NET Framework 4.7+ ile derlenebilir) +- Visual Studio 2022 veya tercih ettiğiniz herhangi bir C# editörü +- Aspose.BarCode for .NET NuGet paketi (`Install-Package Aspose.BarCode`) +- MacroPdf417 barkodu içeren bir örnek görüntü (ör. `MacroPdf417.png`) + +Ek bir yapılandırma gerekmez; kütüphane görüntü yükleme ve çözümlemeyi dahili olarak yönetir. + +## C#'ta bir görüntüden PDF417 barkodlarını nasıl okuyabilirsiniz + +Çözümün çekirdeği `BarCodeReader` sınıfıdır. Görüntüyü açar, belirtilen tipteki tüm barkodları algılar ve bir `BarCodeResult` nesne koleksiyonu döndürür. Aşağıdaki kod tam bir konsol programını gösterir. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Her satırın önemi + +| Adım | Amaç | +|------|------| +| **1️⃣ Initialize** | Bir `BarCodeReader` oluşturur, görüntü dosyasına bağlar ve algılamayı MacroPdf417 sembolojisiyle sınırlar; bu işlem süresini hızlandırır. | +| **2️⃣ Iterate** | `ReadBarCodes()` istenen türle eşleşen **tüm** barkodları döndürür, böylece ekstra döngüler olmadan **birden fazla barkodu okuyabilirsiniz**. | +| **3️⃣ Basic output** | Genel `CodeTypeName` ve insan tarafından okunabilir `CodeText` değerlerini gösterir. Bu, günlük kaydı veya hızlı doğrulama için faydalıdır. | +| **4️⃣ Extended data** | MacroPdf417, ek meta veriler (dosya kimliği, segment sayısı, zaman damgaları vb.) taşır. `Extended.Pdf417` nesnesi her alanı doğrudan ortaya çıkarır, böylece tüm veri paketini saklayabilir veya doğrulayabilirsiniz. | + +Programı geçerli bir MacroPdf417 görüntüsüyle çalıştırdığınızda aşağıdaki gibi bir konsol çıktısı alırsınız: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Çıktı, kütüphanenin barkodu başarıyla okuduğunu, metni çıkardığını ve her MacroPdf417 alanını sağladığını doğrular. + +## Tek bir görüntüden birden fazla barkod okuma + +Gerçek dünyada birçok senaryo, bir etiket üzerinde birkaç PDF417 sembolü bulundurur—örneğin bir taşıyıcı kodu, bir takip numarası ve bir gümrük beyanı içeren bir gönderi manifestosu. Yukarıdaki aynı kod bloğu zaten **birden fazla barkodu okur**, çünkü `ReadBarCodes()` tüm eşleşmeleri dönen bir enumerable sağlar. Ek bir yapılandırma gerekmez; sadece sonuçlar üzerinden döngü yapmanız yeterlidir, örnek gösterildiği gibi. + +Okuyucuyu standart PDF417 (makro olmayan) ile sınırlamak ve yine birden fazla kodu işlemek isterseniz, `DecodeType.MacroPdf417` yerine `DecodeType.Pdf417` kullanın. Mantığın geri kalanı değişmeden kalır. + +## MacroPdf417 genişletilmiş verilerini anlama + +MacroPdf417, normal PDF417 spesifikasyonunun bir uzantısıdır. Büyük veri yüklerini birden fazla segmente ayırır ve tüm dosyayı tanımlayan küçük bir başlık ekler. En ilgili alanlar şunlardır: + +- **MacroPdf417FileID** – aynı dosyanın tüm segmentleri tarafından paylaşılan benzersiz bir tanımlayıcı. +- **MacroPdf417SegmentID** – mevcut segmentin sıra numarası. +- **MacroPdf417SegmentsCount** – beklenen toplam segment sayısı. +- **MacroPdf417FileName** – barkodla iletilen isteğe bağlı dosya adı. +- **MacroPdf417Checksum** – tam dosya için hata kontrol değeri. +- **MacroPdf417FileSize** – orijinal ikili veri yükünün boyutu. +- **MacroPdf417TimeStamp** – barkodun oluşturulduğu ISO‑8601 zaman damgası. +- **MacroPdf417Addressee / Sender** – yönlendirme için isteğe bağlı metin alanları. +- **MacroPdf417Terminator** – bu segmentin son segment olup olmadığını gösterir. + +Tüm segmentleri aldığınızda, `MacroPdf417SegmentID` değerine göre sıralayıp `CodeText` değerlerini birleştirerek orijinal dosyayı yeniden oluşturabilirsiniz. Alanlar elinizde olduğunda bu mantık uygulanması oldukça basittir. + +## Yaygın tuzaklar ve profesyonel ipuçları + +- **Image quality matters** – düşük çözünürlüklü veya aşırı sıkıştırılmış PNG/JPEG dosyaları algılamada kaçırmalara yol açabilir. Baskılı barkodlar için en az 300 dpi DPI kullanın. +- **Mixed symbologies** – görüntü hem MacroPdf417 hem de normal PDF417 içeriyorsa, iki ayrı okuyucu (her `DecodeType` için bir tane) oluşturun veya `DecodeType.AllSupported` kullanıp sonuçları `result.CodeTypeName` ile filtreleyin. +- **Memory usage** – `using` ifadesi `BarCodeReader`'ı hızlı bir şekilde dispose eder, büyük görüntü tamponlarının bellekte kalmasını önler. +- **Thread safety** – `BarCodeReader` thread‑safe değildir. Görüntüleri paralel olarak çözümlüyorsanız her thread için ayrı bir örnek oluşturun. +- **Error handling** – `ReadBarCodes()` çağrısını bir try/catch bloğuna sararak bozuk görüntüler için `BarCodeException` yakalayın. + +## Tam çalışan örnek özeti + +Aşağıda yeni bir konsol projesine kopyalayabileceğiniz tam program yer alıyor. Tüm `using` yönergelerini, görüntü yolu için bir sabiti ve disposal desenini içerir. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +`dotnet build` ile derleyin ve `dotnet run` ile çalıştırın. Konsol, her barkodun temel verilerini ve tam MacroPdf417 yükünü yazdırır. + +## Sonraki adımlar + +- **Reconstruct multipart files** – tüm segmentleri toplayın, `MacroPdf417SegmentID`'ye göre sıralayın ve `CodeText`'i birleştirin + +## Sonra Ne Öğrenmelisiniz? + +Aşağıdaki öğreticiler, bu rehberde gösterilen tekniklere dayanarak yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini ustalaşmanıza ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olacak tam çalışan kod örnekleri ve adım adım açıklamalar içerir. + +- [PDF417 Barkodu Nasıl Oluşturulur – Kompakt PDF417 Kodlaması](/barcode/english/net/compact-pdf417-encoding/) +- [Java'da Türkçe Karakterli PDF417 Barkodlarını Nasıl Okursunuz](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Java'da PDF417 Barkodu (Çince) için Aspose Nasıl Kullanılır](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/turkish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..b69934751 --- /dev/null +++ b/barcode/turkish/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,224 @@ +--- +category: general +date: 2026-08-22 +description: Barcode generator C# öğreticisi, Aspose.BarCode kullanarak meta veriler + içeren bir Macro PDF417 barkodu oluşturmayı ve PNG olarak kaydetmeyi gösterir. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: tr +lastmod: 2026-08-22 +og_description: C# barkod üreticisi, tam dosya düzeyinde meta verilerle bir Macro + PDF417 barkodu oluşturmanıza ve PNG olarak dışa aktarmanıza olanak tanır. Çözümü + uygulamak için bu kılavuzu izleyin. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: C# barkod oluşturucu – Macro PDF417 barkodlarını adım adım oluşturun +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Macro PDF417 için C# barkod oluşturucusunu nasıl kullanılır +url: /tr/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Macro PDF417 için C# barkod üreteci nasıl kullanılır + +Eğer dosya‑seviyesi meta verileriyle bir Macro PDF417 sembolü üretebilen **barcode generator C#**'a ihtiyacınız varsa, bu rehber eksiksiz, çalıştırmaya hazır bir çözüm sunar. Barkod görünümünü nasıl yapılandıracağınızı, dosya kimliği ve segment sayısı gibi makro bilgileri nasıl gömeceğinizi ve sonunda sonucu bir PNG görüntüsü olarak nasıl kaydedeceğinizi göreceksiniz. + +Örnek, tam PDF417 özellik setini destekleyen yaygın olarak kullanılan **C# barcode library** Aspose.BarCode kütüphanesini kullanır. Harici hizmetlere gerek yoktur ve kod .NET 6 veya daha yeni sürümlerle çalışır. + +## Önkoşullar + +* .NET 6 SDK (veya daha yeni bir sürüm) yüklü. +* Visual Studio 2022, VS Code veya başka bir C# IDE. +* **Aspose.BarCode**'e bir NuGet referansı (`dotnet add package Aspose.BarCode`). + +Temel C# sözdizimini ve PDF417 barkodları kavramını anlamak adımları takip etmenize yardımcı olur, ancak öğretici her yapılandırma seçeneğini ayrıntılı olarak açıklar. + +## Öğreticinin kapsadığı konular + +* Macro PDF417 formatı için bir **barcode generator C#** örneği başlatma. +* X‑dimension ve sütun sayısı gibi görsel parametreleri ayarlama. +* Macro PDF417 dosya‑seviyesi alanlarını sağlama: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender ve terminator. +* Oluşturulan sembolü PNG dosyası olarak kaydetme. +* Büyük dosya boyutları veya özel zaman damgaları gibi uç durumları ele alma ipuçları. + +Bu makalenin sonunda, tam uyumlu bir Macro PDF417 barkodu üreten bağımsız bir programınız olacak. + +## Adım 1: barcode generator C# örneğini oluşturma + +İlk işlem, `BarcodeGenerator`'ı `EncodeTypes.MacroPdf417` enum değeri ve kodlamak istediğiniz metinle örneklemektir. Yapıcı ayrıca yük (payload) dizesini kabul eder; bu, makro barkodun veri bölümünü oluşturur. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Neden önemli** – `EncodeTypes.MacroPdf417` bayrağı, Aspose.BarCode'a sembolü bir makro barkod olarak ele almasını söyler ve ardından gelen ek alanları etkinleştirir. Bu bayrak olmadan kütüphane, dosya‑seviyesi meta verileri olmayan normal bir PDF417 barkodu üretir. + +## Adım 2: temel barkod görünümünü ayarlama (PDF417 görsel ayarları) + +Görsel netlik, güvenilir tarama için çok önemlidir. Yaygın iki parametre modül genişliği (`XDimension`) ve sütun sayısıdır. Bu değerleri ayarlamak, boyut ve okunabilirlik arasında denge kurar. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +- `XDimension.Pixels`, her siyah/beyaz çubuğun genişliğini kontrol eder. **2** değeri çoğu etiket yazıcısı için iyi çalışır. +- `Pdf417.Columns`, barkodun kullanacağı sütun sayısını tanımlar. Beş sütun, veri kapasitesinden ödün vermeden kompakt bir sembol üretir. + +## Adım 3: Macro PDF417 dosya‑seviyesi bilgilerini tanımlama + +Macro PDF417, büyük bir dosyanın birden fazla barkod segmentine nasıl bölündüğünü tanımlayan alanlarla standart PDF417 formatını genişletir. Bu alanları sağlamak, sonraki tarayıcıların orijinal dosyayı yeniden oluşturmasını garanti eder. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +- `MacroPdf417FileID`, aynı mantıksal dosyaya ait her segment için aynı olmalıdır. +- `MacroPdf417SegmentID`, **0**'dan `SegmentsCount‑1`'e kadar artar. +- `MacroPdf417SegmentsCount`, çözücüye kaç parça beklemesi gerektiğini söyler. +- `MacroPdf417FileName` isteğe bağlıdır ancak insan tarafından okunabilir tanımlama için faydalıdır. + +## Adım 4: ek makro meta verilerini ayarlama + +Temel dosya bilgilerinin ötesinde, spesifikasyon checksum, dosya boyutu, zaman damgası, alıcı, gönderici ve bir terminatör bayrağı gibi ekstra alanlara izin verir. Bu alanları doldurmak veri bütünlüğünü ve izlenebilirliği artırır. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +- `MacroPdf417Checksum`, tüm dosya için 16‑bit CCITT checksum sağlar; çözücü, yeniden yapılandırmadan sonra bütünlüğü doğrulayabilir. +- `MacroPdf417FileSize`, orijinal dosyanın tam bayt sayısını yansıtmalıdır; `2^31‑1`'den büyük değerler 64‑bit alan gerektirir, Aspose bunu otomatik olarak yönetir. +- `MacroPdf417TimeStamp`, barkodun ne zaman üretildiğini kaydeder. Saat dilimi belirsizliğinden kaçınmak için UTC kullanın. +- `MacroPdf417Addressee` ve `MacroPdf417Sender`, yönlendirme bilgisi depolayabilen serbest metin dizeleridir. +- `MacroPdf417Terminator`, bunun son segment olduğunu işaret eder; son parça için `Set` olarak ayarlayın, aksi takdirde varsayılanı (`NotSet`) bırakın. + +**Uç‑durum ipucu** – Dosya boyutunuz 4 GB'yi aşarsa, içeriği birden fazla makro segmente bölün ve `SegmentsCount`'i buna göre ayarlayın. Kütüphane, büyük‑boyut alanını taşma olmadan yönetir. + +## Adım 5: barkodu PNG görüntüsü olarak kaydetme + +Son adım, oluşturulan sembolü diske yazmaktır. PNG, tam piksel boyutlarını korur ve tarama donanımları tarafından geniş çapta desteklenir. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +`YOUR_DIRECTORY`'yi, çalıştıran işlemin yazabileceği mutlak ya da göreli bir yol ile değiştirin. `BarCodeImageFormat.Png` enumu kayıpsız çıktı sağlar. + +**Neden PNG?** – PNG gibi raster formatlar modül kenarlarını keskin tutar; bu, yüksek‑kontrast kenarlara dayanan tarayıcılar için çok önemlidir. Vektör formatına ihtiyacınız varsa, Aspose ayrıca `Pdf` ve `Svg`'yi destekler. + +## Tam çalıştırılabilir örnek + +Aşağıda, bir konsol uygulamasına kopyalayabileceğiniz tam program yer almaktadır. Gerekli `using` yönergelerini ve bir `Main` metodunu içerir. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Beklenen çıktı + +Programı çalıştırmak, projenin çalışma dizininde **MacroPdf417.png** adlı bir dosya oluşturur. Görüntüyü açtığınızda gömülü makro alanlarıyla kompakt bir PDF417 barkodu görürsünüz. Görüntüyü PDF417‑uyumlu bir okuyucu (ör. ZXing, Aspose.BarCode decoder) ile taradığınızda, orijinal `"Sample text"` yükü ve makro meta verileri döndürülür. + +## Yaygın sorular ve sorun giderme + +| Soru | Cevap | +|----------|--------| +| *Etiket hedefi için barkod çok büyük olursa ne olur?* | `XDimension.Pixels` değerini azaltın veya `Pdf417.Columns` değerini artırın. Her iki parametre de toplam boyutu etkiler. | +| *PNG yerine vektör görüntüsü üretebilir miyim?* | Evet. Ölçeklenebilir çıktı için `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` çağrısını yapın. | +| *Tarama sonrası checksum nasıl doğrulanır?* | Aspose.BarCode çözücüsü, `MacroPdf417Checksum`'i otomatik olarak doğrular ve `MacroPdf417Result` nesnesinde uyumsuzlukları rapor eder. | +| *Kütüphane .NET Core ile uyumlu mu?* | NuGet paketi, .NET Standard 2.0+’ı destekler; bu da .NET Core, .NET 5, .NET 6 ve sonrası sürümleri kapsar. | +| *Metin yerine ikili veri gömmem gerekirse ne olur?* | İkili yükü Base64’e dönüştürün veya bir bayt dizisi kabul eden `EncodeTypes.MacroPdf417` aşırı yüklemesini kullanın. | + +## Üretim kullanımı için profesyonel ipuçları + +* **Cache the generator** – + +## Sonra Ne Öğrenmelisiniz? + +Aşağıdaki öğreticiler, bu rehberde gösterilen tekniklere dayanan ve yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini ustalaşmanıza ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olacak adım adım açıklamalar içeren tam çalışan kod örnekleri sunar. + +- [Barkod Nasıl Oluşturulur – Aspose.BarCode ile Compact PDF417](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Java’da Aspose.BarCode Kullanarak PDF’den Barkod Okuma](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Aspose.Barcode ile Codabar Barkodu Oluşturma – Üreteç ve Okuyucu API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/_index.md index 54c5c8834..f25887e5f 100644 --- a/barcode/vietnamese/net/compact-pdf417-encoding/_index.md +++ b/barcode/vietnamese/net/compact-pdf417-encoding/_index.md @@ -49,7 +49,7 @@ schemas: question: Do I need to install any additional fonts or resources? type: FAQPage second_title: Aspose.BarCode .NET API -title: Cách tạo mã vạch PDF417 – Mã hoá PDF417 Compact +title: Cách tạo mã vạch PDF417 – Mã Hoá PDF417 Compact url: /vi/net/compact-pdf417-encoding/ weight: 29 --- @@ -144,6 +144,21 @@ Mật độ dữ liệu cao và khả năng sửa lỗi mạnh mẽ của Compac ### [Tạo mã vạch Compact PDF417](./compact-pdf417-basic-configuration/) Tìm hiểu cách tạo mã vạch Compact PDF417 bằng Aspose.BarCode cho .NET. Hướng dẫn toàn diện với các bước chi tiết và ví dụ mã. +### [Cách tạo mã vạch PDF417 trong C# và đặt kích thước mã vạch](./how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/) +Hướng dẫn tạo mã vạch PDF417 bằng C# và tùy chỉnh kích thước mã vạch với Aspose.BarCode. + +### [Cách tạo mã vạch micro PDF417 trong C# – hướng dẫn từng bước](./how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/) +Hướng dẫn chi tiết cách tạo mã vạch micro PDF417 bằng C# với Aspose.BarCode, bao gồm cấu hình và lưu ảnh. + +### [Cách sử dụng trình tạo mã vạch C# cho Macro PDF417](./how-to-use-a-barcode-generator-c-for-macro-pdf417/) +Hướng dẫn sử dụng BarcodeGenerator trong C# để tạo mã vạch Macro PDF417 với Aspose.BarCode. + +### [Cách đọc mã vạch PDF417 trong C# – hướng dẫn đầy đủ](./how-to-read-pdf417-barcodes-in-c-complete-guide/) +Hướng dẫn chi tiết cách đọc mã vạch PDF417 bằng C# sử dụng Aspose.BarCode, bao gồm cấu hình và ví dụ thực tế. + +### [Cách tạo mã vạch PDF417 trong C# và lưu dưới dạng PNG](./how-to-create-pdf417-barcode-in-c-and-save-it-as-png/) +Hướng dẫn tạo mã vạch PDF417 bằng C# và lưu ảnh PNG sử dụng Aspose.BarCode. + ## Câu hỏi thường gặp **H: Compact PDF417 có thể lưu trữ tối đa bao nhiêu dữ liệu?** diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md new file mode 100644 index 000000000..d02591e6f --- /dev/null +++ b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/_index.md @@ -0,0 +1,213 @@ +--- +category: general +date: 2026-08-22 +description: Tìm hiểu cách tạo mã vạch micro PDF417 bằng C# và tạo hình ảnh PNG cho + mã vạch. Bao gồm việc thiết lập kích thước mã vạch và lưu tệp. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create micro pdf417 barcode +- how to generate barcode png +- create barcode image c# +- how to set barcode dimensions +language: vi +lastmod: 2026-08-22 +og_description: Tạo mã vạch micro PDF417 bằng C# và xuất ra dạng PNG. Tham khảo hướng + dẫn này để thiết lập kích thước mã vạch và nhanh chóng tạo hình ảnh mã vạch. +og_image_alt: Screenshot of a micro PDF417 barcode generated with C# code +og_title: Tạo mã vạch micro PDF417 bằng C# – hướng dẫn lập trình đầy đủ +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + headline: How to create micro PDF417 barcode in C# – step‑by‑step guide + type: TechArticle +- description: Learn how to create micro PDF417 barcode in C# and generate a barcode + PNG image. Includes setting barcode dimensions and saving the file. + name: How to create micro PDF417 barcode in C# – step‑by‑step guide + steps: + - name: 'Build the project: `dotnet build`.' + text: 'Build the project: `dotnet build`.' + - name: 'Execute: `dotnet run`.' + text: 'Execute: `dotnet run`.' + - name: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + text: Open `MicroPdf417.png` on your desktop and scan it with a mobile barcode + scanner app. + type: HowTo +tags: +- barcode +- C# +- MicroPdf417 +- image generation +title: Cách tạo mã vạch micro PDF417 trong C# – hướng dẫn từng bước +url: /vi/net/compact-pdf417-encoding/how-to-create-micro-pdf417-barcode-in-c-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách tạo mã vạch micro PDF417 trong C# – hướng dẫn từng bước + +Nếu bạn cần **tạo mã vạch micro PDF417** cho hệ thống bán vé, nhãn hàng tồn kho hoặc quét trên thiết bị di động, hướng dẫn này sẽ chỉ cho bạn cách thực hiện. Bạn sẽ thấy chương trình C# đầy đủ tạo ra ảnh PNG của mã vạch, học cách đặt kích thước mã vạch và hiểu mỗi tùy chọn cấu hình. + +Khi kết thúc hướng dẫn này, bạn sẽ có thể tạo ra hình ảnh mã vạch độ phân giải cao, tùy chỉnh X‑dimension, chọn số cột và lưu kết quả dưới dạng tệp PNG—tất cả chỉ với vài dòng mã. + +## Những gì bạn cần + +- .NET 6.0 SDK hoặc phiên bản mới hơn (mã này hoạt động với .NET Core và .NET Framework) +- Visual Studio 2022 hoặc bất kỳ IDE nào hỗ trợ C# +- Gói NuGet **Aspose.BarCode for .NET** (hoặc bất kỳ thư viện nào hỗ trợ `EncodeTypes.MicroPdf417`) +- Kiến thức cơ bản về cú pháp C# + +> **Mẹo:** Phiên bản cộng đồng miễn phí của Aspose.BarCode đủ cho việc phát triển và thử nghiệm. Đối với môi trường sản xuất, hãy mua giấy phép để loại bỏ watermark đánh giá. + +## Bước 1: Cài đặt thư viện mã vạch + +Mở terminal trong thư mục dự án của bạn và chạy: + +```bash +dotnet add package Aspose.BarCode +``` + +Lệnh này sẽ thêm assembly `Aspose.BarCode`, cung cấp lớp `BarcodeGenerator` được sử dụng để **tạo ảnh mã vạch C#** trong các ứng dụng. + +## Bước 2: Khởi tạo trình tạo – tạo mã vạch micro PDF417 + +Dòng lệnh đầu tiên tạo một thể hiện `BarcodeGenerator` được cấu hình cho ký hiệu Micro PDF417 và cung cấp dữ liệu bạn muốn mã hoá. + +```csharp +using Aspose.BarCode.Generation; +using Aspose.BarCode; + +class Program +{ + static void Main() + { + // Step 2: Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); +``` + +*Tại sao điều này quan trọng*: Enum `EncodeTypes.MicroPdf417` chỉ cho thư viện sử dụng phiên bản gọn của PDF417, phù hợp cho các nhãn nhỏ và màn hình di động. + +## Bước 3: Cách đặt kích thước mã vạch trong C# + +Tinh chỉnh độ rộng mô-đun (X‑dimension) kiểm soát mật độ hiển thị của mã vạch. Giá trị nhỏ hơn tạo ra hình ảnh sắc nét hơn, trong khi giá trị lớn hơn giúp mã vạch dễ quét hơn từ khoảng cách xa. + +```csharp + // Step 3: Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; +``` + +> **Tại sao bạn nên đặt kích thước**: Nếu không điều chỉnh X‑dimension, giá trị mặc định có thể tạo ra mã vạch mờ khi hiển thị ở DPI cao. Đặt nó thành 2 pixel là sự cân bằng tốt cho hầu hết các lần quét trên màn hình. + +## Bước 4: Chọn số cột – kiểm soát chiều rộng mã vạch + +Micro PDF417 cho phép từ 1 đến 4 cột. Nhiều cột hơn sẽ nén dữ liệu theo chiều ngang, giảm chiều rộng tổng thể của ảnh. + +```csharp + // Step 4: Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; +``` + +*Trường hợp đặc biệt*: Nếu bạn yêu cầu 5 cột, thư viện sẽ ném ra ngoại lệ `ArgumentOutOfRangeException`. Luôn giữ trong phạm vi được tài liệu chỉ định. + +## Bước 5: Cách tạo PNG cho mã vạch – lưu ảnh + +Bây giờ bạn có thể xuất mã vạch đã tạo ra thành tệp PNG. PNG giữ nguyên chất lượng không mất dữ liệu, điều này rất quan trọng cho việc quét đáng tin cậy. + +```csharp + // Step 5: Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + Console.WriteLine($"Barcode saved to {outputPath}"); + } +} +``` + +Khi bạn chạy chương trình, sẽ thấy thông báo trên console xác nhận vị trí tệp. Tệp `MicroPdf417.png` tạo ra sẽ trông như sau: + +![Ảnh chụp màn hình hiển thị mã vạch micro PDF417 được tạo bằng C#](micro-pdf417-example.png "Mã vạch micro PDF417 đã tạo") + +*Văn bản thay thế hình ảnh*: **mã vạch micro PDF417 được tạo bằng C#** – minh họa kết quả cuối cùng sau khi áp dụng các thiết lập kích thước và số cột. + +## Bước 6: Chạy và xác minh đầu ra + +1. Xây dựng dự án: `dotnet build`. +2. Thực thi: `dotnet run`. +3. Mở `MicroPdf417.png` trên máy tính để bàn và quét bằng ứng dụng quét mã vạch trên điện thoại di động. + +Bạn sẽ thấy văn bản **“Sample text”** được giải mã. Nếu trình quét báo lỗi, hãy kiểm tra lại X‑dimension và số cột – các giá trị cực đoan có thể làm cho mã vạch quá dày đối với một số thiết bị. + +## Các biến thể thường gặp và khắc phục sự cố + +| Tình huống | Điều chỉnh | +|-----------|------------| +| **Cần mã vạch lớn hơn cho máy in độ phân giải thấp** | Tăng `XDimension.Pixels` lên 3 hoặc 4. | +| **Muốn mã vạch cao hơn mà không thay đổi chiều rộng** | Đặt `generator.Parameters.Barcode.Pdf417.Rows` (phạm vi hàng 3‑90). | +| **Tạo nhiều mã vạch trong vòng lặp** | Tái sử dụng cùng một thể hiện `BarcodeGenerator` và chỉ thay đổi `CodeText` trước mỗi lần `Save`. | +| **Lưu dưới dạng JPEG thay vì PNG** | Thay thế `BarCodeImageFormat.Png` bằng `BarCodeImageFormat.Jpeg`. | +| **Chạy trên .NET Framework 4.7** | Mã giống nhau vẫn hoạt động; chỉ cần tham chiếu tới `Aspose.BarCode.dll` phù hợp. | + +## Danh sách mã nguồn đầy đủ (có thể chạy) + +```csharp +using System; +using System.IO; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MicroPdf417Demo +{ + class Program + { + static void Main() + { + // Initialize a Micro PDF417 barcode generator with the data to encode + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Sample text"); + + // Set the X‑dimension (module width) to 2 pixels for finer resolution + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Define the number of columns (allowed values: 1‑4) + generator.Parameters.Barcode.Pdf417.Columns = 4; + + // Save the generated barcode as a PNG image + string outputPath = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.Desktop), + "MicroPdf417.png"); + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"Barcode saved to {outputPath}"); + } + } +} +``` + +**Kết quả mong đợi** – một tệp PNG kích thước 200 × 100 pixel chứa mã vạch Micro PDF417 sắc nét, giải mã thành “Sample text”. + +## Kết luận + +Bây giờ bạn đã biết cách **tạo mã vạch micro PDF417** trong C#, **đặt kích thước mã vạch**, và **tạo ảnh PNG cho mã vạch**. Ví dụ đầy đủ minh họa mọi bước cần thiết—từ cài đặt thư viện đến lưu tệp cuối cùng—để bạn có thể nhúng việc tạo mã vạch trực tiếp vào ứng dụng của mình. + +Tiếp theo, hãy khám phá các chủ đề liên quan như **tạo mã QR với Aspose.BarCode**, **tùy chỉnh màu sắc**, hoặc **nhúng mã vạch vào tài liệu PDF**. Mỗi chủ đề đều dựa trên các nguyên tắc cơ bản của `BarcodeGenerator` đã được trình bày ở đây. + +Bạn có thể thoải mái thử nghiệm với các chuỗi dữ liệu khác nhau, số cột và giá trị X‑dimension để phù hợp với môi trường quét của mình. Chúc lập trình vui vẻ! + +## Bạn nên học gì tiếp theo? + +Các hướng dẫn sau đây bao gồm các chủ đề liên quan chặt chẽ, dựa trên các kỹ thuật được trình bày trong hướng dẫn này. Mỗi tài nguyên đều có ví dụ mã đầy đủ hoạt động kèm theo giải thích từng bước để giúp bạn nắm vững các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [Cách tạo mã vạch – PDF417 Compact với Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cách tạo mã vạch PDF417 – Mã hoá PDF417 Compact](/barcode/english/net/compact-pdf417-encoding/) +- [Cách tạo mã vạch Aztec với Aspose.BarCode cho .NET](/barcode/english/net/aztec-barcode-encoding/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md new file mode 100644 index 000000000..2c81c99be --- /dev/null +++ b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/_index.md @@ -0,0 +1,201 @@ +--- +category: general +date: 2026-08-22 +description: Tìm hiểu cách tạo mã vạch PDF417 trong C# bằng trình tạo mã vạch, thiết + lập bố cục và lưu dưới dạng PNG. Bao gồm mã đầy đủ và các mẹo cho các dự án trình + tạo mã vạch C#. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- create PDF417 barcode +- barcode generator C# +- how to save PNG +- how to generate PDF417 +language: vi +lastmod: 2026-08-22 +og_description: Tạo mã vạch PDF417 trong C# bằng trình tạo mã vạch, tùy chỉnh bố cục + và học cách lưu dưới dạng PNG. Thực hiện theo hướng dẫn từng bước này. +og_image_alt: Screenshot of a generated PDF417 barcode saved as a PNG file +og_title: Tạo mã vạch PDF417 trong C# – hướng dẫn đầy đủ về cách tạo và lưu PNG +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to create PDF417 barcode in C# with a barcode generator, + set layout, and save PNG. Includes full code and tips for barcode generator C# + projects. + headline: How to create PDF417 barcode in C# and save it as PNG + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cách tạo mã vạch PDF417 trong C# và lưu dưới dạng PNG +url: /vi/net/compact-pdf417-encoding/how-to-create-pdf417-barcode-in-c-and-save-it-as-png/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách tạo mã vạch PDF417 trong C# và lưu dưới dạng PNG + +Nếu bạn cần **tạo mã vạch PDF417** trong một ứng dụng C#, hướng dẫn này sẽ chỉ cho bạn các bước chi tiết. Bạn sẽ thấy cách một thư viện tạo mã vạch C# có thể chuyển bất kỳ chuỗi nào thành ảnh PDF417 có thể quét được và cách lưu file PNG mà không cần công cụ bổ sung. + +Việc tạo mã vạch thường gặp trong logistics, bán vé và quản lý tài liệu. Khi kết thúc hướng dẫn này, bạn sẽ có một chương trình console có thể chạy được, tạo ra file PNG có tên `Pdf417Layout.png` trong thư mục bạn chọn. + +## Yêu cầu trước + +Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có: + +- .NET 6.0 SDK hoặc phiên bản mới hơn được cài đặt (mã cũng hoạt động với .NET Framework 4.7+). +- Visual Studio 2022 hoặc bất kỳ trình soạn thảo nào có thể biên dịch dự án C#. +- Gói NuGet **Aspose.BarCode for .NET** (hoặc bất kỳ thư viện tạo mã vạch C# tương thích nào). + Cài đặt bằng lệnh: + +```bash +dotnet add package Aspose.BarCode +``` + +Không cần thư viện xử lý ảnh bổ sung vì trình tạo có thể ghi PNG trực tiếp. + +## Bước 1: Thiết lập dự án console mới + +Tạo một dự án console mới để ví dụ được tự chứa. + +```bash +dotnet new console -n Pdf417Demo +cd Pdf417Demo +dotnet add package Aspose.BarCode +``` + +Thư mục `Pdf417Demo` hiện có file `Program.cs` nơi chúng ta sẽ viết mã tạo mã vạch. + +## Bước 2: Nhập không gian tên barcode + +Mở `Program.cs` và thêm chỉ thị `using` cần thiết ở đầu file: + +```csharp +using Aspose.BarCode.Generation; +``` + +Không gian tên này cung cấp cho bạn quyền truy cập vào `BarcodeGenerator`, `EncodeTypes` và enum định dạng ảnh cần thiết cho **cách lưu PNG**. + +## Bước 3: Tạo trình tạo mã vạch PDF417 + +Cốt lõi của **cách tạo PDF417** là lớp `BarcodeGenerator`. Truyền kiểu mã `EncodeTypes.Pdf417` và chuỗi bạn muốn mã hoá. + +```csharp +// Step 3: Create a PDF417 barcode generator with the desired text +BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); +``` + +`generator` hiện chứa tất cả các thiết lập cho mã vạch. Bố cục mặc định hoạt động, nhưng chúng ta sẽ tùy chỉnh ở bước tiếp theo. + +## Bước 4: Định nghĩa bố cục mã vạch (cột và hàng) + +PDF417 cho phép bạn kiểm soát số cột (2‑30) và số hàng (1‑90). Điều chỉnh các giá trị này có thể cải thiện khả năng đọc cho các máy quét cụ thể. + +```csharp +// Step 4a: Set the number of columns (2‑30 allowed) +generator.Parameters.Barcode.Pdf417.Columns = 4; + +// Step 4b: Set the number of rows (1‑90 allowed) +generator.Parameters.Barcode.Pdf417.Rows = 9; +``` + +> **Mẹo chuyên nghiệp:** Nếu bạn bỏ qua các thiết lập này, thư viện sẽ tự động chọn giá trị tối ưu. Tuy nhiên, cố định số cột và hàng giúp bạn có kích thước ảnh dự đoán được, hữu ích khi nhúng PNG vào PDF hoặc giao diện UI. + +## Bước 5: Lưu mã vạch đã tạo dưới dạng ảnh PNG + +Bây giờ trả lời **cách lưu PNG** bằng cách gọi `Save`. Phương thức này nhận đường dẫn đích và enum định dạng ảnh. + +```csharp +// Step 5: Save the generated barcode as a PNG image +string outputPath = Path.Combine(Environment.CurrentDirectory, "Pdf417Layout.png"); +generator.Save(outputPath, BarCodeImageFormat.Png); +Console.WriteLine($"PDF417 barcode saved to: {outputPath}"); +``` + +File `Pdf417Layout.png` sẽ xuất hiện trong thư mục `bin/Debug/net6.0` của dự án sau khi bạn chạy chương trình. + +## Ví dụ đầy đủ có thể chạy + +Dưới đây là toàn bộ file `Program.cs`. Sao chép vào dự án đã tạo ở **Bước 1** và chạy `dotnet run`. + +```csharp +using System; +using System.IO; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Create a PDF417 barcode generator with the desired text + BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "Sample"); + + // 2️⃣ Define the barcode layout – set columns (2‑30) and rows (1‑90) + generator.Parameters.Barcode.Pdf417.Columns = 4; // 4 columns + generator.Parameters.Barcode.Pdf417.Rows = 9; // 9 rows + + // 3️⃣ Choose the output path and save as PNG + string outputPath = Path.Combine( + Environment.CurrentDirectory, + "Pdf417Layout.png"); + + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"✅ PDF417 barcode created and saved as PNG at:"); + Console.WriteLine(outputPath); + } + } +} +``` + +### Kết quả mong đợi + +Khi chạy chương trình, console sẽ in ra đường dẫn tuyệt đối tới file PNG, và file chứa một mã vạch PDF417 rõ ràng giống như hình dưới đây. + +![tạo ví dụ mã vạch PDF417](image-placeholder.png "Mã vạch PDF417 được lưu dưới dạng PNG") + +Bạn có thể quét PNG bằng bất kỳ máy quét hỗ trợ PDF417 nào (ứng dụng di động, máy đọc phần cứng) để xác nhận rằng văn bản đã mã hoá là `"Sample"`. + +## Xử lý các trường hợp đặc biệt và những lỗi thường gặp + +| Tình huống | Điều cần chú ý | Giải pháp đề xuất | +|-----------|-------------------|-----------------| +| **Giá trị cột/hàng không hợp lệ** | Giá trị ngoài phạm vi 2‑30 (cột) hoặc 1‑90 (hàng) sẽ gây ra `ArgumentException`. | Kiểm tra đầu vào của người dùng trước khi gán, hoặc để thư viện tự chọn mặc định. | +| **Chuỗi đầu vào quá dài** | PDF417 có thể mã hoá tới 1.850 ký tự, nhưng chuỗi rất dài sẽ làm tăng số hàng đáng kể. | Chia dữ liệu thành nhiều mã vạch hoặc sử dụng mức sửa lỗi cao hơn nếu cần. | +| **Quyền truy cập hệ thống tập tin** | Lưu vào thư mục chỉ đọc sẽ ném `UnauthorizedAccessException`. | Ghi vào `Environment.CurrentDirectory` hoặc đường dẫn người dùng có quyền ghi, và xử lý ngoại lệ bằng try/catch. | +| **Thiếu gói NuGet** | Biên dịch thất bại với thông báo “type or namespace name could not be found”. | Đảm bảo `Aspose.BarCode` đã được cài (`dotnet add package Aspose.BarCode`). | + +## Mở rộng ví dụ + +Bây giờ bạn đã biết **cách tạo mã vạch PDF417** và **cách lưu PNG**, bạn có thể khám phá các chủ đề liên quan sau: + +- **Barcode generator C#**: Thay đổi `EncodeTypes` thành `Code128`, `QR`, hoặc các symbology khác. +- **Màu sắc tùy chỉnh**: Sử dụng `generator.Parameters.Barcode.ForegroundColor` và `BackgroundColor` để phù hợp với thương hiệu. +- **Nhúng vào PDF**: Kết hợp PNG với thư viện PDF (ví dụ, iText7) để tạo tài liệu có thể in. +- **Dữ liệu động**: Lấy văn bản từ cơ sở dữ liệu hoặc nhập từ người dùng để tạo mã vạch ngay lập tức. + +## Kết luận + +Bạn đã có một giải pháp hoàn chỉnh, sẵn sàng cho môi trường sản xuất để **tạo mã vạch PDF417** trong C# và lưu kết quả dưới dạng file PNG. Hướng dẫn đã bao quát mọi bước từ thiết lập dự án đến tùy chỉnh bố cục, đồng thời chỉ ra cách tránh các lỗi phổ biến khi sử dụng thư viện tạo mã vạch C#. + +Hãy thoải mái thử nghiệm với các thiết lập cột/hàng, màu sắc, hoặc thậm chí các định dạng mã vạch khác. Nếu gặp vấn đề, hãy quay lại phần **cách tạo PDF417** hoặc khám phá tài liệu của thư viện để biết các tính năng nâng cao. Chúc lập trình vui vẻ! + +## Bạn nên học gì tiếp theo? + +Các hướng dẫn sau đây liên quan chặt chẽ đến các kỹ thuật đã trình bày trong bài viết này. Mỗi tài nguyên bao gồm mã nguồn đầy đủ và các giải thích từng bước để giúp bạn nắm vững các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [Cách tạo mã vạch – PDF417 nén với Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cách tạo mã vạch PDF417 – Mã hoá PDF417 nén](/barcode/english/net/compact-pdf417-encoding/) +- [Cách tạo vùng yên tĩnh cho mã vạch ITF-14 bằng Aspose.BarCode cho .NET](/barcode/english/net/itf-14-barcode-customization/itf-14-barcode-quiet-zone-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md new file mode 100644 index 000000000..81317d72d --- /dev/null +++ b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/_index.md @@ -0,0 +1,200 @@ +--- +category: general +date: 2026-08-22 +description: Tìm hiểu cách tạo mã vạch PDF417 trong C# với Aspose.BarCode, thiết lập + kích thước mã vạch, điều chỉnh các cột và bật chế độ gọn. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate pdf417 barcode +- how to generate pdf417 +- set barcode size +language: vi +lastmod: 2026-08-22 +og_description: Tạo mã vạch PDF417 trong C# với Aspose.BarCode. Hướng dẫn này chỉ + cách đặt kích thước mã vạch, kiểm soát số cột và bật chế độ compact để có hình ảnh + nhỏ hơn. +og_image_alt: Screenshot of a generated PDF417 barcode in C# showing compact mode +og_title: Tạo mã vạch PDF417 trong C# – đặt kích thước, cột và chế độ nén +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn how to generate PDF417 barcode in C# with Aspose.BarCode, set + barcode size, adjust columns, and enable compact mode. + headline: How to generate PDF417 barcode in C# and set barcode size + type: TechArticle +tags: +- pdf417 +- barcode +- csharp +title: Cách tạo mã vạch PDF417 trong C# và đặt kích thước mã vạch +url: /vi/net/compact-pdf417-encoding/how-to-generate-pdf417-barcode-in-c-and-set-barcode-size/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách tạo mã vạch PDF417 trong C# và đặt kích thước mã vạch + +Nếu bạn cần **generate PDF417 barcode** trong một ứng dụng .NET, hướng dẫn này sẽ dẫn bạn qua toàn bộ quá trình. Bạn sẽ thấy chính xác **how to generate PDF417** với Aspose.BarCode, điều chỉnh **set barcode size**, và tạo một PNG nén có thể nhúng vào báo cáo hoặc ứng dụng di động. + +Việc tạo mã vạch không yêu cầu một trình chỉnh sửa đồ họa riêng. Khi kết thúc tutorial này, bạn sẽ có một phương thức C# hoạt động đầy đủ, tạo ra hình ảnh PDF417 với kích thước chính xác bạn cần, sẵn sàng cho quá trình xử lý tiếp theo. + +## Những gì bạn sẽ học + +* Cài đặt và tham chiếu thư viện Aspose.BarCode. +* Tạo một PDF417 barcode generator và chỉ định văn bản được mã hoá. +* **Set barcode size** bằng cách cấu hình X‑dimension và số cột. +* Kích hoạt chế độ compact (truncated) để thu nhỏ ký hiệu. +* Lưu kết quả dưới dạng tệp PNG. +* Xử lý các vấn đề thường gặp như mã không đọc được và hình ảnh quá lớn. + +### Yêu cầu trước + +* .NET 6.0 hoặc mới hơn (API cũng hoạt động với .NET Framework 4.6+). +* Kiến thức cơ bản về C# và Visual Studio (hoặc bất kỳ IDE C# nào). +* Giấy phép Aspose.BarCode hợp lệ (bản dùng thử miễn phí hoạt động cho việc thử nghiệm). + +> **Pro tip:** Nếu bạn dự định tạo nhiều mã vạch trong một vòng lặp, hãy tái sử dụng một thể hiện `BarcodeGenerator` duy nhất và chỉ thay đổi thuộc tính `CodeText`. Điều này giảm việc cấp phát bộ nhớ. + +## Tạo mã vạch PDF417 với Aspose.BarCode + +Bước đầu tiên là khởi tạo `BarcodeGenerator` cho ký hiệu PDF417. Đối tượng này là điểm vào cho tất cả các thao tác mã vạch. + +```csharp +using Aspose.BarCode.Generation; + +// Step 1: Create a PDF417 barcode generator with the desired text +BarcodeGenerator barcodeGenerator = new BarcodeGenerator( + EncodeTypes.Pdf417, // Symbology + "Sample text for PDF417"); // Data to encode +``` + +*Why this matters*: `EncodeTypes.Pdf417` cho thư viện biết sử dụng chuẩn PDF417, hỗ trợ khối lượng dữ liệu lớn và sửa lỗi. Hàm khởi tạo cũng nhận dữ liệu bạn muốn mã hoá, loại bỏ nhu cầu gán `CodeText` riêng sau này. + +## Đặt kích thước mã vạch và số cột + +Các ký hiệu PDF417 bao gồm các hàng và cột của các mô-đun hình chữ nhật nhỏ. Kiểm soát độ rộng mô-đun (X‑dimension) và số cột cho phép bạn tinh chỉnh kích thước tổng thể. + +```csharp +// Step 2: Adjust the module size (X‑dimension) – 2 pixels per module +barcodeGenerator.Parameters.Barcode.XDimension.Pixels = 2; + +// Step 3: Define the number of columns for the PDF417 code +barcodeGenerator.Parameters.Barcode.Pdf417.Columns = 3; +``` + +*Explanation*: +* **X‑dimension** (`Pixels`) xác định độ rộng của mỗi mô-đun. Giá trị nhỏ hơn tạo mã vạch chặt hơn, trong khi giá trị lớn hơn tăng khả năng đọc trên máy quét độ phân giải thấp. +* **Columns** kiểm soát bố cục ngang. Ít cột hơn làm mã vạch cao hơn; nhiều cột hơn làm nó rộng hơn. Điều chỉnh hai thiết lập này cùng nhau để đạt được **set barcode size** chính xác mà bạn cần. + +## Kích hoạt chế độ compact để có mã vạch nhỏ hơn + +PDF417 bao gồm chế độ “compact” (hoặc truncated) loại bỏ phần đệm không cần thiết và giảm diện tích tổng thể. Điều này đặc biệt hữu ích khi bạn có không gian màn hình hạn chế. + +```csharp +// Step 4: Enable compact mode to truncate the barcode data +barcodeGenerator.Parameters.Barcode.Pdf417.Truncate = true; +``` + +*Why enable truncation?* +Khi `Truncate` là `true`, trình tạo bỏ qua mẫu dừng và một số codeword sửa lỗi không cần thiết cho hầu hết các kịch bản quét. Hình ảnh kết quả giảm khoảng 15‑20 % mà không làm mất tính toàn vẹn dữ liệu cho các trường hợp sử dụng thông thường. + +## Lưu mã vạch dưới dạng ảnh PNG + +Sau khi cấu hình kích thước và chế độ, ghi mã vạch ra đĩa. PNG là định dạng không mất dữ liệu, đảm bảo các cạnh mô-đun vẫn sắc nét. + +```csharp +// Step 5: Save the generated barcode as a PNG image +barcodeGenerator.Save( + "YOUR_DIRECTORY/CompactPdf417.png", + BarCodeImageFormat.Png); +``` + +Tệp `CompactPdf417.png` sẽ chứa một ký hiệu PDF417 sắc nét phù hợp với kích thước bạn đã đặt ở các bước trước. + +### Kết quả mong đợi + +Mở PNG đã lưu sẽ hiển thị một mã vạch PDF417 theo chiều dọc gồm ba cột, mỗi mô-đun rộng 2 px, và tổng kích thước khoảng **120 × 240 px** (rộng × cao). Quét hình ảnh bằng bất kỳ trình đọc PDF417 tiêu chuẩn nào sẽ trả về văn bản gốc “Sample text for PDF417”. + +## Những lỗi thường gặp và cách tránh + +| Triệu chứng | Nguyên nhân có thể | Cách khắc phục | +|------------|--------------------|----------------| +| Mã vạch không đọc được | X‑dimension quá nhỏ đối với máy quét | Tăng `XDimension.Pixels` lên 3 hoặc 4 | +| Hình ảnh quá rộng đối với UI | Quá nhiều cột được đặt | Giảm `Pdf417.Columns` hoặc bật `Truncate` | +| Exception `ArgumentOutOfRangeException` | Số cột âm hoặc bằng 0 | Đảm bảo `Columns` là số nguyên dương (tối thiểu 1) | +| Tệp PNG rỗng | Đường dẫn đầu ra không tồn tại hoặc thiếu quyền ghi | Kiểm tra thư mục tồn tại và ứng dụng có quyền ghi | + +> **Pro tip:** Sử dụng `barcodeGenerator.ValidateParameters()` trước khi gọi `Save()` để phát hiện lỗi cấu hình sớm. + +## Ví dụ đầy đủ, có thể chạy + +Dưới đây là một chương trình console tự chứa, bao gồm tất cả các bước ở trên. Sao chép nó vào một dự án C# mới, khôi phục gói NuGet Aspose.BarCode, và chạy để xem kết quả. + +```csharp +using System; +using Aspose.BarCode.Generation; + +namespace Pdf417Demo +{ + class Program + { + static void Main() + { + // Create the generator with the data to encode + var generator = new BarcodeGenerator( + EncodeTypes.Pdf417, + "Sample text for PDF417"); + + // Set module width (X‑dimension) – 2 px per module + generator.Parameters.Barcode.XDimension.Pixels = 2; + + // Choose a small number of columns to keep the barcode compact + generator.Parameters.Barcode.Pdf417.Columns = 3; + + // Enable truncation for a smaller image + generator.Parameters.Barcode.Pdf417.Truncate = true; + + // Optional: validate parameters before saving + generator.ValidateParameters(); + + // Save as PNG + const string outputPath = "CompactPdf417.png"; + generator.Save(outputPath, BarCodeImageFormat.Png); + + Console.WriteLine($"PDF417 barcode saved to {outputPath}"); + } + } +} +``` + +**Running the program** tạo ra `CompactPdf417.png` trong thư mục làm việc của tệp thực thi. Quét hình ảnh bằng một ứng dụng di động (ví dụ, “Barcode Scanner”) để xác nhận rằng văn bản đã mã hoá khớp với chuỗi nguồn. + +## Các bước tiếp theo và các chủ đề liên quan + +* **Increase error correction level** – điều chỉnh `Pdf417.ErrorLevel` cho môi trường có quét nhiễu. +* **Change orientation** – đặt `Pdf417.Rotate` thành `RotationAngle.Rotate90` nếu bạn cần bố cục ngang. +* **Embed the barcode in a PDF** – kết hợp Aspose.PDF với Aspose.BarCode để chèn hình ảnh trực tiếp vào tài liệu. +* **Generate other 2‑D barcodes** – lớp `BarcodeGenerator` tương tự hỗ trợ DataMatrix, QR và Aztec; chỉ cần thay `EncodeTypes.Pdf417` bằng ký hiệu mong muốn. + +Bằng cách thành thạo các kỹ thuật **generate PDF417 barcode**, bạn có thể tự động hoá việc bán vé, dán nhãn tồn kho, và truyền dữ liệu an toàn trên nhiều ứng dụng .NET. + +## Kết luận + +Bây giờ bạn đã biết cách **generate PDF417 barcode** trong C#, chính xác **set barcode size**, cấu hình số cột, bật chế độ compact, và lưu kết quả dưới dạng PNG. Áp dụng các thiết lập này để phù hợp với bất kỳ ràng buộc UI hoặc yêu cầu quét nào, và mở rộng phương pháp sang các định dạng mã vạch khác khi cần. Chúc lập trình vui vẻ! + +## Bạn nên học gì tiếp theo? + +Các tutorial sau đây bao gồm các chủ đề liên quan chặt chẽ, xây dựng trên các kỹ thuật được trình bày trong hướng dẫn này. Mỗi tài nguyên bao gồm các ví dụ mã đầy đủ hoạt động với giải thích từng bước để giúp bạn thành thạo các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [Cách tạo mã vạch PDF417 – Mã hoá PDF417 Compact](/barcode/english/net/compact-pdf417-encoding/) +- [Cách tạo mã vạch – PDF417 Compact với Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [Cách tạo mã vạch DataMatrix bằng Aspose.BarCode cho .NET – Hướng dẫn từng bước](/barcode/english/net/datamatrix-barcode-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md new file mode 100644 index 000000000..6e349fa82 --- /dev/null +++ b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-08-22 +description: Cách đọc mã vạch PDF417 trong C# với hướng dẫn từng bước, bao gồm cách + đọc nhiều mã vạch từ một hình ảnh và trích xuất chi tiết MacroPdf417. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to read pdf417 +- read multiple barcodes +- read barcodes image c# +language: vi +lastmod: 2026-08-22 +og_description: Cách đọc mã vạch PDF417 trong C# nhanh chóng. Hướng dẫn này chỉ cho + bạn cách đọc nhiều mã vạch từ một hình ảnh và truy xuất thông tin mở rộng MacroPdf417. +og_image_alt: Developer console displaying MacroPdf417 barcode details extracted by + C# code +og_title: Cách đọc mã vạch PDF417 trong C# – hướng dẫn lập trình chi tiết +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: How to read PDF417 barcodes in C# with a step‑by‑step guide, covering + how to read multiple barcodes from an image and extract MacroPdf417 details. + headline: How to read PDF417 barcodes in C# – complete guide + type: TechArticle +tags: +- barcode +- C# +- Aspose.BarCode +title: Cách đọc mã vạch PDF417 trong C# – hướng dẫn đầy đủ +url: /vi/net/compact-pdf417-encoding/how-to-read-pdf417-barcodes-in-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách đọc mã vạch PDF417 trong C# – hướng dẫn đầy đủ + +Nếu bạn cần **cách đọc PDF417** trong một ứng dụng .NET, hướng dẫn này cung cấp cho bạn một giải pháp sẵn sàng chạy. Bạn sẽ học cách đọc nhiều mã vạch từ một hình ảnh duy nhất, trích xuất toàn bộ bộ dữ liệu MacroPdf417, và hiển thị chúng trên console. Cách tiếp cận này hoạt động với thư viện Aspose.BarCode cho .NET và chỉ yêu cầu vài dòng mã. + +Đọc mã vạch từ hình ảnh là một nhiệm vụ phổ biến trong hệ thống quản lý tồn kho, xác thực vé, và quản lý tài liệu. Khi kết thúc hướng dẫn này, bạn sẽ có thể giải mã bất kỳ mã vạch PDF417 hoặc MacroPdf417 nào, xử lý nhiều mã trong một hình ảnh, và hiểu các trường mở rộng mà MacroPdf417 cung cấp. + +## Yêu cầu trước + +- .NET 6.0 SDK hoặc phiên bản mới hơn (mã cũng biên dịch được với .NET Framework 4.7+) +- Visual Studio 2022 hoặc bất kỳ trình soạn thảo C# nào bạn thích +- Gói NuGet Aspose.BarCode cho .NET (`Install-Package Aspose.BarCode`) +- Một hình ảnh mẫu chứa mã vạch MacroPdf417 (ví dụ, `MacroPdf417.png`) + +Không cần cấu hình bổ sung; thư viện tự động xử lý việc tải và giải mã hình ảnh. + +## Cách đọc mã vạch PDF417 từ hình ảnh trong C# + +Cốt lõi của giải pháp là lớp `BarCodeReader`. Nó mở hình ảnh, phát hiện tất cả các mã vạch của loại được chỉ định, và trả về một tập hợp các đối tượng `BarCodeResult`. Đoạn mã dưới đây hiển thị một chương trình console hoàn chỉnh. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + // Path to the image that contains one or more MacroPdf417 barcodes + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + // 1️⃣ Initialize the reader for MacroPdf417 barcodes. + // DecodeType.MacroPdf417 tells the engine to look for the extended PDF417 format. + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + // 2️⃣ Iterate over every barcode found in the image. + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + // 3️⃣ Print basic information. + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + // 4️⃣ Access MacroPdf417 extended fields. + // The Extended property contains format‑specific data; for PDF417 it is .Pdf417. + var macro = result.Extended.Pdf417; + + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +### Tại sao mỗi dòng lại quan trọng + +| Bước | Mục đích | +|------|----------| +| **1️⃣ Initialize** | Tạo một `BarCodeReader` liên kết với tệp hình ảnh và giới hạn việc phát hiện chỉ ở ký hiệu MacroPdf417, giúp tăng tốc xử lý. | +| **2️⃣ Iterate** | `ReadBarCodes()` trả về **tất cả** các mã vạch khớp với loại yêu cầu, cho phép bạn **đọc nhiều mã vạch** mà không cần vòng lặp bổ sung. | +| **3️⃣ Basic output** | Hiển thị `CodeTypeName` chung và `CodeText` dễ đọc cho con người. Điều này hữu ích cho việc ghi log hoặc xác thực nhanh. | +| **4️⃣ Extended data** | MacroPdf417 chứa siêu dữ liệu bổ sung (ID tệp, số lượng đoạn, dấu thời gian, v.v.). Đối tượng `Extended.Pdf417` hiển thị mỗi trường trực tiếp, cho phép bạn lưu hoặc xác minh toàn bộ gói dữ liệu. | + +Chạy chương trình với một hình ảnh MacroPdf417 hợp lệ sẽ tạo ra đầu ra console tương tự như dưới đây: + +``` +CodeType: MacroPdf417 +CodeText: https://example.com/document.pdf +Pdf417MacroFileID: 12345678 +Pdf417MacroSegmentID: 1 +Pdf417MacroSegmentsCount: 3 +Pdf417MacroFileName: document.pdf +Pdf417MacroChecksum: 0x9A3F +Pdf417MacroFileSize: 245760 +Pdf417MacroTimeStamp: 2024-07-15T14:32:00Z +Pdf417MacroAddressee: John Doe +Pdf417MacroSender: Acme Corp. +MacroPdf417Terminator: True +---------------------------------------- +``` + +Đầu ra xác nhận rằng thư viện đã đọc thành công mã vạch, trích xuất văn bản, và cung cấp mọi trường của MacroPdf417. + +## Đọc nhiều mã vạch từ một hình ảnh duy nhất + +Nhiều trường hợp thực tế đặt nhiều ký hiệu PDF417 trên một nhãn—ví dụ như một phiếu vận chuyển chứa mã hãng, số theo dõi và tờ khai hải quan. Khối mã ở trên đã **đọc nhiều mã vạch** vì `ReadBarCodes()` trả về một enumerable của tất cả các kết quả phù hợp. Không cần cấu hình bổ sung; bạn chỉ cần lặp qua các kết quả, như đã minh họa. + +Nếu bạn muốn giới hạn trình đọc chỉ ở PDF417 tiêu chuẩn (không macro) trong khi vẫn xử lý nhiều mã, hãy thay thế `DecodeType.MacroPdf417` bằng `DecodeType.Pdf417`. Phần còn lại của logic không thay đổi. + +## Hiểu dữ liệu mở rộng của MacroPdf417 + +MacroPdf417 là một phần mở rộng của chuẩn PDF417 thông thường. Nó chia các tải trọng lớn thành nhiều đoạn và thêm một tiêu đề nhỏ mô tả toàn bộ tệp. Các trường quan trọng nhất bao gồm: + +- **MacroPdf417FileID** – một định danh duy nhất được chia sẻ bởi tất cả các đoạn của cùng một tệp. +- **MacroPdf417SegmentID** – số thứ tự của đoạn hiện tại. +- **MacroPdf417SegmentsCount** – tổng số đoạn dự kiến. +- **MacroPdf417FileName** – tên tệp tùy chọn được truyền cùng mã vạch. +- **MacroPdf417Checksum** – giá trị kiểm tra lỗi cho toàn bộ tệp. +- **MacroPdf417FileSize** – kích thước của tải trọng nhị phân gốc. +- **MacroPdf417TimeStamp** – dấu thời gian ISO‑8601 khi mã vạch được tạo. +- **MacroPdf417Addressee / Sender** – các trường văn bản tùy chọn để định tuyến. +- **MacroPdf417Terminator** – chỉ ra liệu đoạn này có phải là đoạn cuối cùng hay không. + +Khi bạn nhận được tất cả các đoạn, bạn có thể tái tạo lại tệp gốc bằng cách sắp xếp chúng theo `MacroPdf417SegmentID` và nối các giá trị `CodeText`. Logic này rất đơn giản để triển khai một khi bạn đã có các trường dữ liệu. + +## Những lỗi thường gặp và mẹo chuyên nghiệp + +- **Chất lượng hình ảnh quan trọng** – các tệp PNG/JPEG có độ phân giải thấp hoặc nén mạnh có thể gây mất phát hiện. Sử dụng DPI ít nhất 300 dpi cho các mã vạch được in. +- **Ký hiệu hỗn hợp** – nếu hình ảnh chứa cả MacroPdf417 và PDF417 thông thường, khởi tạo hai trình đọc (mỗi `DecodeType` một) hoặc sử dụng `DecodeType.AllSupported` và lọc kết quả bằng `result.CodeTypeName`. +- **Tiêu thụ bộ nhớ** – câu lệnh `using` giải phóng `BarCodeReader` ngay lập tức, ngăn các bộ đệm hình ảnh lớn tồn tại trong bộ nhớ. +- **An toàn đa luồng** – `BarCodeReader` không an toàn khi dùng đa luồng. Tạo một thể hiện riêng cho mỗi luồng nếu bạn giải mã hình ảnh song song. +- **Xử lý lỗi** – bao bọc lời gọi `ReadBarCodes()` trong khối try/catch để bắt `BarCodeException` cho các hình ảnh bị hỏng. + +## Tóm tắt ví dụ hoạt động đầy đủ + +Dưới đây là chương trình hoàn chỉnh mà bạn có thể sao chép vào một dự án console mới. Nó bao gồm tất cả các chỉ thị `using`, một hằng số cho đường dẫn hình ảnh, và mẫu giải phóng tài nguyên. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.BarCodeRecognition; + +namespace Pdf417ReaderDemo +{ + class Program + { + static void Main() + { + const string imagePath = @"YOUR_DIRECTORY\MacroPdf417.png"; + + using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.MacroPdf417)) + { + foreach (BarCodeResult result in reader.ReadBarCodes()) + { + Console.WriteLine($"CodeType: {result.CodeTypeName}"); + Console.WriteLine($"CodeText: {result.CodeText}"); + + var macro = result.Extended.Pdf417; + Console.WriteLine($"Pdf417MacroFileID: {macro.MacroPdf417FileID}"); + Console.WriteLine($"Pdf417MacroSegmentID: {macro.MacroPdf417SegmentID}"); + Console.WriteLine($"Pdf417MacroSegmentsCount: {macro.MacroPdf417SegmentsCount}"); + Console.WriteLine($"Pdf417MacroFileName: {macro.MacroPdf417FileName}"); + Console.WriteLine($"Pdf417MacroChecksum: {macro.MacroPdf417Checksum}"); + Console.WriteLine($"Pdf417MacroFileSize: {macro.MacroPdf417FileSize}"); + Console.WriteLine($"Pdf417MacroTimeStamp: {macro.MacroPdf417TimeStamp}"); + Console.WriteLine($"Pdf417MacroAddressee: {macro.MacroPdf417Addressee}"); + Console.WriteLine($"Pdf417MacroSender: {macro.MacroPdf417Sender}"); + Console.WriteLine($"MacroPdf417Terminator: {macro.MacroPdf417Terminator}"); + Console.WriteLine(new string('-', 40)); + } + } + + Console.WriteLine("Decoding completed. Press any key to exit."); + Console.ReadKey(); + } + } +} +``` + +Biên dịch bằng `dotnet build` và chạy bằng `dotnet run`. Console sẽ in dữ liệu cơ bản của mỗi mã vạch và toàn bộ payload MacroPdf417. + +## Các bước tiếp theo + +- **Tái tạo các tệp đa phần** – thu thập tất cả các đoạn, sắp xếp theo `MacroPdf417SegmentID`, và nối `CodeText` để + +## Bạn Nên Học Gì Tiếp Theo? + +Các hướng dẫn sau đây bao gồm các chủ đề liên quan chặt chẽ, xây dựng trên các kỹ thuật được trình bày trong hướng dẫn này. Mỗi tài nguyên đều có các ví dụ mã hoàn chỉnh với các giải thích từng bước để giúp bạn nắm vững các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [Cách tạo mã vạch PDF417 – Mã hóa PDF417 Compact](/barcode/english/net/compact-pdf417-encoding/) +- [Cách đọc mã vạch PDF417 với ký tự Thổ Nhĩ Kỳ trong Java](/barcode/english/java/multilingual-support/recognizing-pdf417-turkish-characters/) +- [Cách sử dụng Aspose cho mã vạch PDF417 (Tiếng Trung) trong Java](/barcode/english/java/multilingual-support/recognizing-pdf417-chinese-characters/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md new file mode 100644 index 000000000..e05077845 --- /dev/null +++ b/barcode/vietnamese/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-08-22 +description: Hướng dẫn tạo mã vạch C# cho thấy cách tạo mã vạch Macro PDF417 có siêu + dữ liệu và lưu dưới dạng PNG bằng Aspose.BarCode. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- barcode generator C# +- Macro PDF417 +- Aspose.BarCode +- C# barcode library +- PDF417 barcode +- barcode metadata +language: vi +lastmod: 2026-08-22 +og_description: Trình tạo mã vạch C# cho phép bạn tạo mã Macro PDF417 với siêu dữ + liệu cấp tệp đầy đủ và xuất ra định dạng PNG. Hãy làm theo hướng dẫn này để triển + khai giải pháp. +og_image_alt: Screenshot of a Macro PDF417 barcode generated with C# +og_title: Trình tạo mã vạch C# – tạo mã vạch Macro PDF417 từng bước +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: barcode generator C# tutorial shows how to create a Macro PDF417 barcode + with metadata and save it as PNG using Aspose.BarCode. + headline: How to use a barcode generator C# for Macro PDF417 + type: TechArticle +tags: +- barcode +- C# +- PDF417 +title: Cách sử dụng trình tạo mã vạch C# cho Macro PDF417 +url: /vi/net/compact-pdf417-encoding/how-to-use-a-barcode-generator-c-for-macro-pdf417/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách sử dụng trình tạo mã vạch C# cho Macro PDF417 + +Nếu bạn cần một **barcode generator C#** có thể tạo ra ký hiệu Macro PDF417 với siêu dữ liệu ở mức file, hướng dẫn này cung cấp giải pháp hoàn chỉnh, sẵn sàng chạy. Bạn sẽ thấy cách cấu hình giao diện mã vạch, nhúng thông tin macro như file ID và số đoạn, và cuối cùng lưu kết quả dưới dạng ảnh PNG. + +Ví dụ sử dụng thư viện Aspose.BarCode, một **C# barcode library** được áp dụng rộng rãi và hỗ trợ đầy đủ các tính năng của PDF417. Không cần dịch vụ bên ngoài, và mã chạy được với .NET 6 hoặc phiên bản mới hơn. + +## Yêu cầu trước + +Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có: + +* .NET 6 SDK (hoặc bất kỳ phiên bản nào mới hơn) đã được cài đặt. +* Visual Studio 2022, VS Code, hoặc bất kỳ IDE C# nào khác. +* Tham chiếu NuGet tới **Aspose.BarCode** (`dotnet add package Aspose.BarCode`). + +Hiểu biết cơ bản về cú pháp C# và khái niệm mã vạch PDF417 sẽ giúp bạn theo dõi các bước, nhưng tutorial sẽ giải thích chi tiết mọi tùy chọn cấu hình. + +## Nội dung tutorial + +* Khởi tạo một **barcode generator C#** cho định dạng Macro PDF417. +* Điều chỉnh các tham số hiển thị như X‑dimension và số cột. +* Cung cấp các trường mức file của Macro PDF417: file ID, segment ID, segment count, file name, checksum, file size, timestamp, addressee, sender và terminator. +* Lưu ký hiệu đã tạo dưới dạng file PNG. +* Mẹo xử lý các trường hợp đặc biệt như kích thước file lớn hoặc timestamp tùy chỉnh. + +Sau khi đọc xong bài viết này, bạn sẽ có một chương trình tự chứa có thể tạo ra mã vạch Macro PDF417 hoàn toàn tuân chuẩn. + +## Bước 1: Tạo instance trình tạo mã vạch C# + +Hoạt động đầu tiên là khởi tạo `BarcodeGenerator` với giá trị enum `EncodeTypes.MacroPdf417` và chuỗi văn bản bạn muốn mã hoá. Constructor cũng cho phép truyền chuỗi payload, sẽ trở thành phần dữ liệu của mã vạch macro. + +```csharp +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +// Step 1: Create a barcode generator for Macro PDF417 +using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) +{ + // Subsequent configuration goes here +} +``` + +**Tại sao lại quan trọng** – Cờ `EncodeTypes.MacroPdf417` báo cho Aspose.BarCode biết ký hiệu là mã vạch macro, kích hoạt các trường bổ sung phía sau. Nếu không có cờ này, thư viện sẽ tạo một mã vạch PDF417 thông thường, không có siêu dữ liệu mức file. + +## Bước 2: Điều chỉnh giao diện cơ bản của mã vạch (cài đặt visual PDF417) + +Độ rõ nét trực quan rất quan trọng để quét chính xác. Hai tham số thường dùng là độ rộng mô-đun (`XDimension`) và số cột. Điều chỉnh các giá trị này giúp cân bằng giữa kích thước và khả năng đọc. + +```csharp + // Step 2: Adjust basic barcode appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; // width of a single module + generator.Parameters.Barcode.Pdf417.Columns = 5; // number of columns in the symbol +``` + +* `XDimension.Pixels` kiểm soát độ rộng của mỗi thanh đen/trắng. Giá trị **2** thường phù hợp với hầu hết máy in nhãn. +* `Pdf417.Columns` xác định số cột mà mã vạch sẽ sử dụng. Năm cột tạo ra ký hiệu gọn gàng mà không làm giảm dung lượng dữ liệu. + +## Bước 3: Định nghĩa thông tin mức file cho Macro PDF417 + +Macro PDF417 mở rộng định dạng PDF417 tiêu chuẩn bằng các trường mô tả cách một file lớn được chia thành nhiều đoạn mã vạch. Cung cấp các trường này giúp máy quét phía sau có thể tái tạo lại file gốc. + +```csharp + // Step 3: Define Macro PDF417 file‑level information + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; // unique file identifier + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; // current segment number (0‑indexed) + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; // total number of segments + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; // optional logical file name +``` + +* `MacroPdf417FileID` phải giống nhau cho mọi đoạn thuộc cùng một file logic. +* `MacroPdf417SegmentID` tăng dần từ **0** tới `SegmentsCount‑1`. +* `MacroPdf417SegmentsCount` cho decoder biết có bao nhiêu đoạn cần chờ. +* `MacroPdf417FileName` là tùy chọn nhưng hữu ích cho việc nhận dạng bằng mắt người. + +## Bước 4: Thiết lập siêu dữ liệu macro bổ sung + +Ngoài thông tin file cốt lõi, đặc tả cho phép các trường phụ như checksum, file size, timestamp, addressee, sender và một cờ terminator. Điền đầy đủ các trường này sẽ cải thiện tính toàn vẹn và khả năng truy vết dữ liệu. + +```csharp + // Step 4: Set additional macro metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; // CCITT‑16 checksum + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; // file size in bytes + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; +``` + +* `MacroPdf417Checksum` cung cấp một checksum CCITT 16‑bit cho toàn bộ file; decoder có thể xác thực tính toàn vẹn sau khi tái tạo. +* `MacroPdf417FileSize` phải phản ánh đúng số byte của file gốc; giá trị lớn hơn `2^31‑1` yêu cầu trường 64‑bit, Aspose sẽ tự động xử lý. +* `MacroPdf417TimeStamp` ghi lại thời điểm mã vạch được tạo. Hãy dùng UTC để tránh nhầm lẫn múi giờ. +* `MacroPdf417Addressee` và `MacroPdf417Sender` là các chuỗi tự do có thể lưu thông tin định tuyến. +* `MacroPdf417Terminator` báo hiệu đây là đoạn cuối cùng; đặt thành `Set` cho phần cuối, nếu không để mặc định (`NotSet`). + +**Mẹo cho trường hợp đặc biệt** – Nếu kích thước file vượt quá 4 GB, hãy chia nội dung thành nhiều segment macro và điều chỉnh `SegmentsCount` cho phù hợp. Thư viện sẽ quản lý trường kích thước lớn mà không bị tràn. + +## Bước 5: Lưu mã vạch dưới dạng ảnh PNG + +Bước cuối cùng ghi ký hiệu đã tạo ra đĩa. PNG giữ nguyên kích thước pixel và được hầu hết phần cứng quét hỗ trợ. + +```csharp + // Step 5: Save the generated barcode as a PNG image + generator.Save("YOUR_DIRECTORY/MacroPdf417.png", BarCodeImageFormat.Png); +} +``` + +Thay `YOUR_DIRECTORY` bằng đường dẫn tuyệt đối hoặc tương đối mà tiến trình thực thi có quyền ghi. Enum `BarCodeImageFormat.Png` đảm bảo đầu ra không mất dữ liệu. + +**Tại sao lại dùng PNG?** – Các định dạng raster như PNG giữ các cạnh mô-đun sắc nét, điều này rất quan trọng đối với máy quét dựa vào độ tương phản cao. Nếu bạn cần định dạng vector, Aspose cũng hỗ trợ `Pdf` và `Svg`. + +## Ví dụ đầy đủ có thể chạy + +Dưới đây là chương trình hoàn chỉnh bạn có thể sao chép vào một ứng dụng console. Nó bao gồm các chỉ thị `using` cần thiết và một phương thức `Main`. + +```csharp +using System; +using Aspose.BarCode; +using Aspose.BarCode.Generation; + +namespace MacroPdf417Demo +{ + class Program + { + static void Main() + { + // Create a barcode generator for Macro PDF417 with sample payload + using (BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Sample text")) + { + // Adjust visual appearance + generator.Parameters.Barcode.XDimension.Pixels = 2; + generator.Parameters.Barcode.Pdf417.Columns = 5; + + // Define macro file‑level fields + generator.Parameters.Barcode.Pdf417.MacroPdf417FileID = 12345678; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentID = 12; + generator.Parameters.Barcode.Pdf417.MacroPdf417SegmentsCount = 20; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileName = "file01"; + + // Add optional metadata + generator.Parameters.Barcode.Pdf417.MacroPdf417Checksum = 1234; + generator.Parameters.Barcode.Pdf417.MacroPdf417FileSize = 400_000; + generator.Parameters.Barcode.Pdf417.MacroPdf417TimeStamp = new DateTime(2024, 4, 1); + generator.Parameters.Barcode.Pdf417.MacroPdf417Addressee = "street"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Sender = "aspose"; + generator.Parameters.Barcode.Pdf417.MacroPdf417Terminator = Pdf417MacroTerminator.Set; + + // Export to PNG + generator.Save("MacroPdf417.png", BarCodeImageFormat.Png); + } + + Console.WriteLine("Macro PDF417 barcode generated successfully."); + } + } +} +``` + +### Kết quả mong đợi + +Chạy chương trình sẽ tạo một file có tên **MacroPdf417.png** trong thư mục làm việc của dự án. Mở ảnh sẽ thấy một mã vạch PDF417 gọn gàng với các trường macro được nhúng. Quét ảnh bằng một trình đọc hỗ trợ PDF417 (ví dụ: ZXing, Aspose.BarCode decoder) sẽ trả về payload gốc `"Sample text"` cùng với siêu dữ liệu macro. + +## Câu hỏi thường gặp và khắc phục sự cố + +| Câu hỏi | Trả lời | +|----------|--------| +| *Nếu mã vạch quá lớn so với nhãn mục tiêu thì sao?* | Giảm `XDimension.Pixels` hoặc tăng `Pdf417.Columns`. Cả hai tham số đều ảnh hưởng đến kích thước tổng thể. | +| *Tôi có thể tạo ảnh vector thay vì PNG không?* | Có. Gọi `generator.Save("MacroPdf417.svg", BarCodeImageFormat.Svg);` để xuất ra định dạng có thể mở rộng. | +| *Làm sao kiểm tra checksum sau khi quét?* | Bộ giải mã Aspose.BarCode tự động xác thực `MacroPdf417Checksum` và báo lỗi trong đối tượng `MacroPdf417Result`. | +| *Thư viện có tương thích với .NET Core không?* | Gói NuGet hỗ trợ .NET Standard 2.0+, bao gồm .NET Core, .NET 5, .NET 6 và các phiên bản sau. | +| *Nếu tôi muốn nhúng dữ liệu nhị phân thay vì văn bản thì sao?* | Chuyển payload nhị phân sang Base64 hoặc dùng overload `EncodeTypes.MacroPdf417` chấp nhận mảng byte. | + +## Mẹo chuyên nghiệp cho môi trường production + +* **Cache the generator** – + + +## Bạn nên học gì tiếp theo? + +Các tutorial sau đây liên quan chặt chẽ và mở rộng các kỹ thuật đã trình bày trong hướng dẫn này. Mỗi tài nguyên đều bao gồm mã mẫu đầy đủ và giải thích từng bước để giúp bạn nắm vững các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [How to Create Barcode – Compact PDF417 with Aspose.BarCode](/barcode/english/net/compact-pdf417-encoding/compact-pdf417-basic-configuration/) +- [How to read barcode from PDF in Java using Aspose.BarCode](/barcode/english/java/document-barcode-recognition/recognizing-barcodes-from-pdf/) +- [Create Codabar Barcode with Aspose.Barcode – Generator & Reader API](/barcode/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file