IRONSOFTWAREHOME

C#을 사용하여 PDF에 바코드를 스탬프하는 방법

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

IronBarcode의 CreateBarcode 메서드를 사용하여 C#에서 기존 PDF 문서에 바코드를 스탬프합니다. 단일 페이지는 StampToExistingPdfPage, 여러 페이지는 StampToExistingPdfPages를 사용하며, 좌표와 페이지 번호를 지정합니다.

빠른 시작: 생성된 바코드를 PDF 페이지에 스탬프

이 예제는 IronBarcode의 CreateBarcode를 사용하여 바코드를 생성하고 기존 PDF 페이지에 스탬프하는 방법을 보여줍니다. PDF 경로, 위치 좌표 및 페이지 번호를 제공합니다.

  1. 1Install IronBarcode with NuGet Package Manager

    PM > Install-Package BarCode

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

    IronBarCode.BarcodeWriter.CreateBarcode("https://my.site", IronBarCode.BarcodeEncoding.QRCode, 150, 150)
        .StampToExistingPdfPage("report.pdf", x: 50, y: 50, pageNumber: 1);
    C#
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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

StampToExistingPdfPage StampToExistingPdfPages

기존 PDF 페이지에 바코드를 어떻게 스탬프하나요?

PDF로 바코드 내보내기 외에, IronBarcode는 GeneratedBarcode를 기존 PDF 문서에 직접 스탬프할 수 있습니다. 이 기능은 기존 보고서, 송장, 양식에 추적 코드, 인벤토리 라벨, 문서 식별자를 추가할 때 유용합니다. 다음 코드 스니펫은 이 작업을 보여줍니다.

using IronBarCode;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Code128, 200, 100);
myBarcode.StampToExistingPdfPage("pdf_file_path.pdf", x: 200, y: 100, 3, "password");

StampToExistingPdfPage에 필요한 매개변수는 무엇입니까?

StampToExistingPdfPage() GeneratedBarcode

코드 스니펫은 StampSettings 객체와 함께 StampToExistingPdfPage 메서드를 호출하여 객체를 PDF 문서에 스탬프합니다. 이 메소드는 단순성을 유지하면서 유연성을 제공합니다. 아래는 메소드의 매개변수입니다:

  • pdfFilePath: System.String으로, PDF 문서 경로를 나타냅니다(상대 또는 절대).
  • x: 왼쪽 가장자리에서 픽셀로 나타내는 수평 위치의 System.Int32입니다.
  • y: 하단 가장자리에서 픽셀로 나타내는 수직 위치의 System.Int32입니다.
  • pageNumber: 페이지(1부터 시작하여 첫 번째 페이지는 1)를 나타내는 System.Int32입니다.
  • password: 암호로 보호된 PDF용 System.String입니다(옵션).

StampToExistingPdfPage를 언제 사용해야 하나요?

코드 스니펫을 실행하면 중간 저장 없이 GeneratedBarcode을 PDF 문서에 직접 스탬프합니다. 이 메소드는 다음과 같은 시나리오에 적합합니다:

StampToExistingPdfPages() GeneratedBarcode

  • 배송 라벨이나 배송 문서의 고유 추적 코드
  • 제조 보고서의 배치 번호
  • 법적 또는 규제 양식의 문서 관리 번호
  • 디지털 인증 또는 빠른 접근 링크를 위한 QR 코드

직접 스탬프 방법은 처리 시간을 절약하고 임시 파일을 제거합니다. 다른 바코드 유형에 대한 정보는 지원되는 바코드 형식 가이드를 참조하십시오.

여러 PDF 페이지에 바코드를 어떻게 스탬프하나요?

때때로 같은 바코드를 여러 페이지에 스탬프해야 합니다. 일반적인 사용 사례에는 다중 페이지 보고서의 모든 페이지에 문서 식별자를 적용하거나, 기술 문서 전체에 버전 관리 코드를 추가하거나, 기밀 자료 각 페이지에 보안 바코드를 삽입하는 것이 포함됩니다. 단일 페이지 메서드의 반복 대신, BarcodeStamper 클래스의 StampToExistingPdfPages 메서드를 사용하십시오. 다음 코드 스니펫은 이 메소드를 보여줍니다.

using IronBarCode;
using System.Collections.Generic;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Code128, 200, 100);
List<int> pages = new List<int>();
pages.Add(1);
pages.Add(2);
pages.Add(3);
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, pages, "password");

유연성을 위해 LINQ를 사용하여 페이지 범위를 동적으로 생성하십시오:

// Stamp on all even pages from 2 to 10
var evenPages = Enumerable.Range(1, 10).Where(x => x % 2 == 0).ToList();
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, evenPages, "password");

// Stamp on the first and last 3 pages of a 20-page document
var selectedPages = new List<int> { 1, 2, 3, 18, 19, 20 };
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, selectedPages, "password");

StampToExistingPdfPages가 수용하는 매개변수는 무엇입니까?

아래는 메소드의 매개변수입니다:

  • pdfFilePath: PDF 문서 경로를 나타내는 System.String입니다.
  • x: 픽셀로 나타낸 수평 위치의 System.Int32입니다.
  • y: 픽셀로 나타낸 수직 위치의 System.Int32입니다.
  • pageNumbers: 스탬프할 페이지(1부터 시작)를 나타내는 **IEnumerable<System.Int32>**입니다.
  • password: 암호로 보호된 PDF용 System.String입니다(옵션).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

반복 대신 StampToExistingPdfPages를 사용하는 이유는 무엇입니까?

이 메소드는 수동 반복 없이 여러 페이지에 효율적인 바코드 스탬프를 제공하여 코드 가독성과 성능을 향상시킵니다. 내부 구현은 PDF 처리를 최적화하여 다음과 같은 결과를 제공합니다:

  • 더 빠른 실행: PDF가 한 번만 열리고 처리됨
  • 더 낮은 메모리 사용량: 대용량 PDF를 위한 효율적인 자원 관리
  • 더 깔끔한 코드: 수동 루프 및 오류 처리 관리 없음
  • 원자적 작업: 모든 페이지가 단일 작업으로 스탬프됨

고급 스탬프 기술

스탬프 전에 바코드 외형 사용자 정의하기

PDF에 바코드를 스탬프하기 전에, 외형을 사용자 정의하십시오. IronBarcode는 광범위한 사용자 정의 옵션을 제공합니다:

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Code128, 250, 80);

// Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number");
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy");
myBarcode.SetMargins(10);
myBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);

// Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x: 450, y: 700, pageNumber: 1);
C#

다른 바코드 유형과 작업하기

다양한 시나리오에는 다른 바코드 유형이 요구됩니다. QR 코드는 URL 및 대용량 데이터 세트에 적합하고, Code128은 영숫자 식별자에 적합합니다. QR 코드 생성 방법에 대해 더 알아보거나 다른 형식을 탐색하십시오:

// QR Code for contact information
var qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD\nFN:John Doe\nTEL:555-1234\nEND:VCARD", 
    BarcodeEncoding.QRCode, 150, 150);
qrCode.StampToExistingPdfPage("businesscard.pdf", x: 400, y: 50, pageNumber: 1);

// Data Matrix for product tracking
var dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100);
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x: 50, y: 750, pageNumber: 1);

오류 처리 및 모범 사례

PDF 스탬핑 작업에서 적절한 오류 처리를 구현하십시오:

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Code128, 200, 60);
    
    // Verify the PDF exists before attempting to stamp
    if (File.Exists("target.pdf"))
    {
        myBarcode.StampToExistingPdfPage("target.pdf", x: 100, y: 100, pageNumber: 1);
        Console.WriteLine("Barcode stamped successfully!");
    }
    else
    {
        Console.WriteLine("PDF file not found!");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error stamping barcode: {ex.Message}");
    // Log the error or handle it appropriately
}

성능 고려 사항

대용량 PDF 또는 여러 스탬핑 작업을 수행할 때 다음 팁을 고려하십시오:

  1. 배치 작업: StampToExistingPdfPage 루프 대신 StampToExistingPdfPages 사용
  2. 바코드 캐싱: 한 번 생성하여 GeneratedBarcode 객체 재사용
  3. 좌표 계산: 일관된 위치 좌표를 미리 계산하십시오
  4. 메모리 관리: 매우 큰 PDF를 배치로 처리하십시오

스탬핑 후 PDF에서 바코드를 읽는 고급 시나리오의 경우, 우리 가이드에서 PDF 문서에서 바코드 읽기를 참조하십시오.

다른 IronBarcode 기능과의 통합

PDF 스탬핑 기능은 다른 IronBarcode 기능과 원활하게 작동합니다. 비동기 처리와 결합하여 웹 애플리케이션 성능을 향상시키십시오:

// Asynchronous PDF stamping
public async Task StampBarcodeAsync(string pdfPath, string barcodeData)
{
    await Task.Run(() =>
    {
        var barcode = BarcodeWriter.CreateBarcode(barcodeData, BarcodeEncoding.QRCode, 200, 200);
        barcode.StampToExistingPdfPage(pdfPath, x: 100, y: 100, pageNumber: 1);
    });
}

또한 스캔된 PDF에서 바코드 스탬핑 전후에 개선이 필요할 수 있는 경우 IronBarcode의 이미지 수정 기능을 활용하십시오.

일반적인 문제 해결

PDF에 바코드를 스탬핑하는 동안 문제가 발생하면 다음 솔루션을 참조하십시오:

  1. 좌표 문제: PDF 좌표는 왼쪽 위가 아니라 왼쪽 아래에서 시작합니다
  2. 암호 보호된 PDF: 암호화된 PDF에 대한 올바른 암호 매개변수를 확인하십시오
  3. 대용량 파일 크기: 최적화 및 처리 팁은 우리의 트러블슈팅 가이드를 참조하십시오
  4. 폰트 또는 인코딩 문제: 특수 문자 또는 유니코드의 경우 우리의 유니코드 바코드 작성 가이드를 확인하십시오

이러한 지침을 따르고 IronBarcode의 PDF 스탬핑 기능을 활용하면 기존 PDF 문서에 바코드를 효율적으로 추가하면서 높은 성능과 코드 품질을 유지할 수 있습니다.

자주 묻는 질문

C#에서 기존 PDF 문서에 바코드를 추가하는 방법은 무엇인가요?

IronBarcode의 CreateBarcode 메서드를 사용하여 바코드를 생성한 다음, StampToExistingPdfPage 메서드를 적용하여 PDF에 바코드를 삽입합니다. PDF 파일 경로, 위치 좌표(x, y) 및 바코드가 나타날 페이지 번호만 지정하면 됩니다.

StampToExistingPdfPage 메서드에 필요한 매개변수는 무엇입니까?

IronBarcode의 StampToExistingPdfPage 메서드는 다음 매개변수를 필요로 합니다: pdfFilePath(PDF 파일 위치를 나타내는 문자열), x 및 y 좌표(픽셀 단위의 위치를 나타내는 정수), pageNumber(1부터 시작하는 정수), 그리고 보호된 PDF 파일의 경우 선택적으로 암호 매개변수를 사용할 수 있습니다.

PDF 파일의 여러 페이지에 동일한 바코드를 찍을 수 있나요?

네, IronBarcode는 StampToExistingPdfPages 메서드(복수형인 'Pages'에 유의하세요)를 제공하여 생성된 단일 바코드를 PDF 문서의 여러 페이지에 걸쳐 찍을 수 있도록 합니다.

PDF 파일에서 바코드를 배치하는 데 사용되는 좌표계는 무엇입니까?

IronBarcode는 StampToExistingPdfPage 메서드를 사용할 때 픽셀 기반 좌표계를 사용하며, x 좌표는 페이지의 왼쪽 가장자리에서, y 좌표는 페이지의 아래쪽 가장자리에서 측정됩니다.

기존 PDF 파일에 바코드를 삽입하는 일반적인 사용 사례는 무엇인가요?

IronBarcode의 PDF 스탬핑 기능은 일반적으로 배송 라벨에 고유 추적 코드를 추가하거나, 제조 보고서에 배치 번호를 추가하거나, 법률 양식에 문서 관리 번호를 추가하거나, 디지털 인증 또는 빠른 액세스 링크를 위한 QR 코드를 추가하는 데 사용됩니다.

PDF에 바코드를 삽입하려면 중간 파일을 저장해야 하나요?

아니요, IronBarcode의 StampToExistingPdfPage 메서드는 임시 파일을 생성하지 않고 바코드를 PDF 문서에 직접 찍기 때문에 처리 시간과 저장 공간을 절약할 수 있습니다.

비밀번호로 보호된 PDF 문서에 바코드를 찍을 수 있나요?

네, IronBarcode는 암호로 보호된 PDF에 바코드를 찍는 기능을 지원합니다. StampToExistingPdfPage 메서드에 PDF 암호를 선택적 매개변수로 제공하기만 하면 됩니다.

Why should you use the StampToExistingPdfPages method instead of looping for multiple pages?

The `StampToExistingPdfPages` method is preferred for stamping on multiple pages because it is more efficient, reduces processing time, and optimizes resource usage compared to manually looping through pages.

Are there performance considerations when stamping barcodes on large PDFs with IronBarcode?

Yes, when stamping barcodes on large PDFs, it's recommended to use batch operations, cache barcodes, and manage memory efficiently for better performance with IronBarcode.

What should be done if a barcode stamping operation fails in IronBarcode?

If a barcode stamping operation fails, implement error handling using `try-catch` blocks to log errors and ensure that the PDF file exists before stamping with IronBarcode.

시작할 준비 되셨나요?

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일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.