Wie man QR-Codes in C# mit einem NuGet Paket generiert

Wie installiert man ein QR-Code NuGet Paket?

Die Installation von IronQR über NuGet Package Manager dauert nur wenige Sekunden. Öffnen Sie die NuGet Paket-Manager-Konsole in Visual Studio und führen Sie den folgenden Befehl aus, oder verwenden Sie den Befehl dotnet add package für CLI-Umgebungen:

Install-Package IronQR

Das NuGet-Paket kümmert sich automatisch um alle Abhängigkeiten und gewährleistet die Kompatibilität mit Ihren Ziel-Frameworks. IronQR unterstützt .NET Framework 4.6.2+, .NET Core 2.0+ und .NET 5-10 und ist somit eine vielseitige Bibliothek für jedes Visual Studio-Projekt.

Bevor Sie mit dem Programmieren beginnen, benötigen Sie einen kostenlosen Testlizenzschlüssel . Legen Sie dies früh im Startvorgang Ihrer Anwendung fest, damit alle nachfolgenden Aufrufe authentifiziert werden:

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using IronQr;

// Set license key before any IronQR operation
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Nachdem der Lizenzschlüssel eingerichtet ist, kann Ihre Anwendung QR-Codes generieren, lesen und anpassen, ohne dass Wasserzeichen auf den Ausgabebildern erscheinen.

Wie generiert man seinen ersten QR-Code?

Für die Erstellung Ihres ersten QR-Codes ist nur minimaler Code erforderlich. Die Klasse QrWriter übernimmt die QR-Code-Generierung mit sinnvollen Standardeinstellungen, die für die meisten Anwendungsfälle gut funktionieren:

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from text data
QrCode myQr = QrWriter.Write("Hello World");

// Save QR code as bitmap image
AnyBitmap qrImage = myQr.Save();

// Export to PNG file
qrImage.SaveAs("hello-qr.png");

Wie wählt man den richtigen Fehlerkorrekturwert?

QR-Codes unterstützen vier Fehlerkorrekturstufen, die in der Norm ISO/IEC 18004 für QR-Codes definiert sind und festlegen, wie viel Schaden ein Code erleiden kann, ohne an Scanbarkeit einzubüßen. IronQR unterstützt alle vier Ebenen über die Klasse QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionEbene.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure high error correction level
var options = new QrOptions(QrErrorCorrectionEbene.High);

// Generate QR code with options
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap image = qr.Save();
image.SaveAs("high-correction-qr.png");

Wie kann man das Erscheinungsbild eines QR-Codes anpassen?

IronQR bietet umfangreiche Styling-Optionen über QrStyleOptions, die benutzerdefinierte Farben, Abmessungen, Ränder und das Einbetten von Logos ermöglichen. Markeneigene QR-Codes erzielen im Marketingkontext bessere Ergebnisse, da sie den Code visuell mit einer bekannten Identität verknüpfen:

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create styled QR code with custom colors
var styleOptions = new QrStyleOptions
{
    Dimensions = 300,    // Width and height in pixels
    Margins = 10,        // Quiet zone in pixels
    Color = Color.DarkBlue,
    BackgroundColor = Color.White
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap styledImage = qr.Save(styleOptions);
styledImage.SaveAs("styled-qr.png");

Wie speichert man QR-Codes in verschiedenen Ausgabeformaten?

IronQR unterstützt mehrere Ausgabeformate, darunter PNG, JPEG, GIF, TIFF, BMP und SVG. Die Methode SaveAs erkennt das Format automatisch anhand der Dateierweiterung:

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

using IronQr;
using IronSoftware.Drawing;

QrCode qr = QrWriter.Write("Format demonstration");
AnyBitmap image = qr.Save();

// Save to raster image formats
image.SaveAs("qr-output.png");
image.SaveAs("qr-output.jpg");
image.SaveAs("qr-output.gif");

// Get as byte array for HTTP responses or database storage
byte[] pngBytes = image.ExportBytes();

Wie vergleicht man das IronQR NuGet Paket mit QRCoder?

Die QRCoder-Bibliothek ist eine beliebte Open-Source-Option zur QR-Code-Generierung in .NET. Entwickler, die QRCoder bereits verwendet haben, sind mit der mehrstufigen API vertraut, die QRCodeGenerator, QRCodeData und eine separate Rendering-Klasse wie PngByteQRCode umfasst. IronQR vereinfacht dies zu einem einzigen QrWriter.Write()-Aufruf.

QRCoder eignet sich gut für die grundlegende QR-Code-Generierung in Windows-Umgebungen. Das Machine-Learning-Modell von IronQR ermöglicht ein überlegenes Lesen von QR-Codes aus jedem Winkel – ein entscheidender Vorteil für Anwendungen, die vom Benutzer eingereichte Bilder verarbeiten, bei denen die Eingabequalität nicht kontrolliert werden kann. Die API mit nur einer Methode reduziert außerdem die Anzahl der Codezeilen, die für die Bereitstellung einer funktionierenden Funktion erforderlich sind.

Für Teams, die von QRCoder migrieren, steht im Migrationsleitfaden von QRCoder zu IronQR eine vergleichende API-Zuordnung zur Verfügung.

Wie kodiert man Binärdaten in einem QR-Code?

Neben Text unterstützt IronQR auch die Kodierung von Byte-Arrays für binäre QR-Code-Nutzdaten. Dies ist nützlich für verschlüsselte Token, serialisierte Objekte oder rohe Binärbezeichner, die nicht als UTF-8-Zeichenketten dargestellt werden können:

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Encode binary data -- useful for encrypted payloads or binary identifiers
byte[] binaryData = System.Text.Encoding.UTF8.GetBytes("Binary content example");
QrCode qr = QrWriter.Write(binaryData);
qr.Save().SaveAs("binary-qr.png");

Wie liest man QR-Codes in C#?

IronQR übernimmt sowohl das Schreiben als auch das Lesen. Die Klasse QrReader akzeptiert Bilddateien, Bitmaps und Kamerabilder und eignet sich daher sowohl für die Stapelverarbeitung als auch für Echtzeit-Scanszenarien:

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load an existing image containing a QR code
var inputImage = AnyBitmap.FromFile("qr-to-read.png");

// Read all QR codes in the image
QrReadResult readResult = QrReader.Read(inputImage);

foreach (QrResult result in readResult.QrCodes)
{
    // Access the decoded value
    Console.WriteLine($"Decoded: {result.Value}");
}

Die KI-gestützte Lese-Engine verarbeitet Bilder in jeder Ausrichtung und kommt mit Teilschäden bis zur Fehlerkorrekturschwelle zurecht. Für Szenarien, die das Lesen von QR-Codes in der Produktion betreffen, konsultieren Sie bitte das Tutorial zum Lesen von QR-Codes, um Hinweise zum Umgang mit Eingaben geringer Qualität, Bildern mit mehreren Codes und zur Konfiguration des Scanmodus zu erhalten.

Wie verwendet man IronQR in einer ASP.NET Core Anwendung?

Webanwendungen müssen häufig QR-Codes bei Bedarf generieren – beispielsweise für Benutzerkonto-Links, einmalige Anmeldecodes oder Zahlungsanforderungen. Das folgende Beispiel zeigt, wie ein QR-Code-Bild direkt von einem minimalen ASP.NET Core -API-Endpunkt bereitgestellt werden kann:

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

using IronQr;
using IronSoftware.Drawing;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Set license key at application startup
IronQr.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Return a QR code PNG for a given URL parameter
app.MapGet("/qr", (string data) =>
{
    QrCode qr = QrWriter.Write(data);
    AnyBitmap image = qr.Save();
    byte[] pngBytes = image.ExportBytes();
    return Results.File(pngBytes, "image/png");
});

app.Run();

Dieses Muster funktioniert sowohl in minimalen ASP.NET Core -APIs als auch in Standard-MVC-Controllern. Der Aufruf ExportBytes() vermeidet das Schreiben temporärer Dateien auf die Festplatte, was in containerisierten Umgebungen wichtig ist, da das Dateisystem dort möglicherweise schreibgeschützt oder kurzlebig ist.

Eine vollständige Anleitung zur ASP.NET Core -Integration finden Sie im Tutorial zum ASP.NET Core QR-Code-Generator . Eine Blazor-spezifische Anleitung ist auch im Tutorial zum Blazor QR-Code-Generator verfügbar.

Wie fügt man einem QR-Code-Bild einen Rand hinzu und ändert dessen Größe?

Die Kontrolle der Abmessungen und der Ruhezonen ist für eine hohe Druckqualität unerlässlich. IronQR stellt beides über QrStyleOptions bereit, und es gibt separate Anleitungen, die beides detailliert beschreiben:

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Specify dimensions and quiet zone for print output
var printOptions = new QrStyleOptions
{
    Dimensions = 600,   // High resolution for print
    Margins = 20        // Generous quiet zone for reliable scanning
};

QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap printImage = qr.Save(printOptions);
printImage.SaveAs("print-ready-qr.png");

Eine vollständige Anleitung zu Größen- und Randanforderungen für verschiedene Ausgabemedien finden Sie in den Anleitungsartikeln zum Ändern der Größe von QR-Code-Bildern und zum Hinzufügen von Rändern zu QR-Codes . Die Anleitung zum Erstellen von QR-Code-Bildern beschreibt den gesamten Workflow der Bilderstellung von der Lizenzaktivierung bis zur Dateiausgabe.

Für spezifische Anwendungsfälle von QR-Codes – wie das Generieren von QR-Codes für Visitenkarten , das Erstellen eines dynamischen QR-Code-Generators und das Lesen von QR-Codes aus Bildern – werden in den entsprechenden Artikeln alle Szenarien mit vollständigen Codebeispielen behandelt.

Was sind Ihre nächsten Schritte?

IronQR macht aus einem mehrstufigen Prozess die QR-Code-Generierung zu einer unkomplizierten NuGet Integration. Sie installieren das Paket, rufen QrWriter.Write() auf und speichern das Ergebnis – drei Operationen, die die Mehrzahl der realen Anwendungsfälle abdecken. Fehlerkorrekturstufen, benutzerdefinierte Formatierung, PDF-Stempelung und ML-gestütztes Lesen sind alle über dieselbe Bibliothek verfügbar.

Die IronQR Dokumentation bietet die vollständige API-Referenz, einschließlich fortgeschrittener Themen wie das Lesen von QR-Codes mit Scanmodi , Stapelverarbeitung und plattformspezifische Bereitstellungshinweise. Der Tutorialbereich von IronQR enthält Schritt-für-Schritt-Anleitungen for .NET MAUI, VB .NET und Konsolenanwendungen.

Starten Sie eine kostenlose Testphase , um den vollen Funktionsumfang ohne Einschränkungen zu erkunden, oder erwerben Sie eine Lizenz für den Produktiveinsatz mit technischem Support rund um die Uhr (24/5).