Como Exportar Códigos de Barras como HTML em C#

Updated: 4 de junho de 2026

O IronBarcode permite que desenvolvedores C# exportem códigos de barras gerados como HTML em três formatos: URL de Dados para incorporação inline, tag HTML para injeção direta ou arquivo HTML completo para uso independente—oferecendo opções versáteis de integração sem dependências externas.

Início Rápido: Exporte um Código de Barras como uma Tag HTML com Uma Linha

Gere um código de barras e exporte-o diretamente como uma tag de imagem HTML completamente formada usando uma única linha de código fluente. Comece rapidamente sem gerenciar arquivos de imagem externos ou dependências de ativos.

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2Copie e execute este trecho de código.

var htmlTag = BarcodeWriter.CreateBarcode("1234567890", BarcodeWriterEncoding.Code128).ToHtmlTag();

var htmlTag = BarcodeWriter.CreateBarcode("1234567890", BarcodeWriterEncoding.Code128).ToHtmlTag();

3Implante para testar em seu ambiente de produção.

Comece a usar IronBarcode em seu projeto hoje com uma avaliação gratuita

Fluxo de trabalho mínimo (5 etapas)

Baixe a biblioteca C# para exportar códigos de barras
Exportar códigos de barras como URL de dados
Exportar códigos de barras como tag HTML
Exportar códigos de barras como arquivo HTML

Como Eu Exporto um Código de Barras como uma URL de Dados?

Antes de exportar um código de barras como uma URL de Dados, entenda o que é uma URL de Dados. Uma URL de Dados (também conhecida como URI de Dados) é um Identificador de Recurso Uniforme que incorpora dados diretamente na string da URL. Isso permite exibição inline em páginas web como se os dados fossem recursos externos. As URLs de Dados suportam qualquer formato: texto, imagens, áudio, vídeo e dados binários. Use a URL de Dados obtida em HTML dentro de uma tag de imagem como um atributo src. Veja como converter um GeneratedBarcode em uma URL de Dados:

using IronBarCode;
using System;

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

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)

Imports IronBarCode
Imports System

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

Crie um código de barras usando o método CreateBarcode() da classe BarcodeWriter com o valor do código de barras e a codificação como argumentos. Obtenha a URL de Dados anexando o método ToDataUrl() ao GeneratedBarcode. Essa abordagem funciona com todos os formatos de código de barras suportados no IronBarcode.

Por Que Usar URL de Dados é Relevante para Aplicações Web?

As URLs de Dados oferecem vantagens significativas para aplicações web ao reduzir pedidos HTTP e melhorar o desempenho do carregamento da página. Quando você incorpora um código de barras como uma URL de Dados, os dados da imagem tornam-se parte do próprio documento HTML, eliminando solicitações de arquivos de imagem separadas. Isso beneficia:

Aplicações de página única (SPAs) que requerem viagens mínimas ao servidor
Modelos de e-mail onde imagens externas podem ser bloqueadas
Aplicações capazes de operar offline que funcionam sem conectividade de rede
Geração de códigos de barras dinâmica onde criar arquivos físicos é ineficiente

Para implantação em produção, veja nossos guias sobre como implantar no Azure ou implantar na AWS para geração de códigos de barras baseada em nuvem.

Quando Devo Usar URL de Dados em vez de Arquivos de Imagem?

Use URLs de Dados quando os códigos de barras forem pequenos (menos de 32KB) e requerem renderização inline imediata. Escolha arquivos de imagem tradicionais armazenados em servidores ou CDNs quando:

// 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
}

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

' Check estimated size before choosing export method
If barcode.BinaryStream.Length < 32768 Then ' 32KB threshold
    ' Use Data URL for smaller barcodes
    Dim dataUrl As String = barcode.ToDataUrl()
    ' Embed directly in HTML
Else
    ' Save as file for larger barcodes
    barcode.SaveAsImage("large-barcode.png")
    ' Reference as external resource
End If

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

' Check estimated size before choosing export method
If barcode.BinaryStream.Length < 32768 Then ' 32KB threshold
    ' Use Data URL for smaller barcodes
    Dim dataUrl As String = barcode.ToDataUrl()
    ' Embed directly in HTML
Else
    ' Save as file for larger barcodes
    barcode.SaveAsImage("large-barcode.png")
    ' Reference as external resource
End If

Quais São as Limitações de Tamanho das URLs de Dados?

Embora os navegadores modernos tecnicamente suportem URLs de Dados de vários megabytes, existem limitações práticas:

Internet Explorer 8: Limitado a 32KB
Navegadores modernos: Suportam 2-4MB, mas o desempenho se degrada
Navegadores móveis: Limites mais rígidos devido a restrições de memória
Clientes de e-mail: Restringem URLs de Dados a 8-64KB

Mantenha os códigos de barras de URL de Dados abaixo de 32KB para desempenho ideal. Para códigos de barras maiores ou geração de múltiplos códigos de barras, use nossa funcionalidade de exportação como stream para gerenciamento eficiente de memória.

Como exportar um código de barras como uma tag HTML?

Exporte um GeneratedBarcode para HTML usando o método ToHtmlTag(). Este método renderiza o objeto GeneratedBarcode como uma tag HTML totalmente formada para injeção direta em HTML sem dependências de JavaScript, CSS ou imagem. O código a seguir demonstra a exportação de tags HTML:

using IronBarCode;
using System;

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

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)

Imports IronBarCode
Imports System

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

Anexe o método ToHtmlTag() ao GeneratedBarcode para obter a tag HTML do código de barras gerado. Incorpore esta tag HTML diretamente em um arquivo HTML maior. Para opções avançadas de estilo, consulte nosso guia sobre personalização de estilos de código de barras.

Por que a exportação de tags HTML é melhor do que referências de imagem externas?

A exportação de tags HTML oferece vantagens chave sobre as referências de imagem externas:

Nenhum link de imagem quebrado: Dados do código de barras incorporados diretamente na tag
Renderização mais rápida: Nenhuma requisição HTTP adicional necessária
Implantação simplificada: Nenhum gerenciamento de ativos de imagem separado
Melhor segurança: Nenhuma exposição de caminho de arquivo ou estrutura de servidor
Geração dinâmica: Perfeito para criação em tempo real de códigos de barras

Aqui está um exemplo prático de integração em aplicações 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>");
}

Imports System.Text

' Generate multiple barcodes for a product catalog
Dim products = New String() {"PROD-001", "PROD-002", "PROD-003"}
Dim htmlBuilder = New StringBuilder()

For Each productCode In products
    Dim 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>")
Next

Imports System.Text

' Generate multiple barcodes for a product catalog
Dim products = New String() {"PROD-001", "PROD-002", "PROD-003"}
Dim htmlBuilder = New StringBuilder()

For Each productCode In products
    Dim 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>")
Next

Como posso personalizar os atributos da tag HTML gerada?

Enquanto ToHtmlTag() gera uma tag img padrão, você pode melhorá-la com atributos adicionais ou encapsulamento HTML personalizado. Para personalização avançada, combine IronBarcode com nossas capacidades de estilo:

// 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'");

Imports System.Drawing

' Create a customized barcode with specific styling
Dim customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-123", BarcodeEncoding.Code128) _
    .AddAnnotationTextAboveBarcode("Product ID") _
    .SetMargins(15) _
    .ChangeBackgroundColor(Color.LightGray)

' Get the HTML tag and add custom attributes
Dim htmlTag As String = customBarcode.ToHtmlTag()
Dim customizedTag As String = htmlTag.Replace("<img", "<img class='barcode' id='product-123'")

Imports System.Drawing

' Create a customized barcode with specific styling
Dim customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-123", BarcodeEncoding.Code128) _
    .AddAnnotationTextAboveBarcode("Product ID") _
    .SetMargins(15) _
    .ChangeBackgroundColor(Color.LightGray)

' Get the HTML tag and add custom attributes
Dim htmlTag As String = customBarcode.ToHtmlTag()
Dim customizedTag As String = htmlTag.Replace("<img", "<img class='barcode' id='product-123'")

Quando devo escolher a tag HTML em vez do formato de URL de Dados?

Escolha o formato de tag HTML quando precisar de:

Saída HTML limpa e legível
Integração fácil com modelos HTML existentes
Compatibilidade com editores HTML e sistemas CMS
Funcionalidade de copiar e colar direto para criadores de conteúdo

O formato de tag HTML funciona particularmente bem com aplicações Blazor onde você injeta dinamicamente imagens de códigos de barras em componentes.

Como salvo um código de barras como um arquivo HTML?

Salve um GeneratedBarcode como um arquivo HTML usando o método SaveAsHtmlFile(). O código a seguir demonstra este método:

using IronBarCode;

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

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")

Imports IronBarCode

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

Este método aceita uma string de caminho de arquivo. O arquivo HTML gerado contém o código de barras como uma tag HTML dentro de tags <html>, <head> e <body> formando um arquivo HTML completo. Para cenários complexos com vários formatos de arquivo, veja nosso guia de formatos de dados de saída.

Por que gerar arquivos HTML completos em vez de fragmentos?

Arquivos HTML completos oferecem vantagens distintas para casos de uso específicos:

Documentação autônoma: Gerar folhas de códigos de barras imprimíveis
Anexos de e-mail: Enviar arquivos de códigos de barras autossuficientes
Fins de arquivamento: Armazenar códigos de barras com estrutura adequada
Teste e depuração: Visualizar códigos de barras independentemente
Processamento em lote: Gerar múltiplos arquivos para distribuição

Aqui está um exemplo gerando um lote de arquivos 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);
    }
}

' Generate HTML files for inventory items
Public Sub GenerateInventoryBarcodes(items As List(Of InventoryItem))
    For Each item In items
        Dim barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128) _
            .AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}") _
            .ResizeTo(300, 100)

        ' Save with descriptive filename
        Dim filename As String = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html"
        barcode.SaveAsHtmlFile(filename)
    Next
End Sub

' Generate HTML files for inventory items
Public Sub GenerateInventoryBarcodes(items As List(Of InventoryItem))
    For Each item In items
        Dim barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128) _
            .AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}") _
            .ResizeTo(300, 100)

        ' Save with descriptive filename
        Dim filename As String = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html"
        barcode.SaveAsHtmlFile(filename)
    Next
End Sub

Quais são os casos de uso comuns para exportação de arquivo HTML?

A exportação de arquivo HTML prova ser valiosa nestes cenários:

Sistemas de ponto de venda no varejo: Gerar etiquetas de preço imprimíveis
Gestão de armazéns: Criar etiquetas de código de barras para prateleiras
Gestão de documentos: Incorporar códigos de barras em relatórios
Controle de qualidade: Gerar códigos de lote rastreáveis
Gestão de eventos: Crie ingressos com códigos escaneáveis

Para geração de código de barras em grande volume, implemente async e multithreading para melhorar o desempenho. Ao trabalhar com formatos especializados como códigos QR, nosso tutorial de Gerador de Código QR em C# fornece orientação abrangente sobre como criar e personalizar códigos QR para diversas necessidades empresariais.

Perguntas frequentes

Como faço para exportar um código de barras como uma URL de dados em C#?

Com o IronBarcode, você pode exportar um código de barras como uma URL de dados usando o método `ToDataUrl()` em um objeto `GeneratedBarcode`. Basta criar seu código de barras usando `BarcodeWriter.CreateBarcode()` com o valor e a codificação desejados e, em seguida, chamar `ToDataUrl()` para obter a string da URL de dados que pode ser incorporada diretamente em HTML.

Quais são os três formatos de exportação HTML disponíveis para códigos de barras?

O IronBarcode oferece três formatos de exportação HTML: URL de dados para incorporação direta sem arquivos externos, tag HTML para inserção direta em páginas da web e arquivo HTML completo para uso independente. Cada formato atende a diferentes necessidades de integração em aplicações web.

Posso gerar uma tag de imagem HTML para um código de barras com apenas uma linha de código?

Sim, o IronBarcode permite gerar uma tag de imagem HTML completa com uma única linha de código. Use o método `BarcodeWriter.CreateBarcode()` com o valor e a codificação do seu código de barras e, em seguida, encadeie o método `ToHtmlTag()` para obter uma tag de imagem HTML completa, pronta para inserção.

Quando devo usar URLs de dados em vez de arquivos de imagem tradicionais para códigos de barras?

Use URLs de dados quando os códigos de barras forem pequenos (menos de 32 KB) e exigirem renderização embutida imediata. Eles são ideais para aplicativos de página única, modelos de e-mail, aplicativos com capacidade offline e cenários de geração dinâmica de códigos de barras. O método ToDataUrl() do IronBarcode torna essa conversão perfeita.

Quais formatos de código de barras são suportados para exportação em HTML?

O IronBarcode suporta todos os seus formatos de código de barras para exportação em HTML, incluindo Code 128, códigos QR e muitos outros. Os métodos ToDataUrl(), ToHtmlTag() e exportação para arquivos HTML funcionam com todos os formatos de código de barras suportados na biblioteca.

Como o uso de URLs de dados melhora o desempenho de aplicativos web?

Os URLs de dados melhoram o desempenho ao incorporar os dados da imagem do código de barras diretamente no documento HTML, eliminando solicitações HTTP separadas para arquivos de imagem. Isso reduz as viagens de ida e volta ao servidor e melhora os tempos de carregamento da página, o que é particularmente benéfico ao usar o IronBarcode para geração dinâmica de códigos de barras em aplicações web.

What are common use cases for exporting barcodes as complete HTML files?

Complete HTML file export is used for standalone documentation, sending barcode files as email attachments, archiving with structural integrity, testing, debugging, and batch processing for distribution.

How does IronBarcode facilitate fast integration of barcode HTML tags?

IronBarcode offers a quickstart method to generate and export barcodes as a fully-formed HTML image tag with a single line of fluent code, eliminating the need to manage external files or assets.

How can you customize the generated HTML tag attributes in IronBarcode?

While `ToHtmlTag()` provides standard HTML tags, you can enhance these with custom attributes using additional HTML wrapping and IronBarcode’s styling capabilities for advanced customization options.

What scenarios benefit from generating complete HTML files for barcodes?

Generating complete HTML files benefits retail point-of-sale systems for printable tags, warehouse management for labeling, document management for reports, quality control, and event management for tickets with scannable codes.