C# QR 코드 리더 (단계별 튜토리얼)

1. 새 프로젝트 생성

Visual Studio를 열고 파일 메뉴로 이동하세요. 새 프로젝트를 선택한 후 콘솔 애플리케이션/윈도우 폼/WPF 애플리케이션을 선택합니다. 바코드는 모든 유형의 애플리케이션에 사용할 수 있습니다. 또한, Webform/MVC/MVC Core와 같은 앱에서도 사용할 수 있습니다.

새 프로젝트 구성하기

프로젝트 이름을 입력하고 Visual Studio의 적절한 텍스트 상자에 파일 경로를 선택합니다. 다음으로 생성 버튼을 클릭하고 필요한 .NET Framework를 선택합니다. 이제 프로젝트는 선택한 애플리케이션의 구조를 생성합니다. 만약 콘솔 애플리케이션을 선택했다면, 이제 program.cs 파일을 열어서 코드를 입력하고 애플리케이션을 빌드/실행할 수 있습니다.

2. IronBarcode NuGet Install-Package

이제 Visual Studio의 솔루션 탐색기로 이동하여 프로젝트를 왼쪽 클릭합니다. 팝업 메뉴에서 NuGet 패키지 관리자를 선택하고 키워드로 'Barcode'를 검색합니다. NuGet 패키지 대화 상자에서 첫 번째 결과를 선택하고 설치 옵션을 클릭합니다.

NuGet 패키지 관리자에서 IronBarcode 라이브러리 설치

또는 Visual Studio에서 다음 지침을 따르세요: 도구 > NuGet 패키지 관리자 > 패키지 관리자 콘솔

패키지 관리자 콘솔 탭을 엽니다. 다음 줄을 입력합니다:

Install-Package IronQR

NuGet 패키지 관리자 콘솔

바코드 리더 SDK의 최신 버전에 대해 더 알아보려면 다음 링크로 이동하세요.

https://www.nuget.org/packages/Barcode

이어서, 패키지는 모든 DLL 파일을 다운로드하고 현재 프로젝트에 .NET 프로젝트 참조로 해당 DLL 파일의 참조를 추가합니다.

Visual Studio 프로젝트는 이제 코드를 사용하는 준비가 되었습니다.

3. 참조 추가

아래와 같이 코드에 IronBarCode 참조를 추가하여 .NET Core의 IronBarcode 라이브러리에 있는 기능을 사용할 수 있도록 합니다. 바코드 리더 제어, QR 코드 읽기, 구성 요소, QR 코드 유형 지원, 바코드 리더 SDK의 호환성에 대해 더 알아보려면, 다음 링크를 참조하십시오: https://ironsoftware.com/csharp/barcode/

using IronBarCode;

using IronBarCode;

4. 바코드 인스턴스 만들기

BarcodeReader는 QR 코드를 읽고 생성하는 데 사용되는 정적 클래스입니다. 정적 클래스 BarcodeReader에 대한 객체 인스턴스를 생성하지 않고 사용할 수 있습니다. 바코드 리더 컨트롤은 하나의 함수Read 또는 ReadAsync을 사용하여 15가지 종류의 바코드를 스캔할 수 있는 기능을 제공합니다. IronBarcode 라이브러리는 다양한 출처에서 QR 코드/바코드를 읽을 수 있게 합니다:

• 문자열
• 스트림
• 이미지
• 비트맵

5. String을 사용하여 바코드를 읽어보세요

.NET 바코드 리더 라이브러리를 사용하여 QR 코드 및 바코드 이미지를 쉽게 읽을 수 있습니다. Read 메소드는 QR 코드 이미지를 스캔하고 QR 코드와 바코드를 텍스트로 디코드할 정적 함수입니다. 비트맵, PNG 파일, JPEG, TIFF 등 다양한 유형의 이미지 파일을 허용합니다.

이 Read 함수는 이미지에서 QR 코드/바코드 데이터를 추출하고 결과를 객체 BarcodeResult로 가져옵니다. 코드로 이미지 파일을 인식하지 못한 경우 null을 반환합니다.

BarcodeResult에서는 다음과 같은 값을 가집니다:

• BarcodeType
• Value
• 텍스트
• 바이너리 값

BarcodeType는 열거형 데이터 타입이며, 주어진 입력 이미지의 바코드 유형을 반환합니다. IronBarcode에서 지원하는 바코드 유형은 총 22개입니다. 이것은 주어진 입력 이미지에 적용된 바코드 유형을 반환합니다.

Value와 text는 또한 BarcodeResult에서 사용할 수 있는 객체형 값입니다. 값과 텍스트는 모두 문자열 데이터 타입입니다. 이것은 바코드의 문자열 값을 반환합니다. Read 메소드는 QR 코드와 바코드를 읽고 주어진 바코드 이미지의 문자열 값을 value/text로 가져옵니다. 바이너리 값은 바이트 데이터 타입이며, 주어진 이미지의 바이트를 반환합니다. 아래 코드는 .NET Windows Forms 또는 .NET Standard Applications에서 사용할 수 있는 빠른 응답 코드입니다.

// Read a barcode from an image file
BarcodeResult result = BarcodeReader.Read("test.bmp");
// Check if the result is not null and matches the expected text
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

// Read a barcode from an image file
BarcodeResult result = BarcodeReader.Read("test.bmp");
// Check if the result is not null and matches the expected text
if (result != null && result.Text == "https://ironsoftware.com/csharp/barcode")
{
    System.Console.WriteLine("Success");
}

위 코드는 .NET 바코드 리더 라이브러리를 사용하여 QR 코드와 바코드를 읽는 방법을 보여줍니다. 코드는 매우 간단하여, 시스템에서 파일을 Bitmap 객체로 매핑합니다. 또한 이미지에서 QR 코드/바코드를 디코딩하여 객체에 결과를 표시합니다. 아래는 코드에서 인코딩 된 데이터를 스캔하기 위해 제공된 QR 코드/바코드입니다.

바코드 입력

6. TIFF 이미지에서 여러 바코드 읽기

.NET 바코드 리더 컨트롤은 동일한 Read 메소드를 사용하여 이미지 파일에서 여러 QR 코드/바코드를 읽을 수 있으며, 사용하기 매우 쉽습니다.

아래는 이미지에서 여러 QR 코드를 읽기 위한 샘플 코드입니다:

// Configure barcode reader options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

// Read multiple barcodes from a TIFF image
BarcodeResult[] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

// Configure barcode reader options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    ExpectMultipleBarcodes = true,
};

// Read multiple barcodes from a TIFF image
BarcodeResult[] multiFrameResults = BarcodeReader.Read("Multiframe.tiff", options);

위 코드는 TIFF QR 코드 이미지를 추출하는 코드입니다. .NET 바코드 리더는 시스템상의 이미지에서 QR 코드를 스캔하여 결과를 배열로 반환합니다. 위 코드에서는 Code128에 대한 바코드만 스캔합니다. 이미지에 다른 바코드가 있으면 무시됩니다.

7. PDF에서 QR 코드 및 바코드 읽기

이 섹션에서는 PDF 문서에서 QR 코드를 읽는 방법을 보여줍니다. QR 코드 라이브러리는 사용 가능한 모든 페이지와 파일의 QR 코드를 스캔하거나 특정 바코드 유형에 집중합니다. IronBarcode를 사용할 때, 이 라이브러리는 표준 바코드 리더에 필요한 모든 관련 DLL을 제공하므로 .NET 프로젝트 참조로 추가할 기타 DLL이 필요하지 않습니다.

아래는 PDF에서 QR 코드/바코드를 읽는 데 사용할 수 있는 샘플 코드입니다.

// Read barcodes from each page of a PDF document
PagedBarcodeResult[] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Process results for each page
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte[] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

// Read barcodes from each page of a PDF document
PagedBarcodeResult[] pagedResults = BarcodeReader.ReadPdf("MultipleBarcodes.pdf");
// Process results for each page
foreach (PagedBarcodeResult pageRes in pagedResults)
{
    int pageNumber = pageRes.PageNumber;
    string value = pageRes.Value;
    Bitmap img = pageRes.BarcodeImage;
    BarcodeEncoding barcodeType = pageRes.BarcodeType;
    byte[] binary = pageRes.BinaryValue;
    Console.WriteLine(pageRes.Value);
}

위의 코드는 단순히 ReadPdf 메소드를 사용하여 PDF 파일에서 QR 코드/바코드를 읽는 샘플 코드입니다. 각 바코드와 그 유형에 대한 자세한 결과도 제공할 수 있습니다.

결론

.NET 바코드 리더기는 간단하고 쉬운 방법으로 QR 코드를 읽거나 디코딩/생성하여 단순한 단계로 바코드와 QR 코드를 처리할 수 있습니다. IronBarcode DLL은 .NET Windows Forms Applications, Mobile Apps, Web Applications, MAUI 및 Blazor와 같은 다양한 환경에서 .NET Framework 또는 .NET Standard를 사용하여 사용할 수 있습니다. 또한, IronBarcode는 크롭 영역이나 멀티스레딩과 ML 모델의 정확성과 같은 바코드 읽기 속도를 향상시키기 위한 다양한 사용자 정의 옵션을 제공합니다. IronBarcode는 무료 체험 키를 제공하며 현재 Iron Software의 다섯 가지 제품을 두 가지 가격에 구입할 수 있습니다.

더 많은 정보를 보려면 라이센스 페이지를 방문하십시오.

zip 파일 프로젝트를 다운로드할 수도 있습니다.