Jak odczytywać BarCodes z plików PDF w języku C#

Updated: 22 kwietnia 2026

IronBarcode umożliwia bezpośrednie odczytanie kodów kreskowych z dokumentów PDF bez konieczności konwersji do obrazów, używając metody ReadPdf do wyodrębniania danych kodu kreskowego z faktur, etykiet wysyłkowych i raportów w zaledwie jednej linii kodu.

Odczytywanie barcode'ów z dokumentów PDF oznacza wykrywanie i dekodowanie barcode'ów na stronach PDF. Technologia ta pobiera zakodowane informacje bezpośrednio z dokumentów cyfrowych, eliminując ręczne skanowanie drukowanych BARCODE-ów. Automatyzuje procesy przetwarzania faktur, etykiet wysyłkowych, raportów i innych dokumentów zawierających dane BARCODE.

Szybki start: Odczytywanie BarCodes bezpośrednio z pliku PDF

Użyj metody IronBarcode ReadPdf, aby odczytać kody kreskowe z plików PDF bez konieczności konwersji do obrazów. Wyodrębnij dane z kodów BarCode za pomocą jednej linii kodu, a następnie dodaj zaawansowane opcje w razie potrzeby.

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2Skopiuj i uruchom ten fragment kodu.

var results = IronBarCode.BarcodeReader.ReadPdf("invoice.pdf");

var results = IronBarCode.BarcodeReader.ReadPdf("invoice.pdf");

3Wdrożenie do testowania w środowisku produkcyjnym

Rozpocznij używanie IronBarcode w swoim projekcie już dziś z darmową wersją próbną

Jakie są podstawowe kroki odczytu BarCodes w plikach PDF?

Zainstaluj biblioteke kodow kreskowych do przetwarzania plików z kodami kreskowymi. Sprawdz nasz przewodnik po pakietach NuGet, aby uzyskać szczegółowe instrukcje instalacji dla konkretnej platformy.
Utwórz PdfBarcodeReaderOptions, jeśli to wymagane.
Użyj metody ReadPdf z BarcodeReader, aby odczytać kody kreskowe z plików PDF.
Określ dodatkowe opcje odczytywania kodu kreskowego za pomocą BarcodeReaderOption.
Wyodrebnij wartosci kodow kreskowych.

Jak odczytywać kody kreskowe bezpośrednio z dokumentów PDF?

IronBarcode odczytuje kody kreskowe bezpośrednio z dokumentów PDF bez wymogu konwersji do obrazów. Aby uzyskać pełny przegląd wszystkich funkcji, odwiedz nasza Strone funkcjonalności. Użyj metody BarcodeReader.ReadPdf(), która akceptuje następujące typy wejściowe PDF:

byte[] array: dokument PDF jako tablica bajtów.
IEnumerable<Byte[]>: dokumenty PDF jako tablice bajtów przechowywane w kolekcji.
MemoryStream: dokumenty PDF jako typ MemoryStream.
IEnumerable<Stream>: dokumenty PDF jako kolekcja MemoryStream. Zobacz nasz przewodnik po odczytywaniu kodow kreskowych z strumieni.
String: ścieżka dokumentu PDF jako ciąg znaków lub nazwa pliku, jeśli został skopiowany do projektu.
IEnumerable<String>: ścieżki/nazwy plików dokumentów PDF przechowywane w kolekcji.

Metoda BarcodeReader.ReadPdf() akceptuje także PdfBarcodeReaderOptions dla zaawansowanych możliwości odczytu, omawianych w następnej sekcji. Oto jak używać BarcodeReader.ReadPdf() do odczytywania kodów kreskowych w dokumentach PDF:

using IronBarCode;
using System;
using System.Collections.Generic;

List<String> docs = new List<String>();
docs.Add(@"pdf_a.pdf");
docs.Add(@"pdf_b.pdf");

var myBarcode = BarcodeReader.ReadPdfs(docs);   //can also accept individual PDF document file path as argument

foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

using IronBarCode;
using System;
using System.Collections.Generic;

List<String> docs = new List<String>();
docs.Add(@"pdf_a.pdf");
docs.Add(@"pdf_b.pdf");

var myBarcode = BarcodeReader.ReadPdfs(docs);   //can also accept individual PDF document file path as argument

foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private docs As New List(Of String)()
docs.Add("pdf_a.pdf")
docs.Add("pdf_b.pdf")

Dim myBarcode = BarcodeReader.ReadPdfs(docs) 'can also accept individual PDF document file path as argument

For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private docs As New List(Of String)()
docs.Add("pdf_a.pdf")
docs.Add("pdf_b.pdf")

Dim myBarcode = BarcodeReader.ReadPdfs(docs) 'can also accept individual PDF document file path as argument

For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

Przekaż ciąg znaków ścieżki pliku PDF do BarcodeReader.ReadPdf(), aby odczytać wartości kodu kreskowego. Aby uzyskać więcej przykładów dotyczących odczytywania kodow kreskowych z różnych zrodel, zapoznaj sie z naszym samouczkiem dotyczącym odczytywania kodow kreskowych w C# / .NET. Aby wydrukować wszystkie wartości kodu kreskowego znalezione w PDF, iteruj przez wyniki używając pętli foreach i wywołaj ToString() dla każdego elementu. Przyklad ten także demonstruje używanie kolekcji nazw dokumentów PDF jako argumentu metody.

Jak mogę odczytywać wiele plików PDF na raz?

IronBarcode dostarcza metodę ReadPdfs do jednoczesnego przetwarzania wielu plików PDF. Ta metoda skutecznie wyodrebnia kody kreskowe z listy plików PDF. Aby poradzic sobie z wieloma kodami kreskowymi w dokumentach, zapoznaj sie z naszym przewodnikiem Odczytywanie wielu kodow kreskowych.

using IronBarCode;
using System;
using System.Collections.Generic;
using System.IO;

// Get all PDF files from a directory and add to list
string folderPath = @"PATH_TO_YOUR_FOLDER";
List<string> docs = new List<string>(Directory.GetFiles(folderPath, "*.pdf"));

// Read barcodes from all PDFs
var docResult = BarcodeReader.ReadPdfs(docs);

// Print results
foreach (var doc in docResult)
{
    foreach (var item in doc)
    {
        Console.WriteLine("Barcode " + item.ToString() + " found at page " + item.PageNumber);
    }
}

using IronBarCode;
using System;
using System.Collections.Generic;
using System.IO;

// Get all PDF files from a directory and add to list
string folderPath = @"PATH_TO_YOUR_FOLDER";
List<string> docs = new List<string>(Directory.GetFiles(folderPath, "*.pdf"));

// Read barcodes from all PDFs
var docResult = BarcodeReader.ReadPdfs(docs);

// Print results
foreach (var doc in docResult)
{
    foreach (var item in doc)
    {
        Console.WriteLine("Barcode " + item.ToString() + " found at page " + item.PageNumber);
    }
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic
Imports System.IO

' Get all PDF files from a directory and add to list
Dim folderPath As String = "PATH_TO_YOUR_FOLDER"
Dim docs As New List(Of String)(Directory.GetFiles(folderPath, "*.pdf"))

' Read barcodes from all PDFs
Dim docResult = BarcodeReader.ReadPdfs(docs)

' Print results
For Each doc In docResult
    For Each item In doc
        Console.WriteLine("Barcode " & item.ToString() & " found at page " & item.PageNumber)
    Next
Next

Imports IronBarCode
Imports System
Imports System.Collections.Generic
Imports System.IO

' Get all PDF files from a directory and add to list
Dim folderPath As String = "PATH_TO_YOUR_FOLDER"
Dim docs As New List(Of String)(Directory.GetFiles(folderPath, "*.pdf"))

' Read barcodes from all PDFs
Dim docResult = BarcodeReader.ReadPdfs(docs)

' Print results
For Each doc In docResult
    For Each item In doc
        Console.WriteLine("Barcode " & item.ToString() & " found at page " & item.PageNumber)
    Next
Next

Ten kod pobiera wszystkie pliki PDF z katalogu, dodaje je do List<string> i wywołuje ReadPdfs z listą jako wejście. Metoda zwraca tablicę BarcodeResults. Przeprowadz iteracje po wynikach, aby uzyskać dostep do kodow kreskowych z kazdego pliku PDF.

Jak skonfigurować opcje odczytu kodow kreskowych z PDF?

Skonfiguruj odczytywanie kodów kreskowych z PDF za pomocą PdfBarcodeReaderOptions. Aby uzyskać szczegółowe wyjasnienia wszystkich ustawien czytnika, odwiedz nasz przykład Ustal opcje czytnika kodow kreskowych z PDF. Dostosowanie tych właściwości poprawia jakosc, dokładność i wydajność. PdfBarcodeReaderOptions dziedziczy wszystkie właściwości BarcodeReaderOptions i dodaje opcje specyficzne dla PDF. Określ numery stron przy tworzeniu PdfBarcodeReaderOptions:

using IronBarCode;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)  // can also use individual page number as argument
{
    // Properties of PDF Barcode reader options
};

using IronBarCode;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)  // can also use individual page number as argument
{
    // Properties of PDF Barcode reader options
};

Imports IronBarCode
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber)

Imports IronBarCode
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber)

Poznaj dodatkowe właściwości dostępne w PdfBarcodeReaderOptions poza tymi dziedziczonymi z BarcodeReaderOptions.

Jak ustawienie DPI wpływa na odczyt kodow kreskowych?

Ustaw DPI (Kropki na cal) obrazów kodow kreskowych w dokumentach PDF. To poprawia odczytywanie niskiej jakosci kodow kreskowych. Uzyj wartosci typu Integer. Domyslne DPI wynosi 150. W przypadku mniejszych lub niskiej jakosci kodow kreskowych, zwieksz do 300 lub 600, aby uzyskać lepsze rozpoznanie. Wyższe wartości DPI zwiększają czas przetwarzania i zużycie pamięci.

Kiedy powinienem określać numery stron?

Określ numery stron zawierających kody kreskowe, aby poprawić wydajność, szczególnie w przypadku wielostronicowych plików PDF. IronBarcode pomija strony bez kodów kreskowych, gdy podasz konkretne numery stron. Numeracja stron zaczyna się od 1 (pierwsza strona to nie 0, a 1). W celu optymalizacji w przypadku dużych dokumentów, zapoznaj się z naszym przewodnikiem Opcje szybkości odczytu.

Jak postępować z plikami PDF chronionymi hasłem?

Pracuj z zaszyfrowanymi plikami PDF, podając hasło jako wejście typu String. IronBarcode nie może odzyskać haseł do PDF. Upewnij się, że masz niezbędne uprawnienia i bezpiecznie przechowuj hasła w aplikacji.

Jaki współczynnik skali powinienem użyć dla małych kodów kreskowych?

Kontroluj współczynnik skali dla szerokości i wysokości podczas konwersji na obrazy. Akceptuje wartość typu Integer z domyślną wartością 3.5. Wyższe współczynniki skali pomagają odczytać małe kody kreskowe poprzez powiększenie PDF-a. Dla kodów kreskowych o szerokości poniżej 1 cała, użyj współczynnika skali 5.0 lub wyższego. Wysokie współczynniki skali wpływają na wydajność.

Jak zaimplementować zaawansowane odczytywanie kodów kreskowych z PDF?

Zastosuj właściwości PdfBarcodeReaderOptions w swoim projekcie, aby poprawić odczytywanie kodów kreskowych z dokumentów PDF. Dla dodatkowych wskazówek dotyczących rozwiązywania problemów, gdy kody kreskowe nie są rozpoznawane, zapoznaj się z naszym przewodnikiem Barcode Not Recognized.

using IronBarCode;
using System;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)
{
    DPI = 150,
    //PageNumbers = pageNumber,      //this property is not needed if page numbers has been specified as the argument in PdfBarcodeReaderOptions
    Password = "barcode",
    Scale = 3.5,
    //properties below are some of the properties inherited from BarcodeReaderOptions
    Speed = ReadingSpeed.Detailed,
    ExpectBarcodeTypes = BarcodeEncoding.Code93,
    ExpectMultipleBarcodes = true
};

var myBarcode = BarcodeReader.ReadPdf(@"pdf_a_filepath.pdf", PdfOptions);
foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

using IronBarCode;
using System;
using System.Collections.Generic;

List<int> pageNumber = new List<int>() { 1, 2, 3 };

PdfBarcodeReaderOptions PdfOptions = new PdfBarcodeReaderOptions(pageNumber)
{
    DPI = 150,
    //PageNumbers = pageNumber,      //this property is not needed if page numbers has been specified as the argument in PdfBarcodeReaderOptions
    Password = "barcode",
    Scale = 3.5,
    //properties below are some of the properties inherited from BarcodeReaderOptions
    Speed = ReadingSpeed.Detailed,
    ExpectBarcodeTypes = BarcodeEncoding.Code93,
    ExpectMultipleBarcodes = true
};

var myBarcode = BarcodeReader.ReadPdf(@"pdf_a_filepath.pdf", PdfOptions);
foreach (var value in myBarcode)
{
    Console.WriteLine(value.ToString());
}

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber) With {
	.DPI = 150,
	.Password = "barcode",
	.Scale = 3.5,
	.Speed = ReadingSpeed.Detailed,
	.ExpectBarcodeTypes = BarcodeEncoding.Code93,
	.ExpectMultipleBarcodes = True
}

Private myBarcode = BarcodeReader.ReadPdf("pdf_a_filepath.pdf", PdfOptions)
For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

Imports IronBarCode
Imports System
Imports System.Collections.Generic

Private pageNumber As New List(Of Integer)() From {1, 2, 3}

Private PdfOptions As New PdfBarcodeReaderOptions(pageNumber) With {
	.DPI = 150,
	.Password = "barcode",
	.Scale = 3.5,
	.Speed = ReadingSpeed.Detailed,
	.ExpectBarcodeTypes = BarcodeEncoding.Code93,
	.ExpectMultipleBarcodes = True
}

Private myBarcode = BarcodeReader.ReadPdf("pdf_a_filepath.pdf", PdfOptions)
For Each value In myBarcode
	Console.WriteLine(value.ToString())
Next value

Zainicjuj PdfBarcodeReaderOptions z nazwą zmiennej, aby uzyskać dostęp i dostosować właściwości. Podaj numery stron jako argument podczas inicjalizacji, aby zastosować ustawienia do konkretnych stron. Alternatywnie ustaw numery stron używając właściwości PageNumbers.

Użyj odziedziczonych właściwości BarcodeReaderOptions takich jak ExpectMultipleBarcodes i ExpectBarcodeTypes, aby poprawić wydajność i dokładność. Zastosuj skonfigurowane PdfBarcodeReaderOptions przekazując je jako drugi argument do BarcodeReader.ReadPdf(), z ścieżką pliku PDF jako pierwszy argument.

W przypadku przetwarzania plików PDF z niedoskonalymi lub uszkodzonymi kodami kreskowymi, sprawdz nasze funkcje Korekcja obrazów, ktore można zastosować podczas przetwarzania PDF.

Często Zadawane Pytania

Jak mogę odczytać kody kreskowe z plików PDF w C#?

IronBarcode zapewnia prostą metodę ReadPdf, która pozwala na odczyt kodów kreskowych bezpośrednio z dokumentów PDF bez konieczności ich konwersji na obrazy. Możesz wyodrębnić dane z kodów kreskowych z plików PDF w zaledwie jednej linii kodu: var results = IronBarCode.BarcodeReader.ReadPdf("invoice.pdf");

Jakie typy wejściowe PDF akceptuje czytnik kodów kreskowych?

Metoda IronBarcode BarcodeReader.ReadPdf() akceptuje wiele typów wejściowych PDF, w tym: tablice bajtów, kolekcje tablic bajtów, obiekty MemoryStream, kolekcje MemoryStream, stringi ścieżek plików oraz kolekcje stringów ścieżek plików. Ta elastyczność pozwala pracować z plikami PDF z różnych źródeł.

Czy muszę konwertować pliki PDF na obrazy przed odczytem kodów kreskowych?

Nie, IronBarcode odczytuje kody kreskowe bezpośrednio z dokumentów PDF bez potrzeby ich konwersji na obrazy. Biblioteka przetwarza pliki PDF w naturalny sposób, co oszczędza czas i zachowuje oryginalną jakość danych z kodów kreskowych.

Jakie są podstawowe kroki do wdrożenia odczytu kodów kreskowych z plików PDF?

Aby odczytać kody kreskowe z plików PDF za pomocą IronBarcode: 1) Zainstaluj bibliotekę kodów kreskowych za pomocą NuGet, 2) Utwórz PdfBarcodeReaderOptions, jeśli są potrzebne zaawansowane ustawienia, 3) Użyj metody ReadPdf z BarcodeReader, 4) Opcjonalnie określ dodatkowe opcje odczytu używając BarcodeReaderOption, i 5) Wyodrębnij wartości kodów kreskowych z wyników.

Czy mogę skonfigurować zaawansowane opcje odczytu dla wyodrębniania kodów kreskowych z plików PDF?

Tak, IronBarcode wspiera zaawansowane możliwości odczytu poprzez PdfBarcodeReaderOptions. Pozwala to na dostosowanie procesu odczytu kodów kreskowych przy użyciu określonych parametrów i opcji w celu optymalizacji wykrywania i dokładności dla Twojego konkretnego przypadku użycia.

Jakie typy dokumentów mogą skorzystać z odczytu kodów kreskowych z plików PDF?

Odczyt kodów kreskowych z plików PDF za pomocą IronBarcode jest idealny do automatyzacji przepływów pracy obejmujących faktury, etykiety wysyłkowe, raporty i inne dokumenty biznesowe zawierające dane z kodów kreskowych. Eliminuje to potrzebę ręcznego skanowania wydrukowanych kodów kreskowych i usprawnia przetwarzanie dokumentów.

How can I read barcodes from different types of PDF input formats?

IronBarcode's `ReadPdf` method accepts various PDF input types including file paths as strings, byte arrays, and streams, facilitating flexibility in handling different input sources.

Can I extract barcodes from PDFs without converting to images?

Yes, IronBarcode allows you to extract barcodes directly from PDF documents using the `ReadPdf` method, bypassing the need for image conversion.

What scale factor is recommended for small barcodes in PDFs?

A higher scale factor, like 5.0 or higher, is recommended for reading small barcodes as it helps in enlarging the barcode images, making them easier to read.

How can I handle multiple barcodes in a single PDF document?

You can use the `ExpectMultipleBarcodes` property in `PdfBarcodeReaderOptions` to instruct IronBarcode to detect and decode multiple barcodes within the same PDF page.