Como gerar códigos de barras em C# usando o IronBarcode

Como instalar uma biblioteca de gerador de código de barras usando o NuGet Package Manager?

Abra o Visual Studio e instale o pacote NuGet com este comando no Console do Gerenciador de Pacotes:

Install-Package BarCode

O pacote NuGet suporta .NET 10, .NET 8, .NET 6, .NET Core, .NET Standard e .NET Framework -- tornando-o compatível com aplicativos Windows e aplicativos .NET multiplataforma. IronBarcode suporta implantação em contêineres Docker, Azure e servidores Linux. Encontre mais detalhes e documentação de referência na página de documentação do IronBarcode e no projeto GitHub do Iron Software.

Após a instalação, você verá o namespace IronBarCode disponível em seu projeto. A biblioteca não requer dependências de tempo de execução adicionais no Windows -- no Linux, você pode precisar instalar algumas bibliotecas de sistema conforme documentado no guia de implantação do IronBarcode para Linux.

Como você gera um arquivo de imagem de código de barras simples em C#?

Crie imagens de código de barras com apenas algumas linhas de código. O exemplo a seguir mostra a geração de código de barras que salva um arquivo de imagem PNG:

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

using IronBarCode;

// Generate a simple barcode and encode the string data
var barcode = BarcodeWriter.CreateBarcode("SKU-78432-X", BarcodeWriterEncoding.Code128);

// Save the barcode as a PNG image file
barcode.SaveAsPng("product-barcode.png");

O método BarcodeWriter.CreateBarcode() aceita uma string para codificar e o formato do código de barras de BarcodeWriterEncoding. A referência retornada GeneratedBarcode fornece métodos de estilo e opções de exportação para salvar em PNG, JPEG, BMP, TIFF, PDF ou HTML.

Como você cria um código QR e outros tipos de códigos de barras 2D?

O IronBarcode suporta todos os principais formatos de código de barras, incluindo tipos de código de barras 2D, como QR Code e Data Matrix. Gere um código QR com sintaxe semelhante:

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

using IronBarCode;

// Create a QR code and encode URL data
var qrCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode/",
    BarcodeWriterEncoding.QRCode
);
qrCode.SaveAsPng("website-qr.png");

Os tipos de códigos de barras QR são excelentes para armazenar URLs e cargas de dados maiores. A biblioteca lida com correção de erros automaticamente, garantindo que o código de barras permaneça legível, mesmo quando parcialmente danificado. Por padrão, o IronBarcode usa o nível de correção de erros M (médio), que recupera cerca de 15% da perda de dados -- você pode aumentar isso para o nível H para códigos de barras impressos que podem ser riscados ou parcialmente obscurecidos.

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

using IronBarCode;

// Generate an EAN-13 barcode compatible with UPC for retail print applications
var eanBarcode = BarcodeWriter.CreateBarcode("5901234123457", BarcodeWriterEncoding.EAN13);
eanBarcode.SaveAsPng("retail-product.png");

Como você cria um código QR estilizado com opções de estilo avançadas?

A geração profissional de códigos de barras frequentemente requer opções avançadas de estilização para ajustar cores e adicionar anotações. A classe GeneratedBarcode fornece uma API fluente com métodos de estilo:

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

// Create a styled barcode with advanced styling options
var styledBarcode = BarcodeWriter
    .CreateBarcode("INV-2025-001847", BarcodeWriterEncoding.Code128)
    .ResizeTo(400, 120)
    .SetMargins(20)
    .ChangeBarCodeColor(Color.DarkBlue)
    .AddAnnotationTextAboveBarcode("Invoice Number:")
    .AddBarcodeValueTextBelowBarcode();

// Verify to ensure proper scanning after styling
bool isReadable = styledBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
styledBarcode.SaveAsPng("styled-invoice-barcode.png");

A API fluente permite encadear métodos de estilização para ajustar cores, definir margens e adicionar texto em uma única instrução. O método Verify() indica se o seu código de barras continua legível por máquinas -- garantindo a leitura correta na produção após a aplicação de cores não padrão ou redimensionamento para dimensões pequenas.

Alterar a cor das barras para um tom muito claro ou um azul com baixo contraste contra um fundo branco pode fazer com que o código de barras não seja digitalizado. Sempre chame Verify() após qualquer mudança de cor. Se a verificação falhar, aumente o contraste ou volte para barras pretas. O guia de estilização e personalização de códigos de barras cobre todos os métodos de estilo disponíveis em detalhe.

Para gerar múltiplos códigos de barras com estilo consistente em todo um catálogo, construa um método auxiliar que aplique sua cadeia de estilo padrão a cada instância GeneratedBarcode. Essa abordagem garante margens uniformes, tamanho da fonte e cor em milhares de imagens geradas.

Como Exportar Códigos de Barras para Diferentes Formatos de Imagem?

Gere imagens de código de barras em múltiplos formatos para diferentes casos de uso. A biblioteca salva em PNG, JPEG, BMP, TIFF, PDF e HTML:

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("EXPORT-TEST", BarcodeWriterEncoding.Code128);

// Export barcode images to various formats
barcode.SaveAsPng("barcode.png");           // Web-compatible raster image
barcode.SaveAsJpeg("barcode.jpg");          // Compressed format for email attachments
barcode.SaveAsTiff("barcode.tiff");         // High-quality format for print workflows
barcode.SaveAsPdf("barcode.pdf");           // PDF document output
barcode.SaveAsHtmlFile("barcode.html");     // HTML for inline web embedding

// Get as bitmap stream for web APIs or database storage
System.IO.Stream barcodeStream = barcode.ToStream();
System.Drawing.Bitmap bitmapImage = barcode.ToBitmap();

O método ToStream() retorna dados de código de barras compatíveis com APIs web ASP.NET Core e aplicações Blazor. O método ToBitmap() fornece uma referência System.Drawing.Bitmap para uma manipulação de imagem adicional. Para carimbar códigos de barras em documentos PDF existentes, veja o tutorial de código de barras PDF do IronBarcode.

Quais Ambientes .NET Multiplataforma IronBarcode Suporta?

IronBarcode suporta a geração de códigos de barras em todas as principais plataformas .NET. Implemente em:

O guia de configuração Docker do IronBarcode fornece detalhes sobre as bibliotecas de sistema necessárias para implantações em contêineres. Quando executado no Linux, você geralmente precisa de libgdiplus e libc6-dev instalados na sua imagem Docker. No Alpine Linux, é necessário um conjunto ligeiramente diferente de pacotes — o guia cobre ambos os Dockerfiles Ubuntu/Debian e Alpine.

Para implantações no AWS Lambda, o tutorial de implantação no AWS Lambda explica como agrupar dependências nativas no pacote de implantação e configurar limites de memória para lidar com cargas de trabalho de renderização de códigos de barras.

Como Seguir as Melhores Práticas para Geração de Código de Barras no .NET?

Seguir um conjunto consistente de práticas ao gerar imagens de código de barras em aplicações C# faz a diferença entre códigos de barras que são digitalizados de forma confiável no campo e aqueles que falham no ponto de venda ou no chão de armazenamento. As diretrizes abaixo se aplicam independentemente do formato de código de barras que você escolher.

Escolha o formato de código de barras certo para o seu caso de uso. Selecione um formato que corresponda ao seu ambiente de digitalização e requisitos de dados. Use códigos QR para URLs e cargas de dados com mais de 80 caracteres. Use o Code 128 para inventário e logística onde dados alfanuméricos devem caber em um símbolo linear compacto. Use EAN-13 ou UPC-A para produtos de varejo que precisam ser registrados no sistema GS1. A página de comparação de formatos de código de barras do IronBarcode fornece uma referência lado a lado de todos os tipos suportados, seus limites de capacidade e casos de uso recomendados.

Sempre inclua zonas quietas suficientes. O espaço em branco ao redor de um código de barras -- chamado de zona quieta -- é tão importante quanto as próprias barras. Os scanners o utilizam para detectar onde o símbolo começa e termina. Use o método SetMargins() para adicionar pelo menos 10 pixels de preenchimento em todos os lados para exibição digital e pelo menos 2,5 mm para saída de impressão. Entrar na zona quieta é uma das causas mais comuns de falhas de digitalização na produção.

Verifique após qualquer mudança de estilo. Após ajustar cores, aplicar gradientes ou redimensionar para uma dimensão não padrão, chame Verify() no objeto GeneratedBarcode. Se retornar falso, seu código de barras não será digitalizado de forma confiável com hardware padrão. Ou aumente o contraste ou reduza a complexidade da alteração de estilo.

Use padrões de geração em lote para saída em grande volume. Se sua aplicação gera milhares de códigos de barras -- por exemplo, etiquetas de produtos ou manifestos de envio -- processe-os em um loop e reutilize a mesma configuração de estilo. Evite carregar ativos de fontes ou objetos de configuração dentro do loop, pois isso cria sobrecarga desnecessária. O exemplo de geração de código de barras em lote do IronBarcode demonstra um padrão de loop eficiente com saída consistente.

Teste em múltiplos modelos de scanner e condições de iluminação. Scanners de código de barras variam em sua tolerância para cores de baixo contraste, tamanhos pequenos de módulo e qualidade de impressão. Teste códigos de barras impressos com pelo menos dois tipos de scanner diferentes antes de implantar. Para códigos QR exibidos em telas, teste com câmeras de telefone móvel em condições de iluminação tanto brilhante quanto fraca. A página de padrões de verificação de código de barras GS1 fornece orientações autoritativas sobre classificação de qualidade de símbolos para códigos de barras de varejo.

Respeite os limites de capacidade de dados. Cada formato de código de barras tem uma capacidade máxima de dados. O Code 128 pode codificar confortavelmente até aproximadamente 48 caracteres antes que o símbolo se torne muito largo para imprimir em tamanhos de etiqueta padrão. A capacidade do código QR depende do nível de correção de erros -- no nível H, o máximo é em torno de 1.273 caracteres alfanuméricos. Exceder a capacidade força a biblioteca a lançar uma exceção ou degradar silenciosamente a qualidade. Verifique a referência de capacidade de dados de código QR na Wikipedia para uma tabela de capacidade rápida.

Siga os padrões de descarte do .NET. O GeneratedBarcode e qualquer fluxo retornado por ToStream() implementam IDisposable. Envolva-os em declarações using para liberar recursos não gerenciados prontamente, especialmente em aplicações web de alta demanda onde a geração de códigos de barras ocorre por solicitação.

Compreender modos comuns de falha também ajuda a construir códigos de geração mais resilientes. As três causas mais frequentes de falhas de digitalização são: zona quieta insuficiente, cor da barra muito próxima à cor de fundo, e código de barras escalado abaixo do tamanho de módulo mínimo para o formato escolhido. O método Verify() do IronBarcode captura todos os três em tempo de execução.

Para ler códigos de barras de imagens geradas -- para testes de ida e volta ou digitalização de arquivos carregados -- veja o guia do leitor de código de barras IronBarcode. A API do leitor espelha a API do escritor em simplicidade e suporta a mesma ampla gama de formatos.

O padrão ISO/IEC 15417 para Code 128 e o padrão ISO/IEC 18004 para códigos QR definem as especificações técnicas com as quais o IronBarcode está em conformidade. Revisar o padrão relevante para o tipo de código de barras alvo ajuda a entender as restrições dentro das quais a biblioteca deve operar.

Quais são os seus próximos passos?

Este guia cobriu a geração de imagens de código de barras em C# usando o IronBarcode -- desde a instalação do NuGet até a geração de Code 128, códigos QR e EAN-13, estilizacao avançada com a API fluente, exportação multiformato, implantação em várias plataformas e melhores práticas de produção.

Para ir além, explore estes recursos:

• Referência completa da API do IronBarcode -- documentação completa do método para BarcodeWriter, GeneratedBarcode, e todas as enumerações
• Tutorial do leitor de código de barras IronBarcode -- lendo e decodificando códigos de barras de imagens, PDFs e fluxos
• Exemplo de geração de código de barras em lote -- padrões de geração em alto volume para impressão de etiquetas e fluxos de trabalho de envio
• Licenciamento e preços do IronBarcode -- opções a partir de $799

Baixe o IronBarcode para adicionar funcionalidade de código de barras às suas aplicações .NET, ou inicie um teste gratuito de 30 dias para gerar imagens de código de barras em seu ambiente sem chave de licença.