Aspose.BarCode is a powerful library that simplifies barcode generation, recognition, and manipulation in .NET applications. This article focuses on integrating the 1D barcode reader component of Aspose.BarCode into your projects. We will cover installation, setup, and practical examples to help you get started with reading barcodes efficiently.

Встановлення

Перш ніж занурюватися в деталі реалізації, переконайтеся, що ви встановили необхідні компоненти для використання Aspose.BarCode у вашому .NET застосунку. Ви можете встановити його за допомогою NuGet Package Manager або завантажити пакет безпосередньо з офіційного веб‑сайту.

Використання NuGet Package Manager

Щоб додати Aspose.BarCode у ваш проєкт через NuGet, виконайте наступні кроки:

  1. Відкрийте Visual Studio та перейдіть до вашого проєкту.
  2. Клацніть правою кнопкою миші на проєкті в Solution Explorer і виберіть “Manage NuGet Packages”.
  3. Шукати Aspose.BarCode і встановіть його.

Альтернативно, ви можете використати Package Manager Console за допомогою наступної команди:

Install-Package Aspose.BarCode

Ручна установка

Якщо ви віддаєте перевагу завантажити пакет вручну:

  1. Відвідайте офіційний веб‑сайт для Aspose.BarCode.
  2. Завантажте та розпакуйте файли пакету.
  3. Додайте посилання до вашого проєкту, включивши необхідні DLL.

Налаштування ліцензії

Щоб розблокувати повний функціонал, вам потрібно налаштувати ліцензійні ключі. Цей крок є важливим, оскільки він гарантує, що ви використовуєте ліцензовану версію Aspose.BarCode.

Кроки для налаштування ліцензії

  1. Отримайте ваші продуктові ключі з веб‑сайту Aspose після покупки або реєстрації пробної версії.
  2. Створіть Aspose.BarCode.Metered об’єкт і встановіть ваші ліцензійні ключі: csharp // set metered public and private keys Aspose.BarCode.Metered metered = new Aspose.BarCode.Metered(); // Access the setMeteredKey property and pass the public and private keys as parameters metered.SetMeteredKey("*****", "*****");

Посилання на бібліотеку

Після того, як ви встановили та ліцензували Aspose.BarCode, вам потрібно посилатися на нього у вашому проєкті. Це передбачає додавання using директива у верхній частині вашого файлу C#:

using Aspose.BarCode;

Це дозволяє використовувати класи та методи, надані бібліотекою.

Ініціалізація зчитувача штрих-кодів

Щоб зчитати штрихкоди з зображення, вам потрібно створити екземпляр BarCodeReader клас. Цей об’єкт відповідає за розпізнавання штрихкодів у зображеннях або файлах.

Приклад: зчитування штрих‑коду з PNG

Ось як ви можете створити новий екземпляр BarCodeReader:

// Read from an image file
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader("image.png"))
{
    foreach (var result in reader.ReadBarCodes())
    {
        Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
    }
}

Розширене зчитування штрих-кодів

Для більшого контролю над процесом зчитування ви можете вказати типи символьних наборів та інші налаштування:

// Read from a stream
using (System.IO.Stream stream = System.IO.File.OpenRead("image.png"))
{
    using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader(stream))
    {
        foreach (var result in reader.ReadBarCodes())
        {
            Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
        }
    }
}

Кращі практики

Обробка помилок

Завжди включайте обробку помилок, щоб коректно обробляти виключення:

using Aspose.BarCode.BarCodeRecognition;
using System;
using System.IO;


// Example of reading a barcode from a file
try
{
    using (BarCodeReader reader = new BarCodeReader(Path.Combine("C:", "path", "to", "your", "image.png")))
    {
        foreach (BarCodeResult result in reader.ReadBarCodes())
        {
            Console.WriteLine("Code Text: " + result.CodeText);
            Console.WriteLine("Symbology: " + result.CodeType);
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"An error occurred: {ex.Message}");
}

Висновок

Інтеграція Aspose.BarCode у ваші .NET застосунки забезпечує надійне рішення для обробки 1D штрих‑кодів. Дотримуючись кроків, викладених у цій статті, ви зможете ефективно зчитувати та обробляти штрих‑коди з зображень з мінімальними зусиллями.

Для отримання докладнішої інформації або розширених можливостей зверніться до офіційної документації: Aspose.BarCode KB Article

More in this category