Como mesclar ou dividir arquivos PDF em C# | Tutorial IronPDF

Como mesclar, unir ou dividir PDFs em C# com IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPDF permite que desenvolvedores C# mesclem ou unam vários arquivos PDF em um único documento, ou dividam PDFs em arquivos separados usando métodos simples como Merge() para combinar e CopyPages() para dividir, simplificando o gerenciamento de documentos em aplicativos .NET.

Unir PDF ou mesclar PDF pode ser muito útil em diversas situações. Por exemplo, você pode consolidar documentos semelhantes, como currículos, em um único arquivo em vez de compartilhar vários arquivos. Este artigo orienta você no processo de mesclar ou dividir PDF usando C#. O IronPDF simplifica a divisão e a fusão de PDFs com chamadas de método intuitivas em sua aplicação C#. A seguir, apresentaremos todas as funcionalidades de manipulação de páginas.

Início rápido: Mesclar, unir ou dividir PDFs com o IronPDF

Combine ou una vários arquivos PDF em um único documento usando o IronPDF. Com poucas linhas de código, os desenvolvedores podem integrar a funcionalidade de mesclar PDF em seus aplicativos C#. Este guia rápido demonstra como usar o método Merge da biblioteca IronPDF para unir PDF, simplificando as tarefas de gerenciamento de documentos.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf
  2. Copie e execute este trecho de código.

    IronPdf.PdfDocument
        .Merge(IronPdf.PdfDocument.FromFile("file1.pdf"), IronPdf.PdfDocument.FromFile("file2.pdf"))
        .SaveAs("merged.pdf");
  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

    arrow pointer


Como faço para mesclar PDFs em C#?

Na demonstração a seguir, inicializaremos duas strings HTML de duas páginas, renderizaremos cada uma delas como PDFs separados com o IronPDF e, em seguida, as mesclaremos. Essa abordagem é particularmente útil quando você precisa converter HTML em PDF e combinar vários documentos HTML em um único arquivo PDF.

:path=/static-assets/pdf/content-code-examples/how-to/merge-or-split-pdfs-merge.cs
using IronPdf;

// Two paged PDF
const string html_a =
    @"<p> [PDF_A] </p>
    <p> [PDF_A] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_A] 2nd Page</p>";

// Two paged PDF
const string html_b =
    @"<p> [PDF_B] </p>
    <p> [PDF_B] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_B] 2nd Page</p>";

var renderer = new ChromePdfRenderer();

var pdfdoc_a = renderer.RenderHtmlAsPdf(html_a);
var pdfdoc_b = renderer.RenderHtmlAsPdf(html_b);

// Four paged PDF
var merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b);
merged.SaveAs("Merged.pdf");
Imports IronPdf

' Two paged PDF
Private Const html_a As String = "<p> [PDF_A] </p>
    <p> [PDF_A] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_A] 2nd Page</p>"

' Two paged PDF
Private Const html_b As String = "<p> [PDF_B] </p>
    <p> [PDF_B] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_B] 2nd Page</p>"

Private renderer = New ChromePdfRenderer()

Private pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
Private pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

' Four paged PDF
Private merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b)
merged.SaveAs("Merged.pdf")
$vbLabelText   $csharpLabel

O código acima demonstra como usar quebras de página de forma eficaz para criar PDFs com várias páginas antes de mesclá-las. A propriedade CSS page-break-after: always garante que cada seção comece em uma nova página.

Qual é a aparência do PDF mesclado?

Este é o arquivo gerado pelo código:

Quando devo usar a mesclagem de PDFs?

A fusão de PDFs é particularmente valiosa em ambientes corporativos, onde a consolidação de documentos melhora a eficiência do fluxo de trabalho. Aplicações comuns incluem:

  • Geração de relatórios : Combine vários relatórios departamentais em resumos executivos abrangentes usando a geração de relatórios em PDF.
  • Processamento de faturas : Consolide as faturas dos clientes com a documentação de suporte para simplificar os fluxos de trabalho de faturamento.
  • Documentação Legal : Consolide contratos, adendos e assinaturas em documentos legais únicos.
  • Materiais Educacionais : Combine materiais do curso, tarefas e recursos em guias de estudo abrangentes.

Quais são os cenários de fusão mais comuns?

Além da combinação básica de arquivos, o IronPDF oferece suporte a cenários avançados de mesclagem:

  1. Processamento em lote : Mescle centenas de PDFs programaticamente usando loops e coleções.
  2. Fusão Condicional : Combinar PDFs com base em lógica de negócios ou critérios de metadados.
  3. Integração de modelos : Combine conteúdo dinâmico com modelos de PDF predefinidos.
  4. Fusão entre formatos : Combine PDFs criados a partir de diferentes fontes, como strings HTML , URLs ou imagens.

Como posso combinar páginas de um PDF?

Use o método CombinePages para combinar várias páginas de um PDF em uma única página. O método requer a largura, a altura, o número de linhas e o número de colunas. Essa funcionalidade é especialmente útil para criar miniaturas, folhas de contato ou pré-visualizações com várias páginas.

:path=/static-assets/pdf/content-code-examples/how-to/merge-or-split-pdfs-combine.cs
using IronPdf;

// Load an existing PDF document from a file.
PdfDocument pdf = PdfDocument.FromFile("Merged.pdf");

// Combine pages of the loaded PDF into a grid with specified dimensions.
// The parameters for CombinePages are the width and height of each page
// in millimeters followed by the number of rows and columns to create the grid.
int pageWidth = 250;  // Width of each page in the grid
int pageHeight = 250; // Height of each page in the grid
int rows = 2;         // Number of rows in the grid
int columns = 2;      // Number of columns in the grid

// Combine the pages of the PDF document into a single page with specified dimensions.
PdfDocument combinedPages = pdf.CombinePages(pageWidth, pageHeight, rows, columns);

// Save the combined document as a new PDF file.
combinedPages.SaveAs("combinedPages.pdf");
Imports IronPdf

' Load an existing PDF document from a file.
Private pdf As PdfDocument = PdfDocument.FromFile("Merged.pdf")

' Combine pages of the loaded PDF into a grid with specified dimensions.
' The parameters for CombinePages are the width and height of each page
' in millimeters followed by the number of rows and columns to create the grid.
Private pageWidth As Integer = 250 ' Width of each page in the grid
Private pageHeight As Integer = 250 ' Height of each page in the grid
Private rows As Integer = 2 ' Number of rows in the grid
Private columns As Integer = 2 ' Number of columns in the grid

' Combine the pages of the PDF document into a single page with specified dimensions.
Private combinedPages As PdfDocument = pdf.CombinePages(pageWidth, pageHeight, rows, columns)

' Save the combined document as a new PDF file.
combinedPages.SaveAs("combinedPages.pdf")
$vbLabelText   $csharpLabel

Qual é a aparência da página combinada?

Por que combinar páginas em uma grade?

Combinar páginas em um layout de grade serve a vários propósitos:

  • Pré-visualizações de documentos : Crie visualizações em miniatura de documentos com várias páginas para uma leitura visual rápida.
  • Folhas de comparação : Exiba várias versões lado a lado para facilitar a comparação.
  • Otimização de Impressão : Reduza o consumo de papel imprimindo várias páginas em uma única folha.
  • Materiais de apresentação : Crie folhetos com vários slides por página.

Quais são os parâmetros para CombinePages?

O método CombinePages aceita quatro parâmetros essenciais:

  1. pageWidth : Largura individual da página em milímetros dentro da grade
  2. pageHeight : Altura individual da página em milímetros dentro da grade
  3. Linhas : Número de linhas horizontais no layout da grade
  4. colunas : Número de colunas verticais no layout da grade

Para tamanhos de página personalizados, consulte nosso guia sobre configuração de tamanho de papel personalizado .


Como faço para dividir PDFs em C#?

Na demonstração a seguir, dividiremos o documento PDF de várias páginas do exemplo anterior. A divisão de PDFs é essencial para extrair páginas específicas, criar trechos de documentos ou distribuir seções individuais para diferentes destinatários.

:path=/static-assets/pdf/content-code-examples/how-to/merge-or-split-pdfs-split.cs
using IronPdf;

// We will use the 4-page PDF from the Merge example above:
var pdf = PdfDocument.FromFile("Merged.pdf");

// Takes only the first page into a new PDF
var page1doc = pdf.CopyPage(0);
page1doc.SaveAs("Page1Only.pdf");

// Take the pages 2 & 3 (Note: index starts at 0)
var page23doc = pdf.CopyPages(1, 2);
page23doc.SaveAs("Pages2to3.pdf");
Imports IronPdf

' We will use the 4-page PDF from the Merge example above:
Private pdf = PdfDocument.FromFile("Merged.pdf")

' Takes only the first page into a new PDF
Private page1doc = pdf.CopyPage(0)
page1doc.SaveAs("Page1Only.pdf")

' Take the pages 2 & 3 (Note: index starts at 0)
Dim page23doc = pdf.CopyPages(1, 2)
page23doc.SaveAs("Pages2to3.pdf")
$vbLabelText   $csharpLabel

Este código salva dois arquivos:

  • Page1Only.pdf (Apenas a primeira página)
  • Pages2to3.pdf (Segunda para terceira página)

Qual é a aparência dos PDFs divididos?

Estes são os dois arquivos gerados:

Page1Only.pdf

Pages2to3.pdf

Quando devo dividir PDFs?

A divisão de PDFs oferece inúmeras vantagens no gerenciamento de documentos:

  • Distribuição Seletiva : Compartilhe apenas páginas relevantes com as partes interessadas específicas.
  • Gerenciamento do tamanho do arquivo : Divida PDFs grandes em partes menores para anexar por e-mail.
  • Extração de capítulos : Extraia capítulos individuais de livros ou manuais.
  • Processamento de formulários : Separar formulários preenchidos de páginas de instruções.
  • Organização de Arquivos : Divida os documentos por data, departamento ou categoria.

Para manipulação de páginas mais avançada, explore nosso guia sobre como adicionar, copiar e excluir páginas .

Qual a diferença entre CopyPage e CopyPages?

Compreender a distinção entre esses métodos é crucial para a manipulação eficiente de PDFs:

  • CopyPage(int pageIndex) : Extrai uma única página no índice especificado (base zero)
  • CopyPages(int startIndex, int endIndex) : Extrai um intervalo de páginas de forma inclusiva

Aqui está um exemplo avançado que demonstra ambos os métodos:

using IronPdf;

// Load a PDF document
var sourcePdf = PdfDocument.FromFile("LargeDocument.pdf");

// Extract cover page (first page)
var coverPage = sourcePdf.CopyPage(0);
coverPage.SaveAs("CoverPage.pdf");

// Extract table of contents (pages 2-5)
var tableOfContents = sourcePdf.CopyPages(1, 4);
tableOfContents.SaveAs("TableOfContents.pdf");

// Extract specific chapter (pages 20-35)
var chapter3 = sourcePdf.CopyPages(19, 34);
chapter3.SaveAs("Chapter3.pdf");

// Create a custom selection by merging specific pages
var customSelection = PdfDocument.Merge(
    sourcePdf.CopyPage(0),      // Cover
    sourcePdf.CopyPages(5, 7),  // Executive Summary
    sourcePdf.CopyPage(50)      // Conclusion
);
customSelection.SaveAs("ExecutiveBrief.pdf");
using IronPdf;

// Load a PDF document
var sourcePdf = PdfDocument.FromFile("LargeDocument.pdf");

// Extract cover page (first page)
var coverPage = sourcePdf.CopyPage(0);
coverPage.SaveAs("CoverPage.pdf");

// Extract table of contents (pages 2-5)
var tableOfContents = sourcePdf.CopyPages(1, 4);
tableOfContents.SaveAs("TableOfContents.pdf");

// Extract specific chapter (pages 20-35)
var chapter3 = sourcePdf.CopyPages(19, 34);
chapter3.SaveAs("Chapter3.pdf");

// Create a custom selection by merging specific pages
var customSelection = PdfDocument.Merge(
    sourcePdf.CopyPage(0),      // Cover
    sourcePdf.CopyPages(5, 7),  // Executive Summary
    sourcePdf.CopyPage(50)      // Conclusion
);
customSelection.SaveAs("ExecutiveBrief.pdf");
Imports IronPdf

' Load a PDF document
Dim sourcePdf = PdfDocument.FromFile("LargeDocument.pdf")

' Extract cover page (first page)
Dim coverPage = sourcePdf.CopyPage(0)
coverPage.SaveAs("CoverPage.pdf")

' Extract table of contents (pages 2-5)
Dim tableOfContents = sourcePdf.CopyPages(1, 4)
tableOfContents.SaveAs("TableOfContents.pdf")

' Extract specific chapter (pages 20-35)
Dim chapter3 = sourcePdf.CopyPages(19, 34)
chapter3.SaveAs("Chapter3.pdf")

' Create a custom selection by merging specific pages
Dim customSelection = PdfDocument.Merge( _
    sourcePdf.CopyPage(0),      ' Cover
    sourcePdf.CopyPages(5, 7),  ' Executive Summary
    sourcePdf.CopyPage(50)      ' Conclusion
)
customSelection.SaveAs("ExecutiveBrief.pdf")
$vbLabelText   $csharpLabel

Este exemplo demonstra como criar compilações de documentos personalizadas combinando operações de divisão com funcionalidades de mesclagem, ideal para criar briefings executivos ou relatórios personalizados.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Organizar PDFs para obter técnicas abrangentes de organização de PDFs, incluindo gerenciamento de metadados , criação de marcadores e estratégias avançadas de manipulação de páginas.

Perguntas frequentes

Como faço para mesclar vários arquivos PDF em um só usando C#?

Com o IronPDF, você pode mesclar vários arquivos PDF usando o método simples `Merge()`. Basta chamar `IronPdf.PdfDocument.Merge()`, passar os documentos PDF que deseja combinar e salvar o resultado com `SaveAs()`. Isso permite consolidar vários PDFs em um único documento com apenas algumas linhas de código C#.

Qual é a maneira mais rápida de combinar dois PDFs?

A maneira mais rápida é usando a funcionalidade de mesclagem em uma única linha do IronPDF: IronPdf.PdfDocument.Merge(IronPdf.PdfDocument.FromFile("file1.pdf"), IronPdf.PdfDocument.FromFile("file2.pdf")).SaveAs("merged.pdf"). Esta única linha de código carrega dois PDFs e os mescla em um só.

Posso dividir arquivos PDF extraindo páginas específicas?

Sim, o IronPDF oferece os métodos CopyPage() e CopyPages() para dividir PDFs. Esses métodos permitem extrair páginas individuais ou intervalos de páginas de documentos PDF existentes e salvá-los como arquivos separados, facilitando a divisão programática de PDFs grandes.

É possível mesclar conteúdo HTML em PDFs?

Com certeza! O IronPDF permite que você primeiro converta strings HTML em PDF usando seus recursos de renderização de HTML para PDF e, em seguida, mescle esses PDFs gerados. Isso é particularmente útil quando você precisa combinar vários documentos ou relatórios HTML em um único arquivo PDF.

Quais são os casos de uso comuns para a fusão de PDFs em aplicações empresariais?

Os recursos de mesclagem do IronPDF são comumente usados para geração de relatórios (combinando relatórios departamentais), processamento de faturas (mesclando faturas com documentos comprobatórios) e compilação de documentos jurídicos. Esses recursos ajudam a otimizar os fluxos de trabalho de gerenciamento de documentos em aplicativos .NET.

Como posso garantir quebras de página adequadas ao mesclar PDFs a partir de HTML?

Ao usar o IronPDF para converter HTML em PDF antes de mesclar, você pode usar a propriedade CSS 'page-break-after: always' para garantir que cada seção comece em uma nova página. Isso lhe dá controle preciso sobre o layout da página em seus documentos PDF mesclados.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.