Cómo Crear Códigos de Barras como HTML en C#

Cómo exportar BarCodes como HTML en C#

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode permite a los desarrolladores de C# exportar códigos de barras generados como HTML en tres formatos: URL de datos para incrustación en línea, etiqueta HTML para inyección directa o archivo HTML completo para uso independiente, lo que proporciona opciones de integración versátiles sin dependencias externas.

Inicio rápido: Exportar un código de barras como una etiqueta HTML con una línea

Genere un código de barras y expórtelo directamente como una etiqueta de imagen HTML completamente formada utilizando una sola línea de código fluida. Empiece a trabajar rápidamente sin tener que gestionar archivos de imagen externos ni dependencias de activos.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronBarcode con el gestor de paquetes NuGet

    PM > Install-Package BarCode

  2. Copie y ejecute este fragmento de código.

    var htmlTag = BarcodeWriter.CreateBarcode("1234567890", BarcodeWriterEncoding.Code128).ToHtmlTag();
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronBarcode en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

¿Cómo exportar un BarCode como URL de datos?

Antes de exportar un código de barras como URL de datos, entienda qué es una URL de datos. Una URL de datos (también conocida como URI de datos) es un identificador uniforme de recursos que incluye datos directamente en la cadena de URL. Esto permite la visualización en línea en páginas web como si se tratara de recursos externos. Las URL de datos admiten cualquier formato: texto, imágenes, audio, vídeo y datos binarios. Utilice la URL de datos obtenida en HTML dentro de una etiqueta de imagen como atributo src. A continuación se explica cómo convertir un Código de barras generado en una URL de datos:

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsDataUrl.cs
using IronBarCode;
using System;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
var dataUrl = myBarcode.ToDataUrl();
Console.WriteLine(dataUrl);
Imports IronBarCode
Imports System

Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
Private dataUrl = myBarcode.ToDataUrl()
Console.WriteLine(dataUrl)
$vbLabelText   $csharpLabel

Cree un código de barras utilizando el método CreateBarcode() de la clase BarcodeWriter con el valor del código de barras y la codificación como argumentos. Obtenga la URL de los datos adjuntando el método ToDataUrl() al BarcodeGenerado. Este enfoque funciona con todos los formatos de código de barras soportados en IronBarcode.

¿Por qué es importante utilizar URL de datos en las aplicaciones web?

Las URL de datos ofrecen importantes ventajas para las aplicaciones web, ya que reducen las solicitudes HTTP y mejoran el rendimiento de carga de las páginas. Al incrustar un código de barras como URL de datos, los datos de la imagen pasan a formar parte del propio documento HTML, con lo que se eliminan las solicitudes de archivos de imagen por separado. Esto beneficia:

  • Aplicaciones de una sola página (SPA) que requieren un mínimo de idas y vueltas al servidor
  • Plantillas de correo electrónico en las que podrían bloquearse imágenes externas
  • Aplicaciones con capacidad offline que funcionan sin conectividad a la red
  • Generación dinámica de códigos de barras donde la creación de archivos físicos es ineficiente

Para el despliegue en producción, consulte nuestras guías sobre despliegue en Azure o despliegue en AWS para la generación de códigos de barras en la nube.

¿Cuándo debo utilizar URL de datos en lugar de archivos de imagen?

Utilice URL de datos cuando los códigos de barras sean pequeños (menos de 32 KB) y requieran una representación inmediata en línea. Elija archivos de imagen tradicionales almacenados en servidores o CDN cuando:

// Example: Choosing between Data URL and file export based on size
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("LARGE-DATA-STRING-HERE", BarcodeEncoding.PDF417);

// Check estimated size before choosing export method
if (barcode.BinaryStream.Length < 32768) // 32KB threshold
{
    // Use Data URL for smaller barcodes
    string dataUrl = barcode.ToDataUrl();
    // Embed directly in HTML
}
else
{
    // Save as file for larger barcodes
    barcode.SaveAsImage("large-barcode.png");
    // Reference as external resource
}
// Example: Choosing between Data URL and file export based on size
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("LARGE-DATA-STRING-HERE", BarcodeEncoding.PDF417);

// Check estimated size before choosing export method
if (barcode.BinaryStream.Length < 32768) // 32KB threshold
{
    // Use Data URL for smaller barcodes
    string dataUrl = barcode.ToDataUrl();
    // Embed directly in HTML
}
else
{
    // Save as file for larger barcodes
    barcode.SaveAsImage("large-barcode.png");
    // Reference as external resource
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

¿Cuáles son las limitaciones de tamaño de las URL de datos?

Aunque los navegadores modernos admiten técnicamente URL de datos de varios megabytes, existen limitaciones prácticas:

  • Internet Explorer 8: Limitado a 32 KB
  • Navegadores modernos: admiten de 2 a 4 MB, pero el rendimiento disminuye
  • Navegadores móviles: límites más estrictos debido a las limitaciones de memoria
  • Clientes de correo electrónico: Restringir las URL de datos a 8-64KB

Mantenga los códigos de barras de URL de datos por debajo de 32 KB para un rendimiento óptimo. Para códigos de barras más grandes o la generación de múltiples códigos de barras, utilice nuestra funcionalidad export as stream para una gestión eficiente de la memoria.

¿Cómo exportar un BarCode como etiqueta HTML?

Exporte un BarcodeGenerado a HTML utilizando el método ToHtmlTag(). Este método renderiza el objeto GeneratedBarcode como una etiqueta HTML completamente formada para su inyección directa en HTML sin dependencias de JavaScript, CSS o imágenes. El siguiente código muestra la exportación de etiquetas HTML:

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlTag.cs
using IronBarCode;
using System;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
var htmlTag = myBarcode.ToHtmlTag();
Console.WriteLine(htmlTag);
Imports IronBarCode
Imports System

Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
Private htmlTag = myBarcode.ToHtmlTag()
Console.WriteLine(htmlTag)
$vbLabelText   $csharpLabel

Adjunte el método ToHtmlTag() al GeneratedBarcode para obtener la etiqueta HTML del código de barras generado. Incruste esta etiqueta HTML directamente en un archivo HTML más grande. Para opciones de estilo avanzadas, consulte nuestra guía sobre personalización de estilos de códigos de barras.

¿Por qué es mejor la exportación de etiquetas HTML que las referencias de imágenes externas?

La exportación de etiquetas HTML ofrece ventajas clave sobre las referencias de imágenes externas:

  1. Sin enlaces de imagen rotos: los datos del código de barras se incrustan directamente en la etiqueta
  2. Representación más rápida: no se necesitan peticiones HTTP adicionales
  3. Implantación simplificada: sin gestión separada de activos de imagen
  4. Mejor seguridad: No se exponen rutas de archivos ni estructuras de servidores
  5. Generación dinámica: Perfecto para la creación de códigos de barras en tiempo real

He aquí un ejemplo práctico de integración de aplicaciones web:

// Generate multiple barcodes for a product catalog
var products = new[] { "PROD-001", "PROD-002", "PROD-003" };
var htmlBuilder = new StringBuilder();

foreach (var productCode in products)
{
    var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128)
        .ResizeTo(200, 50)
        .SetMargins(10);

    htmlBuilder.AppendLine($"<div class='product-barcode'>");
    htmlBuilder.AppendLine($"  <p>Product: {productCode}</p>");
    htmlBuilder.AppendLine($"  {barcode.ToHtmlTag()}");
    htmlBuilder.AppendLine($"</div>");
}
// Generate multiple barcodes for a product catalog
var products = new[] { "PROD-001", "PROD-002", "PROD-003" };
var htmlBuilder = new StringBuilder();

foreach (var productCode in products)
{
    var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128)
        .ResizeTo(200, 50)
        .SetMargins(10);

    htmlBuilder.AppendLine($"<div class='product-barcode'>");
    htmlBuilder.AppendLine($"  <p>Product: {productCode}</p>");
    htmlBuilder.AppendLine($"  {barcode.ToHtmlTag()}");
    htmlBuilder.AppendLine($"</div>");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

¿Cómo puedo personalizar los atributos de las etiquetas HTML generadas?

Aunque ToHtmlTag() genera una etiqueta img estándar, puedes mejorarla con atributos adicionales o envoltorios HTML personalizados. Para una personalización avanzada, combine IronBarcode con nuestras capacidades de estilización:

// Create a customized barcode with specific styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-123", BarcodeEncoding.Code128)
    .AddAnnotationTextAboveBarcode("Product ID")
    .SetMargins(15)
    .ChangeBackgroundColor(System.Drawing.Color.LightGray);

// Get the HTML tag and add custom attributes
string htmlTag = customBarcode.ToHtmlTag();
string customizedTag = htmlTag.Replace("<img", "<img class='barcode' id='product-123'");
// Create a customized barcode with specific styling
var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-123", BarcodeEncoding.Code128)
    .AddAnnotationTextAboveBarcode("Product ID")
    .SetMargins(15)
    .ChangeBackgroundColor(System.Drawing.Color.LightGray);

// Get the HTML tag and add custom attributes
string htmlTag = customBarcode.ToHtmlTag();
string customizedTag = htmlTag.Replace("<img", "<img class='barcode' id='product-123'");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

¿Cuándo debo elegir la etiqueta HTML en lugar del formato de URL de datos?

Elija el formato de etiqueta HTML cuando lo necesite:

  • Resultado HTML limpio y legible
  • Fácil integración con plantillas HTML existentes
  • Compatibilidad con editores HTML y sistemas CMS
  • Función directa de copiar y pegar para creadores de contenidos

El formato de etiqueta HTML funciona especialmente bien con aplicaciones Blazor en las que se inyectan dinámicamente imágenes de códigos de barras en los componentes.

¿Cómo guardar un BarCode como archivo HTML?

Guarde un BarcodeGenerado como un archivo HTML utilizando el método SaveAsHtmlFile(). El siguiente código demuestra este método:

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlFile.cs
using IronBarCode;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
myBarcode.SaveAsHtmlFile("myBarcode.html");
Imports IronBarCode

Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
myBarcode.SaveAsHtmlFile("myBarcode.html")
$vbLabelText   $csharpLabel

Este método acepta una cadena de ruta de archivo. El archivo HTML generado contiene el código de barras como una etiqueta HTML dentro de las etiquetas <html>, <head> y <body> adecuadas, formando un archivo HTML completo. Para situaciones complejas con varios formatos de archivo, consulte nuestra guía de formatos de datos de salida.

¿Por qué generar archivos HTML completos en lugar de fragmentos?

Los archivos HTML completos ofrecen distintas ventajas para casos de uso específicos:

  • Documentación estándar: Generar hojas de códigos de barras imprimibles
  • Adjuntos de correo electrónico: Envíe archivos de códigos de barras autocontenidos
  • Propósitos de archivo: Almacenar códigos de barras con la estructura adecuada
  • Pruebas y depuración: Visualización independiente de códigos de barras
  • Procesamiento por lotes: Generar múltiples archivos para su distribución

He aquí un ejemplo de generación de un lote de archivos HTML:

// Generate HTML files for inventory items
public void GenerateInventoryBarcodes(List<InventoryItem> items)
{
    foreach (var item in items)
    {
        var barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128)
            .AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}")
            .ResizeTo(300, 100);

        // Save with descriptive filename
        string filename = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html";
        barcode.SaveAsHtmlFile(filename);
    }
}
// Generate HTML files for inventory items
public void GenerateInventoryBarcodes(List<InventoryItem> items)
{
    foreach (var item in items)
    {
        var barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128)
            .AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}")
            .ResizeTo(300, 100);

        // Save with descriptive filename
        string filename = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html";
        barcode.SaveAsHtmlFile(filename);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

¿Cuáles son los casos de uso comunes para la exportación de archivos HTML?

La exportación de archivos HTML resulta muy útil en estos casos:

  1. Sistemas de punto de venta minorista: Generar etiquetas de precios imprimibles
  2. Gestión de almacenes: Crear etiquetas de códigos de barras para estanterías
  3. Gestión de documentos: incrustación de códigos de barras en informes
  4. Control de calidad: Generar códigos de lote trazables
  5. Gestión de eventos: Crear tickets con códigos escaneables

Para la generación de códigos de barras de gran volumen, implemente async y multithreading para mejorar el rendimiento. Cuando se trabaja con formatos especializados como los códigos QR, nuestro tutorial C# QR Code Generator proporciona una guía completa sobre la creación y personalización de códigos QR para diversas necesidades empresariales.

Preguntas Frecuentes

¿Cómo puedo exportar un código de barras como una URL de datos en C#?

Con IronBarcode, puede exportar un código de barras como una URL de datos utilizando el método ToDataUrl() en un objeto GeneratedBarcode. Basta con crear el código de barras mediante BarcodeWriter.CreateBarcode() con el valor y la codificación deseados y, a continuación, llamar a ToDataUrl() para obtener la cadena URL de datos que puede incrustarse directamente en HTML.

¿Cuáles son los tres formatos de exportación HTML disponibles para los códigos de barras?

IronBarcode ofrece tres formatos de exportación HTML: URL de datos para incrustación en línea sin archivos externos, etiqueta HTML para inyección directa en páginas web y archivo HTML completo para uso independiente. Cada formato responde a diferentes necesidades de integración en aplicaciones web.

¿Puedo generar una etiqueta de imagen HTML para un código de barras con una sola línea de código?

Sí, IronBarcode le permite generar una etiqueta de imagen HTML completamente formada con una sola línea de código fluido. Utilice BarcodeWriter.CreateBarcode() con el valor y la codificación de su código de barras y, a continuación, encadene el método ToHtmlTag() para obtener una etiqueta de imagen HTML completa lista para su inserción.

¿Cuándo debo utilizar URL de datos en lugar de archivos de imagen tradicionales para los códigos de barras?

Utilice URL de datos cuando los códigos de barras sean pequeños (menos de 32 KB) y requieran una representación inmediata en línea. Son ideales para aplicaciones de una sola página, plantillas de correo electrónico, aplicaciones sin conexión y escenarios de generación dinámica de códigos de barras. El método ToDataUrl() de IronBarcode facilita esta conversión.

¿Qué formatos de código de barras son compatibles con la exportación HTML?

IronBarcode admite todos sus formatos de código de barras para la exportación a HTML, incluidos el Código 128, los códigos QR y muchos otros. Los métodos ToDataUrl(), ToHtmlTag() y de exportación de archivos HTML funcionan con todos los formatos de código de barras compatibles de la biblioteca.

¿Cómo mejora el rendimiento de las aplicaciones web el uso de URL de datos?

Las URL de datos mejoran el rendimiento al incrustar los datos de la imagen del código de barras directamente en el documento HTML, eliminando las peticiones HTTP separadas para los archivos de imagen. Esto reduce los viajes de ida y vuelta del servidor y mejora los tiempos de carga de la página, lo que resulta especialmente beneficioso cuando se utiliza IronBarcode para la generación dinámica de códigos de barras en aplicaciones web.

Hairil Hasyimi Bin Omar
Ingeniero de Software
Como todos los grandes ingenieros, Hairil es un ávido aprendiz. Está refinando su conocimiento de C#, Python y Java, usando ese conocimiento para agregar valor a los miembros del equipo en Iron Software. Hairil se unió al equipo de Iron Software desde la Universiti Teknologi MARA en Malasia, donde se ...
Leer más
¿Listo para empezar?
Nuget Descargas 2,002,059 | Versión: 2025.12 recién lanzado