Como Ler Códigos de Barras de PDFs em C#

Quais são as etapas básicas para ler códigos de barras em PDF?

1. Instale a biblioteca de códigos de barras para processar arquivos de códigos de barras. Consulte nosso guia de Pacotes NuGet para instalação específica da plataforma.
2. Crie PdfBarcodeReaderOptions se necessário.
3. Use o método ReadPdf do BarcodeReader para ler códigos de barras de PDFs.
4. Especifique opções adicionais de leitura de código de barras usando BarcodeReaderOption.
5. Extraia os valores do código de barras.

Como ler códigos de barras de documentos PDF diretamente?

IronBarcode lê códigos de barras diretamente de documentos PDF sem a necessidade de conversão para imagens. Para uma visão abrangente de todas as funcionalidades, visite nossa página de Recursos. Use o método BarcodeReader.ReadPdf(), que aceita estes tipos de entrada em PDF:

• byte[] array: Documento PDF como um array de bytes.
• IEnumerable<Byte[]>: Documentos PDF como arrays de bytes armazenados em uma coleção.
• MemoryStream: Documentos PDF como tipo MemoryStream.
• IEnumerable<Stream>: Documentos PDF como uma coleção de MemoryStream. Veja nosso guia Ler Código de Barras de Streams.
• String: Caminho do documento PDF como uma string ou nome de arquivo se copiado para o projeto.
• IEnumerable<String>: Strings de nome/caminho de documento PDF armazenadas em uma coleção.

O método BarcodeReader.ReadPdf() também aceita PdfBarcodeReaderOptions para capacidades de leitura avançadas, discutidas na próxima seção. Veja como usar BarcodeReader.ReadPdf() para ler códigos de barras em documentos PDF:

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-1.cs

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());
}

Passe a string de caminho do arquivo PDF para BarcodeReader.ReadPdf() para ler valores de código de barras. Para mais exemplos de leitura de códigos de barras de diferentes fontes, confira nosso tutorial Lendo Códigos de Barras em C# / .NET. Para imprimir todos os valores de código de barras encontrados no PDF, percorra os resultados usando um loop foreach e chame ToString() em cada elemento. Este exemplo também demonstra o uso de uma coleção de nomes de documentos PDF como argumento do método.

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-read-from-multiple-pdf.cs

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);
    }
}

Como configuro as opções do leitor de códigos de barras de PDF?

Configure a leitura de códigos de barras de PDFs usando PdfBarcodeReaderOptions. Para uma explicação detalhada de todas as configurações do leitor, visite nosso exemplo Configurar Opções do Leitor de Códigos de Barras de PDF. Ajustar essas propriedades melhora a qualidade, precisão e desempenho. PdfBarcodeReaderOptions herda todas as propriedades de BarcodeReaderOptions e adiciona opções específicas para PDF. Especifique números de página ao instanciar PdfBarcodeReaderOptions:

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-2.cs

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
};

Explore as propriedades adicionais disponíveis em PdfBarcodeReaderOptions além daquelas herdadas de BarcodeReaderOptions.

Como Implemento Leitura Avançada de Código de Barras em PDFs?

Aplique propriedades PdfBarcodeReaderOptions em seu projeto para melhorar a leitura de códigos de barras de documentos PDF. Para dicas adicionais de solução de problemas quando códigos de barras não são reconhecidos, consulte nosso guia Código de Barras Não Reconhecido.

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-pdf-3.cs

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());
}

Inicialize PdfBarcodeReaderOptions com um nome de variável para acessar e ajustar propriedades. Passe números de página como um argumento durante a inicialização para aplicar configurações a páginas específicas. Alternativamente, defina números de página usando a propriedade PageNumbers.

Use propriedades herdadas de BarcodeReaderOptions como ExpectMultipleBarcodes e ExpectBarcodeTypes para melhorar o desempenho e a precisão. Aplique PdfBarcodeReaderOptions configurado passando-o como o segundo argumento para BarcodeReader.ReadPdf(), com o caminho do arquivo PDF como o primeiro argumento.

Para processar PDFs com códigos de barras imperfeitos ou danificados, explore nossos recursos de Correção de Imagem que podem ser aplicados durante o processamento de PDFs.