GroupDocs.Merger for .NET에서 PDF를 북마크와 함께 병합하는 방법

이 가이드에서는 북마크가 포함된 PDF 병합 방법과 워드 섹션 구분 병합과 같은 고급 워드 병합 시나리오를 다룹니다. GroupDocs.Merger for .NET은 문서 구조에 대한 세밀한 제어를 제공하여 PDF의 탐색 트리를 보존하고 워드 파일의 섹션 경계를 유지합니다. 보고서 엔진, 전자증거 개시 파이프라인, 배치 처리 서비스 등을 구축할 때 아래 기술을 사용하면 복잡한 결합 작업 중에도 문서 무결성을 유지할 수 있습니다.

빠른 답변

  • PDF를 병합할 때 북마크를 유지할 수 있나요? 예 – GroupDocs.Merger는 각 원본 PDF의 북마크 트리를 결합된 문서에 복사합니다.
  • 라이브러리가 Word 섹션 구분 병합을 지원하나요? 물론입니다; 병합 중 섹션 구분을 처리하는 방식을 지정할 수 있습니다.
  • 호환되는 .NET 버전은 무엇인가요? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.
  • 프로덕션에 라이선스가 필요합니까? 프로덕션 사용을 위해서는 상용 라이선스가 필요합니다; 평가용 무료 체험판을 제공하고 있습니다.
  • 얼마나 큰 문서를 병합할 수 있나요? API는 전체 내용을 메모리에 로드하지 않고 최대 2 GB 파일을 처리합니다.

PDF를 북마크와 함께 병합이란?

merge pdf with bookmarks는 여러 PDF 파일을 하나의 PDF로 결합하면서 각 파일의 북마크 계층 구조를 보존하는 과정입니다. 이를 통해 최종 사용자는 병합 후에도 친숙한 북마크 패널을 이용해 원본 섹션으로 이동할 수 있습니다.

이 작업에 GroupDocs.Merger를 사용하는 이유

GroupDocs.Merger는 50개 이상의 입력 및 출력 형식을 지원하며 일반 서버 하드웨어에서 수백 페이지 PDF를 1초 이내에 처리할 수 있습니다. 메모리 효율적인 스트리밍 엔진을 통해 2 GB까지의 문서를 RAM을 고갈시키지 않고 병합할 수 있어 엔터프라이즈 규모 워크로드에 적합합니다.

GroupDocs.Merger 정의

GroupDocs.Merger는 PDF, Word, Excel, PowerPoint 및 이미지 파일을 원본 애플리케이션 없이도 병합, 분할 및 조작할 수 있는 API를 제공하는 .NET 라이브러리입니다.

전제 조건

  • .NET 개발 환경 (Visual Studio 2022 이상).
  • GroupDocs.Merger for .NET NuGet 패키지 설치.
  • 프로덕션 빌드를 위한 유효한 GroupDocs.Merger 라이선스.

PDF를 북마크와 함께 병합하는 단계별 방법

PDF를 병합할 때 북마크를 보존하는 방법

각 원본 PDF를 로드하고 PreserveBookmarks 옵션을 활성화한 뒤 Merge 메서드를 호출합니다. PreserveBookmarks는 원본 PDF의 북마크 계층 구조를 유지하도록 라이브러리에 지시하는 병합 옵션입니다. Merge는 지정된 소스 문서를 하나의 출력 파일로 결합하는 메서드이며, 라이브러리는 충돌을 방지하기 위해 고유 ID를 할당하면서 북마크 트리를 자동으로 결합합니다.

병합 중 Word 섹션 구분을 제어하는 방법

Merge를 호출하기 전에 SectionBreakMode 속성을 KeepSource 또는 ForceNew로 설정합니다. SectionBreakMode는 병합 작업 중 Word 섹션 구분이 어떻게 처리되는지를 결정합니다. 이를 통해 원본 섹션 구분을 유지하거나 결과 문서에 단일 구분으로 교체할지를 지정할 수 있습니다.

PDF/A 또는 PDF/UA에 대한 컴플라이언스 모드를 활성화하는 방법

실행 전에 병합 설정 객체의 PdfCompliance 옵션을 구성합니다. PdfCompliance는 출력 문서에 적용할 PDF/A 또는 PDF/UA 컴플라이언스 수준을 지정합니다. 이를 통해 생성된 PDF가 선택한 보관 또는 접근성 표준을 충족하도록 보장합니다.

사용 가능한 튜토리얼

GroupDocs.Merger for .NET를 사용하여 북마크가 있는 PDF 파일 병합 방법

GroupDocs.Merger for .NET을 사용해 여러 PDF 파일을 북마크를 유지하면서 원활하게 병합하는 방법을 배웁니다. 이 튜토리얼에서는 설정, 구현 및 모범 사례를 다룹니다.

추가 리소스

일반적인 문제 및 해결책

  • 북마크가 병합 후 사라짐 – 병합 옵션에서 PreserveBookmarks가 true로 설정되어 있는지 확인합니다.
  • 섹션 구분이 사라짐 – 원본 구분을 유지하려면 SectionBreakMode = SectionBreakMode.KeepSource를 사용합니다.
  • 대용량 파일에서 성능 저하 – 메모리 사용량을 줄이기 위해 스트리밍 모드(UseMemoryStream = false)를 활성화합니다.

자주 묻는 질문

Q: 암호화된 PDF를 병합할 수 있나요?
A: 예, 병합하기 전에 Password 속성을 통해 각 원본 파일의 비밀번호를 제공하면 됩니다.

Q: 라이브러리가 증분 병합(기존 PDF에 페이지 추가)을 지원하나요?
A: 물론입니다; 기존 PDF를 열어 새 페이지를 추가하고 전체 문서를 다시 생성하지 않고 결과를 저장할 수 있습니다.

Q: 중복된 북마크 이름은 어떻게 처리되나요?
A: API는 중복 이름 앞에 원본 파일 인덱스를 자동으로 접두어로 붙여 고유성을 유지합니다.

Q: 한 번에 병합할 수 있는 문서 수에 제한이 있나요?
A: 실질적으로 제한은 없습니다; 유일한 제약은 사용 가능한 메모리와 파일 크기 제한(병합당 최대 2 GB)입니다.

Q: 병합된 PDF의 컴플라이언스를 어떻게 확인하나요?
A: 병합 후 PdfValidator.Validate(outputPath, PdfCompliance.PdfA)를 호출하여 문서가 선택한 표준을 충족하는지 확인합니다. PdfValidator.Validate는 지정된 컴플라이언스 표준에 대해 병합된 PDF를 검사합니다.

마지막 업데이트: 2026-08-20
테스트 환경: GroupDocs.Merger 23.9 for .NET
작성자: GroupDocs

관련 튜토리얼