O problema fundamental

A arquitetura de controle daSyncfusiontorna a geração programática de arquivos indireta. Produzir um arquivo de código de barras com SfBarcode requer pré-alocação de um Bitmap, chamando DrawToBitmap, e então salvando o bitmap — um padrão de renderização WinForms que carrega o runtime do Windows Forms como dependência:

//SyncfusionSfBarcode: indirect file output through DrawToBitmap
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "SHIP-2024-001";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.Width = 400;
barcode.Height = 150;

using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("shipping-label.png", ImageFormat.Png);
// Reading: not possible — requires separate OPX purchase

//SyncfusionSfBarcode: indirect file output through DrawToBitmap
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "SHIP-2024-001";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.Width = 400;
barcode.Height = 150;

using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("shipping-label.png", ImageFormat.Png);
// Reading: not possible — requires separate OPX purchase

Imports Syncfusion.Licensing
Imports System.Drawing
Imports System.Drawing.Imaging

' SyncfusionSfBarcode: indirect file output through DrawToBitmap
SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

Dim barcode As New SfBarcode()
barcode.Text = "SHIP-2024-001"
barcode.Symbology = BarcodeSymbolType.Code128A
barcode.Width = 400
barcode.Height = 150

Using bitmap As New Bitmap(barcode.Width, barcode.Height)
    barcode.DrawToBitmap(bitmap, barcode.ClientRectangle)
    bitmap.Save("shipping-label.png", ImageFormat.Png)
End Using
' Reading: not possible — requires separate OPX purchase

O IronBarcode gera arquivos diretamente e os lê com o mesmo pacote:

// IronBarcode: direct generation and reading in one package
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Generate
BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPng("shipping-label.png");

// Read — same package, no additional product required
var results = BarcodeReader.Read("shipping-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// IronBarcode: direct generation and reading in one package
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Generate
BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPng("shipping-label.png");

// Read — same package, no additional product required
var results = BarcodeReader.Read("shipping-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

Imports IronBarCode

' IronBarcode: direct generation and reading in one package
License.LicenseKey = "YOUR-LICENSE-KEY"

' Generate
BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPng("shipping-label.png")

' Read — same package, no additional product required
Dim results = BarcodeReader.Read("shipping-label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Passo 1: Substituir pacotes NuGet

Remova o pacote de código de barrasSyncfusionpara a plataforma em uso. Se o projeto for destinado a várias plataformas, execute a remoção para cada uma delas:

# Blazor
dotnet remove package Syncfusion.Blazor.BarcodeGenerator

# WinForms
dotnet remove package Syncfusion.SfBarcode.Windows

# WPF
dotnet remove package Syncfusion.SfBarcode.WPF

# MAUI
dotnet remove package Syncfusion.Maui.Barcode

# Blazor
dotnet remove package Syncfusion.Blazor.BarcodeGenerator

# WinForms
dotnet remove package Syncfusion.SfBarcode.Windows

# WPF
dotnet remove package Syncfusion.SfBarcode.WPF

# MAUI
dotnet remove package Syncfusion.Maui.Barcode

Se não houver mais nenhum pacote daSyncfusionno projeto após a remoção do pacote de código de barras, remova também o pacote de licenciamento:

dotnet remove package Syncfusion.Licensing

dotnet remove package Syncfusion.Licensing

Instale o IronBarcode— um pacote para todas as plataformas:

dotnet add package IronBarcode

dotnet add package IronBarcode

Etapa 2: Atualizar Namespaces

Remova os namespaces de código de barras daSyncfusione adicione o namespace IronBarcode:

// Remove these (barcode-specific; leave others if non-barcodeSyncfusioncontrols remain)
using Syncfusion.Windows.Forms.Barcode;
using Syncfusion.Licensing;
// @using Syncfusion.Blazor.BarcodeGenerator  (in _Imports.razor)

// Add this
using IronBarCode;

// Remove these (barcode-specific; leave others if non-barcodeSyncfusioncontrols remain)
using Syncfusion.Windows.Forms.Barcode;
using Syncfusion.Licensing;
// @using Syncfusion.Blazor.BarcodeGenerator  (in _Imports.razor)

// Add this
using IronBarCode;

Imports IronBarCode

Etapa 3: Inicializar a licença

Remova o registro da licençaSyncfusione a configuração da plataforma da inicialização do aplicativo. Em seguida, adicione uma única linha de licença IronBarcode no mesmo local de inicialização:

// Remove from Program.cs / App.xaml.cs / MauiProgram.cs:
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");
builder.Services.AddSyncfusionBlazor();         // Blazor only — remove if no otherSyncfusioncontrols
builder.ConfigureSyncfusionCore();              // MAUI only — remove if no otherSyncfusioncontrols

// Add at the same startup point:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove from Program.cs / App.xaml.cs / MauiProgram.cs:
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");
builder.Services.AddSyncfusionBlazor();         // Blazor only — remove if no otherSyncfusioncontrols
builder.ConfigureSyncfusionCore();              // MAUI only — remove if no otherSyncfusioncontrols

// Add at the same startup point:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove from Program.vb / App.xaml.vb / MauiProgram.vb:
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")
builder.Services.AddSyncfusionBlazor()         ' Blazor only — remove if no other Syncfusion controls
builder.ConfigureSyncfusionCore()              ' MAUI only — remove if no other Syncfusion controls

' Add at the same startup point:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Para pipelines de CI/CD e contêineres Docker, armazene a chave em uma variável de ambiente:

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports System

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

WinForms SfBarcode para BarcodeWriter

A migração do WinForms elimina a indiação de DrawToBitmap e a substitui por uma cadeia de saída de arquivo direta. O padrão deSyncfusionrequer pré-alocação de um Bitmap de dimensões conhecidas; O IronBarcode calcula as dimensões como parte da chamada de geração.

AbordagemSyncfusion:

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "ORD-20240315-001";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;
barcode.Width = 400;
barcode.Height = 150;

using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("order-label.png", ImageFormat.Png);

using Syncfusion.Windows.Forms.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY");

var barcode = new SfBarcode();
barcode.Text = "ORD-20240315-001";
barcode.Symbology = BarcodeSymbolType.Code128A;
barcode.BarHeight = 100;
barcode.NarrowBarWidth = 1;
barcode.ShowText = true;
barcode.Width = 400;
barcode.Height = 150;

using var bitmap = new Bitmap(barcode.Width, barcode.Height);
barcode.DrawToBitmap(bitmap, barcode.ClientRectangle);
bitmap.Save("order-label.png", ImageFormat.Png);

Imports Syncfusion.Windows.Forms.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR-VERSION-SPECIFIC-KEY")

Dim barcode As New SfBarcode()
barcode.Text = "ORD-20240315-001"
barcode.Symbology = BarcodeSymbolType.Code128A
barcode.BarHeight = 100
barcode.NarrowBarWidth = 1
barcode.ShowText = True
barcode.Width = 400
barcode.Height = 150

Using bitmap As New Bitmap(barcode.Width, barcode.Height)
    barcode.DrawToBitmap(bitmap, barcode.ClientRectangle)
    bitmap.Save("order-label.png", ImageFormat.Png)
End Using

Abordagem do IronBarcode:

using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

BarcodeWriter.CreateBarcode("ORD-20240315-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .AddBarcodeText()
    .SaveAsPng("order-label.png");

using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

BarcodeWriter.CreateBarcode("ORD-20240315-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .AddBarcodeText()
    .SaveAsPng("order-label.png");

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

BarcodeWriter.CreateBarcode("ORD-20240315-001", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .AddBarcodeText() _
    .SaveAsPng("order-label.png")

BarcodeSymbolType.Code128A mapeia para BarcodeEncoding.Code128. A sequência DrawToBitmap + Bitmap.Save colapsa em .SaveAsPng(). Se o código de barras precisar ser exibido dentro de um PictureBox do WinForms em vez de ser salvo em disco, use .ToPngBinaryData() para carregar a imagem no controle. A gama completa de formatos de código de barras 1D no IronBarcode vai muito além da lista suportada pelo controladorSyncfusion.

Blazor SfBarcodeGenerator para endpoint de API mínimo

A migração para o Blazor é uma mudança estrutural, e não uma substituição linha por linha. SfBarcodeGenerator é um componente Razor que apresenta no navegador através da camada JavaScript do Syncfusion.IronBarcode não possui componente Razor ; É uma biblioteca do lado do servidor. O padrão de substituição é um endpoint de API mínimo no servidor que retorna bytes de código de barras, referenciados na página Razor como uma fonte de imagem.

AbordagemSyncfusion:

@page "/fulfillment"
@using Syncfusion.Blazor.BarcodeGenerator

<SfBarcodeGenerator
    Width="300px"
    Height="150px"
    Type="BarcodeType.Code128"
    Value="@orderNumber">
    <BarcodeGeneratorDisplayText Visibility="true"></BarcodeGeneratorDisplayText>
</SfBarcodeGenerator>

@code {
    private string orderNumber = "ORD-20240315-001";
}

Abordagem do IronBarcode:

Adicione um ponto de extremidade de geração em Program.cs:

using IronBarCode;

app.MapGet("/barcode/{value}", (string value) =>
{
    var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
        .ResizeTo(300, 150)
        .AddBarcodeText()
        .ToPngBinaryData();

    return Results.File(bytes, "image/png");
});

using IronBarCode;

app.MapGet("/barcode/{value}", (string value) =>
{
    var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
        .ResizeTo(300, 150)
        .AddBarcodeText()
        .ToPngBinaryData();

    return Results.File(bytes, "image/png");
});

Imports IronBarCode

app.MapGet("/barcode/{value}", Function(value As String)
    Dim bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128) _
        .ResizeTo(300, 150) _
        .AddBarcodeText() _
        .ToPngBinaryData()

    Return Results.File(bytes, "image/png")
End Function)

Referencie o endpoint no componente Razor :

@page "/fulfillment"

<img src="/barcode/@orderNumber" alt="Order barcode: @orderNumber" />

@code {
    private string orderNumber = "ORD-20240315-001";
}

Este endpoint pode ser testado de forma independente, é reutilizável a partir de qualquer cliente HTTP e é compatível com Blazor Server, Blazor WebAssembly com um backend de API hospedado e qualquer outro frontend web.

Geração de código QR

O componente QR daSyncfusiontambém é renderizado no navegador, sem um caminho de saída no servidor. O IronBarcode gera códigos QR no servidor com saída direta em arquivo.

AbordagemSyncfusion:

@using Syncfusion.Blazor.BarcodeGenerator

<SfQRCodeGenerator
    Width="300px"
    Height="300px"
    Value="https://example.com/product/ABC-123">
    <QRCodeGeneratorDisplayText Visibility="false">
    </QRCodeGeneratorDisplayText>
</SfQRCodeGenerator>

Abordagem do IronBarcode:

using IronBarCode;

// Standard QR code
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 300,
    QRCodeWriter.QrErrorCorrectionLevel.High)
    .SaveAsPng("product-qr.png");

// QR code with embedded brand logo — not available in Syncfusion
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("product-qr-branded.png");

using IronBarCode;

// Standard QR code
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 300,
    QRCodeWriter.QrErrorCorrectionLevel.High)
    .SaveAsPng("product-qr.png");

// QR code with embedded brand logo — not available in Syncfusion
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("product-qr-branded.png");

Imports IronBarCode

' Standard QR code
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 300, QRCodeWriter.QrErrorCorrectionLevel.High) _
    .SaveAsPng("product-qr.png")

' QR code with embedded brand logo — not available in Syncfusion
QRCodeWriter.CreateQrCode("https://example.com/product/ABC-123", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("product-qr-branded.png")

Substituição de leitura OPX

Se o projeto utilizou o leitor de código de barras OPX — ou adiou a necessidade de leitura para uma futura aquisição do OPX — o IronBarcode substitui essa dependência pelo pacote já instalado. Sem produto secundário, sem segunda licença.

AbordagemSyncfusion(Leitor de código de barras OPX):

// Requires separate Código de barrasSyncfusionReader OPX purchase
// OPX wraps ZXing.Net internally (Apache 2.0 — free to use directly)
using Syncfusion.BarcodeReader;

var reader = new BarcodeReader();
var results = reader.ReadBarcodes("warehouse-scan.png");
foreach (var result in results)
    Console.WriteLine($"Value: {result.Value}");

// Requires separate Código de barrasSyncfusionReader OPX purchase
// OPX wraps ZXing.Net internally (Apache 2.0 — free to use directly)
using Syncfusion.BarcodeReader;

var reader = new BarcodeReader();
var results = reader.ReadBarcodes("warehouse-scan.png");
foreach (var result in results)
    Console.WriteLine($"Value: {result.Value}");

Imports Syncfusion.BarcodeReader

Dim reader As New BarcodeReader()
Dim results = reader.ReadBarcodes("warehouse-scan.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
Next

Abordagem do IronBarcode:

using IronBarCode;

// Included in the same NuGet package as generation — no second product required
var results = BarcodeReader.Read("warehouse-scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

using IronBarCode;

// Included in the same NuGet package as generation — no second product required
var results = BarcodeReader.Read("warehouse-scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

Imports IronBarCode

' Included in the same NuGet package as generation — no second product required
Dim results = BarcodeReader.Read("warehouse-scan.png")
For Each result In results
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Confidence: {result.Confidence}%")
Next

A documentação sobre leitura de código de barras abrange a leitura de matrizes de bytes para manipuladores de upload, o ajuste de velocidade versus precisão e a detecção de múltiplos códigos de barras.

Geração de código de barras em PDF

Os controles de código de barras daSyncfusionnão possuem um caminho de saída em PDF. O IronBarcode trata o PDF como um formato de saída de primeira classe.

AbordagemSyncfusion:

// Não direct path — requires combining Syncfusion.Barcode.WinForms and Syncfusion.Pdf
// Step 1: Generate to Bitmap via DrawToBitmap
// Step 2: LoadSyncfusionPDF document
// Step 3: Insert bitmap as image element
// Two packages, two APIs, two license obligations

// Não direct path — requires combining Syncfusion.Barcode.WinForms and Syncfusion.Pdf
// Step 1: Generate to Bitmap via DrawToBitmap
// Step 2: LoadSyncfusionPDF document
// Step 3: Insert bitmap as image element
// Two packages, two APIs, two license obligations

' Não direct path — requires combining Syncfusion.Barcode.WinForms and Syncfusion.Pdf
' Step 1: Generate to Bitmap via DrawToBitmap
' Step 2: LoadSyncfusionPDF document
' Step 3: Insert bitmap as image element
' Two packages, two APIs, two license obligations

Abordagem do IronBarcode:

using IronBarCode;

// Generate directly to PDF — no secondary library required
BarcodeWriter.CreateBarcode("PALLET-2024-0891", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("pallet-label.pdf");

// Read barcodes from an existing PDF
var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

using IronBarCode;

// Generate directly to PDF — no secondary library required
BarcodeWriter.CreateBarcode("PALLET-2024-0891", BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .SaveAsPdf("pallet-label.pdf");

// Read barcodes from an existing PDF
var pdfResults = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

Imports IronBarCode

' Generate directly to PDF — no secondary library required
BarcodeWriter.CreateBarcode("PALLET-2024-0891", BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .SaveAsPdf("pallet-label.pdf")

' Read barcodes from an existing PDF
Dim pdfResults = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

O guia de geração de PDFs com código de barras aborda a criação de PDFs com várias páginas e a incorporação de códigos de barras junto com outros conteúdos do documento.

Problema 1: Marcas d'água de avaliação após atualização do NuGet

Syncfusion: A atualização do Essential Studio 24.x para a versão 25.x invalida a chave de licença existente. Qualquer saída gerada antes da atualização do repositório de segredos exibirá uma marca d'água de teste. Trata-se de uma falha silenciosa — o aplicativo continua em execução, mas produz resultados não conformes.

Solução: Após atualizar o pacote NuGet do IronBarcode, a chave de licença não muda dentro da mesma versão principal. Não é necessária nenhuma atualização ou reimplementação de segredos para versões secundárias ou de correção. Ao atualizar para uma nova versão principal, atualize a chave uma única vez no ponto de entrada do aplicativo:

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Problema 2: DrawToBitmap falha em ambientes sem interface gráfica.

Syncfusion: SfBarcode.DrawToBitmap depende do pipeline de renderização do Windows Forms. Em um processo ASP.NET Core, Função Azure ou contêiner Docker Linux, chamar DrawToBitmap lançará InvalidOperationException ou produzirá um bitmap em branco porque não há um loop de mensagens do Windows Forms presente.

Solução: Substituir por BarcodeWriter.CreateBarcode(). O IronBarcode realiza a geração em código gerenciado, sem qualquer dependência de tempo de execução da interface do usuário:

// Works in ASP.NET Core, Azure Functions, Docker on Linux, console apps
var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .ToPngBinaryData();

// Works in ASP.NET Core, Azure Functions, Docker on Linux, console apps
var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
    .ResizeTo(400, 150)
    .ToPngBinaryData();

' Works in ASP.NET Core, Azure Functions, Docker on Linux, console apps
Dim bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128) _
    .ResizeTo(400, 150) _
    .ToPngBinaryData()

Problema 3: SfBarcodeGenerator não possui saída no servidor

Syncfusion: SfBarcodeGenerator é um componente Razor sem superfície de API do lado do servidor. As tentativas de utilizá-lo em uma ação de controlador ou serviço em segundo plano não encontrarão nenhum método aplicável para gerar bytes de código de barras.

Solução: Crie um endpoint de API mínimo que gere o código de barras no servidor e o retorne como uma resposta HTTP. Referencie o ponto de extremidade do componente Razor através de uma tag <img src="...">:

app.MapGet("/barcode/{value}", (string value) =>
{
    var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
        .ResizeTo(300, 150)
        .ToPngBinaryData();
    return Results.File(bytes, "image/png");
});

app.MapGet("/barcode/{value}", (string value) =>
{
    var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
        .ResizeTo(300, 150)
        .ToPngBinaryData();
    return Results.File(bytes, "image/png");
});

Imports Microsoft.AspNetCore.Builder
Imports Microsoft.AspNetCore.Http

app.MapGet("/barcode/{value}", Function(value As String)
                                   Dim bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128) _
                                       .ResizeTo(300, 150) _
                                       .ToPngBinaryData()
                                   Return Results.File(bytes, "image/png")
                               End Function)

Problema 4: Falta de capacidade de leitura (OPX não adquirido)

Syncfusion: Projetos que adiaram a leitura de código de barras porque o OPX ainda não havia sido adquirido não possuem código de leitura para migrar. Adicionar a capacidade de leitura do zero requer a aquisição do OPX, a integração e um novo contrato de licença.

Solução: A leitura de código de IronBarcode está incluída no mesmo pacote. Não é necessário adquirir nenhuma licença adicional. Adicione BarcodeReader.Read(path) onde quer que a leitura seja necessária:

var results = BarcodeReader.Read("incoming-scan.png");

var results = BarcodeReader.Read("incoming-scan.png");

Dim results = BarcodeReader.Read("incoming-scan.png")

Problema 5: Expiração da licença da comunidade durante a migração

Syncfusion: Uma equipe que utiliza a Licença Comunitária e ultrapassa qualquer limite de elegibilidade durante o período de migração — incluindo o encerramento de uma rodada de financiamento — pode constatar que os controles daSyncfusionparam de produzir resultados válidos antes da conclusão da migração.

Solução: O período de teste de 30 dias do IronBarcode permite uma avaliação completa sem condições de receita, pessoal ou capital. A marca d'água de teste aparece na saída gerada; A ativação de uma chave de licença adquirida a remove. Não existem limites de tamanho organizacional no modelo de licenciamento do IronBarcode.

Tarefas pré-migração

Analise o código-fonte para localizar todos os arquivos que fazem referência ao código de barras daSyncfusion:

grep -r "SyncfusionLicenseProvider.RegisterLicense\|AddSyncfusionBlazor\|ConfigureSyncfusionCore" --include="*.cs" .
grep -r "new SfBarcode\(\)\|SfBarcodeGenerator\|SfQRCodeGenerator" --include="*.cs" --include="*.razor" .
grep -r "BarcodeSymbolType\.\|BarcodeType\." --include="*.cs" --include="*.razor" .
grep -r "DrawToBitmap\|barcode\.Text\s*=" --include="*.cs" .
grep -r "Syncfusion\.Barcode\|Syncfusion\.Blazor\.BarcodeGenerator" --include="*.csproj" .

grep -r "SyncfusionLicenseProvider.RegisterLicense\|AddSyncfusionBlazor\|ConfigureSyncfusionCore" --include="*.cs" .
grep -r "new SfBarcode\(\)\|SfBarcodeGenerator\|SfQRCodeGenerator" --include="*.cs" --include="*.razor" .
grep -r "BarcodeSymbolType\.\|BarcodeType\." --include="*.cs" --include="*.razor" .
grep -r "DrawToBitmap\|barcode\.Text\s*=" --include="*.cs" .
grep -r "Syncfusion\.Barcode\|Syncfusion\.Blazor\.BarcodeGenerator" --include="*.csproj" .

Documente o seguinte antes de escrever qualquer código de migração:

• Liste todos os arquivos que chamam SyncfusionLicenseProvider.RegisterLicense
• Liste todas as instanciações de SfBarcode e suas atribuições de propriedades
• Liste todas as utilizações de componentes Razor <SfBarcodeGenerator> e <SfQRCodeGenerator>
• Liste todas as chamadas DrawToBitmap e o caminho de salvamento ou exibição a jusante
• Confirme se o leitor de código de barras OPX está instalado; Em caso afirmativo, liste todas as chamadas de leitura.

Tarefas de atualização de código

1. Remova os pacotes NuGet de código de barras daSyncfusionpara cada plataforma no projeto.
2. Remova o pacote NuGet Syncfusion.Licensing se nenhum outro controleSyncfusionpermanecer
3. Instale o pacote NuGet IronBarcode
4. Substitua SyncfusionLicenseProvider.RegisterLicense("KEY") por IronBarCode.License.LicenseKey = "KEY" no ponto de entrada da aplicação
5. Remove builder.Services.AddSyncfusionBlazor() se nenhum outro controleSyncfusionpermanecer
6. Remove builder.ConfigureSyncfusionCore() se nenhum outro controleSyncfusionpermanecer
7. Remove @using Syncfusion.Blazor e @using Syncfusion.Blazor.BarcodeGenerator de _Imports.razor se aplicável
8. Substitua using Syncfusion.Windows.Forms.Barcode e using Syncfusion.Licensing por using IronBarCode
9. Substitua cada bloco new SfBarcode() + atribuições de propriedades + DrawToBitmap por BarcodeWriter.CreateBarcode(value, BarcodeEncoding.X).ResizeTo(w, h).SaveAsPng(path)
10. Substitua BarcodeSymbolType.Code128A (e equivalente) por BarcodeEncoding.Code128
11. Substitua BarcodeType.Code128 (enum Blazor) por BarcodeEncoding.Code128
12. Substitua cada componente Razor <SfBarcodeGenerator> por um ponto de extremidade de API mínimo e uma referência <img src="..."> no componente
13. Substitua cada componente Razor <SfQRCodeGenerator> por um ponto de extremidade QRCodeWriter.CreateQrCode() e uma referência <img src="...">
14. Substitua todas as chamadas de leitura do Barcode Reader OPX por BarcodeReader.Read(path)
15. Adicione BarcodeReader.Read(path) onde quer que a capacidade de leitura estivesse anteriormente ausente devido à OPX não ter sido adquirida

Testes pós-migração

• Verifique se as imagens de código de barras geradas são válidas para leitura usando um leitor de hardware ou um aplicativo de leitura de referência.
• Verifique se não há marcas d'água de avaliação nos arquivos gerados após a ativação da chave de licença.
• Confirme que BarcodeReader.Read() retorna o valor esperado e o formato para cada tipo de código de barras em uso
• Teste a saída em PDF com .SaveAsPdf() para confirmar que as dimensões da página e as dimensões do código de barras atendem aos requisitos do design
• Teste o endpoint da API mínima do Blazor diretamente (via navegador ou cliente HTTP) antes de testá-lo dentro do componente Razor.
• Confirme se a implantação do Docker e do Linux produz resultados idênticos aos das máquinas de desenvolvimento Windows.
• Execute uma auditoria final grep para confirmar que não há referências restantes a SfBarcode, SfBarcodeGenerator, DrawToBitmap, BarcodeSymbolType ou SyncfusionLicenseProvider