Das grundsätzliche Problem

Die Steuerungsarchitektur von Syncfusion macht die programmatische Dateigenerierung indirekt. Das Erstellen einer Barcode-Datei mit SfBarcode erfordert das Vorzuweisen eines Bitmap, das Aufrufen von DrawToBitmap und dann das Speichern der Bitmap — ein WinForms-Darstellungsmuster, das die Windows Forms-Laufzeit als Abhängigkeit mit sich bringt:

// 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 generiert Dateien direkt und liest sie mit demselben Paket:

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

Schritt 1: Ersetzen von NuGet-Paketen

Entfernen Sie das Syncfusion Barcode-Paket für die verwendete Plattform. Wenn das Projekt mehrere Plattformen anvisiert, führen Sie die Entfernung für jede Plattform durch:

# 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

Falls nach dem Entfernen des Barcode-Pakets keine weiteren Syncfusion Pakete mehr im Projekt vorhanden sind, entfernen Sie auch das Lizenzierungspaket:

dotnet remove package Syncfusion.Licensing

dotnet remove package Syncfusion.Licensing

Installieren Sie IronBarcode – ein Paket für alle Plattformen:

dotnet add package IronBarcode

dotnet add package IronBarcode

Schritt 2: Namespaces aktualisieren

Entfernen Sie die Syncfusion Barcode-Namensräume und fügen Sie den IronBarcode -Namensraum hinzu:

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

Schritt 3: Lizenz initialisieren

Entfernen Sie die Syncfusion -Lizenzregistrierung und die Plattformkonfiguration aus dem Anwendungsstart. Fügen Sie anschließend an derselben Startstelle eine einzelne IronBarcode -Lizenzzeile hinzu:

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

Für CI/CD-Pipelines und Docker-Container speichern Sie den Schlüssel in einer Umgebungsvariablen:

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 zu BarcodeWriter

Die WinForms-Migration beseitigt die DrawToBitmap Indirektion und ersetzt sie durch eine direkte Datei-Ausgabekette. Das Syncfusion-Muster erfordert das Vorzuweisen eines Bitmap bekannter Dimensionen; IronBarcode berechnet die Dimensionen im Rahmen des Generierungsaufrufs.

Syncfusion Ansatz:

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

IronBarcode -Ansatz:

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 wird zu BarcodeEncoding.Code128. Die DrawToBitmap + Bitmap.Save Sequenz kollabiert zu .SaveAsPng(). Falls der Barcode in einem WinForms PictureBox angezeigt und nicht auf Festplatte gespeichert werden muss, verwenden Sie .ToPngBinaryData(), um das Bild in die Steuerung zu laden. Die vollständige Palette der 1D-Barcode-Formate in IronBarcode geht weit über die vom Syncfusion Steuerelement unterstützte Liste hinaus.

Blazor SfBarcodeGenerator zu Minimalem API-Endpunkt

Die Blazor -Migration ist eher eine strukturelle Veränderung als ein Zeilenaustausch. SfBarcodeGenerator ist eine Razor-Komponente, die im Browser über Syncfusions JavaScript-Ebene gerendert wird. IronBarcode enthält keine Razor Komponente; Es handelt sich um eine serverseitige Bibliothek. Das Ersatzmuster ist ein minimaler API-Endpunkt auf dem Server, der Barcode-Bytes zurückgibt und auf der Razor -Seite als Bildquelle referenziert wird.

Syncfusion Ansatz:

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

IronBarcode -Ansatz:

Fügen Sie einen Generierungspunkt in Program.cs hinzu:

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)

Verweisen Sie auf den Endpunkt in der Razor Komponente:

@page "/fulfillment"

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

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

Dieser Endpunkt ist unabhängig testbar, von jedem HTTP-Client wiederverwendbar und kompatibel mit Blazor Server, Blazor WebAssembly mit einem gehosteten API-Backend und jedem anderen Web-Frontend.

QR-Code-Generierung

Die Syncfusion QR-Komponente wird ebenfalls im Browser gerendert, ohne serverseitigen Ausgabepfad. IronBarcode generiert QR-Codes serverseitig mit direkter Dateiausgabe.

Syncfusion Ansatz:

@using Syncfusion.Blazor.BarcodeGenerator

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

IronBarcode -Ansatz:

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

OPX-Lesegerät-Ersatz

Wenn das Projekt Barcode Reader OPX verwendet hat oder eine Leseanforderung auf einen späteren Kauf von OPX verschoben hat, ersetzt IronBarcode diese Abhängigkeit durch das bereits installierte Paket. Kein Folgeprodukt, keine Zweitlizenz.

Syncfusion Ansatz (Barcode-Lesegerät OPX):

// Requires separate Syncfusion BarCodeReader 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 Syncfusion BarCodeReader 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

IronBarcode -Ansatz:

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

Die Dokumentation zum Barcode-Lesen umfasst das Lesen aus Byte-Arrays für Upload-Handler, die Optimierung des Verhältnisses von Geschwindigkeit zu Genauigkeit sowie die Erkennung mehrerer Barcodes.

PDF-Barcode-Generierung

Syncfusion Barcode-Steuerelemente verfügen über keinen PDF-Ausgabepfad. IronBarcode behandelt PDF als erstklassiges Ausgabeformat.

Syncfusion Ansatz:

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

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

'Neindirect 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

IronBarcode -Ansatz:

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

Der Leitfaden zur Barcode-PDF-Generierung behandelt mehrseitige PDF-Ausgaben und das Einbetten von Barcodes neben anderen Dokumentinhalten.

Problem 1: Testwasserzeichen nach NuGet Update

Syncfusion: Durch das Upgrade von Essential Studio 24.x auf 25.x wird der bestehende Lizenzschlüssel ungültig. Alle Ausgaben, die vor der Aktualisierung des Geheimnisspeichers generiert wurden, werden mit einem Testwasserzeichen versehen. Dies ist ein stiller Fehler – die Anwendung läuft zwar weiter, erzeugt aber nicht konforme Ergebnisse.

Lösung: Nach der Aktualisierung des IronBarcode NuGet Pakets ändert sich der Lizenzschlüssel innerhalb einer Hauptversion nicht. Für kleinere Updates oder Patches ist keine Aktualisierung der Geheimnisse oder eine erneute Bereitstellung erforderlich. Beim Upgrade auf eine neue Hauptversion muss der Schlüssel einmalig am Einstiegspunkt der Anwendung aktualisiert werden:

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

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

Imports IronBarCode

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

Problem 2: DrawToBitmap schlägt in Headless-Umgebungen fehl

Syncfusion: SfBarcode.DrawToBitmap hängt von der Windows Forms-Darstellungspipeline ab. In einem ASP.NET Core-Prozess, Azure-Funktion oder Linux-Docker-Container wird das Aufrufen von DrawToBitmap InvalidOperationException auslösen oder eine leere Bitmap erzeugen, da keine Windows Forms-Nachrichtenschleife vorhanden ist.

Lösung: Ersetzen Sie durch BarcodeWriter.CreateBarcode(). IronBarcode generiert Barcodes in verwaltetem Code ohne Abhängigkeit von der UI-Laufzeitumgebung:

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

Problem 3: SfBarcodeGenerator liefert keine serverseitige Ausgabe

Syncfusion: SfBarcodeGenerator ist eine Razor-Komponente ohne serverseitige API-Oberfläche. Bei dem Versuch, es in einer Controller-Aktion oder einem Hintergrunddienst zu verwenden, findet sich keine geeignete Methode zum Generieren von Barcode-Bytes.

Lösung: Erstellen Sie einen minimalen API-Endpunkt, der den Barcode serverseitig generiert und als HTTP-Antwort zurückgibt. Verweisen Sie den Endpunkt von der Razor-Komponente über einen <img src="..."> Tag:

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)

Problem 4: Fehlende Lesefunktion (OPX nicht erworben)

Syncfusion: Projekte, bei denen das Barcode-Lesen verschoben wurde, weil OPX noch nicht erworben wurde, verfügen über keinen Lesecode, der migriert werden könnte. Um die Lesefähigkeit von Grund auf neu hinzuzufügen, sind die Beschaffung von OPX, die Integration und eine neue Lizenzvereinbarung erforderlich.

Lösung: Die IronBarcode Lesefunktion ist im selben Paket enthalten. Es ist keine Beschaffung oder Zweitlizenz erforderlich. Fügen Sie BarcodeReader.Read(path) überall dort hinzu, wo das Lesen erforderlich ist:

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

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

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

Problem 5: Ablauf der Gemeinschaftslizenz während der Migration

Syncfusion: Ein Team, das die Community-Lizenz verwendet und während des Migrationszeitraums eine der Zulassungsschwellen überschreitet – einschließlich des Abschlusses einer Finanzierungsrunde –, muss möglicherweise feststellen, dass die Syncfusion Steuerelemente keine gültigen Ausgaben mehr erzeugen, bevor die Migration abgeschlossen ist.

Lösung: Die 30-tägige Testphase von IronBarcode ermöglicht eine umfassende Evaluierung ohne Umsatz-, Mitarbeiterzahl- oder Kapitalbeschränkungen. Das Testwasserzeichen erscheint auf der generierten Ausgabe; Durch die Aktivierung eines gekauften Lizenzschlüssels wird dieser entfernt. Im IronBarcode -Lizenzmodell gibt es keine Beschränkungen hinsichtlich der Unternehmensgröße.

Vor der Migration anfallende Aufgaben

Überprüfen Sie den Quellcode, um alle Dateien zu finden, die auf den Syncfusion -Barcode verweisen:

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" .

Dokumentieren Sie Folgendes, bevor Sie Migrationscode schreiben:

• Listen Sie jede Datei auf, die SyncfusionLicenseProvider.RegisterLicense aufruft
• Listen Sie jede SfBarcode Instanzierung und deren Eigenschaftszuweisungen auf
• Listen Sie jede Nutzung von <SfBarcodeGenerator> und <SfQRCodeGenerator> Razor-Komponenten auf
• Listen Sie jeden DrawToBitmap Aufruf und den nachgelagerten Speicher- oder Anzeigepfad auf
• Prüfen Sie, ob der Barcode-Leser OPX installiert ist; Falls ja, listen Sie alle Lesungsanrufe auf.

Aufgaben der Code-Aktualisierung

1. Entfernen Sie die Syncfusion Barcode- NuGet Pakete für jede Plattform im Projekt.
2. Entfernen Sie das Syncfusion.Licensing NuGet-Paket, wenn keine anderen Syncfusion-Steuerelemente verbleiben
3. Installieren Sie das IronBarcode NuGet-Paket
4. Ersetzen Sie SyncfusionLicenseProvider.RegisterLicense("KEY") durch IronBarCode.License.LicenseKey = "KEY" an der Anwendungseintrittsstelle
5. Entfernen Sie builder.Services.AddSyncfusionBlazor(), wenn keine anderen Syncfusion-Steuerelemente verbleiben
6. Entfernen Sie builder.ConfigureSyncfusionCore(), wenn keine anderen Syncfusion-Steuerelemente verbleiben
7. Entfernen Sie @using Syncfusion.Blazor und @using Syncfusion.Blazor.BarcodeGenerator aus _Imports.razor, falls zutreffend
8. Ersetzen Sie using Syncfusion.Windows.Forms.Barcode und using Syncfusion.Licensing durch using IronBarCode
9. Ersetzen Sie jeden new SfBarcode() + Eigenschaftszuweisungen + DrawToBitmap Block durch BarcodeWriter.CreateBarcode(value, BarcodeEncoding.X).ResizeTo(w, h).SaveAsPng(path)
10. Ersetzen Sie BarcodeSymbolType.Code128A (und Äquivalente) durch BarcodeEncoding.Code128
11. Ersetzen Sie BarcodeType.Code128 (Blazor-Enum) durch BarcodeEncoding.Code128
12. Ersetzen Sie jede <SfBarcodeGenerator> Razor-Komponente durch einen minimalen API-Endpunkt und einen <img src="..."> Verweis in der Komponente
13. Ersetzen Sie jede <SfQRCodeGenerator> Razor-Komponente durch einen QRCodeWriter.CreateQrCode() Endpunkt und einen <img src="..."> Verweis
14. Ersetzen Sie alle Barcode Reader OPX-Leseaufrufe durch BarcodeReader.Read(path)
15. Fügen Sie BarcodeReader.Read(path) hinzu, wo auch immer vorher eine Lese-Fähigkeit fehlte, da OPX nicht gekauft wurde

Post-Migrationstests

• Überprüfen Sie mithilfe eines Hardware-Scanners oder einer Referenzleseanwendung, ob die generierten Barcode-Bilder scan-gültig sind.
• Stellen Sie sicher, dass nach der Aktivierung des Lizenzschlüssels keine Testwasserzeichen auf den generierten Ausgaben erscheinen.
• Bestätigen Sie, dass BarcodeReader.Read() den erwarteten Wert und das Format für jeden verwendeten Barcode-Typ zurückgibt
• Testen Sie die PDF-Ausgabe mit .SaveAsPdf(), um zu bestätigen, dass die Seitendimensionen und die Barcode-Dimensionen den Entwurfsspezifikationen entsprechen
• Testen Sie den minimalen API-Endpunkt von Blazor direkt (über Browser oder HTTP-Client), bevor Sie innerhalb der Razor Komponente testen.
• Bestätigen Sie, dass die Docker- und Linux-Bereitstellung die gleiche Ausgabe wie die Windows-Entwicklungsrechner erzeugt.
• Führen Sie einen abschließenden grep Audit durch, um sicherzustellen, dass keine verbleibenden Verweise auf SfBarcode, SfBarcodeGenerator, DrawToBitmap, BarcodeSymbolType oder SyncfusionLicenseProvider vorhanden sind