Wygeneruj i przeczytaj kod QR Royal Mail przy użyciu języka C#

Kod kreskowy 2D Royal Mail Mailmark to złożony kod kreskowy nadający się do odczytu maszynowego, używany w listach. Dostarcza informacji o śledzeniu poczty i statusie dostarczenia. Może również zawierać dodatkowe informacje, takie jak harmonogram dostaw i statystyki raportowania. W tym artykule dowiemy się, jak wygenerować i odczytać kod kreskowy 2D Royal Mail Mailmark przy użyciu języka C#.

W tym artykule zostaną omówione następujące tematy:

  1. C# API do generowania i odczytywania kodów QR Royal Mail
  2. Co to jest królewski kod kreskowy?
  3. Rodzaje kodów QR Royal Mail
  4. Wygeneruj kod QR Royal Mail
  5. Przeczytaj kod QR Royal Mail
  6. Darmowe zasoby edukacyjne

API C# do generowania i odczytywania kodu QR Royal Mail

Do generowania i odczytywania kodu QR Royal Mail będziemy używać Aspose.BarCode for .NET API. Za pomocą API możemy generować i rozpoznawać szeroką gamę typów kodów kreskowych 1D i 2D.

Proszę pobierz bibliotekę DLL interfejsu API lub zainstaluj ją za pomocą NuGet.

PM> Install-Package Aspose.BarCode

Co to jest królewski kod kreskowy?

Kod kreskowy Royal Mail to kod kreskowy Complex Mail Data Mark (CMDM). Został opracowany przez brytyjski system pocztowy w celu automatyzacji sortowania i śledzenia poczty. Posiada określony format kodu typu Data Matrix ECC200, zgodny z międzynarodowym standardem. Nazywa się go także 4-stanowym kodem klienta Royal Mail (RM4SCC).

Rodzaje kodów QR Royal Mail

Istnieją trzy typy kodów kreskowych 2D ze złożonymi znakami pocztowymi:

  • Typ 7:
    • Listy
    • Rozmiar kodu kreskowego: 24 × 24 moduły
    • Rozmiar fizyczny: 12 × 12 mm
    • Całkowita liczba znaków: 51 znaków
    • Do użytku klienta: 6 wolnych miejsc
Mailmark2DType7
  • Typ 9:
    • Duże litery, w tym litery foliowe
    • Rozmiar kodu kreskowego: 32 × 32 moduły
    • Rozmiar fizyczny: 16 × 16 mm
    • Całkowita liczba znaków: 90 znaków
    • Do użytku klienta: >25, ale maksymalnie 45 wolnych miejsc
Mailmark2DType9
  • Typ 29:
    • Duże litery, w tym litery zawijane folią
    • Rozmiar kodu kreskowego: 16 × 48 modułów
    • Rozmiar fizyczny: 8 × 24 mm
    • Całkowita liczba znaków: 70 znaków
    • Całkowita liczba znaków: Potrzebujemy 6–25 znaków klienta.
Mailmark2DType29

Wygeneruj stempel z kodem kreskowym Royal Mail w języku C#

Możemy wygenerować stempel z kodem kreskowym Royal Mail, wykonując poniższe czynności:

  1. Najpierw utwórz instancję klasy Mailmark2DCodetext.
  2. Następnie ustaw różne właściwości, takie jak UPUCountryID, VersionID, Class, ItemID itp.
  3. Następnie określ Mailmark2DType jako Type7, Type9 lub Type29.
  4. Następnie utwórz instancję klasy ComplexBarcodeGenerator z obiektem Mailmark2DCodetext jako argumentem.
  5. Następnie ustaw wymiary kodu kreskowego.
  6. Na koniec wywołaj metodę Save, aby zapisać obraz kodu kreskowego na dysku lokalnym.

Poniższy przykład kodu demonstruje, jak wygenerować kod kreskowy 2D Mailmark typu 7 przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak wygenerować kod kreskowy 2D Mailmark
// Zainicjuj kod 2D Mailmark
Mailmark2DCodetext mailmark2D = new Mailmark2DCodetext();
mailmark2D.UPUCountryID = "JGB ";
mailmark2D.InformationTypeID = "0";
mailmark2D.VersionID = "1";
mailmark2D.Class = "1";
mailmark2D.SupplyChainID = 123;
mailmark2D.ItemID = 1234;
mailmark2D.DestinationPostCodeAndDPS = "QWE1";
mailmark2D.RTSFlag = "0";
mailmark2D.ReturnToSenderPostCode = "QWE2";

// Zakoduj kod pocztowy 2D typu 7
mailmark2D.DataMatrixType = Mailmark2DType.Type_7;
mailmark2D.CustomerContent = "CUSTOM";

// Zainicjuj generator kodów kreskowych
var generator = new ComplexBarcodeGenerator(mailmark2D);
generator.Parameters.Barcode.XDimension.Pixels = 4;

// Ratować
generator.Ratować(@"D:\Files\BarCode\Mailmark2DType7.png");

Przeczytaj kod QR Royal Mail za pomocą C#

Kod QR Royal Mail możemy odczytać, wykonując poniższe czynności:

  1. Najpierw utwórz instancję klasy BarCodeReader.
  2. Następnie podaj ścieżkę wejściowego obrazu kodu kreskowego i DecodeType.
  3. Następnie uzyskaj BarCodeResult, wywołując metodę ReadBarCodes().
  4. Następnie zdekoduj kod kreskowy za pomocą metody TryDecodeMailmark2D().
  5. Na koniec przeczytaj zdekodowane właściwości obiektu Mailmark2DCodetext.

Poniższy przykład kodu demonstruje, jak odczytać kod QR Mailmark przy użyciu języka C#.

// Ten przykładowy kod pokazuje, jak odczytać kod kreskowy 2D Mailmark
// Rozpoznaj kod Mailmark 2D
BarCodeReader reader = new BarCodeReader(@"D:\Files\BarCode\Mailmark2DType7.png", DecodeType.DataMatrix);
foreach (BarCodeResult result in reader.ReadBarCodes())
{
    // Dekoduj znak pocztowy 2D 
    Mailmark2DCodetext mailmarkResult = ComplexCodetextReader.TryDecodeMailmark2D(result.CodeText);
    
    // Przeczytaj właściwości
    Console.WriteLine($"UPUCountryID:{mailmarkResult.UPUCountryID}");
    Console.WriteLine($"InformationTypeID:{mailmarkResult.InformationTypeID}");
    Console.WriteLine($"VersionID:{mailmarkResult.VersionID}");
    Console.WriteLine($"Class:{mailmarkResult.Class}");
    Console.WriteLine($"SupplyChainID:{mailmarkResult.SupplyChainID}");
    Console.WriteLine($"ItemID:{mailmarkResult.ItemID}");
    Console.WriteLine($"DestinationPostCodeAndDPS:{mailmarkResult.DestinationPostCodeAndDPS}");
    Console.WriteLine($"RTSFlag:{mailmarkResult.RTSFlag}");
    Console.WriteLine($"ReturnToSenderPostCode:{mailmarkResult.ReturnToSenderPostCode}");
    Console.WriteLine($"CustomerContent:{mailmarkResult.CustomerContent}");
}
UPUCountryID:JGB
InformationTypeID:0
VersionID:1
Class:1
SupplyChainID:123
ItemID:1234
DestinationPostCodeAndDPS:QWE1
RTSFlag:0
ReturnToSenderPostCode:QWE2
CustomerContent:CUSTOM DATA

Zdobądź bezpłatną licencję

Możesz uzyskać bezpłatną licencję tymczasową, aby wypróbować bibliotekę bez ograniczeń ewaluacyjnych.

Biblioteka kodów kreskowych 2D Mailmark — zasoby edukacyjne

Oprócz generowania i odczytywania kodów QR Royal Mail, możesz dowiedzieć się więcej o różnych innych funkcjach Aspose.BarCode, korzystając z zasobów podanych poniżej:

Wniosek

W tym artykule dowiedzieliśmy się, jak wygenerować kod QR Royal Mail i zapisać obrazy kodów kreskowych na dysku. Widzieliśmy również, jak programowo odczytać wygenerowany kod kreskowy 2D Mailmark. Poza tym możesz dowiedzieć się więcej o Aspose.BarCode for .NET API, korzystając z dokumentacji. W przypadku jakichkolwiek niejasności prosimy o kontakt na naszym bezpłatnym forum pomocy technicznej.

Zobacz też