IRONSOFTWAREHOME

IronBarcode를 사용하여 C#에서 데이터 형식을 출력하는 방법

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Updated: 2026년 6월 29일

IronBarcode는 BarCode 판독 결과로 BarcodeImage, BarcodeType, BinaryValue, 좌표, 치수, 페이지 번호, 방향, 텍스트 및 값 속성 등 다양한 출력 형식을 제공합니다. 이러한 형식을 통해 다양한 사용 사례에 맞춰 BarCode 데이터를 프로그래밍 방식으로 처리할 수 있습니다.

IronBarcode는 단순히 BarCode를 읽고 콘솔에 값을 출력하는 것 이상의 기능을 제공합니다. 사용자가 읽은 결과를 처리할 수 있도록 여러 출력 형식을 제공합니다. 이러한 형식에는 BarCode 이미지, BarCode 유형, BinaryValue, 좌표, 높이, 너비, 페이지 번호, BarCode, 페이지 방향, textvalue와 같은 속성이 포함됩니다.

사용자는 프로그램 내에서 이러한 속성을 추가로 조작할 수 있습니다. 이제 이러한 속성을 사용하는 방법과 유용하게 활용할 수 있는 사용 사례를 살펴보겠습니다.

빠른 시작: 한 줄로 BarCode 값 및 유형 읽기

이 예제는 IronBarcode를 사용하여 이미지에서 바코드를 읽는 방법을 보여줍니다. 한 줄의 코드로 바코드를 불러온 후, 바코드의 값과 유형을 즉시 출력합니다. 빠르게 시작하기에 안성맞춤입니다. 더 포괄적인 예제를 보려면 BarCode 퀵스타트 가이드를 확인해 보세요.

  1. 1Install IronBarcode with NuGet Package Manager

    PM > Install-Package BarCode

  2. 2다음 코드 조각을 복사하여 실행하세요.

    var result = IronBarCode.BarcodeReader.Read("input.png");
    Console.WriteLine($"Value: {result[0].Value}, Type: {result[0].BarcodeType}");
    C#
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronBarcode 사용 시작하기
    arrow pointer

사용 가능한 출력 형식과 그 사용 사례는 무엇입니까?

BarcodeResult는 다양한 유용한 속성을 저장합니다. 이러한 속성은 다음과 같습니다:

  • BarcodeImage
  • BarcodeType
  • BinaryValue
  • 좌표, HeightWidth
  • PageNumber
  • BarcodePageOrientation
  • Text & Value

각 속성은 BarCode 처리 워크플로에서 특정 목적을 수행합니다. 재고 관리 시스템, 문서 처리 파이프라인 또는 품질 관리 애플리케이션을 구축할 때, 이러한 데이터 형식은 다양한 소스의 BARCODE를 읽는 데 필요한 유연성을 제공합니다.

BarCode 이미지를 추출하고 저장하려면 어떻게 해야 하나요?

IronBarcode가 이미지를 읽으면, 이미지에서 발견된 BARCODE는 BarcodeResultBarcodeImage 유형의 AnyBitmap 속성으로 저장됩니다. BarcodeImage 속성은 발견된 BarCode 이미지를 저장합니다. 사용자는 이 객체를 불러와 이미지를 추가로 처리하거나 영구적인 사본으로 저장할 수 있습니다. 이를 통해 이미지에서 BarCode 이미지를 추출하기 위한 추가 코드를 제거함으로써 효율성과 사용 편의성을 제공합니다.

이 출력 형식의 사용 사례를 보여주는 아래 코드 스니펫을 참고하십시오:

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Read barcode from PDF file
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Create list for barcodes
List<AnyBitmap> barcodeList = new List<AnyBitmap>();

foreach (BarcodeResult barcode in result)
{
    barcodeList.Add(barcode.BarcodeImage);
}

// Create multi-page TIFF
AnyBitmap.CreateMultiFrameTiff(barcodeList).SaveAs("barcodeImages.tif");

위의 코드 스니펫은 이 출력 형식의 사용 사례 중 하나를 보여줍니다. 구체적으로, 이 도구는 PDF 문서 내에서 감지된 BarCode를 사용하여 다중 페이지 TIFF 이미지를 생성합니다. 먼저, 샘플 PDF에서 BARCODE를 스캔하거나 감지합니다. 그런 다음, AnyBitmap 속성의 정보를 저장할 BarcodeImage 목록을 생성합니다. 마지막으로, 이 목록을 사용하여 CreateMultiFrameTiff 방법을 통해 여러 페이지로 구성된 TIFF 파일을 생성합니다. 이 기법은 특히 여러 페이지로 구성된 GIF 및 TIFF 파일을 처리할 때 유용합니다.

BarcodeImage 속성은 BarcodeResult에서 읽기 과정에서 발견된 BARCODE 이미지만 저장하며, 입력 이미지 전체는 저장하지 않습니다.

프로그래밍 방식으로 다양한 BarCode 유형을 어떻게 식별할 수 있나요?

이 속성은 입력 이미지나 문서에 어떤 유형의 BARCODE가 포함되어 있는지 파악하는 데 도움이 됩니다. 단, 이미지 내의 BARCODE 유형은 IronBarcode에서 지원하고 읽을 수 있어야 한다는 제한 사항이 있습니다. IronBarcode에서 지원하는 BarCode 유형에 대해 자세히 알아보려면 이 문서를 참조하십시오. 또한, 지원되는 BARCODE 형식 전체 목록을 확인하여 특정 요구 사항과의 호환성을 확보하십시오.

아래 코드 예제는 이미지에 포함된 BarCode 값과 BarCode 유형을 가져와 콘솔에 출력하는 방법을 보여줍니다.

using IronBarCode;
using System;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("bc3.png");

// Output barcode type to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value is " + barcode.ToString() + " and the barcode type is " + barcode.BarcodeType);
}

위의 코드 스니펫에서, 입력 이미지에 대해 BarcodeReader.Read() 메서드를 호출하여 BARCODE를 판독합니다. 이 메서드는 이미지에 있는 모든 BARCODE를 읽어온 후, 모든 BarcodeResults를 저장하는 BarcodeResult 객체를 반환합니다. 다음으로, BarcodeResults 객체를 반복 처리하여 BarcodeResult를 가져오고, BARCODE valuetype를 콘솔에 출력합니다. 이 방식은 Code 39 BarCode와 같은 특수 형식을 포함하여 다양한 BarCode 유형과 원활하게 호환됩니다.

이진 값 출력은 언제 사용해야 합니까?

Using IronBarcode, you can access the value object's BinaryValue property and retrieve the byte array of the BarcodeResult BarCode. 이를 통해 사용자는 프로그램 내에서 BarCode value을 추가로 조작할 수 있습니다. Binary value 출력은 암호화된 데이터나 BarCode로 인코딩된 파일 첨부 파일을 다룰 때, 또는 바이트 단위 데이터 처리가 필요한 시스템과 통합할 때 특히 유용합니다.

아래 코드 예제는 BarCode value를 바이너리 데이터로 가져오는 사용 사례를 보여줍니다:

using IronBarCode;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

int i = 1;
foreach (BarcodeResult barcode in result)
{
    var binaryValue = barcode.BinaryValue;
    var barcodeType = IronBarCode.BarcodeEncoding.QRCode;

    // Create QR code
    GeneratedBarcode generatedBarcode = BarcodeWriter.CreateBarcode(binaryValue, barcodeType);

    // Export QR code
    generatedBarcode.SaveAsPng($"qrFromBinary{i}.png");
    i++;
}

위의 코드 스니펫을 보면, 이미지 내의 여러 BarCode를 각각 별도의 새로운 이진 인코딩 파일로 변환하는 간단한 프로그램을 만들었습니다. 먼저, 샘플 PNG 이미지의 BarCode를 스캔합니다. BARCODE를 감지하면, 이를 순차적으로 처리하여 BinaryValue 속성에 접근하고, 이를 사용하여 새로운 바이너리 파일을 생성합니다. 이 기술은 여러 BarCode를 읽고 각 BarCode의 이진 데이터를 개별적으로 처리해야 할 때 특히 유용합니다.

BarCode 위치와 크기는 어떻게 확인할 수 있나요?

사용자가 액세스할 수 있는 BarcodeResult 객체의 또 다른 속성은 BARCODE의 좌표로, 여기에는 X1, Y1, X2, Y2, 그리고 이미지 파일이나 문서 내의 HeightWidth를 포함합니다. 이러한 속성은 사용자가 BARCODE의 위치 및 크기에 대한 정보를 확인해야 할 때 유용합니다. 이러한 공간 정보는 자동 문서 처리, 품질 관리 시스템, 또는 BarCode 스캔 최적화를 위한 크롭 영역 구현과 같이 정밀한 위치 정보가 필요한 애플리케이션에 매우 중요합니다.

BarCode의 위치와 크기를 보여드리겠습니다.

using IronBarCode;
using IronSoftware.Drawing;
using System.Linq;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

AnyBitmap bitmap = AnyBitmap.FromFile("multiple-barcodes.png");

foreach (BarcodeResult barcode in result)
{
    PointF[] barcodePoints = barcode.Points;

    float x1 = barcodePoints.Select(b => b.X).Min();
    float y1 = barcodePoints.Select(b => b.Y).Min();

    Rectangle rectangle = new Rectangle((int)x1, (int)y1, (int)barcode.Width!, (int)barcode.Height!);

    bitmap = bitmap.Redact(rectangle, Color.Magenta);

    // Save the image
    bitmap.SaveAs("redacted.png", AnyBitmap.ImageFormat.Png);
}
유사한 시각적 패턴으로 서로 다른 인코딩된 데이터를 보여주는 세 개의 바코드 샘플(A, B, C)
판독할 수 없는 텍스트 조각이 있는 세 개의 편집된 콘텐츠 블록

위의 코드 스니펫은 이미지 파일에서 발견된 여러 BARCODE를 처리합니다. 이를 위해 IronBarcode 라이브러리와 IronDrawing이라는 두 라이브러리를 함께 사용합니다. BarcodeResult 객체를 가져와 그 속성을 추출하려면, 먼저 BarcodeReader.Read() 메서드를 사용하여 이미지 파일에 포함된 BARCODE를 읽어야 합니다. 동시에, 입력 이미지 파일을 AnyBitmap 객체로 변환하여 이미지에 편집 방법을 적용해야 합니다. BarcodeResults 객체를 확보하면 루프를 적용하여 이를 반복 처리함으로써, 이미지에 포함된 모든 바코드의 X1, Y1, Width, Height 값을 추출하여 CropRectangle 메서드의 AnyBitmap.Redact() 속성에 사용할 수 있습니다.

다중 페이지 문서에서 페이지 번호는 왜 중요한가요?

사용자는 BARCODE가 발견된 페이지 번호를 확인할 수 있습니다. 이 기능은 여러 BarCode가 포함된 다중 페이지 문서를 사용하는 사용자가 후속 처리를 위해 문서 내 BarCode의 위치를 파악해야 할 때 유용합니다. 이 기능은 PDF 문서에서 BarCode를 읽거나 Enterprise 애플리케이션에서 일괄 문서를 처리할 때 필수적입니다.

아래 코드 스니펫을 확인해 보세요:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page number to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value " + barcode.ToString() + " is found on page number " + barcode.PageNumber);
}

위의 코드 스니펫은 사용자가 다중 페이지 PDF 문서에서 발견된 BarCode의 value 및 해당 페이지 번호를 반환하도록 프로그램에 요청하는 사용 사례를 보여줍니다. 이 코드는 BarcodeReader.ReadPdf() 메서드를 사용하여 다중 페이지 PDF 문서 내의 BARCODE를 읽으며, 이 메서드는 문서에서 발견된 모든 BarcodeResults를 저장하는 BarcodeResult 객체를 반환합니다. 루프를 적용하여 객체의 각 항목을 순차적으로 처리함으로써 BARCODE의 value 및 BARCODE가 발견된 페이지 번호를 가져옵니다. 이 사용 사례 외에도, 사용자는 이 속성을 사용하여 문서 내의 모든 BARCODE가 읽혔는지 디버깅할 수 있습니다.

참고해 주세요: 이 속성에서 반환되는 값은 1을 기준으로 합니다. 즉, 첫 번째 페이지는 항상 1이며 0이 아닙니다.

BarCode 회전 및 페이지 방향을 어떻게 감지할 수 있나요?

Using IronBarcode, you can retrieve information about the BarCode orientation and the page orientation of the page where the BarCode was found. 이 두 가지 정보를 추출하려면 BarcodeResult 객체에서 RotationPageOrientation 속성에 액세스하십시오. Rotation는 발견된 BARCODE의 회전 각도를 나타내는 정수를 반환합니다. 이 기능은 이미지 방향 보정 기능과 연동되어 스캔 각도에 관계없이 BarCode를 정확하게 판독할 수 있도록 합니다.

아래 코드 스니펫을 확인해 보세요:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page orientation and rotation to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.PageOrientation);
    Console.WriteLine(barcode.Rotation);
}

위의 코드 스니펫은 사용자가 pageOrientation 및 BARCODE rotation를 각각 가져와 페이지 방향과 BARCODE 회전 각도를 확인할 수 있음을 증명하기 위해 첨부된 샘플 PDF 입력 파일로 실행되었습니다. 이 기능은 주로 디버깅 목적으로 유용합니다.

참고해 주세요: IronBarcode는 BarcodeResult.PageOrientation, BarcodeResult.Rotation, 0, 90, 180, 270도인 바코드만 읽을 수 있습니다. BarCode의 회전 값이 언급된 값과 다를 경우, IronBarcode는 아무런 값도 반환하지 않습니다. PageOrientationPageOrientation 객체를 반환하며, 이 객체는 Portrait 또는 Landscape로 구성됩니다.

Text 속성과 Value 속성의 차이점은 무엇인가요?

물론, 사용자가 IronBarcode를 사용할 때 가장 중요하게 여기는 기능은 valuetext입니다. 이 두 속성은 종종 혼용되어 사용되며 동일한 value을 반환합니다. 그 외에도 사용자는 BarcodeResult.ToString() 메서드를 사용하여 동일한 결과를 얻을 수 있습니다. 전문 애플리케이션을 사용하거나 BarCode 데이터를 스트림으로 내보낼 때, 이러한 속성을 활용하면 원하는 형식으로 BarCode 콘텐츠에 유연하게 접근할 수 있습니다.

아래 코드 예시는 이를 보여줍니다:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("barcodestamped3.pdf");

// Output text value to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.Text);
    Console.WriteLine(barcode.ToString());
}

위의 코드 예제에서 볼 수 있듯이, 사용자는 IronBarcode를 사용하여 이미지에 포함된 바코드를 읽기 위해 단 몇 줄의 코드만 작성하면 됩니다. BarcodeResults 메서드가 반환한 BarcodeReader.Read()을 반복 처리한 후, ValueText 속성을 가져온 결과와 BarcodeResult.ToString() 메서드를 호출한 결과를 콘솔에 출력하여, 이 모든 것이 동일한 value를 반환함을 보여줍니다.

간단히 말해, IronBarcode는 BarCode 작성 및 디코딩에 국한되지 않고 BarCode와 관련된 다양한 작업을 수행할 수 있는 완벽한 API입니다. 다양한 출력 데이터 형식을 지원하므로, 사용자는 IronBarcode가 반환하는 BarcodeResult 객체를 활용하여 훨씬 더 많은 작업을 수행할 수 있습니다.

자주 묻는 질문

C# 바코드 읽기 기능은 어떤 출력 형식을 지원하나요?

IronBarcode는 BarcodeImage, BarcodeType, BinaryValue, 좌표, 크기, 페이지 번호, 방향, 텍스트 및 값 속성을 포함한 다양한 출력 형식을 제공합니다. 이러한 형식을 통해 다양한 .NET 애플리케이션에서 바코드 데이터를 포괄적으로 처리할 수 있습니다.

단 한 줄의 코드로 바코드 값을 읽어내는 방법은 무엇인가요?

IronBarcode를 사용하면 다음 한 줄로 바코드를 읽을 수 있습니다. var result = IronBarCode.BarcodeReader.Read('input.png'); 이렇게 하면 result[0].Value 및 result[0].BarcodeType을 통해 바코드의 값과 유형에 즉시 액세스할 수 있습니다.

BarcodeResult에서 사용할 수 있는 속성은 무엇입니까?

IronBarcode의 BarcodeResult 객체는 BarcodeImage, BarcodeType, BinaryValue, Coordinates, Height & Width, PageNumber, Barcode, PageOrientation, Text 및 Value를 포함한 속성을 제공하여 바코드 처리 워크플로에 필요한 포괄적인 데이터를 제공합니다.

바코드를 읽은 후 이미지를 추출하여 저장할 수 있나요?

네, IronBarcode는 찾은 바코드를 BarcodeImage 속성에 AnyBitmap 객체로 저장합니다. 이 객체를 가져와 이미지를 추가로 처리하거나 영구 사본으로 저장하여 바코드 이미지를 추출하는 추가 코드를 작성할 필요성을 없앨 수 있습니다.

바코드 좌표와 크기는 어떻게 확인할 수 있나요?

IronBarcode는 감지된 각 바코드에 대해 x, y 좌표와 높이 및 너비 치수를 포함한 좌표 데이터를 제공합니다. 이러한 속성은 BarcodeResult 객체를 통해 접근할 수 있어 정확한 바코드 위치 추적이 가능합니다.

텍스트 속성과 값 속성의 차이점은 무엇인가요?

IronBarcode에서 Text 및 Value 속성은 모두 바코드의 데이터 내용을 포함합니다. 이 속성들은 BarcodeResult 객체의 일부이며, 디코딩된 바코드 정보를 가져오기 위해 서로 바꿔 사용할 수 있습니다.

바코드가 어느 페이지에서 발견되었는지 확인할 수 있나요?

예, IronBarcode는 BarcodeResult 객체에 PageNumber 속성을 포함하고 있어, 여러 페이지로 구성된 문서나 PDF에서 감지된 각 바코드가 포함된 페이지를 정확하게 식별할 수 있습니다.

감지된 바코드의 종류를 어떻게 확인할 수 있나요?

IronBarcode의 BarcodeResult 객체에 있는 BarcodeType 속성은 감지된 특정 바코드 형식(예: QR 코드, Code 128 등)을 식별하여 애플리케이션에서 형식별 처리를 가능하게 합니다.

What kind of applications benefit from using IronBarcode's output data formats?

Applications in inventory management, document processing, and quality control greatly benefit from IronBarcode's diverse data formats as they offer extensive barcode data processing options.

Can IronBarcode read barcodes from multipage PDF documents?

Yes, IronBarcode can read barcodes from multipage PDF documents using methods like `BarcodeReader.ReadPdf()`, which also informs about the page number on which each barcode is found.

시작할 준비 되셨나요?

Nuget Downloads 2,422,100버전:2026.9방금 출시

무료로 받기

30일 체험 키를 즉시 받으세요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.
bullet_test워터마크 없이
프로덕션에서 테스트
bullet_calendar30일 완전한
기능의 제품
bullet_support체험 기간 동안
24/5 기술 지원
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.9

PM > Install-Package BarCode
nuget.org/packages/BarCode/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronBarCode"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.9

  1. IronBarCode 파일을 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 해제하세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronBarCode.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.