Generador de matrices de datos en C#: tutorial completo con ejemplos de código

¿Qué hace que los códigos de barras Data Matrix sean especiales?

Los códigos de barras Data Matrix son símbolos 2D que codifican datos en una cuadrícula de puntos blancos y negros dispuestos en filas y columnas. A diferencia de los códigos de barras lineales tradicionales como UPC o EAN, pueden almacenar hasta 2.335 caracteres alfanuméricos o 3.116 dígitos numéricos en un espacio tan pequeño como 10 x 10 módulos. Su corrección de errores Reed-Solomon incorporada permite que los lectores de códigos de barras modernos los lean con precisión incluso cuando hasta el 30 % del símbolo esté dañado.

Estas características hacen que Data Matrix sea ideal para el marcado de piezas pequeñas, códigos de barras postales y componentes electrónicos, así como para el etiquetado en centros sanitarios y logísticos. La industria sanitaria utiliza los estándares GS1 Data Matrix para el seguimiento de medicamentos, mientras que los fabricantes los integran en sus líneas de producción para identificar artículos en todo el mundo. Dado que un solo código de barras puede almacenar tanta información, ahora se utilizan internacionalmente en diversas industrias que buscan una trazabilidad completa de las aplicaciones.

El estándar ISO/IEC 16022 rige la codificación Data Matrix y define la variante ECC200 que IronBarcode utiliza de forma predeterminada. ECC200 proporciona la corrección de errores más eficiente y la mayor capacidad de datos de cualquier versión de Data Matrix, lo que lo convierte en la opción correcta para nuevas implementaciones.

¿Cómo instalar la biblioteca de código de barras en un proyecto C#?

La instalación de IronBarcode lleva menos de un minuto utilizando el Administrador de paquetes NuGet . Abra la consola del gestor de paquetes en Visual Studio y ejecute:

Install-Package BarCode

Alternativamente, busque BarCode de Iron Software en la GUI del Administrador de paquetes NuGet . Tras la instalación, añada el espacio de nombres a su archivo C#:

using IronBarCode;

using IronBarCode;

Esa es toda la configuración necesaria. IronBarcode maneja internamente toda la codificación compleja de Data Matrix, siguiendo el estándar ISO/IEC 16022, para que usted pueda concentrarse en la lógica de la aplicación. Para obtener opciones de configuración adicionales, como instalación sin conexión o fuentes de paquetes personalizados, consulte la guía de instalación de IronBarcode y la página de instalación avanzada de NuGet .

¿Cómo crear su primer código de barras Data Matrix?

Para generar un código de barras Data Matrix solo se necesita una línea de código:

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

// Create a Data Matrix barcode with product information
var myBarcode = BarcodeWriter.CreateBarcode("PROD-12345-2024", BarcodeWriterEncoding.DataMatrix);

// Save as a high-quality PNG image
myBarcode.SaveAsImage("product-label.png");

Este código crea un código de barras Data Matrix que codifica el texto PROD-12345-2024 y lo guarda como archivo PNG. El parámetro BarcodeWriterEncoding.DataMatrix indica a IronBarcode que utilice el formato Data Matrix. El código de barras resultante aplica automáticamente la especificación ECC200, que incluye corrección de errores incorporada y garantiza un escaneo confiable en condiciones del mundo real.

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

// Get barcode as a bitmap for direct display in a UI control
var barcodeBitmap = myBarcode.ToBitmap();

// Save as PDF for document integration
myBarcode.SaveAsPdf("barcode-document.pdf");

¿Qué tipos de datos se pueden codificar en un código de barras de matriz de datos?

Data Matrix admite varios modos de codificación, cada uno optimizado para un conjunto de caracteres diferente. IronBarcode selecciona automáticamente el modo más eficiente en función del contenido que usted proporcione:

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

// Encode alphanumeric product codes
var productCode = BarcodeWriter.CreateBarcode("ABC-123-XYZ", BarcodeWriterEncoding.DataMatrix);
productCode.SaveAsImage("product-code.png");

// Encode numeric serial numbers (numeric mode uses less space)
var serialNumber = BarcodeWriter.CreateBarcode("987654321098765", BarcodeWriterEncoding.DataMatrix);
serialNumber.SaveAsImage("serial-number.png");

// Encode URLs for product landing pages or support portals
var urlCode = BarcodeWriter.CreateBarcode("https://example.com/product/12345", BarcodeWriterEncoding.DataMatrix);
urlCode.SaveAsImage("url-datamatrix.png");

// Encode Unicode text for international applications
var unicodeBarcode = BarcodeWriter.CreateBarcode("製品-2024-東京", BarcodeWriterEncoding.DataMatrix);
unicodeBarcode.SaveAsImage("unicode-datamatrix.png");

Los datos numéricos utilizan un modo de codificación compacto que reduce el tamaño del código de barras en comparación con el texto alfanumérico. La codificación binaria maneja caracteres especiales y texto Unicode sin configuración manual. IronBarcode selecciona automáticamente el modo de codificación más eficiente, por lo que no es necesario especificarlo explícitamente.

¿Cómo personalizar la apariencia de un código de barras Data Matrix?

IronBarcode expone un conjunto completo de opciones de personalización de códigos de barras para controlar el tamaño, el color, las anotaciones y los márgenes:

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

// Create barcode with custom styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeWriterEncoding.DataMatrix);

// Set specific dimensions in pixels
customBarcode.ResizeTo(500, 500);

// Adjust colors for special label requirements
customBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
customBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);

// Add human-readable text below the barcode symbol
customBarcode.AddAnnotationTextBelowBarcode("Product: CUSTOM-2024");

// Set margins to preserve the required quiet zone
customBarcode.SetMargins(10);

customBarcode.SaveAsImage("custom-datamatrix.png");

Estas personalizaciones ayudan a cumplir con los requisitos de marca corporativa o estándares de etiquetado específicos. El método ResizeTo mantiene proporciones de módulo adecuadas, lo cual es esencial para la legibilidad de Data Matrix a cualquier distancia del escáner. Los cambios de color se adaptan a procesos de impresión especiales o restricciones de sustrato, como etiquetas de colores o materiales metálicos. El margen de zona silenciosa establecido por SetMargins cumple con el requisito mínimo de espacio en blanco definido en la especificación ISO/IEC 16022.

Generador de matrices de datos en C#: Guía completa con IronBarcode: Imagen 4 - Salida de matriz de datos personalizada

¿Cómo generar múltiples códigos de barras en un lote?

La generación de lotes reduce el trabajo involucrado en la creación de grandes conjuntos de códigos Data Matrix para ejecuciones de producción, etiquetas de envío o inventario serializado:

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

// Generate barcodes for a batch of products
string[] productIds = { "PROD-001", "PROD-002", "PROD-003", "PROD-004", "PROD-005" };

foreach (string id in productIds)
{
    var batchBarcode = BarcodeWriter.CreateBarcode(id, BarcodeWriterEncoding.DataMatrix);
    batchBarcode.ResizeTo(150, 150);
    batchBarcode.AddAnnotationTextBelowBarcode(id);

    // Save each barcode with a unique filename
    string filename = $"barcode_{id.Replace("-", "_")}.png";
    batchBarcode.SaveAsImage(filename);
}

Este patrón se adapta a los flujos de trabajo de logística y atención médica que requieren grandes conjuntos de etiquetas, cada uno asociado con un identificador único. Para aplicaciones web, estampar códigos de barras directamente en documentos PDF o transmitirlos como matrices de bytes permite la generación de etiquetas en tiempo real sin guardar archivos intermedios.

Generador de matrices de datos en C#: Guía completa con IronBarcode: Imagen 5 - Creación de códigos de barras de matrices de datos por lotes

¿Cómo se leen y verifican los códigos de barras Data Matrix?

Generar códigos de barras es solo la mitad del flujo de trabajo; verificar que los escáneres los lean correctamente cierra el ciclo de calidad. IronBarcode incluye un lector de códigos de barras integrado que permite decodificar una imagen generada inmediatamente después de crearla:

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Formato: {result.BarcodeEscriba a}");
}

// Generate a barcode
var generated = BarcodeWriter.CreateBarcode("VERIFY-2024", BarcodeWriterEncoding.DataMatrix);
generated.SaveAsImage("verify-test.png");

// Read it back to confirm correct encoding
var results = BarcodeReader.Read("verify-test.png");
foreach (var result in results)
{
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"Formato: {result.BarcodeEscriba a}");
}

Este patrón de verificación de ida y vuelta es particularmente valioso en industrias reguladas como la farmacéutica, donde la regulación DSCSA exige que los códigos de barras serializados en los paquetes de medicamentos recetados sean legibles por máquina y tengan el formato correcto. La ejecución de una verificación de lectura como parte del proceso de generación detecta errores de codificación antes de que las etiquetas lleguen a la línea de producción.

Para escenarios de lectura más avanzados, consulte la documentación de lectura de IronBarcode y la guía de lectura de códigos de barras en PDF .

¿Cuales son tus próximos pasos?

La generación de códigos de barras Data Matrix en C# con IronBarcode sigue un patrón consistente: instalar el paquete NuGet , llamar a BarcodeWriter.CreateBarcode con BarcodeWriterEncoding.DataMatrix, aplicar las personalizaciones necesarias y exportar a su formato de destino. La misma API maneja todo, desde prototipos de código de barras único hasta procesos de lotes de gran volumen.

Aquí están las rutas recomendadas para llevar esto más allá:

• Explore la lectura de códigos de barras : la guía de lectura de IronBarcode cubre la decodificación de códigos de barras de imágenes, archivos PDF y transmisiones de cámaras en vivo.
• Pruebe otros formatos 2D : IronBarcode también genera códigos QR , PDF417, Aztec y todos los principales formatos 1D utilizando la misma API.
• Incrustar códigos de barras en documentos : el tutorial de estampado de PDF muestra cómo agregar códigos de barras a archivos PDF existentes mediante programación.
• Escala con procesamiento asincrónico : revise la guía asincrónica y de múltiples subprocesos para paralelizar trabajos por lotes grandes.
• Revisar licencias : La página de licencias de IronBarcode enumera opciones desde desarrollador hasta redistribución OEM.

Comience una prueba gratuita para probar todas las funciones sin restricciones o revise la documentación completa de IronBarcode para obtener referencias API detalladas y ejemplos de código adicionales.

Instalar con NuGet

PM >  Install-Package BarCode

Echa un vistazo a IronBarcode en NuGet para una instalación rápida. Con más de 10 millones de descargas, está transformando el desarrollo de PDF con C#. También puede descargar el DLL.