La integración de la generación de códigos de barras en una aplicación web ASP.NET abre potentes posibilidades para la gestión de inventarios, el seguimiento de productos y la automatización de documentos. Este tutorial demuestra cómo generar códigos de barras en un proyecto .NET Core usando IronBarcode, una biblioteca de códigos de barras que admite más de 30 formatos, incluyendo QR Code, Data Matrix, Code 128 y UPC A.
El siguiente ejemplo rápido muestra cómo crear un código de barras Código 128 y devolverlo como una imagen PNG desde una acción del controlador MVC:
using IronBarCode;
using Microsoft.AspNetCore.Mvc;
public IActionResult GenerateBarcode(string data)
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
barcode.AddBarcodeValueTextBelowBarcode();
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png");
}Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc
Public Function GenerateBarcode(data As String) As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
barcode.AddBarcodeValueTextBelowBarcode()
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png")
End FunctionComience su prueba gratuita para seguir los ejemplos de código tutoriales completos a continuación.
Agregar capacidades de generación de códigos de barras a una aplicación web ASP.NET Core requiere instalar el paquete NuGet de IronBarcode. Abra Visual Studio y utilice la consola del gestor de paquetes para instalar las dependencias:
El paquete es compatible con .NET Core 6, 7, 8, 10 y versiones más nuevas, así como con .NET Framework 4.6.2+. La biblioteca maneja todas las dependencias automáticamente, sin requerir fuentes de código de barras adicionales ni configuración del sistema. Una vez instalado, agregue la referencia del espacio de nombres al controlador o al archivo de servicio:
using IronBarCode;Imports IronBarCodeIronBarcode apunta a todos los tiempos de ejecución modernos de .NET:
No se requieren bibliotecas GD externas, códecs nativos ni instalaciones de fuentes de códigos de barras. La biblioteca es completamente autónoma y resuelve toda la lógica de codificación internamente.
Después de instalar el paquete NuGet, referencia el IronBarCode namespace en la parte superior de cualquier controlador, servicio o modelo de Razor Page donde se necesite la generación de códigos de barras:
using IronBarCode;
using Microsoft.AspNetCore.Mvc;Imports IronBarCode
Imports Microsoft.AspNetCore.MvcEsta única directiva using proporciona acceso a BarcodeWriter, QRCodeWriter, BarcodeReader, y todos los tipos de soporte para tanto la generación como la lectura de códigos de barras.
Crear códigos de barras en un controlador MVC implica la clase BarcodeWriter de IronBarcode. El siguiente ejemplo demuestra una acción de controlador completa que crea un código de barras Código 128 basado en una URL o texto proporcionado por un usuario:
using IronBarCode;
using Microsoft.AspNetCore.Mvc;
public class BarcodeController : Controller
{
public IActionResult GenerateBarcode(string data)
{
// Generate barcode from input data
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
data,
BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
barcode.AddBarcodeValueTextBelowBarcode();
// Return as image for display in browser
byte[] barcodeBytes = barcode.ToPngBinaryData();
return File(barcodeBytes, "image/png");
}
}Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc
Public Class BarcodeController
Inherits Controller
Public Function GenerateBarcode(data As String) As IActionResult
' Generate barcode from input data
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
barcode.AddBarcodeValueTextBelowBarcode()
' Return as image for display in browser
Dim barcodeBytes As Byte() = barcode.ToPngBinaryData()
Return File(barcodeBytes, "image/png")
End Function
End Class
El método BarcodeWriter.CreateBarcode() acepta datos de código de barras como el primer parámetro y el formato de codificación como el segundo. Este enfoque crea códigos de barras de forma dinámica según la entrada del usuario o los valores de la base de datos.
Para guardar imágenes de códigos de barras en una carpeta del proyecto, utiliza el método SaveAsImage():
barcode.SaveAsImage("wwwroot/images/generated-barcode.png");barcode.SaveAsImage("wwwroot/images/generated-barcode.png")La biblioteca admite varios formatos de salida, como PNG, GIF, BMP, SVG y JPEG. También puede exportar códigos de barras como HTML para incrustarlos directamente en páginas web.
Para devolver el código de barras como un archivo descargable en lugar de una imagen en línea, configura el encabezado Content-Disposition en la respuesta:
public IActionResult DownloadBarcode(string data)
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128);
barcode.ResizeTo(400, 120);
byte[] pdfBytes = barcode.ToPdfBinaryData();
return File(pdfBytes, "application/pdf", "barcode.pdf");
}Public Function DownloadBarcode(data As String) As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, BarcodeWriterEncoding.Code128)
barcode.ResizeTo(400, 120)
Dim pdfBytes As Byte() = barcode.ToPdfBinaryData()
Return File(pdfBytes, "application/pdf", "barcode.pdf")
End FunctionEste patrón es útil para la generación de etiquetas de envío, flujos de trabajo de etiquetado de productos y cualquier escenario en el que el usuario final necesite guardar o imprimir un documento de código de barras directamente.
IronBarcode admite más de 30 formatos. A continuación se detalla cómo crear los tipos más utilizados:
// Create QR Code with custom size
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode(
"https://example.com/product/12345",
500,
QRCodeWriter.QrErrorCorrectionLevel.Medium);
qrCode.SaveAsPng("product-qr.png");' Create QR Code with custom size
Dim qrCode As GeneratedBarcode = QRCodeWriter.CreateQrCode( _
"https://example.com/product/12345", _
500, _
QRCodeWriter.QrErrorCorrectionLevel.Medium)
qrCode.SaveAsPng("product-qr.png")
La generación de códigos QR admite niveles de corrección de errores que determinan qué parte del código puede dañarse sin dejar de ser legible. Utilice un nivel medio o alto para aplicaciones de impresión de códigos QR en las que se prevea un desgaste físico. Obtenga más información sobre las opciones de personalización del código QR .
// Create Data Matrix barcode
GeneratedBarcode dataMatrix = BarcodeWriter.CreateBarcode(
"DMX-2024-001",
BarcodeWriterEncoding.DataMatrix);
dataMatrix.SaveAsGif("datamatrix.gif");' Create Data Matrix barcode
Dim dataMatrix As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
"DMX-2024-001", _
BarcodeWriterEncoding.DataMatrix)
dataMatrix.SaveAsGif("datamatrix.gif")
Los códigos de barras Data Matrix destacan en situaciones que requieren una codificación compacta y de alta densidad. La biblioteca también genera formatos PDF417, Aztec y MaxiCode . Estos tipos de códigos de barras 2D almacenan muchos más datos que los formatos lineales, al tiempo que mantienen una precisión de escaneado fiable.
// Create UPC-A barcode for retail products
GeneratedBarcode upcBarcode = BarcodeWriter.CreateBarcode(
"012345678905",
BarcodeWriterEncoding.UPCA);
upcBarcode.SaveAsPng("upc-barcode.png");IRON VB CONVERTER ERROR developers@ironsoftware.com
Los códigos de barras UPC A y EAN incluyen validación automática de suma de comprobación, lo que evita errores de codificación en el proceso de generación de códigos de barras. Para obtener una lista completa de formatos admitidos, consulte la referencia de formatos de código de barras .
Para diseñar códigos de barras para una aplicación web es necesario ajustar colores, fuentes, márgenes y anotaciones. La fluidez de la API facilita la personalización:
GeneratedBarcode styledBarcode = BarcodeWriter.CreateBarcode(
"STYLED-2024",
BarcodeWriterEncoding.Code128);
// Apply styling
styledBarcode.ResizeTo(450, 150);
styledBarcode.SetMargins(20);
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:");
styledBarcode.AddBarcodeValueTextBelowBarcode();
// Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png");
styledBarcode.SaveAsPdf("styled-barcode.pdf");Dim styledBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("STYLED-2024", BarcodeWriterEncoding.Code128)
' Apply styling
styledBarcode.ResizeTo(450, 150)
styledBarcode.SetMargins(20)
styledBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue)
styledBarcode.AddAnnotationTextAboveBarcode("Product ID:")
styledBarcode.AddBarcodeValueTextBelowBarcode()
' Export to multiple formats
styledBarcode.SaveAsPng("styled-barcode.png")
styledBarcode.SaveAsPdf("styled-barcode.pdf")
El método SetMargins() añade espacio en blanco alrededor del código de barras para mejorar la legibilidad del escáner. Puede ajustar la configuración de fuentes para el texto de anotación, cambiar la familia y el tamaño de fuente y personalizar ampliamente el estilo del código de barras . La biblioteca representa texto utilizando fuentes del sistema sin necesidad de fuentes de código de barras externas.
Para las vistas ASP.NET MVC, genere códigos de barras como cadenas Base64 para incrustación HTML directa sin guardar archivos en el disco:
public IActionResult DisplayBarcode()
{
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
"INV-2024-0042",
BarcodeWriterEncoding.Code128);
string base64Image = barcode.ToDataUrl();
ViewBag.BarcodeImage = base64Image;
return View();
}Public Function DisplayBarcode() As IActionResult
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("INV-2024-0042", BarcodeWriterEncoding.Code128)
Dim base64Image As String = barcode.ToDataUrl()
ViewBag.BarcodeImage = base64Image
Return View()
End Function
En la vista Razor, muéstralo dentro de un elemento <div>:
<div class="barcode-container">
<img src="@ViewBag.BarcodeImage" alt="Generated Barcode" />
</div>
<div class="print-actions">
<button onclick="window.print()">Print Barcode</button>
</div>Este enfoque elimina la necesidad de guardar imágenes de códigos de barras en el sistema de archivos, manteniendo el servicio web sin estado. La referencia completa de API documenta todos los métodos y propiedades disponibles.
La lectura de códigos de barras de imágenes subidas o streams de archivos se maneja con la clase BarcodeReader. Esto es útil para recibir flujos de trabajo, procesar devoluciones y cualquier escenario en el que sea necesario decodificar un código de barras escaneado en el lado del servidor:
using IronBarCode;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
public class BarcodeScanController : Controller
{
public IActionResult ScanBarcode(IFormFile uploadedImage)
{
using var stream = uploadedImage.OpenReadStream();
var results = BarcodeReader.Read(stream);
if (results.Count > 0)
{
string decodedValue = results[0].Value;
return Ok(new { barcode = decodedValue });
}
return BadRequest("No barcode detected in image.");
}
}Imports IronBarCode
Imports Microsoft.AspNetCore.Http
Imports Microsoft.AspNetCore.Mvc
Public Class BarcodeScanController
Inherits Controller
Public Function ScanBarcode(uploadedImage As IFormFile) As IActionResult
Using stream = uploadedImage.OpenReadStream()
Dim results = BarcodeReader.Read(stream)
If results.Count > 0 Then
Dim decodedValue As String = results(0).Value
Return Ok(New With {.barcode = decodedValue})
End If
Return BadRequest("No barcode detected in image.")
End Using
End Function
End ClassEl método BarcodeReader.Read() acepta rutas de archivos, streams, y objetos System.Drawing.Bitmap. Detecta automáticamente el formato del código de barras y devuelve una colección de objetos BarcodeResult, cada uno conteniendo el valor decodificado, el tipo de formato, y la posición en la imagen. Cuando aparecen varios códigos de barras en una sola imagen (por ejemplo, en la fotografía de un estante de un almacén), el lector devuelve todos los valores detectados en la colección, no solo el primero.
También vale la pena considerar el rendimiento para aplicaciones ASP.NET de alto rendimiento. El lector admite el escaneo de región de interés, que recorta la imagen en un rectángulo de píxeles específico antes del análisis. Esto reduce significativamente el tiempo de procesamiento cuando los códigos de barras siempre aparecen en un área conocida de la imagen.
Para escenarios avanzados, como ajustar el contraste para imágenes de baja calidad o ajustar la sensibilidad de detección, consulte la documentación de lectura de códigos de barras .
La generación de códigos de barras integrados directamente en documentos PDF es un requisito común para etiquetas de envío, etiquetas de almacén y documentos de cumplimiento. IronBarcode admite guardar directamente en formato PDF:
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(
"SHIP-2024-99471",
BarcodeWriterEncoding.Code128);
barcode.ResizeTo(500, 150);
barcode.AddAnnotationTextAboveBarcode("Shipping Label");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.SaveAsPdf("shipping-label.pdf");Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
"SHIP-2024-99471", _
BarcodeWriterEncoding.Code128)
barcode.ResizeTo(500, 150)
barcode.AddAnnotationTextAboveBarcode("Shipping Label")
barcode.AddBarcodeValueTextBelowBarcode()
barcode.SaveAsPdf("shipping-label.pdf")Para documentos PDF con múltiples códigos de barras (por ejemplo, una página de etiquetas de productos), genere cada código de barras por separado y combínelos utilizando una biblioteca PDF. La guía de integración de IronPDF explica cómo estampar códigos de barras en plantillas PDF existentes, lo cual es útil para añadir códigos de barras a diseños de etiquetas pre-diseñados.
El método SaveAsPdf() también acepta dimensiones de salida para que la página del PDF renderizado coincida con el tamaño físico de etiqueta requerido por las impresoras de etiquetas.
Las reglas de codificación de códigos de barras varían según el formato. Por ejemplo, UPC-A requiere exactamente 11 o 12 dígitos, EAN-13 requiere exactamente 12 o 13, y el Código 128 tiene un límite práctico de 48 caracteres para una salida legible en tamaños estándar. Pasar datos inválidos genera un IronBarCodeEncoderException.
Manejar errores de codificación explícitamente en las acciones del controlador:
public IActionResult SafeGenerate(string data, string format)
{
try
{
var encoding = Enum.Parse<BarcodeWriterEncoding>(format, true);
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(data, encoding);
return File(barcode.ToPngBinaryData(), "image/png");
}
catch (IronBarCodeEncoderException ex)
{
return BadRequest($"Encoding error: {ex.Message}");
}
catch (ArgumentException ex)
{
return BadRequest($"Unknown format: {ex.Message}");
}
}Imports System
Public Function SafeGenerate(data As String, format As String) As IActionResult
Try
Dim encoding = [Enum].Parse(Of BarcodeWriterEncoding)(format, True)
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(data, encoding)
Return File(barcode.ToPngBinaryData(), "image/png")
Catch ex As IronBarCodeEncoderException
Return BadRequest($"Encoding error: {ex.Message}")
Catch ex As ArgumentException
Return BadRequest($"Unknown format: {ex.Message}")
End Try
End FunctionPara uso en producción, valida la longitud de los datos de entrada y el conjunto de caracteres antes de llamar a CreateBarcode(). La documentación de IronBarcode proporciona restricciones de codificación específicas de formato para cada tipo de código de barras compatible.
Crear un generador de códigos de barras ASP.NET con IronBarcode proporciona una solución confiable para crear, estilizar y exportar imágenes de códigos de barras en aplicaciones web de .NET Core. La biblioteca gestiona estándares de codificación complejos de forma automática, al tiempo que ofrece una amplia personalización a través de una API fácil de usar para los desarrolladores. Ya sea generando códigos QR para escaneos móviles, códigos de barras Data Matrix para aplicaciones industriales o códigos UPC para retail, IronBarcode se integra directamente con controladores ASP.NET MVC y páginas Razor.
Explora estos recursos para ir más allá:
Puede probar el conjunto completo de funciones durante el período de evaluación gratuito. Para implementación de producción y uso comercial, consulte las opciones de licencia para seleccionar la licencia adecuada para los requisitos de su proyecto. La biblioteca admite exportaciones de mapas de bits y vectores, y cada versión mantiene la compatibilidad con los destinos de implementación de Windows, Linux, Android e iOS.
Para preguntas, comparativas frente a bibliotecas de códigos de barras alternativas para .NET, o soporte de integración empresarial, visita el portal de soporte de IronBarcode.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
IronBarcode es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesite leer, escribir y diseñar Códigos de Barras, rápido.
