Projekt wyłącznie z kodem QR

QRCoder oddziela etap tworzenia danych od etapu renderowania. QRCodeGenerator generuje pośredni obiekt QRCodeData, który następnie jest przekazywany do klasy renderera. Ten wzorzec zapewnia precyzyjną kontrolę nad formatem wyjściowym kosztem dodatkowych obiektów:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

Metoda QRCodeGenerator.CreateQrCode jest jedynym punktem wejścia do tworzenia kodu — nie ma CreateCode128, CreateDataMatrix, ani CreateEAN13. Biblioteka w pełni odpowiada zamierzonemu zakresowi.

Szczegółowe porównanie funkcji

Podejście QRCoder

QRCoder używa wzoru dwufazowego: QRCodeGenerator.CreateQrCode produkuje pośredni obiekt QRCodeData kodujący dane i poziom korekcji błędów, a oddzielna klasa renderera przekształca ten obiekt pośredni w pożądany format wyjściowy. Poziom ECC jest parametrem wymaganym, który nie ma wartości domyślnej — programiści muszą dokonać wyraźnego wyboru:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

Ten wzór ma tę zaletę, że pozwala na ponowne użycie obiektu qrCodeData dla wielu formatów wyjściowych bez ponownego generowania danych kodu. Klasy rendererów obejmują PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, i BitmapByteQRCode, wśród innych.

Podejście IronBarcode

IronBarcode łączy generowanie i renderowanie w płynny łańcuch na statycznej klasie BarcodeWriter. Parametr BarcodeEncoding.QRCode wybiera format, a metody terminalne takie jak SaveAsPng lub ToPngBinaryData określają wyjście:

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

W przypadku wymagających jawnej kontroli korekcji błędów, klasa QRCodeWriter oferuje opcje specyficzne dla formatu:

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

Przewodnik po tworzeniu kodów 2D IronBarcode obejmuje wszystkie obsługiwane formaty 2D, w tym Kod QR, DataMatrix,PDF417i Aztec, poprzez ten sam punkt wejścia BarcodeWriter.

Podejście QRCoder

Osadzanie logoQRCoderprzebiega przez renderer klasy QRCode (odrębny od PngByteQRCode), który udostępnia przeciążenie GetGraphic akceptujące System.Drawing.Bitmap. Oznacza to, że kod wywołujący musi pracować z System.Drawing bezpośrednio, aby załadować plik logo:

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

Dostosowanie koloru następuje w podobny sposób poprzez parametry darkColor i lightColor przeciążenia GetGraphic.

Podejście IronBarcode

IronBarcode udostępnia osadzanie logo i zmiany koloru jako nazwane metody na obiekcie wyniku QRCodeWriter. Metoda AddBrandLogo akceptuje ścieżkę do pliku, a ChangeBarCodeColor przyjmuje wartość Color:

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

' Logo embedding
Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-logo.png")

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

Przewodnik po dostosowywaniu stylu kodów QR szczegółowo omawia rozmiary logo, kombinacje kolorów oraz kontrolę strefy ciszy.

Podejście QRCoder

QRCoder nie posiada API do odczytu kodów kreskowych. Klasa QRCodeGenerator i wszystkie klasy rendererów są tylko do generowania. Nie ma metody dekodowania kodu QR z obrazu, pliku lub strumienia. Aplikacje, które muszą zarówno generować, jak i odczytywać kody QR, muszą dodać oddzielną bibliotekę — zazwyczaj ZXing.Net — z własnym API, własną przestrzenią nazw i własnym cyklem konserwacji:

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

'QRCoder has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

Jest to decyzja projektowa, a nie przeoczenie —QRCoderjest wyraźnie biblioteką generującą.

Podejście IronBarcode

IronBarcode zawiera interfejs API do odczytu w tym samym pakiecie. BarcodeReader.Read akceptuje pliki obrazów, pliki PDF, strumienie i obiekty System.Drawing.Bitmap. Automatycznie wykrywa formaty BARCODE bez konieczności określania przez użytkownika, jakiego formatu szuka, i zwraca wszystkie BARCODE znalezione na obrazie:

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);       // decoded value
    Console.WriteLine(result.Format);      // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);       // decoded value
    Console.WriteLine(result.Format);      // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Value)       ' decoded value
    Console.WriteLine(result.Format)      ' QRCode, Code128, EAN13, etc.
Next

Przewodnik dotyczący odczytu BARCODE-ów z obrazów obejmuje odczyt z plików PDF, dokumentów wielostronicowych, strumieni oraz obrazów o niskiej rozdzielczości lub zawierających zakłócenia za pośrednictwem tego samego punktu wejścia.

Podejście QRCoder

QRCoder generuje wyłącznie kody QR — tak zostało zaprojektowane. Metoda QRCodeGenerator.CreateQrCode jest jedynym punktem wejścia dla generowania, który biblioteka udostępnia. Projekty, które rozpoczynają się od kodów QR, a później wymagają etykiet wysyłkowych w formacie Code 128, kodów produktów EAN-13 lub kodów zgodności farmaceutycznej DataMatrix, muszą wprowadzić drugą bibliotekę, aby obsłużyć każdy dodatkowy format:

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Kod 128 requires a different library (e.g., NetBarcode)
//DataMatrixrequires yet another library
// Reading any format requires yet another library

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Kod 128 requires a different library (e.g., NetBarcode)
//DataMatrixrequires yet another library
// Reading any format requires yet another library

Imports QRCoder

' QRCoder is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

' Kod 128 requires a different library (e.g., NetBarcode)
' DataMatrix requires yet another library
' Reading any format requires yet another library

Podejście IronBarcode

IronBarcode obejmuje wszystkie rodziny formatów poprzez ten sam punkt wejścia BarcodeWriter.CreateBarcode. Przejście z kodu QR na Kod 128 naDataMatrixwymaga tylko zmiany parametru BarcodeEncoding — bez dodatkowych pakietów, nowych przestrzeni nazw, oddzielnych API:

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

Wymagania dotyczące formatu wykraczają poza QR

Większość wymagań dotyczących kodów kreskowych zaczyna się od kodów QR, aQRCoderniezawodnie radzi sobie z tym początkowym zakresem. Napięcie pojawia się, gdy do rozmowy wkracza drugi format. Zespoły logistyczne, które potrzebują etykiet Kod 128 do wysyłki, operacje detaliczne wymagające kodów produktów EAN-13, procesy farmaceutyczne wymagająceDataMatrixdo serializacji — każdy nowy format zmusza zespół do dodania kolejnej zależności NuGet. Koszt integracji każdej dodatkowej biblioteki obejmuje naukę nowej przestrzeni nazw, monitorowanie nowego cyklu wydawniczego oraz nowy punkt potencjalnego konfliktu wersji podczas aktualizacji Wersji .NET.

Odczytywanie BarCode staje się konieczne

Aplikacja generująca kody QR wychodzące na potrzeby kampanii jest systemem służącym wyłącznie do generowania. Aplikacja, która przetwarza również przesyłki przychodzące, weryfikuje kody produktów w momencie ich dostarczenia lub sprawdza bilety podczas wydarzenia, jest systemem generowania i odczytu.QRCoderz założenia nie posiada funkcji odczytu — tę lukę musi wypełnić druga biblioteka. Wprowadzenie biblioteki odczytu znacznie zmienia ślad integracyjny podsystemu BarCode, zwłaszcza jeśli biblioteka odczytu nakłada własne wymagania dotyczące specyfikacji formatu lub ograniczenia dotyczące bezpieczeństwa wątków.

Obciążenie związane z utrzymaniem wielu bibliotek

Naturalny schemat tworzenia projektu opartego na QRCoderze przebiega w przewidywalny sposób:QRCoderdo generowania kodów QR, biblioteka kodów kreskowych 1D do etykiet wysyłkowych, biblioteka odczytu do dekodowania. Każda biblioteka posiada własną dokumentację, własny cykl wydawania wersji oraz własną historię zmian wprowadzających niekompatybilność. Niewielka aktualizacja wersji .NET dla jednej biblioteki może zbiegać się w czasie z istotną zmianą w innej. Zespoły, które zarządzają tymi zasobami od lat, informują, że ukryty koszt nie wynika z początkowej integracji, ale z narastających kosztów utrzymania w wielu cyklach aktualizacji.

Obsługa dokumentów PDF

Generowanie barcode'ów do osadzenia w raportach PDF lub wyodrębnianie barcode'ów z przychodzących dokumentów PDF w procesie przetwarzania dokumentów nie jest możliwe w QRCoder. Obsługa plików PDF wymaga albo pełnej biblioteki PDF z funkcjami BarCode, albo dedykowanej kombinacji bibliotek. Zespoły tworzące procesy oparte na dokumentach — przetwarzanie faktur, raportowanie zgodności, generowanie etykiet na podstawie szablonów PDF — zauważają, że zakres działaniaQRCoderpokrywa się z wymaganiami dotyczącymi plików PDF już na wczesnym etapie cyklu życia projektu.

Format ciągu znaków PayloadGenerator

Klasy pomocnicze PayloadGenerator wQRCoderprodukują ciągi zgodne z publicznymi standardami ładunku kodów QR. Format WiFi, na przykład, produkuje WIFI:T:WPA;S:NetworkName;P:Password;;. Ciągi te można tworzyć bezpośrednio w IronBarcode bez klasy pomocniczej, ponieważ format jest publicznym standardem udokumentowanym w specyfikacji kodu QR. Zespoły z wieloma użyciami PayloadGenerator powinny planować pisanie małych statycznych metod pomocniczych, które replikuja konstruowanie ciągów.

Mapowanie enumów ECCLevel

QRCoder używa QRCodeGenerator.ECCLevel z wartościami L, M, Q, H.IronBarcode używa QRCodeWriter.QrErrorCorrectionLevel z wartościami Low, Medium, Quartile, i Highest. Mapowanie jest bezpośrednie, ale odniesienia do enumów muszą zostać zaktualizowane we wszystkich miejscach wywołania. Tam, gdzieQRCoderwymagał explicytnego wyboru ECC przy każdym wywołaniu CreateQrCode,IronBarcode stosuje rozsądne domyślne wartości, gdy używana jest ścieżka BarcodeWriter.CreateBarcode.

Usunięcie klasy Renderer

Klasy rendererówQRCoder— PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode — stają się niepotrzebne po migracji.IronBarcode wbudowuje renderowanie w płynny łańcuch na GeneratedBarcode, więc wzorzec pośredniego obiektu renderer nie przenosi się. Kod, który instancjuje te klasy rendererów, może być zastąpiony z wezwaniami do metod terminalnych na wyniku BarcodeWriter.