El problema fundamental

La arquitectura de control de Syncfusion hace que la generación programática de archivos sea indirecta. La producción de un archivo de código de barras con SfBarcode requiere preasignar un Bitmap, llamar a DrawToBitmap y luego guardar el mapa de bits, un patrón de renderizado de WinForms que lleva el tiempo de ejecución de Windows Forms como dependencia:

// Syncfusion SfBarcode: 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

// Syncfusion SfBarcode: 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

' Syncfusion SfBarcode: 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

IronBarcode genera archivos directamente y los lee con el mismo paquete:

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

Paso 1: Sustituir paquetes NuGet

Retire el paquete de códigos de barras de Syncfusion para la plataforma que esté utilizando. Si el proyecto está dirigido a varias plataformas, ejecute la eliminación para cada una:

# 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

Si no quedan otros paquetes de Syncfusion en el proyecto después de eliminar el paquete de códigos de barras, elimine también el paquete de licencias:

dotnet remove package Syncfusion.Licensing

dotnet remove package Syncfusion.Licensing

Instala IronBarcode : un único paquete para todas las plataformas.

dotnet add package IronBarcode

dotnet add package IronBarcode

Paso 2: Actualizar los espacios de nombres

Elimine los espacios de nombres de códigos de barras de Syncfusion y agregue el espacio de nombres de IronBarcode :

// Remove these (barcode-specific; leave others if non-barcode Syncfusion controls 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-barcode Syncfusion controls remain)
using Syncfusion.Windows.Forms.Barcode;
using Syncfusion.Licensing;
// @using Syncfusion.Blazor.BarcodeGenerator  (in _Imports.razor)

// Add this
using IronBarCode;

Imports IronBarCode

Paso 3: Inicializar licencia

Elimine el registro de licencia de Syncfusion y la configuración de la plataforma del inicio de la aplicación. Luego, agregue una única línea de licencia de IronBarcode en la misma ubicación de inicio:

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

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

' 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 y contenedores Docker, almacene la clave en una variable de entorno:

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

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

Imports System

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

Conversión de SfBarcode a BarcodeWriter en WinForms

La migración de WinForms elimina la indirectación DrawToBitmap y la reemplaza con una cadena de salida de archivo directa. El patrón de Syncfusion requiere preasignar un Bitmap de dimensiones conocidas; IronBarcode calcula las dimensiones como parte de la llamada de generación.

Enfoque de Syncfusion :

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

Enfoque de 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 se asigna a BarcodeEncoding.Code128. La secuencia DrawToBitmap + Bitmap.Save se colapsa en .SaveAsPng(). Si el código de barras debe mostrarse dentro de un PictureBox de WinForms en lugar de guardarse en el disco, use .ToPngBinaryData() para cargar la imagen en el control. La gama completa de formatos de código de barras 1D en IronBarcode va mucho más allá de la lista de formatos compatibles con el control Syncfusion .

Generador de códigos de barras Blazor a punto final de API mínimo

La migración de Blazor es un cambio estructural, más que una sustitución línea por línea. SfBarcodeGenerator es un componente Razor que se renderiza en el navegador a través de la capa de JavaScript de Syncfusion. IronBarcode no tiene ningún componente Razor ; Es una biblioteca del lado del servidor. El patrón de reemplazo consiste en un punto final de API mínimo en el servidor que devuelve bytes de código de barras, a los que se hace referencia en la página Razor como origen de la imagen.

Enfoque de Syncfusion :

@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";
}

Enfoque de IronBarcode :

Agregue un punto de generación en 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)

Haga referencia al punto final en el componente Razor :

@page "/fulfillment"

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

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

Este punto final se puede probar de forma independiente, es reutilizable desde cualquier cliente HTTP y es compatible con Blazor Server, Blazor WebAssembly con un backend de API alojado y cualquier otro frontend web.

Generación de códigos QR

El componente QR de Syncfusion también se renderiza en el navegador sin ninguna ruta de salida del lado del servidor. IronBarcode genera códigos QR en el servidor con salida directa a archivos.

Enfoque de Syncfusion :

@using Syncfusion.Blazor.BarcodeGenerator

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

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

Reemplazo de lectura OPX

Si el proyecto utilizó Barcode Reader OPX, o si pospuso un requisito de lectura para una futura compra de OPX, IronBarcode reemplaza esa dependencia con el paquete que ya está instalado. Sin producto secundario, sin segunda licencia.

Enfoque Syncfusion (lector de código de barras OPX):

// Requires separate Código de barras Syncfusion Reader 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 barras Syncfusion Reader 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

Enfoque de 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

La documentación sobre lectura de códigos de barras abarca la lectura de matrices de bytes para controladores de carga, el ajuste de velocidad frente a precisión y la detección de múltiples códigos de barras.

Generación de códigos de barras PDF

Los controles de código de barras de Syncfusion no tienen ruta de salida a PDF. IronBarcode trata el formato PDF como un formato de salida de primera clase.

Enfoque de Syncfusion :

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

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

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

Enfoque de 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

La guía para la generación de PDF con códigos de barras abarca la creación de archivos PDF de varias páginas y la inserción de códigos de barras junto con el resto del contenido del documento.

Problema 1: Marcas de agua de prueba después de la actualización de NuGet

Syncfusion: La actualización de Essential Studio 24.x a 25.x invalida la clave de licencia existente. Cualquier resultado generado antes de actualizar el almacén de secretos mostrará una marca de agua de prueba. Se trata de un fallo silencioso: la aplicación sigue funcionando, pero produce resultados que no cumplen con los requisitos.

Solución: Tras actualizar el paquete NuGet de IronBarcode , la clave de licencia no cambia dentro de una versión principal. No es necesario actualizar ni redistribuir los secretos para las versiones menores o de parches. Al actualizar a una nueva versión principal, actualice la clave una sola vez en el punto de entrada de la aplicación:

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

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

Imports IronBarCode

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

Problema 2: DrawToBitmap falla en entornos sin interfaz gráfica.

Syncfusion: SfBarcode.DrawToBitmap depende de la canalización de renderizado de Windows Forms. En un proceso ASP.NET Core, Azure Function o contenedor Docker de Linux, llamar a DrawToBitmap lanzará InvalidOperationException o producirá un mapa de bits en blanco porque no hay un bucle de mensajes de Windows Forms presente.

Solución: Reemplace con BarcodeWriter.CreateBarcode(). IronBarcode realiza la generación en código administrado sin ninguna dependencia de tiempo de ejecución de la interfaz de usuario:

// 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 no tiene salida en el servidor.

Syncfusion: SfBarcodeGenerator es un componente Razor sin superficie de API del lado del servidor. Los intentos de utilizarlo en una acción de controlador o en un servicio en segundo plano no encontrarán ningún método aplicable para generar bytes de código de barras.

Solución: Crear un punto final de API mínimo que genere el código de barras en el servidor y lo devuelva como respuesta HTTP. Referencie el endpoint desde el componente Razor a través de una etiqueta <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 capacidad de lectura (OPX no adquirido)

Syncfusion: Los proyectos que aplazaron la lectura de códigos de barras porque aún no se había adquirido OPX no tienen código de lectura para migrar. Agregar la capacidad de lectura desde cero requiere la adquisición de OPX, su integración y un nuevo acuerdo de licencia.

Solución: La lectura de IronBarcode está incluida en el mismo paquete. No se requiere adquisición ni licencia adicional. Agregue BarcodeReader.Read(path) donde se requiera lectura:

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

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

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

Problema 5: Caducidad de la licencia comunitaria durante la migración

Syncfusion: Un equipo que utilice la Licencia Comunitaria y supere cualquier umbral de elegibilidad durante el período de migración, incluido el cierre de una ronda de financiación, puede encontrarse con que los controles de Syncfusion dejan de producir resultados válidos antes de que finalice la migración.

Solución: La prueba gratuita de 30 días de IronBarcode permite una evaluación completa sin condiciones de ingresos, plantilla o capital. La marca de agua de prueba aparece en la salida generada; Al activar una clave de licencia comprada, esta se elimina. El modelo de licencias de IronBarcode no establece umbrales de tamaño para las organizaciones.

Tareas previas a la migración

Audite el código fuente para localizar todos los archivos que hacen referencia al código de barras de Syncfusion :

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 lo siguiente antes de escribir cualquier código de migración:

• Liste cada archivo que llame a SyncfusionLicenseProvider.RegisterLicense
• Liste cada instanciación de SfBarcode y sus asignaciones de propiedades
• Liste cada uso del componente Razor <SfBarcodeGenerator> y <SfQRCodeGenerator>
• Liste cada llamada DrawToBitmap y la ruta de guardado o visualización posterior
• Confirme si el lector de códigos de barras OPX está instalado; Si es así, enumere todas las llamadas de lectura.

Tareas de actualización de código

1. Elimine el/los paquete(s) NuGet de código de barras de Syncfusion para cada plataforma en el proyecto.
2. Eliminar el paquete NuGet Syncfusion.Licensing si no quedan otros controles de Syncfusion
3. Instalar el paquete NuGet IronBarcode
4. Reemplace SyncfusionLicenseProvider.RegisterLicense("KEY") con IronBarCode.License.LicenseKey = "KEY" en el punto de entrada de la aplicación
5. Eliminar builder.Services.AddSyncfusionBlazor() si no quedan otros controles de Syncfusion
6. Eliminar builder.ConfigureSyncfusionCore() si no quedan otros controles de Syncfusion
7. Eliminar @using Syncfusion.Blazor y @using Syncfusion.Blazor.BarcodeGenerator de _Imports.razor si es aplicable
8. Reemplazar using Syncfusion.Windows.Forms.Barcode y using Syncfusion.Licensing con using IronBarCode
9. Reemplazar cada bloque new SfBarcode() + asignaciones de propiedades + DrawToBitmap con BarcodeWriter.CreateBarcode(value, BarcodeEncoding.X).ResizeTo(w, h).SaveAsPng(path)
10. Reemplazar BarcodeSymbolType.Code128A (y equivalentes) con BarcodeEncoding.Code128
11. Reemplazar BarcodeType.Code128 (enum Blazor) con BarcodeEncoding.Code128
12. Reemplazar cada componente Razor <SfBarcodeGenerator> con un endpoint de API mínimo y una referencia <img src="..."> en el componente
13. Reemplazar cada componente Razor <SfQRCodeGenerator> con un endpoint QRCodeWriter.CreateQrCode() y una referencia <img src="...">
14. Reemplace todas las llamadas de lectura de OPX del lector de códigos de barras con BarcodeReader.Read(path)
15. Agregue BarcodeReader.Read(path) donde previamente no había capacidad de lectura debido a que OPX no fue adquirido

Pruebas posteriores a la migración

• Verifique que las imágenes de códigos de barras generadas sean válidas para el escaneo utilizando un escáner de hardware o una aplicación de lector de referencia.
• Verifique que no aparezcan marcas de agua de prueba en la salida generada después de la activación de la clave de licencia.
• Confirmar que BarcodeReader.Read() devuelve el valor y formato esperado para cada tipo de código de barras en uso
• Probar la salida PDF con .SaveAsPdf() para confirmar que las dimensiones de la página y del código de barras coinciden con los requisitos de diseño
• Pruebe el endpoint de la API mínima de Blazor directamente (a través del navegador o cliente HTTP) antes de probarlo dentro del componente Razor.
• Confirmar que la implementación de Docker y Linux produce resultados idénticos a los de las máquinas de desarrollo de Windows.
• Ejecutar una auditoría final grep para confirmar que no quedan referencias a SfBarcode, SfBarcodeGenerator, DrawToBitmap, BarcodeSymbolType o SyncfusionLicenseProvider