.NET HTML을 PDF로 변환하는 방법

IronPDF를 어떻게 시작합니까?

NuGet 패키지 관리자 콘솔 또는 .NET CLI를 사용하여 IronPDF를 .NET 프로젝트에 추가하십시오. 패키지는 .NET Standard 2.0을 대상으로 하며 .NET Framework 4.6.2+, .NET Core, 및 .NET 8과 .NET 10을 포함한 모든 최신 .NET 버전에서 실행됩니다.

dotnet add package IronPdf

설치 후, C# 파일의 맨 위에 using IronPdf;을 추가하세요. 유효한 라이선스 키가 전체 상업적 사용을 해제합니다. a 무료 체험판 라이선스는 평가 및 개발을 포함합니다. API를 호출하기 전에 키를 한 번 설정하세요:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

패키지가 참조되고 라이선스가 구성되면 이 기사에 있는 모든 예제는 수정 없이 컴파일되고 실행됩니다. IronPDF NuGet 패키지는 모든 필수 종속성을 자동으로 설치합니다; Windows, Linux, 또는 macOS에서 추가적인 네이티브 바이너리나 런타임 설정이 필요하지 않습니다.

단일 페이지를 PDF 문서 내에서 어떻게 이동할 수 있습니까?

IronPDF를 사용하여 PDF 문서 내에서 페이지를 이동하는 것은 세 단계로 구성됩니다: 대상 페이지를 복사하고, 새로운 위치에 삽입한 다음, 원본을 제거합니다. PdfDocument 클래스는 이 작업의 각 부분을 처리하기 위해 CopyPage, InsertPdf 및 RemovePage를 제공합니다.

다음 코드는 문서의 마지막 페이지를 시작으로 이동하는 방법을 보여줍니다:

using IronPdf;

// Load the PDF document from the file system
var pdf = PdfDocument.FromFile("report.pdf");

// Get the zero-based index of the last page
int lastPageIndex = pdf.PageCount - 1;

// Copy the last page into a standalone PdfDocument
var pageToCopy = pdf.CopyPage(lastPageIndex);

// Insert the copied page at position 0 (the first page slot)
pdf.InsertPdf(pageToCopy, 0);

// The original last page has shifted down by one; remove it
pdf.RemovePage(lastPageIndex + 1);

// Save the reordered document to a new file
pdf.SaveAs("report-reorganized.pdf");

using IronPdf;

// Load the PDF document from the file system
var pdf = PdfDocument.FromFile("report.pdf");

// Get the zero-based index of the last page
int lastPageIndex = pdf.PageCount - 1;

// Copy the last page into a standalone PdfDocument
var pageToCopy = pdf.CopyPage(lastPageIndex);

// Insert the copied page at position 0 (the first page slot)
pdf.InsertPdf(pageToCopy, 0);

// The original last page has shifted down by one; remove it
pdf.RemovePage(lastPageIndex + 1);

// Save the reordered document to a new file
pdf.SaveAs("report-reorganized.pdf");

Imports IronPdf

' Load the PDF document from the file system
Dim pdf = PdfDocument.FromFile("report.pdf")

' Get the zero-based index of the last page
Dim lastPageIndex As Integer = pdf.PageCount - 1

' Copy the last page into a standalone PdfDocument
Dim pageToCopy = pdf.CopyPage(lastPageIndex)

' Insert the copied page at position 0 (the first page slot)
pdf.InsertPdf(pageToCopy, 0)

' The original last page has shifted down by one; remove it
pdf.RemovePage(lastPageIndex + 1)

' Save the reordered document to a new file
pdf.SaveAs("report-reorganized.pdf")

여러 페이지를 한 번에 이동하는 과정은 무엇인가요?

여러 페이지를 다시 배치해야 할 때에는 CopyPages가 특정 페이지 집합을 한 번의 호출로 추출합니다. 이 메서드는 0부터 시작하는 페이지 인덱스 목록을 수락하고, 지정된 순서대로 페이지만 포함하는 새로운 PdfDocument를 반환합니다. 이 접근 방식은 보고서의 마지막으로 연속된 부록 페이지 블록을 이동하거나 요약 페이지 세트를 앞쪽으로 가져오는 시나리오에 적합합니다.

using IronPdf;
using System.Collections.Generic;

// Load the quarterly report
var pdf = PdfDocument.FromFile("quarterly-report.pdf");

// Copy pages at indexes 1 and 2 (the second and third pages)
var selectedPages = pdf.CopyPages(new List<int> { 1, 2 });

// Append the copied pages to the end of the original document
var result = PdfDocument.Merge(pdf, selectedPages);

// Remove the originals at their former positions (now indexes 1 and 2)
result.RemovePages(new List<int> { 1, 2 });

// Write the reordered result to a new path
result.SaveAs("quarterly-report-reordered.pdf");

using IronPdf;
using System.Collections.Generic;

// Load the quarterly report
var pdf = PdfDocument.FromFile("quarterly-report.pdf");

// Copy pages at indexes 1 and 2 (the second and third pages)
var selectedPages = pdf.CopyPages(new List<int> { 1, 2 });

// Append the copied pages to the end of the original document
var result = PdfDocument.Merge(pdf, selectedPages);

// Remove the originals at their former positions (now indexes 1 and 2)
result.RemovePages(new List<int> { 1, 2 });

// Write the reordered result to a new path
result.SaveAs("quarterly-report-reordered.pdf");

Imports IronPdf
Imports System.Collections.Generic

' Load the quarterly report
Dim pdf = PdfDocument.FromFile("quarterly-report.pdf")

' Copy pages at indexes 1 and 2 (the second and third pages)
Dim selectedPages = pdf.CopyPages(New List(Of Integer) From {1, 2})

' Append the copied pages to the end of the original document
Dim result = PdfDocument.Merge(pdf, selectedPages)

' Remove the originals at their former positions (now indexes 1 and 2)
result.RemovePages(New List(Of Integer) From {1, 2})

' Write the reordered result to a new path
result.SaveAs("quarterly-report-reordered.pdf")

두 개의 PDF 파일 간에 페이지를 이동하는 방법은 무엇입니까?

한 PDF 문서에서 다른 문서로 페이지를 전송하는 것은 두 개의 별도 PdfDocument 인스턴스에 걸쳐 동일한 복사-삽입 패턴을 적용합니다. 여러 원본 파일의 내용을 통합할 때 표준 접근 방식입니다: 예를 들어, 승인된 페이지를 초안에서 최종 계약 문서로 이동합니다.

using IronPdf;

// Load the source and destination documents
var sourceDoc = PdfDocument.FromFile("source-document.pdf");
var destinationDoc = PdfDocument.FromFile("destination-document.pdf");

// Extract the first page (index 0) from the source document
var pageToMove = sourceDoc.CopyPage(0);

// Insert the extracted page at position 2 in the destination (third page slot)
destinationDoc.InsertPdf(pageToMove, 2);

// Save the updated destination document
destinationDoc.SaveAs("destination-document-updated.pdf");

// Remove the transferred page from the source and save separately
sourceDoc.RemovePage(0);
sourceDoc.SaveAs("source-document-updated.pdf");

using IronPdf;

// Load the source and destination documents
var sourceDoc = PdfDocument.FromFile("source-document.pdf");
var destinationDoc = PdfDocument.FromFile("destination-document.pdf");

// Extract the first page (index 0) from the source document
var pageToMove = sourceDoc.CopyPage(0);

// Insert the extracted page at position 2 in the destination (third page slot)
destinationDoc.InsertPdf(pageToMove, 2);

// Save the updated destination document
destinationDoc.SaveAs("destination-document-updated.pdf");

// Remove the transferred page from the source and save separately
sourceDoc.RemovePage(0);
sourceDoc.SaveAs("source-document-updated.pdf");

Imports IronPdf

' Load the source and destination documents
Dim sourceDoc = PdfDocument.FromFile("source-document.pdf")
Dim destinationDoc = PdfDocument.FromFile("destination-document.pdf")

' Extract the first page (index 0) from the source document
Dim pageToMove = sourceDoc.CopyPage(0)

' Insert the extracted page at position 2 in the destination (third page slot)
destinationDoc.InsertPdf(pageToMove, 2)

' Save the updated destination document
destinationDoc.SaveAs("destination-document-updated.pdf")

' Remove the transferred page from the source and save separately
sourceDoc.RemovePage(0)
sourceDoc.SaveAs("source-document-updated.pdf")

PDF 페이지 재정렬의 일반적인 사용 사례는 무엇입니까?

개발자들은 다양한 실제 시나리오에서 PDF 페이지를 이동하고 재정렬해야 합니다. PDF 사양에 정의된 PDF 페이지 모델은 문서의 페이지 트리에서 각 페이지를 독립된 객체로 나타냅니다. 그렇기 때문에 단일 페이지에 대한 복사-삽입-제거 작업은 문서 길이에 상관없이 항상 유효합니다. 패턴을 이해하면 다양한 입력 구조를 처리하는 문서 처리 파이프라인을 설계하는 데 도움이 됩니다.

페이지 조작 이상의 기능을 위해, IronPDF는 동일한 파이프라인에서 문서 작업 전체를 지원합니다. 헤더 및 풋터 추가, 워터마크 적용, 및 디지털 서명 추가가 동일한 PdfDocument API를 통해 제공되므로 최종 저장 전에 여러 변환을 연결할 수 있습니다. IronPDF 기능 페이지에서는 제공되는 모든 기능을 개괄적으로 설명합니다.

페이지 위치가 문서 내용에 의해 결정되는 자동화 시나리오(특정 섹션을 발견한 후 승인 페이지를 삽입하는 경우)에서는 Edit PDF Files tutorial에서 페이지 재정렬과 결합할 수 있는 텍스트 검색 및 콘텐츠 기반 조작 기술을 다룹니다.

대용량 문서에서 페이지를 이동할 때 성능을 어떻게 처리합니까?

IronPDF에서의 페이지 조작은 메모리 내 문서 표현에서 작동하므로, 성능은 문서 크기와 적용된 작업 수에 따라 확장됩니다. 대용량 PDF의 경우, 처리 효율성을 유지하는 몇 가지 패턴이 있습니다.

최소한으로 필요한 페이지 수로 작업하면 메모리 오버헤드를 줄일 수 있습니다. 500페이지 문서를 로드해서 두 페이지를 이동하는 대신, 먼저 CopyPages로 문서를 섹션으로 나누고, 작은 집합에서 재정렬을 수행한 다음 Merge로 재조립 합니다. Split PDF Pages example은 이 분해 및 재조립 패턴을 보여줍니다.

여러 문서에 걸쳐 페이지를 이동하는 배치 처리 파이프라인의 경우, 각 저장 후에 PdfDocument 인스턴스를 삭제하여 메모리를 신속하게 해제하세요. PdfDocument은 IDisposable을 구현하므로, 각 인스턴스를 using 문 안에 감싸면 파이프라인 중간에 예외가 발생하더라도 확정적인 정리가 보장됩니다.

using IronPdf;

// Use 'using' declarations to ensure deterministic disposal
using var source = PdfDocument.FromFile("source-large.pdf");
using var destination = PdfDocument.FromFile("destination-large.pdf");

var pageToTransfer = source.CopyPage(0);
destination.InsertPdf(pageToTransfer, 0);

destination.SaveAs("destination-updated.pdf");
source.RemovePage(0);
source.SaveAs("source-updated.pdf");

using IronPdf;

// Use 'using' declarations to ensure deterministic disposal
using var source = PdfDocument.FromFile("source-large.pdf");
using var destination = PdfDocument.FromFile("destination-large.pdf");

var pageToTransfer = source.CopyPage(0);
destination.InsertPdf(pageToTransfer, 0);

destination.SaveAs("destination-updated.pdf");
source.RemovePage(0);
source.SaveAs("source-updated.pdf");

Imports IronPdf

' Use 'Using' blocks to ensure deterministic disposal
Using source = PdfDocument.FromFile("source-large.pdf")
    Using destination = PdfDocument.FromFile("destination-large.pdf")
        Dim pageToTransfer = source.CopyPage(0)
        destination.InsertPdf(pageToTransfer, 0)

        destination.SaveAs("destination-updated.pdf")
        source.RemovePage(0)
        source.SaveAs("source-updated.pdf")
    End Using
End Using

여기서의 using 선언은 PdfDocument 객체 두 개가 SaveAs 호출 완료 후에 폐기되도록 하여, 기본 메모리 버퍼를 즉시 해방합니다. 이 패턴은 특히 많은 요청이 같은 서버에서 문서를 동시에 처리할 수 있는 ASP.NET Core 응용 프로그램에서 매우 중요합니다. 메모리 안전한 문서 처리에 대한 추가 API 세부 정보는 IronPDF API Reference를 참조하세요.

다음 단계는 무엇입니까?

C#에서 PDF 페이지를 이동하고 재정렬 하려면, 복사-삽입-제거 순서대로 적용되는 세 개의 IronPDF 메서드: CopyPage, InsertPdf, 및 RemovePage가 필요합니다. 같은 패턴이 한 문서 내에서 한 페이지를 이동하는 것에서 여러 파일에 걸쳐 페이지 묶음을 전송하는 것까지 확장됩니다. IronPDF는 동일한 API로 VB.NET에서도 작동하며, 페이지 조작 메서드는 .NET 8 및 .NET 10을 포함한 모든 지원되는 .NET 플랫폼에서 사용할 수 있습니다.

관련 기능을 탐색하려면 Add, Copy & Delete PDF Pages guide가 모든 페이지 수준 메서드를 깊이 있게 다룹니다. 페이지 색인 배열을 사용한 전체 문서 재정렬을 위해서는 Rearrange Pages in PDF C# article에서 해당 접근 방식을 안내합니다.

프로젝트에 PDF 페이지 조작 기능을 추가할 준비가 되었습니까? 무료 체험판을 시작하여 개발 중 IronPDF의 모든 기능에 액세스하거나 라이선스를 구매하여 오늘 프로덕션에 배포하세요.