Generator i Czytnik Kodów QR .NET Core | IronQR

Jak zainstalować bibliotekę kodów QR w .NET Core?

Aby rozpocząć, otwórz Visual Studio i kliknij przycisk tworzenia, aby rozpocząć nowy projekt. Po nadaniu nazwy projektowi instalacja biblioteki za pomocą menedżera pakietów NuGet zajmuje zaledwie kilka sekund. Chociaż niektórzy programiści mogą szukać pakietu QRCoder NuGet, framework IronQR można zainstalować, uruchamiając następujące polecenie w konsoli menedżera pakietów:

Install-Package IronQR

Alternatywnie można skorzystać z interfejsu użytkownika menedżera pakietów NuGet, wyszukując "IronQR" i klikając przycisk instalacji. Biblioteka zapewnia implementację .NET zgodną z .NET Core 3.x, .NET 5, 6, 7, 8, 9 i 10, co czyni ją idealną do nowoczesnego tworzenia stron internetowych i projektów wielopłatformowych.

Po instalacji dodaj wymagańe dyrektywy using na początku pliku. IronQR integruje się z IronSoftware.Drawing w celu obsługi obrazów na wielu platformach, eliminując potrzebę stosowania zależności specyficznych dla platformy, takich jak System.Drawing.Common, które zostały wycofane z użytku na wielu platformach w .NET 6 i nowszych wersjach.

Możesz sprawdzić, czy instalacja się powiodła, sprawdzając odwołania do pakietów w pliku .csproj lub upewniając się, że pakiet NuGet pojawia się w wynikach konsoli menedżera pakietów. Po zainstalowaniu dokumentacja API IronQR staje się natychmiast dostępna.

Jak wygenerować kod QR?

Klasa QrWriter, często używana wraz z wygodnymi metodami rozszerzeń, sprawia, że generowanie kodów QR jest proste. Oto kod źródłowy kompletnego przykładu wykorzystującego instrukcje najwyższego poziomu do wygenerowania kodu QR za pomocą zaledwie kilku wierszy kodu:

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate a QR code from input text
QrCode qrcode = QrWriter.Write("https://ironsoftware.com");

// Save as PNG image
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("website-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate a QR code from input text
Dim qrcode As QrCode = QrWriter.Write("https://ironsoftware.com")

' Save as PNG image
Dim qrImage As AnyBitmap = qrcode.Save()
qrImage.SaveAs("website-qr.png")

Czym są poziomy korekty błędów i dłączego mają znaczenie?

Korekcja błędów określa, ile uszkodzeń może wytrzymać symbol QR, pozostając jednocześnie skanowalnym. Jest to jedna z opcjonalnych funkcji zaawansowanych, która pozwala na budowanie marki i zapewnia trwałość. Norma dotycząca kodów QR (ISO/IEC 18004) definiuje cztery poziomy korekcji błędów, z których każdy wiąże się z kompromisem między pojemnością danych a odpornością.

Skonfiguruj korektę błędów za pomocą QrOptions:

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionPoziom.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure with high error correction level
var options = new QrOptions(QrErrorCorrectionPoziom.High, 20);

// Generate QR code with options
QrCode qrcode = QrWriter.Write("Product-12345", options);
AnyBitmap qrImage = qrcode.Save();
qrImage.SaveAs("product-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Configure with high error correction level
Dim options As New QrOptions(QrErrorCorrectionPoziom.High, 20)

' Generate QR code with options
Dim qrcode As QrCode = QrWriter.Write("Product-12345", options)
Dim qrImage As AnyBitmap = qrcode.Save()
qrImage.SaveAs("product-qr.png")

Jak dostosować wygląd kodu QR za pomocą logo i kolorów?

Funkcja QrStyleOptions firmy IronQR umożliwia generowanie kodów QR zgodnych z wizerunkiem marki, z niestandardowymi kolorami, wymiarami i osadzonymi logo. Jest to szczególnie przydatne w przypadku materiałów marketingowych, opakowań produktów i biletów na wydarzenia, gdzie spójność wizualna ma znaczenie.

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

var styleOptions = new QrStyleOptions
{
    Dimensions = 300,
    Margins = 10,
    Color = Color.DarkBlue,
    Logo = new QrLogo { Bitmap = AnyBitmap.FromFile("company-logo.png") }
};

QrCode qrcode = QrWriter.Write("https://yourcompany.com");
AnyBitmap qrImage = qrcode.Save(styleOptions);
qrImage.SaveAs("branded-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim styleOptions As New QrStyleOptions With {
    .Dimensions = 300,
    .Margins = 10,
    .Color = Color.DarkBlue,
    .Logo = New QrLogo With {.Bitmap = AnyBitmap.FromFile("company-logo.png")}
}

Dim qrcode As QrCode = QrWriter.Write("https://yourcompany.com")
Dim qrImage As AnyBitmap = qrcode.Save(styleOptions)
qrImage.SaveAs("branded-qr.png")

Jak generować kody QR w ASP.NET Core?

Integracja generowania kodów QR z ASP.NET Core odbywa się zgodnie z wzorcem Model-View-Controller. Oto implementacja klasy HomeController, która zwraca obraz kodu QR bezpośrednio z metody akcji:

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

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

namespace Examples
{
    public class HomeController : Controller
    {
        public IActionResult GenerateQR(string content)
        {
            QrCode myQr = QrWriter.Write(content);
            AnyBitmap qrImage = myQr.Save();
            byte[] imageBytes = qrImage.ExportBytes();
            return File(imageBytes, "image/png");
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

Namespace Examples
    Public Class HomeController
        Inherits Controller

        Public Function GenerateQR(content As String) As IActionResult
            Dim myQr As QrCode = QrWriter.Write(content)
            Dim qrImage As AnyBitmap = myQr.Save()
            Dim imageBytes As Byte() = qrImage.ExportBytes()
            Return File(imageBytes, "image/png")
        End Function
    End Class
End Namespace

Ten punkt końcowy przyjmuje dane kodu QR jako parametr i zwraca bezpośrednio wygenerowany obraz PNG. Podejście to sprawdza się zarówno w przypadku projektów ASP.NET Core Web API, jak i widoków Razor.

W przypadku produkcyjnych aplikacji .NET Core warto rozważyć buforowanie często generowanych kodów QR przy użyciu IMemoryCache lub IDistributedCache, aby zmniejszyć obciążenie procesora. Kody QR dla statycznych adresów URL, identyfikatorów produktów lub linków do wydarzeń nie zmieniają się między żądaniami i idealnie nadają się do buforowania.

Można również zintegrować IronQR z punktem końcowym Minimal API. Samouczek dotyczący integracji z .NET Core zawiera kompletny przykład obejmujący wzorce wstrzykiwania zależności oraz sposób udostępniania obrazów kodów QR z komponentu Blazor.

Rejestracja klucza licencyjnego IronQR w Program.cs przy użyciu wzorca instrukcji najwyższego poziomu pozwala zachować przejrzystość konfiguracji startowej:

using IronQr;

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

using IronQr;

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

Imports IronQr

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

Ustaw klucz licencyjny przed wywołaniem jakichkolwiek metod IronQR. W trakcie tworzenia oprogramowania można skorzystać z bezpłatnego klucza próbnego, który można uzyskać na stronie licencyjnej IronQR.

Jak zakodować tekst japoński w formacie Unicode?

IronQR obsługuje kodowanie japońskiego tekstu Unicode w trybie Kanji, który efektywnie koduje japońskie znaki Unicode przy użyciu mniejszej liczby segmentów danych niż standardowe kodowanie. Zmniejsza to wersję (rozmiar) kodu QR dla tej samej treści, tworząc mniej złożony symbol, który skanuje się szybciej.

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
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("こんにちは世界");
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

' Generate QR that encodes Japanese Unicode text
Dim japaneseQr As QrCode = QrWriter.Write("こんにちは世界")
Dim qrImage As AnyBitmap = japaneseQr.Save()
qrImage.SaveAs("japanese-qr.png")

Jak odczytywać kody QR za pomocą uczenia maszynowego?

IronQR wyróżnia się dzięki czytnikowi kodów QR opartemu na uczeniu maszynowym. Model ML osiąga wysoką dokładność nawet podczas odczytywania kodów QR pod różnymi kątami lub z częściowo zasłoniętych obrazów — jest to znacząca przewaga nad tradycyjnymi algorytmami wykrywania opartymi na progach, stosowanymi w wielu alternatywnych rozwiązaniach open source.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
AnyBitmap inputBmp = AnyBitmap.FromFile("scanned-document.png");
QrImageInput imageInput = new QrImageInput(inputBmp);

// Read with ML-powered detection
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

foreach (var result in results)
{
    Console.WriteLine($"Found: {result.Value}");
}

Imports IronQr
Imports IronSoftware.Drawing

' Load image containing QR code
Dim inputBmp As AnyBitmap = AnyBitmap.FromFile("scanned-document.png")
Dim imageInput As New QrImageInput(inputBmp)

' Read with ML-powered detection
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

For Each result In results
    Console.WriteLine($"Found: {result.Value}")
Next

Jak działa obsługa wielu platform?

W przeciwieństwie do rozwiązań opartych na System.Drawing.Common (wycofanym do użytku międzyplatformowego w .NET 6+), IronQR wykorzystuje IronSoftware.Drawing do prawdziwie wielopłatformowych projektów. Twój kod działa spójnie na systemach Windows, macOS, Linux, iOS i Android. W przypadku projektów wielopłatformowych alternatywy dla SkiaSharp nie są konieczne — IronQR wewnętrznie obsługuje abstrakcję platformy.

Dokumentacja dotycząca wielopłatformowości .NET wyjaśnia szerszy kontekst kompatybilności platformy w przypadku .NET 10. IronQR jest zgodny z tymi zasadami, całkowicie unikając interfejsów API specyficznych dla danej platformy.

IronQR obsługuje następujące środowiska docelowe:

• .NET 10, 9, 8, 7, 6 — wszystkie nowoczesne wersje .NET
• .NET Core 3.x — dla aplikacji, które nie zostały jeszcze przeniesione na nowoczesną platformę .NET
• Xamarin i MAUI — do tworzenia aplikacji mobilnych
• Azure Functions i AWS Lambda — do zadań bezserwerowych

Podczas działania w kontenerach Docker nie są potrzebne żadne dodatkowe pakiety systemówe poza standardowym obrazem środowiska uruchomieniowego .NET Standard. To upraszcza Dockerfile w porównaniu z bibliotekami wymagającymi natywnych zależności GDI+. Przewodnik wdrożeniowy IronQR obejmuje konfigurację dla środowisk kontenerowych i chmurowych.

Jak wypada IronQR na tle innych bibliotek QR dla platformy .NET?

Istnieje kilka bibliotek QR dla platformy .NET, z których każda ma inne zalety i wady. Zrozumienie różnic pomoże Ci wybrać odpowiednie narzędzie do Twojego projektu.

QRCoder to biblioteka open source na licencji MIT. Sprawdza się dobrze w przypadku prostego generowania kodów QR, ale nie obejmuje funkcji odczytu kodów QR ani wykrywania opartego na uczeniu maszynowym. Opcje wyjściowe są bardziej ograniczone w porównaniu z obsługą stylizowanego wyjścia w IronQR.

ZXing.NET to port biblioteki Java ZXing napisany w języku C#. Obsługuje zarówno odczyt, jak i zapis, ale opiera się na tradycyjnych technikach wizji komputerowej, które mają trudności z uszkodzonymi lub obróconymi kodami. Obsługa obrazów na różnych platformach wymaga dodatkowej konfiguracji.

IronQR zapewnia generowanie i odczyt w jednym pakiecie, a Licencja Enterprise obejmuje dedykowane wsparcie techniczne. Czytnik oparty na ML, stylizowane wyniki oraz integracja z IronSoftware.Drawing sprawiają, że jest to bardziej kompletne rozwiązanie dla aplikacji produkcyjnych.

Szczegółowe porównanie funkcji można znaleźć w artykułach IronQR vs QRCoder oraz IronQR vs ZXing.

Jakie są Twoje kolejne kroki?

IronQR zapewnia kompletne rozwiązanie do generowania i odczytu kodów QR w środowisku .NET Core. Dzięki obsłudze złożonych generatorów ładunków oraz automatycznemu montażowi modułów surowych i danych QrCodeData upraszcza cykl rozwoju. Niezależnie od tego, czy potrzebujesz prostej alternatywy dla biblioteki open source, czy systemu z opcjonalnymi zaawansowanymi funkcjami, architektura wielopłatformowa IronQR zapewnia niezawodne działanie.

Aby kontynuować tworzenie z wykorzystaniem IronQR, zapoznaj się z poniższymi zasobami:

• Pakiet IronQR NuGet — zainstaluj najnowszą stabilną wersję
• Dokumentacja API IronQR — pełna dokumentacja klas i metod
• Przykłady kodów QR — gotowy do skopiowania i wklejenia kod dla typowych scenariuszy
• Samouczki IronQR — przewodniki krok po kroku dotyczące konkretnych przypadków użycia
• Opcje licencyjne — wybierz plan odpowiedni dla swojego projektu

Rozpocznij bezpłatny okres próbny, aby odkryć pełen potencjał IronQR bez żadnych zobowiązań z góry.