Cómo generar códigos de barras PDF417 con Aspose.BarCode para .NET
Este artículo demuestra cómo generar los códigos de barras PDF417 utilizando Aspose.BarCode para .NET en C#. PDF317 es un barcode 2D de alta densidad ampliamente utilizado para los billetes de transporte, los pasaportes de embarque, las tarjetas de identificación y la gestión de inventario.
Problemas del mundo real
Los códigos de barras PDF417 son requeridos por las compañías aéreas, proveedores de logística, y agencias gubernamentales para codificar grandes volúmenes de datos en un formato seguro, que se puede leer por máquina. Generar manualmente el pdf417, es causado por errores y pocas herramientas de código barro soportan batch, automatización o flujos de trabajo .NET.
Revisión de Soluciones
Aspose.BarCode para .NET le permite generar códigos de barras PDF417 de forma programática con control completo sobre líneas, columnas, corrección de errores y formato de exportación – ideal para pases digitales, etiquetas de envío o credenciales.
Prerequisitos
Antes de comenzar, asegúrese de tener:
- Visual Studio 2019 o más tarde
- .NET 6.0 o posterior (o .Net Framework 4.6.2+)
- Aspose.BarCode para .NET instalado a través de NuGet
- Conocimiento básico de C#
PM> Install-Package Aspose.BarCode
Implementación paso a paso
Paso 1: Instalar y importar Aspose.BarCode
Instalar el paquete NuGet y importar los espacios de nombre requeridos:
using Aspose.BarCode.Generation;
Paso 2: Crea el generador de código de barras PDF417
Instalar el generador para PDF417:
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
Paso 3: Personalizar las configuraciones de PDF417
Ajustar líneas, columnas, ECC o estilo según sea necesario:
// Set number of rows and columns
generator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
generator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
// Set error correction level (0-8, higher is stronger)
generator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
// Optional: Set XDimension (pixel size)
generator.Parameters.Barcode.XDimension.Pixels = 4;
// Optional: Set foreground and background color
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.Barcode.BackColor = Color.White;
Paso 4: Generar y guardar el código de barras PDF417
Exporta el código de barras a PNG, JPEG o cualquier formato apoyado:
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
Paso 5: El ejemplo completo
using Aspose.BarCode.Generation;
using System.Drawing; // Required for Color
class Program
{
static void Main()
{
// Create PDF417 generator for transport data
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Pdf417, "PASSENGER: SMITH/JANE\nFLIGHT: 1234\nDATE: 2025-06-18");
generator.Parameters.Barcode.Pdf417.Pdf417Rows = 10;
generator.Parameters.Barcode.Pdf417.Pdf417Columns = 4;
generator.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level5;
generator.Parameters.Barcode.XDimension.Pixels = 4;
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.Barcode.BackColor = Color.White;
generator.Save("boarding-pass-pdf417.png", BarCodeImageFormat.Png);
// Test with a PDF417 scanner
}
}
Usar Casos y Aplicaciones
- **Pasos de barco: ** Aeronaves y boletos de transporte
- Cartas de identificación y credenciales: Identidad de lectura por máquina, licencias
- Logística y inventario: Etiquetas de envío y almacenamiento
Desafíos y soluciones comunes
**Desafío 1: PDF417 no es escaneado?**La solución: Utilice corrección de error suficiente, ajuste las líneas/columnas al tamaño de los datos, verifica el tamaño del módulo para los scanners.
Challenge 2: ¿Los datos son demasiado grandes?La solución: Aumentar el tamaño de los códigos de barras, las líneas / columnas o los datos divididos.
Challenge 3: Blurry o imagen de baja resistencia?La solución: Exportación en tamaño de pixel superior o DPI para uso impreso.
Consideraciones de rendimiento
- Utilice la corrección correcta del error para la crítica de la aplicación
- Batch genera PDF417 para listas de pasajeros o manifiestos de envío
- Utilice los flujos de memoria para la exportación de código de barras en memoria
Mejores Prácticas
- Tune líneas y columnas para los datos y el tamaño de la etiqueta
- Prueba con escáneres / dispositivos PDF417 certificados
- Exportación a PNG para impresión, JPEG para pantalla digital
- Mantener el texto de datos estructurado y conciso
Escenarios avanzados
Batch Generate PDF417 Códigos de barras
foreach (var ticket in tickets)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Pdf417, ticket.Data);
g.Save($"pdf417_{ticket.Id}.png", BarCodeImageFormat.Png);
}
Configurar PDF417 Compacción y Modos Macro
// Set compaction mode for numeric, text, or binary data
generator.Parameters.Barcode.Pdf417.Pdf417CompactionMode = Pdf417CompactionMode.Text;
// Enable macro PDF417 for segmented/barcoded documents
generator.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 12345;
Conclusión
Aspose.BarCode para .NET le permite crear códigos de barras PDF417 para las aplicaciones de transporte, ID y inventario, con control avanzado sobre el formato y la seguridad. Aspose.BarCode API Referencia .