Das grundsätzliche Problem

Die deutlichste Ausprägung der Lesebeschränkung von Telerik besteht darin, dass die Komponente, die ein Format generiert, dieses nicht durch den Reader zurückführen kann:

// Telerik — generates a QR code, then cannot read it back
var qrBarcode = new RadBarcode();
qrBarcode.Value = "https://example.com/order/4821";
qrBarcode.Symbology = new QRCode { ErrorCorrectionLevel = ErrorCorrectionLevel.H };
// Save to file...

// Attempt to read the same QR code:
var reader = new RadBarcodeReader();
// DecodeType.QR does not exist — QR cannot be added to this list
reader.DecodeTypes = new[] { DecodeType.Code128, DecodeType.EAN13 };
var bitmap = new BitmapImage(new Uri("qr-output.png", UriKind.Absolute));
var result = reader.Decode(bitmap);
// result == null — always, for any QR code image

// Telerik — generates a QR code, then cannot read it back
var qrBarcode = new RadBarcode();
qrBarcode.Value = "https://example.com/order/4821";
qrBarcode.Symbology = new QRCode { ErrorCorrectionLevel = ErrorCorrectionLevel.H };
// Save to file...

// Attempt to read the same QR code:
var reader = new RadBarcodeReader();
// DecodeType.QR does not exist — QR cannot be added to this list
reader.DecodeTypes = new[] { DecodeType.Code128, DecodeType.EAN13 };
var bitmap = new BitmapImage(new Uri("qr-output.png", UriKind.Absolute));
var result = reader.Decode(bitmap);
// result == null — always, for any QR code image

' Telerik — generates a QR code, then cannot read it back
Dim qrBarcode As New RadBarcode()
qrBarcode.Value = "https://example.com/order/4821"
qrBarcode.Symbology = New QRCode With {.ErrorCorrectionLevel = ErrorCorrectionLevel.H}
' Save to file...

' Attempt to read the same QR code:
Dim reader As New RadBarcodeReader()
' DecodeType.QR does not exist — QR cannot be added to this list
reader.DecodeTypes = New DecodeType() {DecodeType.Code128, DecodeType.EAN13}
Dim bitmap As New BitmapImage(New Uri("qr-output.png", UriKind.Absolute))
Dim result = reader.Decode(bitmap)
' result == null — always, for any QR code image

IronBarcode schließt diese Lücke. Generierung und Lesen verwenden dasselbe Paket, und die Lese-Engine erkennt QR-Codes, DataMatrix, PDF417 und alle anderen Formate automatisch:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Generate a QR code
BarcodeWriter.CreateBarcode("https://example.com/order/4821", BarcodeEncoding.QRCode)
             .SaveAsPng("qr-output.png");

// Read that same QR code back — no format specification needed
var results = BarcodeReader.Read("qr-output.png");
Console.WriteLine(results.First().Value);
// Output: https://example.com/order/4821

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Generate a QR code
BarcodeWriter.CreateBarcode("https://example.com/order/4821", BarcodeEncoding.QRCode)
             .SaveAsPng("qr-output.png");

// Read that same QR code back — no format specification needed
var results = BarcodeReader.Read("qr-output.png");
Console.WriteLine(results.First().Value);
// Output: https://example.com/order/4821

Imports IronBarCode

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

' Generate a QR code
BarcodeWriter.CreateBarcode("https://example.com/order/4821", BarcodeEncoding.QRCode) _
             .SaveAsPng("qr-output.png")

' Read that same QR code back — no format specification needed
Dim results = BarcodeReader.Read("qr-output.png")
Console.WriteLine(results.First().Value)
' Output: https://example.com/order/4821

Schritt 1: Ersetzen des NuGet-Pakets

Entfernen Sie das Telerik UI-Paket für die Plattform(en) in Ihrem Projekt:

# WPF
dotnet remove package Telerik.UI.for.Wpf.60.Xaml

# WinForms
dotnet remove package Telerik.UI.for.WinForms.Common
dotnet remove package Telerik.UI.for.WinForms.Barcode

# Blazor
dotnet remove package Telerik.UI.for.Blazor

# WPF
dotnet remove package Telerik.UI.for.Wpf.60.Xaml

# WinForms
dotnet remove package Telerik.UI.for.WinForms.Common
dotnet remove package Telerik.UI.for.WinForms.Barcode

# Blazor
dotnet remove package Telerik.UI.for.Blazor

Wenn Ihr Projekt auch andere Telerik-Steuerelemente aus demselben Paket verwendet, lassen Sie das Paket an Ort und Stelle und fahren Sie mit Schritt 2 fort. Sie werden die barcodespezifischen API-Aufrufe entfernen, ohne das gemeinsam genutzte Paket zu entfernen.

IronBarcode installieren:

dotnet add package IronBarcode

dotnet add package IronBarcode

Ein Paket umfasst WPF, WinForms, ASP.NET Core, Blazor Server, Konsolenanwendungen, Docker, Azure Functions und AWS Lambda. Die vollständigen Details zur Plattformkompatibilität dokumentieren die genauen unterstützten .NET Versionen und Betriebssystemziele.

Schritt 2: Namespaces aktualisieren

Entfernen Sie die Telerik-Barcode-Namensraumimporte und ersetzen Sie sie durch den IronBarcode Namensraum:

// Remove these namespace imports:
// using Telerik.Windows.Controls.Barcode;      // WPF reader and generator
// using Telerik.Windows.Controls;              // WPF general
// using Telerik.WinControls.UI;               // WinForms
// using Telerik.WinControls.UI.Barcode;        // WinForms barcode reader

// Add this:
using IronBarCode;

// Remove these namespace imports:
// using Telerik.Windows.Controls.Barcode;      // WPF reader and generator
// using Telerik.Windows.Controls;              // WPF general
// using Telerik.WinControls.UI;               // WinForms
// using Telerik.WinControls.UI.Barcode;        // WinForms barcode reader

// Add this:
using IronBarCode;

Imports IronBarCode

Schritt 3: Lizenz initialisieren

Ersetzen Sie die Telerik-Lizenzinitialisierung durch die IronBarcode -Schlüsselzuweisung beim Anwendungsstart:

// Remove:
// Telerik.WinControls.TelerikLicenseManager.InstallLicense("key");

// Add at application startup (Program.cs, App.xaml.cs, or composition root):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove:
// Telerik.WinControls.TelerikLicenseManager.InstallLicense("key");

// Add at application startup (Program.cs, App.xaml.cs, or composition root):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove:
' Telerik.WinControls.TelerikLicenseManager.InstallLicense("key")

' Add at application startup (Program.vb, App.xaml.vb, or composition root):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Die Schlüsselzuweisung erfolgt einmalig am Einstiegspunkt der Anwendung. Es gibt keine Lizenzdatei, die bereitgestellt werden muss, keinen plattformspezifischen Initialisierungspfad und keine separate Konfiguration für WPF im Vergleich zu ASP.NET Core.

Barcode-Generierung: XAML-Steuerung zu codebasierter API

Teleriks Generierung in WPF ist deklarativ – das RadBarcode-XAML-Element wird direkt im UI-Baum gerendert. IronBarcode generiert Barcodes im Code und gibt ein GeneratedBarcode-Objekt zurück, das als Datei gespeichert oder in ein BitmapSource für die WPF-Anzeige konvertiert werden kann.

Telerik-Ansatz:

<Window xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation">
    <telerik:RadBarcode Value="PROD-2026-00184" Symbology="Code128" />
</Window>

<Window xmlns:telerik="http://schemas.telerik.com/2008/xaml/presentation">
    <telerik:RadBarcode Value="PROD-2026-00184" Symbology="Code128" />
</Window>

@* Blazor — TelerikBarcode renders as a Razor component *@
<TelerikBarcode Value="PROD-2026-00184" Type="@BarcodeType.Code128" />

IronBarcode -Ansatz:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Save to file — replaces XAML generation + manual export
BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
             .ResizeTo(400, 100)
             .SaveAsPng("barcode.png");

// Display in WPF — assign to an Image control's Source property
var bitmapSource = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
                                .ToBitmapSource();
barcodeImageControl.Source = bitmapSource;

// Serve in Blazor or ASP.NET Core — return as base64 src attribute
byte[] bytes = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
                            .ResizeTo(400, 100)
                            .ToPngBinaryData();
string imgSrc = $"data:image/png;base64,{Convert.ToBase64String(bytes)}";

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Save to file — replaces XAML generation + manual export
BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
             .ResizeTo(400, 100)
             .SaveAsPng("barcode.png");

// Display in WPF — assign to an Image control's Source property
var bitmapSource = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
                                .ToBitmapSource();
barcodeImageControl.Source = bitmapSource;

// Serve in Blazor or ASP.NET Core — return as base64 src attribute
byte[] bytes = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128)
                            .ResizeTo(400, 100)
                            .ToPngBinaryData();
string imgSrc = $"data:image/png;base64,{Convert.ToBase64String(bytes)}";

Imports IronBarCode

' Save to file — replaces XAML generation + manual export
BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128) _
             .ResizeTo(400, 100) _
             .SaveAsPng("barcode.png")

' Display in WPF — assign to an Image control's Source property
Dim bitmapSource = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128) _
                                .ToBitmapSource()
barcodeImageControl.Source = bitmapSource

' Serve in Blazor or ASP.NET Core — return as base64 src attribute
Dim bytes As Byte() = BarcodeWriter.CreateBarcode("PROD-2026-00184", BarcodeEncoding.Code128) _
                                   .ResizeTo(400, 100) _
                                   .ToPngBinaryData()
Dim imgSrc As String = $"data:image/png;base64,{Convert.ToBase64String(bytes)}"

Das BarcodeEncoding-Enum deckt dieselben Symbologien wie das Symbology-Enum von Telerik ab. Die Umstellung auf QR-Code-Generierung ändert lediglich das Enum-Argument. Die IronBarcode Dokumentation bietet vollständige Beispiele für alle Optionen zur Generierung von 2D-Barcodes , einschließlich QR-Fehlerkorrekturstufen und DataMatrix-Dimensionen.

Lesen von Barcodes aus Desktop-Anwendungen

Telerik bietet zwei separate Leser-Klassen für Desktop-Plattformen – RadBarcodeReader für WPF und RadBarcodeReader für WinForms – mit unterschiedlichen Klassennamen, unterschiedlichen Eigenschaftsnamen und unterschiedlichen Eingabetypen. IronBarcode ersetzt beide mit einem einzigen statischen Aufruf, der in jedem Projekttyp identisch funktioniert.

Telerik WPF-Ansatz:

Für das Lesen in WPF wird eine RadBarcodeReader-Instanz, eine explizite DecodeType-Konfiguration, ein BitmapImage-Objekt, das von einer URI geladen wird, und ein Aufruf von reader.Decode() benötigt. Die Ergebnisseigenschaft ist .Text.

using Telerik.Windows.Controls.Barcode;
using System.Windows.Media.Imaging;

public string ReadProductBarcode(string imagePath)
{
    var reader = new RadBarcodeReader();
    reader.DecodeTypes = new DecodeType[]
    {
        DecodeType.Code128,
        DecodeType.Code39,
        DecodeType.EAN13,
        DecodeType.EAN8,
        DecodeType.UPCA,
        DecodeType.UPCE,
        DecodeType.Codabar,
        DecodeType.ITF
    };

    var bitmap = new BitmapImage(new Uri(imagePath, UriKind.Absolute));
    var result = reader.Decode(bitmap);

    return result?.Text ?? "No barcode found";
}

using Telerik.Windows.Controls.Barcode;
using System.Windows.Media.Imaging;

public string ReadProductBarcode(string imagePath)
{
    var reader = new RadBarcodeReader();
    reader.DecodeTypes = new DecodeType[]
    {
        DecodeType.Code128,
        DecodeType.Code39,
        DecodeType.EAN13,
        DecodeType.EAN8,
        DecodeType.UPCA,
        DecodeType.UPCE,
        DecodeType.Codabar,
        DecodeType.ITF
    };

    var bitmap = new BitmapImage(new Uri(imagePath, UriKind.Absolute));
    var result = reader.Decode(bitmap);

    return result?.Text ?? "No barcode found";
}

Imports Telerik.Windows.Controls.Barcode
Imports System.Windows.Media.Imaging

Public Function ReadProductBarcode(imagePath As String) As String
    Dim reader = New RadBarcodeReader()
    reader.DecodeTypes = New DecodeType() {
        DecodeType.Code128,
        DecodeType.Code39,
        DecodeType.EAN13,
        DecodeType.EAN8,
        DecodeType.UPCA,
        DecodeType.UPCE,
        DecodeType.Codabar,
        DecodeType.ITF
    }

    Dim bitmap = New BitmapImage(New Uri(imagePath, UriKind.Absolute))
    Dim result = reader.Decode(bitmap)

    Return If(result?.Text, "No barcode found")
End Function

Telerik WinForms-Ansatz:

Die WinForms RadBarcodeReader-Klasse verwendet einen anderen Namen, einen anderen Eigenschaftsnamen (DecodeType singular anstelle von DecodeTypes plural), und nimmt einen System.Drawing.Image anstelle eines BitmapImage an.

using Telerik.WinControls.UI.Barcode;
using System.Drawing;

public string ReadShippingLabel(string imagePath)
{
    var reader = new RadBarcodeReader();
    reader.DecodeType = new DecodeType[]
    {
        DecodeType.Code128,
        DecodeType.ITF,
        DecodeType.EAN13
    };

    using var image = Image.FromFile(imagePath);
    var result = reader.Read(image);

    return result?.Text ?? "No barcode found";
}

using Telerik.WinControls.UI.Barcode;
using System.Drawing;

public string ReadShippingLabel(string imagePath)
{
    var reader = new RadBarcodeReader();
    reader.DecodeType = new DecodeType[]
    {
        DecodeType.Code128,
        DecodeType.ITF,
        DecodeType.EAN13
    };

    using var image = Image.FromFile(imagePath);
    var result = reader.Read(image);

    return result?.Text ?? "No barcode found";
}

Imports Telerik.WinControls.UI.Barcode
Imports System.Drawing

Public Function ReadShippingLabel(imagePath As String) As String
    Dim reader = New RadBarcodeReader()
    reader.DecodeType = New DecodeType() {
        DecodeType.Code128,
        DecodeType.ITF,
        DecodeType.EAN13
    }

    Using image = Image.FromFile(imagePath)
        Dim result = reader.Read(image)
        Return If(result?.Text, "No barcode found")
    End Using
End Function

IronBarcode -Ansatz:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public string ReadProductBarcode(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value ?? "No barcode found";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public string ReadProductBarcode(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value ?? "No barcode found";
}

Imports IronBarCode

Public Function ReadProductBarcode(imagePath As String) As String
    Dim results = BarcodeReader.Read(imagePath)
    Return If(results.FirstOrDefault()?.Value, "No barcode found")
End Function

BarcodeReader.Read() ist eine statische Methode – kein Leser-Instanz wird benötigt. Es akzeptiert direkt einen Dateipfad-String, ohne dass ein BitmapImage- oder System.Drawing.Image-Laden erforderlich ist. Die Format-Erkennung ist automatisch bei allen über 50 unterstützten Typen. Die Ergebnisseigenschaft ist .Value anstelle von .Text. Dieser Aufruf funktioniert ohne Änderungen sowohl in WPF- als auch in WinForms-Anwendungen – es gibt keine plattformspezifische Variante. Es liest außerdem QR-Codes, DataMatrix und alle anderen im Bild vorhandenen Formate, im Gegensatz zu den Telerik-Lesegeräten, die auf 1D-Formate beschränkt sind.

QR-Codes lesen: Bisher unmöglich mit Telerik

Wenn Ihr Codekommentar oder eine NotSupportedException-Dokumentation enthält, dass QR-Lesen nicht verfügbar ist, ist dies der Ersatz. Es gibt in Telerik keinen Konfigurationspfad, der das Lesen von QR-Codes ermöglicht – dieses Szenario hat kein Telerik-Äquivalent.

Telerik-Ansatz:

// RadBarcodeReader does not support QR codes.
// DecodeType.QR does not exist in the Telerik enum.
public string ReadQrCode(string imagePath)
{
    throw new NotSupportedException(
        "Telerik RadBarcodeReader cannot read QR codes. " +
        "DecodeType.QR is not a valid enum value.");
}

// RadBarcodeReader does not support QR codes.
// DecodeType.QR does not exist in the Telerik enum.
public string ReadQrCode(string imagePath)
{
    throw new NotSupportedException(
        "Telerik RadBarcodeReader cannot read QR codes. " +
        "DecodeType.QR is not a valid enum value.");
}

' RadBarcodeReader does not support QR codes.
' DecodeType.QR does not exist in the Telerik enum.
Public Function ReadQrCode(imagePath As String) As String
    Throw New NotSupportedException("Telerik RadBarcodeReader cannot read QR codes. " & _
                                    "DecodeType.QR is not a valid enum value.")
End Function

IronBarcode -Ansatz:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417, and Aztec are all detected automatically
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value ?? "No QR code found";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417, and Aztec are all detected automatically
    var results = BarcodeReader.Read(imagePath);
    return results.FirstOrDefault()?.Value ?? "No QR code found";
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417, and Aztec are all detected automatically
    Dim results = BarcodeReader.Read(imagePath)
    Return If(results.FirstOrDefault()?.Value, "No QR code found")
End Function

Der gleiche BarcodeReader.Read()-Aufruf, der EAN-13-Barcodes liest, liest auch QR-Codes. Es gibt keine separate Konfiguration für 2D-Formate. Eine vollständige Liste der unterstützten Barcode-Formate für Lese- und Generierungsprozesse finden Sie in der IronBarcode Dokumentation. Diese umfasst alle über 50 Einträge mit formatspezifischen Hinweisen.

Lesen von Barcodes in einem ASP.NET Core -Endpunkt

Telerik bietet keine Barcode-Lesekomponente für ASP.NET Core oder Blazor an. Falls eine bestehende Anwendung hochgeladene Bilder zum Lesen an einen Desktop-Dienst weiterleitet, weil die Webschicht keinen Telerik-Reader besitzt, wird diese Umgehungslösung durch direktes Lesen in der Webschicht ersetzt.

Telerik-Ansatz:

// No Telerik reading API available in ASP.NET Core.
// Workaround: forward uploaded file to a WPF or WinForms service
// that can reference Telerik.Windows.Controls.Barcode.
[HttpPost("read")]
public async Task<IActionResult> ReadBarcode(IFormFile imageFile)
{
    // Must proxy to desktop service — no Telerik reader available here
    var bytes = await ReadAllBytesAsync(imageFile);
    var result = await _desktopBridgeService.ReadAsync(bytes);
    return Ok(result);
}

// No Telerik reading API available in ASP.NET Core.
// Workaround: forward uploaded file to a WPF or WinForms service
// that can reference Telerik.Windows.Controls.Barcode.
[HttpPost("read")]
public async Task<IActionResult> ReadBarcode(IFormFile imageFile)
{
    // Must proxy to desktop service — no Telerik reader available here
    var bytes = await ReadAllBytesAsync(imageFile);
    var result = await _desktopBridgeService.ReadAsync(bytes);
    return Ok(result);
}

Imports Microsoft.AspNetCore.Mvc

' No Telerik reading API available in ASP.NET Core.
' Workaround: forward uploaded file to a WPF or WinForms service
' that can reference Telerik.Windows.Controls.Barcode.
<HttpPost("read")>
Public Async Function ReadBarcode(imageFile As IFormFile) As Task(Of IActionResult)
    ' Must proxy to desktop service — no Telerik reader available here
    Dim bytes = Await ReadAllBytesAsync(imageFile)
    Dim result = Await _desktopBridgeService.ReadAsync(bytes)
    Return Ok(result)
End Function

IronBarcode -Ansatz:

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/barcode")]
public class BarcodeController : ControllerBase
{
    [HttpPost("read")]
    public IActionResult ReadBarcode(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var results = BarcodeReader.Read(stream);
        return Ok(results.Select(r => new
        {
            Format = r.BarcodeType.ToString(),
            Value = r.Value
        }));
    }

    [HttpGet("generate")]
    public IActionResult GenerateBarcode([FromQuery] string data)
    {
        var bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
                                 .ResizeTo(400, 100)
                                 .ToPngBinaryData();
        return File(bytes, "image/png");
    }
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/barcode")]
public class BarcodeController : ControllerBase
{
    [HttpPost("read")]
    public IActionResult ReadBarcode(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var results = BarcodeReader.Read(stream);
        return Ok(results.Select(r => new
        {
            Format = r.BarcodeType.ToString(),
            Value = r.Value
        }));
    }

    [HttpGet("generate")]
    public IActionResult GenerateBarcode([FromQuery] string data)
    {
        var bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
                                 .ResizeTo(400, 100)
                                 .ToPngBinaryData();
        return File(bytes, "image/png");
    }
}

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/barcode")>
Public Class BarcodeController
    Inherits ControllerBase

    <HttpPost("read")>
    Public Function ReadBarcode(imageFile As IFormFile) As IActionResult
        Using stream = imageFile.OpenReadStream()
            Dim results = BarcodeReader.Read(stream)
            Return Ok(results.Select(Function(r) New With {
                .Format = r.BarcodeType.ToString(),
                .Value = r.Value
            }))
        End Using
    End Function

    <HttpGet("generate")>
    Public Function GenerateBarcode(<FromQuery> data As String) As IActionResult
        Dim bytes = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
                                 .ResizeTo(400, 100) _
                                 .ToPngBinaryData()
        Return File(bytes, "image/png")
    End Function
End Class

BarcodeReader.Read() akzeptiert direkt einen Stream, sodass der hochgeladene Dateistrom ohne Schreiben auf die Festplatte übergeben wird. Dieser Controller kann ohne Änderungen unter Linux, Docker oder Azure App Service bereitgestellt werden.

Barcodes aus PDF-Dateien lesen

Telerik verfügt über keine PDF-Barcode-Lesefunktion. Das Hinzufügen des PDF-Lesens zu einer bestehenden auf Telerik basierenden Codebasis erfordert eine PDF-Rendering-Bibliothek, um die Seiten zu Bildern zu konvertieren, bevor sie an RadBarcodeReader übergeben werden. IronBarcode liest PDF-Dateien direkt.

Telerik-Ansatz:

// No direct PDF reading support in RadBarcodeReader.
// Workaround: use a separate PDF library to extract page images
using SomePdfLibrary; // third-party dependency
using Telerik.Windows.Controls.Barcode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();
    var pages = PdfRenderer.ExtractPages(pdfPath); // third-party call

    foreach (var pageImage in pages)
    {
        var reader = new RadBarcodeReader();
        reader.DecodeTypes = new[] { DecodeType.Code128, DecodeType.EAN13 };
        var bitmap = ConvertToBitmapImage(pageImage); // conversion required
        var result = reader.Decode(bitmap);
        if (result != null)
            results.Add(result.Text); // 1D only — QR codes on PDF pages are missed
    }
    return results;
}

// No direct PDF reading support in RadBarcodeReader.
// Workaround: use a separate PDF library to extract page images
using SomePdfLibrary; // third-party dependency
using Telerik.Windows.Controls.Barcode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();
    var pages = PdfRenderer.ExtractPages(pdfPath); // third-party call

    foreach (var pageImage in pages)
    {
        var reader = new RadBarcodeReader();
        reader.DecodeTypes = new[] { DecodeType.Code128, DecodeType.EAN13 };
        var bitmap = ConvertToBitmapImage(pageImage); // conversion required
        var result = reader.Decode(bitmap);
        if (result != null)
            results.Add(result.Text); // 1D only — QR codes on PDF pages are missed
    }
    return results;
}

Imports SomePdfLibrary ' third-party dependency
Imports Telerik.Windows.Controls.Barcode

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results As New List(Of String)()
    Dim pages = PdfRenderer.ExtractPages(pdfPath) ' third-party call

    For Each pageImage In pages
        Dim reader As New RadBarcodeReader()
        reader.DecodeTypes = New DecodeType() {DecodeType.Code128, DecodeType.EAN13}
        Dim bitmap = ConvertToBitmapImage(pageImage) ' conversion required
        Dim result = reader.Decode(bitmap)
        If result IsNot Nothing Then
            results.Add(result.Text) ' 1D only — QR codes on PDF pages are missed
        End If
    Next

    Return results
End Function

IronBarcode -Ansatz:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);
    return results.Select(r =>
        $"Page {r.PageNumber}: {r.BarcodeType} — {r.Value}").ToList();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = BarcodeReader.Read(pdfPath);
    return results.Select(r =>
        $"Page {r.PageNumber}: {r.BarcodeType} — {r.Value}").ToList();
}

Imports IronBarCode

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results = BarcodeReader.Read(pdfPath)
    Return results.Select(Function(r) $"Page {r.PageNumber}: {r.BarcodeType} — {r.Value}").ToList()
End Function

Es wird keine separate PDF-Bibliothek benötigt. Kein Seitenextraktionsschritt. Keine Bildkonvertierung. Übergeben Sie den PDF-Pfad, und IronBarcode verarbeitet alle Seiten und gibt alle Barcodes mit Seitennummerverfolgung zurück. Es werden sowohl 1D- als auch 2D-Barcodes auf PDF-Seiten erkannt.

Ausgabe 1: Ersatz für XAML-Barcode-Steuerung

Telerik: <telerik:RadBarcode> ist ein visuelles Steuerelement, das direkt im WPF-UI-Elementbaum gerendert wird. Es kann nicht durch ein Image-Element ohne Code-Behind-Änderungen ersetzt werden.

Lösung: Ersetzen Sie das <telerik:RadBarcode>-Element durch ein <Image>-Steuerelement und generieren Sie den Barcode im Code-Behind. Binden Sie die Image.Source an ein BitmapSource, das von IronBarcode generiert wurde:

// In code-behind or ViewModel
using IronBarCode;

var generated = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeEncoding.Code128)
                             .ResizeTo(400, 100);
BarcodeImage.Source = generated.ToBitmapSource();

// In code-behind or ViewModel
using IronBarCode;

var generated = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeEncoding.Code128)
                             .ResizeTo(400, 100);
BarcodeImage.Source = generated.ToBitmapSource();

Imports IronBarCode

' In code-behind or ViewModel
Dim generated = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeEncoding.Code128) _
                             .ResizeTo(400, 100)
BarcodeImage.Source = generated.ToBitmapSource()

Für Blazor ersetzen Sie <TelerikBarcode> durch ein <img>-Element, dessen src-Attribut einen serverseitig generierten base64-codierten PNG empfängt.

Problem 2: Nebenwirkungen der DecodeType-Entfernung

Telerik: Die DecodeTypes- (WPF) oder DecodeType- (WinForms) Eigenschaft filtert, welche Formate der Leser zu erkennen versucht. Durch das Entfernen dieses Filters im Rahmen einer IronBarcode -Migration gibt IronBarcode nun Ergebnisse für alle im Bild vorhandenen Formate zurück, einschließlich der Formate, die zuvor durch den Filter ausgeschlossen wurden.

Lösung: Entfernen Sie den DecodeType-Zuweisungsblock vollständig. Wenn die zusätzlich erkannten Formate unerwartete Ergebnisse in nachgelagerter Logik verursachen — zum Beispiel, wenn der Code davon ausgeht, dass immer nur ein Barcode-Format zurückgegeben wird — fügen Sie optionales Filtern mit BarcodeReaderOptions hinzu:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    ExpectedBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};
var results = BarcodeReader.Read(imagePath, options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    ExpectedBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};
var results = BarcodeReader.Read(imagePath, options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .ExpectedBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.EAN13
}
Dim results = BarcodeReader.Read(imagePath, options)

Dies ist optional. Das Standardverhalten (alle Formate erkennen) ist für die meisten Anwendungsfälle korrekt und liefert Ergebnisse, die mit der vorherigen Telerik-Implementierung nicht möglich waren.

Problem 3: Bereinigung des TelerikLicenseManager

Telerik: Telerik.WinControls.TelerikLicenseManager.InstallLicense(key)-Aufrufe erscheinen beim Anwendungsstart, typischerweise in Program.cs (WinForms) oder App.xaml.cs (WPF). Der Schlüssel wird oft in den App-Einstellungen, einer Konfigurationsdatei oder fest im Startverfahren codiert gespeichert.

Lösung: Entfernen Sie den TelerikLicenseManager.InstallLicense()-Aufruf. Ersetzen Sie es durch die IronBarcode -Schlüsselzuweisung am selben Startort:

// Remove:
// Telerik.WinControls.TelerikLicenseManager.InstallLicense("TELERIK-KEY");

// Add:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove:
// Telerik.WinControls.TelerikLicenseManager.InstallLicense("TELERIK-KEY");

// Add:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove:
' Telerik.WinControls.TelerikLicenseManager.InstallLicense("TELERIK-KEY")

' Add:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Wenn das Telerik-Paket weiterhin installiert bleibt (weil andere Nicht-Barcode Telerik-Steuerelemente noch verwendet werden), sollte der TelerikLicenseManager-Aufruf für diese Steuerelemente beibehalten werden. Den Aufruf nur dann entfernen, wenn die Telerik-Pakete selbst vollständig entfernt werden.

Vor der Migration anfallende Aufgaben

Prüfen Sie den Quellcode auf jegliche Verwendung von Telerik-Barcodes, bevor Sie Codeänderungen vornehmen:

# License initialization
grep -r "TelerikLicenseManager.InstallLicense" --include="*.cs" .

# XAML generation controls
grep -r "RadBarcode" --include="*.xaml" .
grep -r "TelerikBarcode" --include="*.razor" .

# Code-behind generation references
grep -r "RadBarcode" --include="*.cs" .
grep -r "Symbology\." --include="*.cs" .

# Reading API — WPF
grep -r "RadBarcodeReader" --include="*.cs" .
grep -r "DecodeTypes\." --include="*.cs" .
grep -r "reader\.Decode(" --include="*.cs" .

# Reading API — WinForms
grep -r "BarCodeReader" --include="*.cs" .
grep -r "DecodeType\." --include="*.cs" .
grep -r "reader\.Read(" --include="*.cs" .

# Result property access
grep -r "result\.Text" --include="*.cs" .
grep -r "result\.Symbology" --include="*.cs" .

# License initialization
grep -r "TelerikLicenseManager.InstallLicense" --include="*.cs" .

# XAML generation controls
grep -r "RadBarcode" --include="*.xaml" .
grep -r "TelerikBarcode" --include="*.razor" .

# Code-behind generation references
grep -r "RadBarcode" --include="*.cs" .
grep -r "Symbology\." --include="*.cs" .

# Reading API — WPF
grep -r "RadBarcodeReader" --include="*.cs" .
grep -r "DecodeTypes\." --include="*.cs" .
grep -r "reader\.Decode(" --include="*.cs" .

# Reading API — WinForms
grep -r "BarCodeReader" --include="*.cs" .
grep -r "DecodeType\." --include="*.cs" .
grep -r "reader\.Read(" --include="*.cs" .

# Result property access
grep -r "result\.Text" --include="*.cs" .
grep -r "result\.Symbology" --include="*.cs" .

Dokumentieren Sie jedes Spiel. Notieren Sie, welche Dateien XAML-Steuerelemente enthalten, welche Lesecode enthalten und zu welcher Plattform die jeweilige Datei gehört.

Aufgaben der Code-Aktualisierung

1. Entfernen Sie die Telerik-Barcode- NuGet -Pakete (oder behalten Sie sie bei, falls sie für andere Steuerelemente benötigt werden).
2. Installieren Sie das IronBarcode-NuGet-Paket in jedem Projekt, das Barcode-Funktionalität benötigt.
3. Fügen Sie IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY" an jedem Anwendungsstart-Einstiegspunkt hinzu.
4. Entfernen Sie Telerik-Namensraum-Importe und fügen Sie using IronBarCode hinzu.
5. Ersetzen Sie <telerik:RadBarcode>-XAML-Elemente durch <Image>-Steuerelemente.
6. Generieren Sie Barcode-Bilder im Code-Behind mit BarcodeWriter.CreateBarcode(...).ToBitmapSource().
7. Ersetzen Sie <TelerikBarcode>-Razor-Komponenten durch Base64-<img>-Quellen, die serverseitig generiert wurden.
8. Ersetzen Sie new RadBarcodeReader()-Instanzen durch BarcodeReader.Read(path)-statische Aufrufe.
9. Ersetzen Sie new RadBarcodeReader()-Instanzen durch BarcodeReader.Read(path)-statische Aufrufe.
10. Löschen Sie alle reader.DecodeTypes = new DecodeType[] { ... } and reader.DecodeType = new DecodeType[] { ... } Blöcke
11. Ersetzen Sie reader.Decode(bitmapImage)-Aufrufe durch BarcodeReader.Read(imagePath).
12. Ersetzen Sie reader.Read(drawingImage)-Aufrufe durch BarcodeReader.Read(imagePath).
13. Benennen Sie result.Text in result.Value um an allen Leseergebnis-Zugriffspunkten.
14. Benennen Sie result.Symbology in result.BarcodeType an allen Formatprüfpunkten um.
15. Ersetzen Sie Symbology.Code128 und ähnliche Generierungs-Enum-Werte durch BarcodeEncoding.Code128.
16. Entfernen Sie TelerikLicenseManager.InstallLicense()-Aufrufe, wo Telerik-Pakete vollständig entfernt wurden.

Post-Migrationstests

• Überprüfen Sie, ob alle zuvor gelesenen 1D-Barcodes (Code128, EAN13 usw.) weiterhin korrekte Werte liefern.
• Bestätigen Sie, dass QR-Codes in Testbildern nun erfolgreich gelesen werden, nachdem sie zuvor "null" zurückgegeben hatten.
• Testen Sie, ob die generierten Barcodes (gespeichert als PNG oder als Bytes bereitgestellt) sichtbar dargestellt und korrekt gescannt werden.
• Überprüfen Sie, ob ASP.NET Core oder Blazor Endpunkte, die zuvor keine Leseoperationen durchführen konnten, nun korrekt funktionieren.
• Falls die PDF-Lesefunktion hinzugefügt wurde, überprüfen Sie, ob die Barcodes auf jeder PDF-Seite mit den korrekten Seitenzahlen erkannt werden.
• Führen Sie die grep-Audit-Befehle aus dem Abschnitt "Vormigration" aus, um zu bestätigen, dass keine weiteren Telerik-Barcode-API-Referenzen mehr vorhanden sind.
• Stellen Sie sicher, dass IronBarCode.License.LicenseKey vor dem ersten BarcodeReader.Read()- oder BarcodeWriter.CreateBarcode()-Aufruf eingestellt ist.