1.0 Wprowadzenie

Sposobem na przedstawienie danych w widocznym, czytelnym dla maszyn formacie jest użycie BARCODE-ów. Początkowo równoległe linie miały różne odstępy, szerokości i rozmiary, aby przedstawiać dane w BARCODE-ach. Te nowoczesne kody kreskowe liniowe lub jednowymiarowe (1D) mogą być odczytywane przez specjalistyczne skanery optyczne znane jako czytniki BARCODE, których istnieje kilka odmian. Później powstały wersje dwuwymiarowe (2D), znane jako kody matrycowe lub BARCODES 2D, mimo że tak naprawdę nie wykorzystują one kresek. W tych wariantach zamiast tradycyjnych BARCODE-ów wykorzystano prostokąty, kropki, sześciokąty i inne wzory. Skanery optyczne 2D, zaprojektowane specjalnie do odczytu BARCODE-ów 2D, są dostępne w różnych konfiguracjach. Inną metodą odczytu kodów kreskowych 2D jest użycie aparatu cyfrowego podłączonego do komputera z oprogramowaniem, które robi zdjęcie kodu kreskowego i dekoduje go na podstawie obrazu. Ten ostatni rodzaj skanera BarCode może być używany przez urządzenie mobilne z wbudowanym aparatem, takie jak smartfon, po zainstalowaniu specjalistycznego oprogramowania.

2.0 Funkcje IronBarcode

Generowanie dynamicznych kodów kreskowych jest łatwe dzięki bibliotece IronBarcode. Ta prosta biblioteka pozwala wygenerować BARCODE za pomocą zaledwie kilku linii kodu. Czytniki kodów kreskowych IronBarcode zawierają niezawodne generatory kodów kreskowych, które umożliwiają tworzenie kodów kreskowych o wysokiej jakości. Dzięki temu skaner kodów kreskowych z łatwością odczyta Twój BarCode.

• IronBarcode potrafi odczytywać i zapisywać większość formatów BarCode oraz standardów QR, w tym UPC A/E, Databar, EAN 8/13, MSI, Code 39/93/128, CodaB, RSS 14/Expanded oraz ITF.
• Podczas odczytywania skanów i klatek wideo w czasie rzeczywistym IronBarcode może korygować obrót, szumy, zniekształcenia i przekrzywienie. Podczas generowania BarCodes IronBarcode automatycznie przetwarza obrazy BarCodes, aby poprawić szybkość i precyzję odczytu. BARCODE dynamiczny jest popularny, ponieważ umożliwia modyfikację treści.
• IronBarcode może wykorzystywać wiele rdzeni i wątków, co jest korzystne dla serwerów przetwarzających dane w trybie wsadowym.
• W dokumentach jedno- i wielostronicowych IronBarcode może automatycznie znaleźć jeden lub więcej BarCodes.
• IronBarcode obsługuje zarówno architekturę 32-bitową, jak i 64-bitową oraz jest kompatybilny zarówno z implementacjami .NET Framework, jak i .NET Core.
• IronBarcode obsługuje aplikacje konsolowe, desktopowe, chmurowe i internetowe na platformach PC i mobilnych.
• IronBarcode może tworzyć obrazy BARCODE dla różnych typów plików i strumieni, w tym PDF, JPG, TIFF, GIF, BMP, PNG i HTML.

3.0 Tworzenie nowego projektu w Visual Studio

Aby korzystać z frameworka IronBarcode, należy najpierw utworzyć projekt Visual Studio .NET. Można używać dowolnej wersji programu Visual Studio, choć zalecana jest najnowsza wersja. W zależności od potrzeb można utworzyć aplikację .NET Windows Forms lub wybrać jeden z wielu szablonów projektów. W tej lekcji, aby uprościć sprawę, użyjemy aplikacji Windows Forms.

Wprowadź nazwę i lokalizację projektu.

W projekcie tym zostanie wykorzystany .NET Framework 4.7.

Po utworzeniu projektu plik Form1.cs otworzy się w widoku projektanta. Możesz wstawiać kod programu, projektować interfejs użytkownika oraz kompilować i uruchamiać program. Aby użyć biblioteki IronBarcode w rozwiązaniu, należy pobrać wymagany pakiet. Można to zrobić, używając następującego kodu w konsoli menedżera pakietów:

Install-Package BarCode

Alternatywnie można użyć menedżera pakietów NuGet, aby wyszukać i pobrać pakiet "BarCode", który wyświetli listę wszystkich wyników wyszukiwania. Stamtąd można wybrać wymagany pakiet do pobrania.

W naszym formularzu umieściliśmy okno SaveFileDialog, które pozwala na zapisanie wygenerowanych obrazów kodów kreskowych w wybranej lokalizacji.

4.0 Generowanie kodów kreskowych za pomocą IronBarcode

Biblioteka IronBarcode pozwala nam szybko generować kody kreskowe za pomocą zaledwie kilku linii kodu. Poniżej znajduje się przykładowy kod służący do generowania etykiety z kodem BarCode przy użyciu formularza Windows Form:

using IronBarCode;  // Import IronBarcode namespace for barcode generation
using System;
using System.Windows.Forms;  // For creating Windows Forms applications

namespace IronBarcode_demo
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();  // Initializes the form components
        }

        private void button1_Click(object sender, EventArgs e)
        {
            try
            {
                saveFileDialog1.Filter = ".png|*.png";  // Set file filter for saving as PNG
                DialogResult result = saveFileDialog1.ShowDialog();  // Show save file dialog
                if (result == DialogResult.OK)
                {
                    string filename = saveFileDialog1.FileName;  // Get the filename chosen by the user
                    // Create a QR code using data from textBox1, and save it as a PNG
                    QRCodeWriter.CreateQrCode(textBox1.Text, 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng(filename);
                    MessageBox.Show("Barcode Generated Successfully");  // Inform user of success
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);  // Display error message in case of exception
            }
        }
    }
}

using IronBarCode;  // Import IronBarcode namespace for barcode generation
using System;
using System.Windows.Forms;  // For creating Windows Forms applications

namespace IronBarcode_demo
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();  // Initializes the form components
        }

        private void button1_Click(object sender, EventArgs e)
        {
            try
            {
                saveFileDialog1.Filter = ".png|*.png";  // Set file filter for saving as PNG
                DialogResult result = saveFileDialog1.ShowDialog();  // Show save file dialog
                if (result == DialogResult.OK)
                {
                    string filename = saveFileDialog1.FileName;  // Get the filename chosen by the user
                    // Create a QR code using data from textBox1, and save it as a PNG
                    QRCodeWriter.CreateQrCode(textBox1.Text, 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng(filename);
                    MessageBox.Show("Barcode Generated Successfully");  // Inform user of success
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);  // Display error message in case of exception
            }
        }
    }
}

Imports IronBarCode ' Import IronBarcode namespace for barcode generation
Imports System
Imports System.Windows.Forms ' For creating Windows Forms applications

Namespace IronBarcode_demo
	Partial Public Class Form1
		Inherits Form

		Public Sub New()
			InitializeComponent() ' Initializes the form components
		End Sub

		Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs)
			Try
				saveFileDialog1.Filter = ".png|*.png" ' Set file filter for saving as PNG
				Dim result As DialogResult = saveFileDialog1.ShowDialog() ' Show save file dialog
				If result = System.Windows.Forms.DialogResult.OK Then
					Dim filename As String = saveFileDialog1.FileName ' Get the filename chosen by the user
					' Create a QR code using data from textBox1, and save it as a PNG
					QRCodeWriter.CreateQrCode(textBox1.Text, 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng(filename)
					MessageBox.Show("Barcode Generated Successfully") ' Inform user of success
				End If
			Catch ex As Exception
				MessageBox.Show(ex.Message) ' Display error message in case of exception
			End Try
		End Sub
	End Class
End Namespace

Imports IronBarCode ' Import IronBarcode namespace for barcode generation
Imports System
Imports System.Windows.Forms ' For creating Windows Forms applications

Namespace IronBarcode_demo
	Partial Public Class Form1
		Inherits Form

		Public Sub New()
			InitializeComponent() ' Initializes the form components
		End Sub

		Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs)
			Try
				saveFileDialog1.Filter = ".png|*.png" ' Set file filter for saving as PNG
				Dim result As DialogResult = saveFileDialog1.ShowDialog() ' Show save file dialog
				If result = System.Windows.Forms.DialogResult.OK Then
					Dim filename As String = saveFileDialog1.FileName ' Get the filename chosen by the user
					' Create a QR code using data from textBox1, and save it as a PNG
					QRCodeWriter.CreateQrCode(textBox1.Text, 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng(filename)
					MessageBox.Show("Barcode Generated Successfully") ' Inform user of success
				End If
			Catch ex As Exception
				MessageBox.Show(ex.Message) ' Display error message in case of exception
			End Try
		End Sub
	End Class
End Namespace

Przed rozpoczęciem pisania kodu dodaj pole tekstowe do aplikacji .NET WinForms. To pozwoli nam wprowadzić tekst w celu wygenerowania BARCODE. Następnie dodaj przycisk do aplikacji Windows Forms i dodaj wymagany kod z przykładowego kodu. Używamy również narzędzia SaveFileDialog, które pomoże zapisać wygenerowany obraz kodu kreskowego w wybranej lokalizacji.

Po kliknięciu przycisku "zapisz BarCode" pojawi się okno dialogowe "Zapisz jako", w którym użytkownik może wybrać nazwę pliku i lokalizację, w której wygenerowany obraz BarCode zostanie zapisany jako plik PNG. BarCode jest generowany na podstawie tekstu wprowadzonego w polu tekstowym.

Jedynym wymaganym argumentem dla funkcji CreateQrCode jest dane, które muszą być zakodowane w obrazie kodu QR (ciąg znaków lub strumień, które otrzymujemy z pola tekstowego). Metoda akceptuje również trzy dodatkowe parametry opcjonalne:

• Domyślny rozmiar grafiki to 500 pikseli szerokości i 500 pikseli wysokości.
• Poziom korekty błędów. IronBarcode ma cztery poziomy korekcji błędów: Niski, Średni, Wysoki i Najwyższy. Najwyższy poziom korekcji jest domyślnie używany przy tworzeniu kodów QR (QRCodeWriter.QrErrorCorrectionLevel.greatest).
• Numer wersji kodu QR. Jeśli wartość wynosi 0 (wartość domyślna), metoda otrzymuje polecenie użycia odpowiedniego numeru wersji na podstawie danych, które będzie kodować.

Powyższy przykład tworzy grafikę o wymiarach 500 na 500 pikseli przy użyciu średniego stopnia korekcji błędów. Używając funkcji SaveAsPng na niestandardowym kodzie QR, który został wygenerowany, możemy zapisać kod QR jako plik PNG w wyznaczonej lokalizacji pliku, którą otrzymaliśmy z dialogu plików SaveAs.

Kliknij tutaj, aby uzyskać bardziej szczegółowy przewodnik po IronBarcode.

5.0 Podsumowanie

Biblioteka IronBarcode jest uważana za jedną z najlepszych opcji do generowania i rozpoznawania kodów kreskowych ze względu na swoją wydajność i kompatybilność z różnymi systemami operacyjnymi. Oferuje szereg funkcji do tworzenia i dostosowywania różnych typów BARCODE-ów, w tym możliwość dostosowania tekstu, koloru, szerokości linii i wysokości. Szczegóły dotyczące licencji biblioteki są dostępne na stronie internetowej, która zawiera zarówno płatne, jak i bezpłatne wersje dla programistów. Aktualizacje i wsparcie techniczne są zapewniane bezpłatnie przez rok.