Como gerar imagens de código de barras em C#

How to Generate Barcode Images in C# .NET Applications

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

Precisa gerar rapidamente imagens de códigos de barras profissionais em suas aplicações .NET? Este tutorial mostra exatamente como criar, personalizar e exportar códigos de barras usando o IronBarcode - desde implementações simples de uma linha até técnicas avançadas de estilização que oferecem controle total sobre a aparência do seu código de barras.

Início Rápido: Crie e Salve uma Imagem de Código de Barras Instantaneamente

Com o IronBarcode, você pode gerar e exportar uma imagem de código de barras com apenas uma chamada simples. Use o método CreateBarcode com o seu texto, escolha o formato e tamanho, depois chame SaveAsPng — sem necessidade de configuração complexa.

  1. Instale IronBarcode com o Gerenciador de Pacotes NuGet

    PM > Install-Package BarCode
  2. Copie e execute este trecho de código.

    IronBarCode.BarcodeWriter.CreateBarcode("Hello123", BarcodeWriterEncoding.Code128, 200, 100).SaveAsPng("barcode.png");
  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer

How Do I Install a Barcode Generator Library in C#?

Instalar o IronBarcode leva apenas segundos usando o Gerenciador de Pacotes NuGet. Você pode instalá-lo diretamente através do Console do Gerenciador de Pacotes ou baixar o DLL manualmente.

Install-Package BarCode
IronBarcode simplifica a geração de códigos de barras em aplicações .NET com recursos poderosos e APIs fáceis de usar *IronBarcode oferece capacidades abrangentes de geração de códigos de barras para desenvolvedores .NET*

How Can I Generate a Simple Barcode Using C#?

Criar seu primeiro código de barras requer apenas duas linhas de código. O exemplo abaixo demonstra como gerar um código de barras padrão Code128 e salvá-lo como um arquivo de imagem.

using IronBarCode;

// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128);

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

// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });
using IronBarCode;

// Create a barcode with your desired content and encoding type
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.Code128);

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

// Optional: Open the generated image in your default viewer
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("myBarcode.png") { UseShellExecute = true });
$vbLabelText   $csharpLabel

O método BarcodeWriter.CreateBarcode() é seu ponto de entrada para a geração de códigos de barras. Ele aceita dois parâmetros: os dados que você deseja codificar e o formato de código de barras do enum BarcodeWriterEncoding. O IronBarcode suporta todos os principais formatos de códigos de barras, incluindo Code128, Code39, EAN13, UPC-A, PDF417, DataMatrix e códigos QR.

Uma vez gerado, o objeto GeneratedBarcode fornece múltiplas opções de exportação. Você pode salvá-lo em vários formatos de imagem (PNG, JPEG, GIF, TIFF), exportar para PDF, ou até mesmo recuperá-lo como um System.Drawing.Bitmap para processamento adicional em sua aplicação.

Exemplo de um código de barras Code128 gerado usando IronBarcode em C# *A Code128 barcode generated with IronBarcode displaying a URL*

Posso Personalizar a Aparência dos Códigos de Barras Gerados?

IronBarcode oferece opções de personalização extensivas que vão muito além da geração básica de códigos de barras. Você pode adicionar anotações, ajustar cores, definir margens e controlar todos os aspectos da aparência do seu código de barras.

using IronBarCode;
using IronSoftware.Drawing;

// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode", 
    BarcodeWriterEncoding.QRCode
);

// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");

// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();

// Set consistent margins around the barcode
myBarCode.SetMargins(100);

// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);

// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");
using IronBarCode;
using IronSoftware.Drawing;

// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode", 
    BarcodeWriterEncoding.QRCode
);

// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");

// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();

// Set consistent margins around the barcode
myBarCode.SetMargins(100);

// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);

// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");
$vbLabelText   $csharpLabel

A classe GeneratedBarcode fornece um rico conjunto de métodos para personalização:

  • Anotações: Use AddAnnotationTextAboveBarcode() e AddAnnotationTextBelowBarcode() para adicionar etiquetas ou instruções personalizadas ao redor do seu código de barras
  • Exibição de Valor: O método AddBarcodeValueTextBelowBarcode() exibe automaticamente os dados codificados em formato legível
  • Espaçamento: Controle o espaço em branco com SetMargins() para garantir a correta leitura e apelo visual
  • Cores: Altere as cores de primeiro plano e fundo usando ChangeBarCodeColor() e ChangeBackgroundColor()
  • Opções de Exportação: Salve como arquivos de imagem, PDFs ou documentos HTML auto-contidos
Customized purple QR code with annotations generated using IronBarcode styling features *Um código QR estilizado com cor personalizada e texto de anotação*

Para opções detalhadas de personalização, explore a documentação da classe GeneratedBarcode que abrange todos os métodos e propriedades de estilo disponíveis.

Como Eu Crio e Exporto um Código de Barras em Uma Linha de Código?

IronBarcode implementa um padrão de design de API fluente que permite o encadeamento de métodos para um código mais conciso e legível. Esta abordagem é particularmente útil ao aplicar múltiplas transformações ao seu código de barras.

using IronBarCode;
using IronSoftware.Drawing;

// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";

// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
    .CreateBarcode(value, BarcodeWriterEncoding.PDF417)  // Create PDF417 barcode
    .ResizeTo(300, 200)                                  // Set specific dimensions
    .SetMargins(10)                                      // Add 10px margins
    .ToBitmap();                                         // Convert to bitmap

// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;
using IronBarCode;
using IronSoftware.Drawing;

// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";

// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
    .CreateBarcode(value, BarcodeWriterEncoding.PDF417)  // Create PDF417 barcode
    .ResizeTo(300, 200)                                  // Set specific dimensions
    .SetMargins(10)                                      // Add 10px margins
    .ToBitmap();                                         // Convert to bitmap

// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;
$vbLabelText   $csharpLabel

O padrão de API fluente oferece várias vantagens:

  • Legibilidade: Encadeie operações em uma sequência lógica que se lê como linguagem natural
  • Eficiência: Reduza declarações de variáveis e etapas intermediárias
  • Flexibilidade: Adicione ou remova operações facilmente sem reestruturação do seu código

Operações fluentes comuns incluem:

  • ResizeTo(): Controle dimensões exatas do código de barras
  • SetMargins(): Adicione espaçamento consistente
  • ChangeBarCodeColor(): Modifique a aparência
  • AddAnnotationTextAboveBarcode(): Inclua texto descritivo
  • ToBitmap(), SaveAsPng(), SaveAsPdf(): Exporte em vários formatos
Código de barras PDF417 criado usando a API fluente do IronBarcode com dimensões personalizadas *A PDF417 barcode generated using fluent method chaining*

Quais Formatos de Código de Barras São Suportados pelo IronBarcode?

O IronBarcode suporta geração abrangente de formatos de código de barras através do enum BarcodeWriterEncoding. Os formatos suportados incluem:

Códigos de Barras 1D: Code128, Code39, Code93, Codabar, ITF, MSI, Plessey, UPCA, UPCE, EAN8, EAN13 Códigos de Barras 2D: QRCode, DataMatrix, PDF417, Aztec, MaxiCode Formatos Especializados: IntelligentMail, DataBar, DataBarExpanded e vários padrões GS1

Cada formato tem características específicas e casos de uso. Por exemplo, códigos QR são excelentes para armazenar URLs e grandes quantidades de dados, enquanto EAN13 é padrão para produtos de varejo. Saiba mais sobre escolher o formato de código de barras certo para sua aplicação.

Como Posso Verificar se Meu Código de Barras Gerado é Legível?

A garantia de qualidade é crítica para a implementação de códigos de barras. IronBarcode inclui verificação integrada para garantir que seus códigos de barras gerados continuem legíveis:

// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
    .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128)
    .ResizeTo(200, 100)
    .ChangeBarCodeColor(Color.DarkBlue);

// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
    .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128)
    .ResizeTo(200, 100)
    .ChangeBarCodeColor(Color.DarkBlue);

// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");
$vbLabelText   $csharpLabel

O método Verify() verifica se o seu código de barras permanece legível por máquinas após aplicar transformações como redimensionamento ou recoloração. Isso é especialmente importante ao usar cores não padrão ou tamanhos muito pequenos.

Onde Posso Encontrar Mais Exemplos de Geração de Códigos de Barras?

Para expandir suas capacidades de geração de códigos de barras, explore esses recursos adicionais:

Código Fonte e Exemplos

Baixe o código fonte completo deste tutorial:

Tópicos Avançados

Documentação da API

Pronto para Gerar Códigos de Barras Profissionais em Sua Aplicação?

IronBarcode torna a geração de códigos de barras simples enquanto fornece a flexibilidade necessária para aplicações profissionais. Seja para códigos de produtos simples ou códigos de barras 2D complexos com estilo personalizado, IronBarcode lida com tudo com código mínimo.

Baixe o IronBarcode hoje e comece a gerar códigos de barras em minutos. Precisa de ajuda para escolher a licença certa? Confira nossas opções de licenciamento ou solicite uma chave de teste gratuita para testar o IronBarcode em seu ambiente de produção.

Perguntas frequentes

Como posso criar uma imagem de código de barras em C#?

Para criar uma imagem de código de barras em C#, você pode usar o método BarcodeWriter.CreateBarcode() do IronBarcode. Isso permite especificar os dados e o formato do código de barras e, em seguida, salvar a imagem em formatos como PNG ou JPEG usando métodos como SaveAsPng() .

Quais são os passos para instalar o IronBarcode em um projeto .NET?

Você pode instalar o IronBarcode em seu projeto .NET usando o Gerenciador de Pacotes NuGet no Visual Studio. Como alternativa, você pode baixar a DLL do site do IronBarcode e adicioná-la às referências do seu projeto.

Como posso exportar um código de barras como PDF em C#?

O IronBarcode permite exportar códigos de barras como PDFs usando o método SaveAsPdf() da classe GeneratedBarcode , oferecendo uma maneira simples de salvar seus códigos de barras em formato PDF.

Quais opções de personalização estão disponíveis para códigos de barras em C#?

O IronBarcode oferece extensas opções de personalização, como alterar as cores do código de barras com ChangeBarCodeColor() , adicionar anotações de texto usando AddAnnotationTextAboveBarcode() e definir margens com SetMargins() .

Como posso criar e estilizar rapidamente um código de barras em uma única linha de código?

Usando a API Fluent do IronBarcode, você pode criar e estilizar um código de barras em uma linha com encadeamento de métodos: BarcodeWriter.CreateBarcode(data, encoding).ResizeTo(300, 200).SetMargins(10).SaveAsPng(path) .

Como posso garantir que meu código de barras seja legível após as modificações?

Para verificar se um código de barras pode ser lido após ser formatado ou redimensionado, use o método Verify() no objeto GeneratedBarcode para verificar sua legibilidade por máquina.

Posso gerar códigos QR com logotipos em C#?

Sim, o IronBarcode suporta a geração de códigos QR com logotipos incorporados usando a classe QRCodeWriter , que inclui recursos para inserção de logotipos e níveis aprimorados de correção de erros.

Qual é o processo para gerar vários códigos de barras de forma eficiente em C#?

Você pode gerar vários códigos de barras de forma eficiente em C# usando o IronBarcode, que oferece suporte ao processamento em lote e permite o uso de loops ou processamento paralelo para lidar com a geração de códigos de barras em grande volume.

Quais formatos de arquivo posso usar para exportar códigos de barras em C#?

O IronBarcode suporta a exportação de códigos de barras em vários formatos, incluindo PNG, JPEG, GIF, TIFF, BMP, PDF e HTML, proporcionando flexibilidade para diferentes necessidades de aplicação.

Como posso adicionar texto legível por humanos abaixo de um código de barras em C#?

Para adicionar texto legível por humanos abaixo de um código de barras em C#, use o método AddBarcodeValueTextBelowBarcode() , que exibe automaticamente o valor codificado em formato de texto abaixo da imagem do código de barras.

Jacob Mellor, Diretor de Tecnologia da Team Iron
Diretor de Tecnologia

Jacob Mellor é Diretor de Tecnologia da Iron Software e um engenheiro visionário pioneiro na tecnologia C# PDF. Como desenvolvedor original do código-fonte principal da Iron Software, ele moldou a arquitetura de produtos da empresa desde sua criação, transformando-a, juntamente com o CEO Cameron Rimington, em uma ...

Leia mais
Pronto para começar?
Nuget Downloads 2,108,094 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package BarCode
executar um exemplo Veja seu fio se transformar em um código de barras.