QR-Code .NET Core: QR-Codes in C# lesen und generieren

Wie installiert man die QR-Code-Bibliothek?

Die Installation von IronQR über NuGet dauert nur wenige Sekunden. Öffnen Sie Visual Studio, gehen Sie zu Tools > NuGet Paket-Manager > NuGet Pakete für Projektmappe verwalten , suchen Sie nach IronQR und klicken Sie auf Installieren . Das Paket hat minimale Abhängigkeiten und ist sofort einsatzbereit für Windows, macOS und Linux.

Install-Package IronQR

IronQR ist kompatibel mit .NET Core 6, 7, 8, 9 und 10 sowie .NET Framework 4.6.2 und höher. Bei plattformübergreifenden Projekten übernimmt eine SkiaSharp-Integration die Bildverarbeitung auf Nicht-Windows-Laufzeitumgebungen. Die Bibliothek funktioniert mit ASP.NET Core Webanwendungen, Konsolenanwendungen und Desktop-Lösungen ohne zusätzliche Laufzeitkonfiguration. Nach der Installation stehen alle notwendigen Erweiterungsmethoden und -typen sofort zur Verfügung.

Wie liest man einen einfachen QR-Code aus einem Bild?

Das Auslesen von QR-Code-Daten aus Bilddateien erfordert nur wenige Codezeilen. Die Klasse QrReader verwendet ein fortschrittliches Machine-Learning-Modell, das die Bildqualität bewertet und automatisch den richtigen Segmentierungsmodus auswählt, sodass Sie auch dann genaue Ergebnisse erhalten, wenn das Eingabebild nicht optimal ist.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

Wie extrahiert man erweiterte QR-Code-Daten?

Über die grundlegende Wertdekodierung hinaus liefert IronQR Koordinaten, Rohdatensegmente und Informationen auf Modulebene aus jedem gescannten Symbol. Dies ist unerlässlich für Dokumentenverarbeitungs-Workflows, bei denen genau bekannt sein muss, wo sich ein QR-Code auf der Seite befindet, oder für Anwendungen, die mehrere Codes in einem einzigen Bild verarbeiten müssen.

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

Wie beeinflussen Fehlerkorrekturstufen die Qualität von QR-Codes?

Die Fehlerkorrektur ist der Mechanismus, der es einem QR-Scanner ermöglicht, die Originaldaten wiederherzustellen, selbst wenn ein Teil des Codes verdeckt, schlecht gedruckt oder physisch beschädigt ist. Der QR-Code-Standard definiert vier Stufen – Niedrig (L), Mittel (M), Quartil (Q) und Hoch (H) –, bei denen jeweils Speicherkapazität gegen Schadensresistenz eingetauscht wird.

Bei der Generierung von QR-Codes stellt die Angabe eines höheren Fehlerkorrekturniveaus sicher, dass die Ausgabe auch unter realen Scanbedingungen Bestand hat:

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

Wie generiert man QR-Codes mit internationalen Zeichen?

IronQR unterstützt alle QR-Codierungsmodi : numerisch, alphanumerisch, Byte und Kanji. Für japanische Texte und andere Unicode-Inhalte wählt die Bibliothek automatisch die speichereffizienteste Kodierung aus:

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Wie verwendet man Payload-Generatoren für strukturierte QR-Daten?

Ein QR-Code, der eine einfache URL kodiert, eignet sich für die einfache Linkweitergabe, aber viele Anwendungen müssen strukturierte Daten kodieren – WLAN-Zugangsdaten, Visitenkarten im vCard-Format oder Ereignisdaten. Das manuelle Formatieren dieser Nutzdaten ist fehleranfällig; Ein fehlendes Semikolon oder eine falsche Feldreihenfolge führen dazu, dass Scanner die Daten falsch interpretieren.

IronQR stellt Payload-Hilfsfunktionen bereit, die diese strukturierten Zeichenketten korrekt erstellen:

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

Wie kann man das Erscheinungsbild eines QR-Codes anpassen?

Mit IronQR haben Sie die Kontrolle über das visuelle Erscheinungsbild der generierten Codes, ohne die Lesbarkeit zu beeinträchtigen. Sie können die Vorder- und Hintergrundfarben ändern, ein individuelles Branding anwenden oder ein Logo in die Ruhezone in der Mitte einbetten.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

Durch das Einbetten eines Logos verringert sich der effektive Datenbereich, daher benötigt die Bibliothek beim Bereitstellen eines Logos die Fehlerkorrekturstufe H. Die reservierte Ruhezone im Zentrum umfasst etwa 30 % der Codefläche, was innerhalb der Wiederherstellungskapazität der H-Ebene liegt. Die Bibliothek setzt diese Einschränkung automatisch durch – wenn Sie neben einem Logo eine niedrigere Fehlerkorrekturstufe festlegen, löst IronQR eine Ausnahme mit einer beschreibenden Meldung aus, anstatt einen Code zu erzeugen, der unzuverlässig gescannt werden kann.

Für ASP.NET Core Anwendungen zeigt das Tutorial zum ASP.NET Core QR-Code-Generator, wie generierte QR-Codes als Bildantworten von einer Controller-Aktion bereitgestellt werden. Der Ausgabestream schreibt direkt in die Antwort, ohne zwischenzeitliche Datei-E/A, wodurch die Latenz für stark frequentierte Endpunkte gering bleibt.

Wie liest man QR-Codes in einer ASP.NET Core Anwendung?

Das Scannen von QR-Codes serverseitig – aus hochgeladenen Bildern, Dokumentenverarbeitungspipelines oder automatisierten Inspektionssystemen – ist ein häufiger Anwendungsfall für die Lese-API. Die Anleitung zum ASP.NET -QR-Code-Scanner beschreibt die vollständige Einrichtung von Controller und Dienst, das grundlegende Lesemuster ist jedoch dasselbe wie bei einer Konsolenanwendung:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

Die Methode AnyBitmap.FromStream() akzeptiert jeden lesbaren Datenstrom. Daher funktioniert derselbe Codepfad für über ein Formular hochgeladene Dateien, aus dem Blob-Speicher abgerufene Bilder oder aus einer Videopipeline extrahierte Frames. Der Controller schreibt keine temporären Dateien auf die Festplatte, was für containerisierte Bereitstellungen relevant ist, da das Dateisystem dort möglicherweise schreibgeschützt ist.

Bei Szenarien mit hohem Durchsatz instanziieren Sie QrReader einmal pro Anwendungslebensdauer als Singleton, da die Kosten für das Laden des ML-Modells bei der ersten Konstruktion anfallen. Nachfolgende Read()-Aufrufe auf derselben Instanz sind threadsicher und teilen sich das geladene Modell.

Wie generiert man QR-Codes in einer .NET MAUI Anwendung?

Das .NET MAUI QR-Code-Tutorial demonstriert die vollständige plattformübergreifende Generierung auf iOS, Android, macOS und Windows. IronQR verwendet das SkiaSharp -Rendering-Backend, wenn es auf Nicht-Windows-Plattformen ausgeführt wird, wodurch eine konsistente Ausgabe auf allen MAUI-Zielen gewährleistet wird.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

Auf mobilen Endgeräten gibt ExportBytes() ein PNG-Byte-Array zurück, das Sie direkt in StreamImageSource einlesen oder in ImageButton schreiben können. Das MAUI-Gerüst benötigt keine plattformspezifischen Codepfade – die gleiche Generierungslogik läuft auf allen vier MAUI-Zielen identisch ab.

Für VB .NET -Projekte ist die API-Oberfläche identisch; Lediglich die Syntax unterscheidet sich. Die Bibliothek wird als einzelnes NuGet Paket ausgeliefert, eine separate VB .NET -Assembly ist nicht erforderlich.

Was sind Ihre nächsten Schritte?

IronQR deckt den gesamten QR-Code-Lebenszyklus in .NET ab – von der grundlegenden Generierung und der strukturierten Nutzdatenkodierung bis hin zum ML-gestützten Lesen beschädigter oder markengeschützter Codes. Die Bibliothek übernimmt die Kanji-Kodierung, die Konfiguration der Fehlerkorrektur und die plattformübergreifende Bildausgabe, sodass Sie sich auf die für Ihre Anwendung spezifische Logik konzentrieren können.

Um das Gelernte in die Praxis umzusetzen:

• Sehen Sie sich das C# QR-Code-Leser-Tutorial an, um einen detaillierteren Einblick in die Lese-API und die Ergebnisverarbeitung zu erhalten.
• Arbeiten Sie das Tutorial zur C#-QR-Code-Generator-Anwendung durch, um eine vollständige Projektbeschreibung zu erhalten.
• Durchstöbern Sie die Codebeispiele , um weitere Generierungs- und Lesemuster zu sehen.
• Erwerben Sie eine IronQR Lizenz , um alle Funktionen für den Produktiveinsatz freizuschalten, oder verlängern Sie die kostenlose Testphase, wenn Sie mehr Testzeit benötigen.