GroupDocs.Merger for .NET을 사용하여 특정 페이지 PDF 추출

다중 페이지 문서에서 특정 페이지 PDF를 추출하는 것은 관련 섹션만 공유하거나 파일 크기를 줄이거나 검토 워크플로를 자동화해야 할 때 흔히 요구되는 작업입니다. 이 튜토리얼에서는 GroupDocs.Merger for .NET을 사용하여 PDF, Word 파일 또는 30개 이상의 지원 형식에서 정확한 페이지를 추출하는 명확하고 프로그래밍 방식의 접근법을 알아봅니다.

빠른 답변

  • GroupDocs.Merger가 Word 문서에서 페이지를 추출할 수 있나요? 예, DOCX, DOC 및 기타 Office 형식에서 작동합니다.
  • 파일 크기 제한이 있나요? 라이브러리는 전체 문서를 메모리에 로드하지 않고도 최대 2 GB 파일을 처리할 수 있습니다.
  • 개발에 라이선스가 필요합니까? 무료 체험판을 사용할 수 있으며, 프로덕션 사용에는 라이선스가 필요합니다.
  • .NET 6에서 작동합니까? 물론입니다—GroupDocs.Merger는 .NET Framework 4.5+, .NET Core 3.1+, 및 .NET 5/6+를 지원합니다.
  • 한 번에 몇 페이지를 추출할 수 있나요? 한 번의 호출로 단일 페이지, 범위 또는 짝수·홀수 선택을 지정할 수 있습니다.

GroupDocs.Merger for .NET이란?

GroupDocs.Merger for .NET은 Microsoft Office나 Adobe Acrobat이 필요 없이 30개 이상의 문서 형식에서 병합, 분할, 회전 및 페이지 추출을 가능하게 하는 서버 측 라이브러리입니다. 스트리밍 방식으로 파일을 처리하므로 수백 페이지 PDF에서도 메모리 사용량을 낮게 유지합니다.

왜 특정 페이지 PDF를 추출해야 할까요?

특정 페이지 PDF를 추출하면 대역폭을 줄이고 협업 속도를 높이며 기밀 섹션이 숨겨지도록 할 수 있습니다. 구체적인 이점: 조직에서는 전체 파일 대신 필요한 페이지만 공유할 때 문서 검토 주기가 최대 40 % 빨라진다고 보고합니다. 또한, 파일 크기가 작아지면 웹 뷰어의 로드 시간이 개선되고 저장 비용이 감소합니다.

사전 요구 사항

  • Visual Studio 2022 또는 .NET 호환 IDE.
  • .NET 6 SDK (또는 .NET Framework 4.7.2+).
  • GroupDocs.Merger를 설치할 수 있는 NuGet 피드에 대한 접근 권한.
  • 기본 C# 지식 및 파일 시스템 권한.

특정 페이지 PDF를 단계별로 추출하는 방법

소스 파일을 로드하고, 필요한 페이지를 정의한 뒤, 결과를 저장합니다—모두 몇 줄의 코드로 가능합니다.

직접 답변

Merger는 문서 조작 작업을 조정하는 핵심 클래스입니다. ExtractOptions는 추출할 페이지와 처리 방식을 지정합니다. Extract는 제공된 옵션에 따라 추출을 수행하고 결과를 새 파일에 기록합니다. 특정 페이지 PDF를 추출하려면 소스 파일로 Merger 인스턴스를 생성하고, 페이지 범위와 모드(짝수, 홀수 또는 사용자 정의)를 정의하는 ExtractOptions 객체를 구성한 뒤 Extract를 호출하고 출력 파일을 저장합니다. 이 전체 워크플로는 일반적인 100페이지 PDF를 표준 서버에서 1초 미만에 실행됩니다.

단계 1: NuGet 패키지 설치

프로젝트 폴더에서 터미널을 열고 다음 명령 중 하나를 실행합니다:

.NET CLI

dotnet add package GroupDocs.Merger

Package Manager Console

Install-Package GroupDocs.Merger

NuGet Package Manager UI – UI를 사용하여 “GroupDocs.Merger”를 검색하고 Install를 클릭합니다.

단계 2: 파일 경로 정의

입력 및 출력 문서에 대한 절대 경로나 상대 경로를 지정합니다.

정의 앵커
ExtractOptions는 라이브러리에 어떤 페이지를 추출하고 어떻게 처리할지 알려주는 구성 객체입니다.

string filePath = "YOUR_DOCUMENT_DIRECTORY\\Sample.docx"; // Input document path
string filePathOut = Path.Combine("YOUR_OUTPUT_DIRECTORY", "ExtractedPages.docx"); // Output document path

단계 3: 추출 옵션 설정

ExtractOptions 인스턴스를 생성하고 StartPageNumber, EndPageNumber를 설정한 뒤 RangeMode(예: Even)를 선택합니다. 이는 엔진에게 지정된 범위 내에서 매 두 번째 페이지를 선택하도록 지시합니다.

정의 앵커
Merger는 추출, 병합 및 페이지 회전을 포함한 모든 문서 조작 작업을 조정하는 핵심 클래스입니다.

ExtractOptions extractOptions = new ExtractOptions(1, 3, RangeMode.EvenPages);

단계 4: 추출 및 저장

Merger 인스턴스에서 Extract 메서드를 호출하고 옵션과 출력 경로를 전달합니다. 라이브러리는 전체 소스를 메모리에 로드하지 않고 새 파일을 기록하므로 대용량 문서에 이상적입니다.

using (Merger merger = new Merger(filePath))
{
    merger.ExtractPages(extractOptions);
    merger.Save(filePathOut); // Save the result to a specified path
}

일반적인 문제 및 해결책

  • 페이지가 추출되지 않음 – StartPageNumber와 EndPageNumber가 1부터 시작하는지, 그리고 소스 파일에 실제로 요청한 범위가 포함되어 있는지 다시 확인하십시오.
  • 대용량 파일에서 메모리 부족 오류 – 스트리밍 API(기본값)를 사용하고 있는지, 프로세스에 충분한 가상 메모리가 있는지 확인하십시오; 라이브러리 구성에서 maxMemory 설정을 늘리는 것을 고려하세요.
  • 비밀번호 보호 파일 – LoadOptions를 사용하면 보호된 문서를 로드할 때 비밀번호와 같은 매개변수를 설정할 수 있습니다. Merger 인스턴스를 만들기 전에 LoadOptions를 통해 비밀번호를 제공하십시오.

실용적인 활용 사례

  1. 문서 검토 – 검토자가 필요한 조항만 추출하고 나머지는 기밀로 유지합니다.
  2. 교육 – 강의 슬라이드나 교과서 챕터를 추출하여 맞춤형 핸드아웃을 생성합니다.
  3. 법률 워크플로 – 전체 사건 파일을 노출하지 않고 법원 제출용 전시 페이지를 분리합니다.

성능 고려 사항

GroupDocs.Merger는 스트리밍 방식으로 문서를 처리하여 2 GB까지의 파일을 처리하면서 피크 메모리를 150 MB 이하로 유지합니다. 최상의 결과를 위해 Merger 객체를 using 문으로 감싸서 적절히 해제하고, 동일한 소스에서 여러 범위를 추출할 때는 단일 인스턴스를 재사용하십시오.

결론

이제 GroupDocs.Merger for .NET을 사용하여 특정 페이지 PDF를 추출하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. ExtractOptions를 구성하고 라이브러리의 스트리밍 엔진을 활용하면 지원되는 모든 형식에 대해 문서 슬라이싱을 자동화하고 협업 속도를 향상시키며 민감한 정보를 관리할 수 있습니다.

다음 단계 – 문서 병합, 페이지 회전, 워터마크 적용 등 라이브러리의 다른 기능을 탐색하여 완전 자동화된 문서 파이프라인을 구축하십시오.

자주 묻는 질문

Q: 어떤 파일 형식에서 페이지를 추출할 수 있나요?
A: GroupDocs.Merger는 PDF, DOCX, XLSX, PPTX, HTML 및 PNG, JPEG와 같은 이미지 형식을 포함해 30개 이상의 형식을 지원합니다.

Q: 연속되지 않은 페이지(예: 1, 3, 5)를 추출할 수 있나요?
A: 예, 개별 페이지 번호 목록이나 여러 범위를 ExtractOptions에 전달할 수 있습니다.

Q: 비밀번호로 보호된 PDF를 어떻게 처리하나요?
A: Merger 인스턴스를 생성할 때 LoadOptions를 통해 비밀번호를 제공하면 추출이 정상적으로 진행됩니다.

Q: 한 번의 호출로 추출할 수 있는 페이지 수에 제한이 있나요?
A: 엄격한 제한은 없으며, 실질적인 제약은 스트리밍 덕분에 낮은 메모리 사용량을 유지하는 가용 메모리뿐입니다.

Q: 라이브러리를 사용하려면 Microsoft Office나 Adobe Acrobat을 설치해야 하나요?
A: 외부 애플리케이션이 필요하지 않으며, 모든 처리는 .NET 런타임 내에서 이루어집니다.

리소스

마지막 업데이트: 2026-09-26
테스트 환경: GroupDocs.Merger 23.11 for .NET
작성자: GroupDocs

관련 튜토리얼