Entendendo o código de barras C1

C1BarCode é um controle visual. O fluxo de trabalho de geração cria uma instância, define propriedades e chama GetImage() para recuperar um System.Drawing.Image:

// ComponentOne C1BarCode
using C1.Win.Barcode;
using C1.BarCode;
using System.Drawing;

// License must be set before first use
C1.C1License.Key = "YOUR-COMPONENTONE-KEY";

var barcode = new C1BarCode();
barcode.CodeType = CodeType.Code128;
barcode.Text = "ITEM-12345";
barcode.BarHeight = 100;
barcode.ModuleSize = 2;
barcode.ShowText = true;
barcode.CaptionPosition = CaptionPosition.Below;

using var image = barcode.GetImage();
image.Save("barcode.png", System.Drawing.Imaging.ImageFormat.Png);

// ComponentOne C1BarCode
using C1.Win.Barcode;
using C1.BarCode;
using System.Drawing;

// License must be set before first use
C1.C1License.Key = "YOUR-COMPONENTONE-KEY";

var barcode = new C1BarCode();
barcode.CodeType = CodeType.Code128;
barcode.Text = "ITEM-12345";
barcode.BarHeight = 100;
barcode.ModuleSize = 2;
barcode.ShowText = true;
barcode.CaptionPosition = CaptionPosition.Below;

using var image = barcode.GetImage();
image.Save("barcode.png", System.Drawing.Imaging.ImageFormat.Png);

Imports C1.Win.Barcode
Imports C1.BarCode
Imports System.Drawing
Imports System.Drawing.Imaging

' License must be set before first use
C1.C1License.Key = "YOUR-COMPONENTONE-KEY"

Dim barcode As New C1BarCode()
barcode.CodeType = CodeType.Code128
barcode.Text = "ITEM-12345"
barcode.BarHeight = 100
barcode.ModuleSize = 2
barcode.ShowText = True
barcode.CaptionPosition = CaptionPosition.Below

Using image As Image = barcode.GetImage()
    image.Save("barcode.png", ImageFormat.Png)
End Using

A API de configuração de propriedades é familiar para desenvolvedores WinForms — ela mapeia diretamente para a superfície do designer. CodeType, BarHeight, ModuleSize, ShowText e CaptionPosition são todas propriedades visíveis pelo designer que funcionam de forma idêntica no código.

O C1BarCode suporta 38 simbologias que cobrem os formatos principais de 1D e 2D: Code 39, Code 128, EAN-8, EAN-13, UPC-A, UPC-E, ITF, Código QR, PDF417, e DataMatrix, entre outros. Para geração de códigos de barras, ele cobre os casos de uso comuns.

Sem API de leitura

Essa não é uma lacuna que uma opção de configuração preenche. Não há classe C1BarCodeReader. Não há método Decode() em C1BarCode. O controle de código de barras da ComponentOne é projetado para ser apenas de geração.

Se sua aplicação precisa escanear códigos de barras a partir de imagens carregadas, verificar etiquetas impressas, processar documentos com códigos incorporados ou extrair dados de códigos QR em uma API web — nada disso é possível com o C1BarCode. Você precisaria de uma biblioteca separada para leitura, o que levanta a questão de por que pagar por um componente exclusivo para geração de código de barras dentro de um Suite Enterprise com mais de 100 controles, quando bibliotecas de código de barras independentes abrangem ambas as operações.

A ausência de uma API de leitura não é incomum para controles de código de barras WinForms projetados para impressão. O que torna isso um ponto de decisão é quando os requisitos aumentam — e os requisitos de código de barras quase sempre aumentam.

Restrição exclusiva do Windows

As edições WinForms e WPF do C1BarCode exigem uma configuração de framework de destino específica do Windows:

<TargetFramework>net8.0-windows</TargetFramework>
<UseWindowsForms>true</UseWindowsForms>

<TargetFramework>net8.0-windows</TargetFramework>
<UseWindowsForms>true</UseWindowsForms>

O moniker do framework de destino net8.0-windows e UseWindowsForms não são preferências opcionais. C1.Win.BarCode depende dos tipos System.Windows.Forms — UserControl, PaintEventArgs, Graphics — que existem apenas no Windows. Remover net8.0-windows quebra a compilação. ComponentOne realmente envia edições Blazor e ASP.NET Core MVC do controle de código de barras que têm como alvo TFMs multiplataforma, mas os pacotes WinForms e WPF são exclusivos do Windows.

Em contraste,IronBarcode tem como alvo net8.0 (ou qualquer TFM suportado) sem restrições de plataforma:

<TargetFramework>net8.0</TargetFramework>

<TargetFramework>net8.0</TargetFramework>

Isso é importante em diversos cenários práticos:

• Azure App Service no Linux: Plano padrão para novas implantações do App Service. net8.0-windows não pode tê-lo como alvo.
• Contêineres Docker: Contêineres Linux são o padrão. Um contêiner Windows é maior, custa mais e não está disponível em muitos planos de nuvem.
• API Web ASP.NET Core : Um endpoint de geração de código de barras que só pode ser implantado no Windows é uma restrição de implantação que a equipe eventualmente precisará remover.
• Azure Functions: O plano de consumo é executado no Linux. Uma função de geração de código de barras com um alvo net8.0-windows não pode ser implantada no plano de Consumo.
• Desenvolvimento no macOS: Desenvolvedores no macOS não podem executar um projeto net8.0-windows localmente, nem mesmo para testar a lógica de geração.

A restrição de plataforma não é um problema se o seu aplicativo for uma ferramenta de desktop WinForms que só será executada no Windows. Isso se torna um problema no momento em que os requisitos de implantação incluem qualquer ambiente Linux ou em nuvem.

Pacotes de Suite

O controle C1BarCode é vendido como parte do ComponentOne Studio Enterprise, que inclui a suíte completa de controles ComponentOne para WinForms, WPF, Blazor, e ASP.NET. O preço do ComponentOne Studio Enterprise é $1.299 por desenvolvedor por ano (assinatura); edições de plataforma única (WinForms ou WPF) são $799 por desenvolvedor por ano.

Esse Suite inclui mais de 100 componentes: grades, gráficos, agendadores, controles de entrada, designers de relatórios, controles de mapa, medidores e muito mais. Se você está construindo uma aplicação intensiva em dados e precisa de muitos desses controles, o preço da suíte pode fazer sentido. Se você precisa de geração de código de barras e chegou ao ComponentOne porque ele apareceu em uma pesquisa, você está comprando uma suíte de UI empresarial principalmente por um controle.

O pacote NuGet é C1.Win.BarCode para WinForms (com C1.WPF.BarCode, C1.WinUI.BarCode e C1.Blazor.BarCode para outras plataformas) e é licenciado por meio da assinatura do ComponentOne Studio. Para desenvolvedores que desejam funcionalidade de código de barras sem a suíte completa, não há um nível de licença separada apenas para código de barras.

A estrutura de preços do IronBarcode é diferente: é uma biblioteca de código de barras autônoma com licenciamento perpétuo a partir de $749 para um único desenvolvedor (Lite), $1,499 para três (Plus), $2,999 para dez (Professional), e $5,999 para desenvolvedores ilimitados. Não há controle de grade, biblioteca de gráficos ou designer de relatórios — apenas a funcionalidade de código de barras que você procura.

Personalização de código QR

Ambas as bibliotecas suportam a geração de códigos QR com opções de personalização. O estilo da API difere significativamente.

Abordagem do ComponentOne para definir propriedades:

// ComponentOne — QR code with error correction and color
using C1.Win.Barcode;
using C1.BarCode;
using System.Drawing;

C1.C1License.Key = "YOUR-COMPONENTONE-KEY";

var barcode = new C1BarCode();
barcode.CodeType = CodeType.QRCode;
barcode.Text = "https://example.com/product/4821";
barcode.QRCodeVersion = QRCodeVersion.Version5;
barcode.QRCodeErrorCorrectionLevel = QRCodeErrorCorrectionLevel.High;
barcode.QRCodeModel = QRCodeModel.Model2;
barcode.ForeColor = Color.DarkBlue;
barcode.BackColor = Color.White;
barcode.ModuleSize = 4;

using var image = barcode.GetImage();
image.Save("product-qr.png", System.Drawing.Imaging.ImageFormat.Png);

// ComponentOne — QR code with error correction and color
using C1.Win.Barcode;
using C1.BarCode;
using System.Drawing;

C1.C1License.Key = "YOUR-COMPONENTONE-KEY";

var barcode = new C1BarCode();
barcode.CodeType = CodeType.QRCode;
barcode.Text = "https://example.com/product/4821";
barcode.QRCodeVersion = QRCodeVersion.Version5;
barcode.QRCodeErrorCorrectionLevel = QRCodeErrorCorrectionLevel.High;
barcode.QRCodeModel = QRCodeModel.Model2;
barcode.ForeColor = Color.DarkBlue;
barcode.BackColor = Color.White;
barcode.ModuleSize = 4;

using var image = barcode.GetImage();
image.Save("product-qr.png", System.Drawing.Imaging.ImageFormat.Png);

Imports C1.Win.Barcode
Imports C1.BarCode
Imports System.Drawing
Imports System.Drawing.Imaging

C1.C1License.Key = "YOUR-COMPONENTONE-KEY"

Dim barcode As New C1BarCode()
barcode.CodeType = CodeType.QRCode
barcode.Text = "https://example.com/product/4821"
barcode.QRCodeVersion = QRCodeVersion.Version5
barcode.QRCodeErrorCorrectionLevel = QRCodeErrorCorrectionLevel.High
barcode.QRCodeModel = QRCodeModel.Model2
barcode.ForeColor = Color.DarkBlue
barcode.BackColor = Color.White
barcode.ModuleSize = 4

Using image As Image = barcode.GetImage()
    image.Save("product-qr.png", ImageFormat.Png)
End Using

Cadeia fluente IronBarcode:

//IronBarcode— QR code with error correction and color
// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Drawing;

QRCodeWriter.CreateQrCode(
        "https://example.com/product/4821",
        300,
        QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("product-qr.png");

//IronBarcode— QR code with error correction and color
// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Drawing;

QRCodeWriter.CreateQrCode(
        "https://example.com/product/4821",
        300,
        QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("product-qr.png");

Imports IronBarCode
Imports System.Drawing

QRCodeWriter.CreateQrCode( _
        "https://example.com/product/4821", _
        300, _
        QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .ChangeBarCodeColor(Color.DarkBlue) _
    .SaveAsPng("product-qr.png")

A abordagem ComponentOne requer instanciar um objeto C1BarCode e definir múltiplas propriedades antes de chamar GetImage(). O QRCodeWriter do IronBarcode usa uma cadeia fluente — cada operação retorna o objeto de código de barras, e você chama .SaveAsPng() no final. Não há instâncias para gerenciar.

O IronBarcode também suporta a incorporação de logotipos em códigos QR, o que o C1BarCode não faz:

// QR code with embedded brand logo
QRCodeWriter.CreateQrCode("https://example.com/track/8821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("branded-qr.png");

// QR code with embedded brand logo
QRCodeWriter.CreateQrCode("https://example.com/track/8821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(Color.DarkBlue)
    .SaveAsPng("branded-qr.png");

' QR code with embedded brand logo
QRCodeWriter.CreateQrCode("https://example.com/track/8821", 500) _
    .AddBrandLogo("company-logo.png") _
    .ChangeBarCodeColor(Color.DarkBlue) _
    .SaveAsPng("branded-qr.png")

Entendendo o IronBarcode

IronBarcode é uma biblioteca independente para .NET que abrange a geração e a leitura de códigos de barras. Ele instala a partir do NuGet (dotnet add package IronBarcode), tem como alvo qualquer TFM .NET suportado sem restrições de plataforma, e roda no Windows, Linux, macOS, Docker, Azure e AWS Lambda.

A funcionalidade de leitura abrange documentos PDF nativamente:

// Read barcodes from a PDF — no image extraction needed
using IronBarCode;

var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

// Read barcodes from a PDF — no image extraction needed
using IronBarCode;

var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

Imports IronBarCode

' Read barcodes from a PDF — no image extraction needed
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

Para cenários de alta produtividade, BarcodeReaderOptions controla o compromisso entre velocidade e precisão e a detecção de múltiplos códigos de barras:

// Multi-barcode read with performance options
using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};

var results = BarcodeReader.Read("warehouse-manifest.jpg", options);

// Multi-barcode read with performance options
using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};

var results = BarcodeReader.Read("warehouse-manifest.jpg", options);

Imports IronBarCode

' Multi-barcode read with performance options
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode
}

Dim results = BarcodeReader.Read("warehouse-manifest.jpg", options)

A geração abrange os formatos padrão com uma API estática consistente:

// Code 128 generation to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

// Geração de código QR to byte array (for HTTP response)
byte[] qrBytes = QRCodeWriter.CreateQrCode("https://example.com/order/7734", 400)
    .ToPngBinaryData();

// Code 128 generation to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

// Geração de código QR to byte array (for HTTP response)
byte[] qrBytes = QRCodeWriter.CreateQrCode("https://example.com/order/7734", 400)
    .ToPngBinaryData();

' Code 128 generation to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

' Geração de código QR to byte array (for HTTP response)
Dim qrBytes As Byte() = QRCodeWriter.CreateQrCode("https://example.com/order/7734", 400) _
    .ToPngBinaryData()

Plataformas suportadas: Windows, Linux, macOS, Docker, Azure (Serviço de Aplicativos e Funções), AWS Lambda. Versões .NET suportadas: .NET Framework 4.6.2+, .NET Core 3.1+, e .NET 5/6/7/8.

Comparação de recursos

Referência de Mapeamento de API

Para equipes que estão migrando do C1BarCode para o IronBarcode, aplicam-se as seguintes equivalências diretas:

Quando as equipes trocam

A necessidade de leitura surge. Este é o gatilho mais comum. Uma equipe cria um sistema de geração de etiquetas de código de barras com o C1BarCode e, em seguida, recebe a solicitação de verificar leituras, processar documentos de remessas recebidas ou decodificar códigos QR a partir de imagens carregadas. A biblioteca C1BarCode não pode ajudar. As opções são: adicionar uma segunda biblioteca de código de barras para leitura ou substituir a C1BarCode por uma biblioteca que suporte ambas as funções.

Implantação em Linux ou Docker. Um aplicativo de desktop WinForms distribuído para desktops Windows não enfrenta essa restrição. Uma API ASP.NET Core que gera imagens de código de barras é essencial — especialmente se precisar ser executada em um contêiner Linux ou implantada no Azure App Service no Linux. O framework de destino net8.0-windows bloqueia imediatamente essas opções de implantação.

Arquitetura de microsserviços ou sem servidor. Azure Functions, AWS Lambda e microsserviços em contêineres priorizam o Linux. Um serviço de geração de código de barras que não pode ser implantado no Linux não é um microsserviço viável.

Custo da assinatura do Suite versus escopo de requisitos. As equipes que pagam pelo ComponentOne Studio Enterprise e já utilizam seus grids, gráficos e outros controles já justificaram o investimento na assinatura. Equipes que assinaram o serviço principalmente ou exclusivamente para geração de códigos de barras estão pagando por mais de 100 controles que não utilizam. O custo da assinatura por desenvolvedor aumenta exponencialmente com o tamanho da equipe.

Preferência por licença perpétua. O ComponentOne Studio funciona apenas por assinatura. Não existe opção de licença perpétua. Para equipes que preferem possuir o software que enviam — particularmente por razões de conformidade ou manutenção a longo prazo — o licenciamento perpétuo do IronBarcode(começando em $749 Lite) é estruturalmente diferente.

Conclusão

O C1BarCode gera códigos de barras de forma limpa em um contexto WinForms. Essa é realmente a sua principal vantagem, e para um aplicativo desktop WinForms que precisa apenas de geração de rótulos no Windows, é uma escolha funcional dentro do Suite ComponentOne.

O escopo termina aí. Sem necessidade de leitura, implantação exclusiva para Windows, sem pacote independente, licenciamento por assinatura. Quando os requisitos de um projeto vão além da geração de WinForms no Windows — como um requisito de leitura, uma implantação em Linux, uma API web, um contêiner Docker ou uma função na nuvem — o C1BarCode não consegue atendê-los. O IronBarcode abrange a geração e leitura de códigos de barras, funciona em qualquer plataforma compatível com .NET e está disponível como um pacote independente, sem necessidade de assinatura de um Suite Enterprise com 100 controles.