O formato de documento portátil (PDF) é um formato de arquivo universalmente utilizado que garante consistência na apresentação de documentos em todas as plataformas e dispositivos. Seu formato fixo o torna a opção ideal para compartilhar documentos, contratos, faturas e muito mais. Os arquivos PDF são indispensáveis ​​no mundo corporativo para documentação formal. Com a crescente necessidade de geração e manipulação de PDFs, diversas bibliotecas surgiram, simplificando o processo para os desenvolvedores.

Neste artigo, exploraremos como adicionar números de página a um PDF usando o QuestPDF em C#, além de comparar o QuestPDF com o IronPDF para ajudá-lo a decidir qual biblioteca se adapta melhor às necessidades do seu projeto.

O que é o IronPDF?

IronPDF é uma biblioteca rica em recursos, criada para o ecossistema .NET , projetada para lidar com tarefas de criação, manipulação e renderização de PDFs de forma eficiente. Ele utiliza um mecanismo baseado no Chromium para fornecer uma conversão precisa de HTML, CSS e JavaScript em documentos PDF. Isso a torna uma excelente opção para desenvolvedores web que precisam converter conteúdo HTML diretamente para o formato PDF, mantendo o layout e o estilo originais.

Com o IronPDF, você pode integrar facilmente funcionalidades de PDF em seus aplicativos .NET , incluindo a criação de cabeçalhos e rodapés personalizados, a adição de novas páginas aos seus PDFs, a incorporação de imagens e tabelas e a realização de manipulações avançadas de PDF, como mesclar ou dividir documentos. A biblioteca suporta vários formatos e oferece uma ampla gama de opções de personalização, tornando-a ideal para gerar PDFs de nível profissional a partir de conteúdo dinâmico da web.

Principais funcionalidades do IronPDF:

• Permite gerar PDFs diretamente a partir de código C# .
• Converte páginas da web, HTML e JavaScript em PDFs de alta qualidade.
• Oferece opções para adicionar elementos personalizados, como cabeçalhos, rodapés e marcas d'água .
• Facilita a fusão, divisão e edição de PDFs existentes.
• Funciona perfeitamente com aplicações .NET , incluindo ASP.NET e frameworks MVC.

Para explorar mais a fundo as funcionalidades do IronPDF e exemplos mais avançados, consulte a documentação oficial aqui .

Instalando o IronPDF

Para adicionar o IronPDF ao seu projeto, utilize o gerenciador de pacotes NuGet no Visual Studio. Você pode usar a interface visual de linha de comando ou pesquisar diretamente no Gerenciador de Pacotes NuGet .

Instalação via linha de comando:

Install-Package IronPdf

Alternativamente, você pode pesquisar por "IronPDF" no gerenciador de pacotes NuGet e instalá-lo.

O que é o QuestPDF?

QuestPDF é uma biblioteca .NET moderna projetada para geração de documentos PDF. Seu foco é fornecer aos desenvolvedores uma ferramenta flexível e eficiente para a criação de PDFs em C#. O QuestPDF permite uma abordagem intuitiva e fluida para o design de documentos usando um estilo declarativo.

O QuestPDF prioriza a simplicidade, a velocidade e o desempenho, tornando-o uma ótima opção para gerar relatórios e documentos dinâmicos. A biblioteca também oferece suporte a recursos avançados de layout, estilos personalizados e modelos fáceis de usar.

Recursos do QuestPDF

• API fácil de usar para criar documentos PDF complexos.
• Suporta layout flexível e estruturação de documentos, definindo páginas padrão, itens de coluna e assim por diante.
• Permite estilizar elementos facilmente usando propriedades semelhantes ao CSS.
• Fornece suporte para imagens, configurações de estilo de texto padrão, tabelas, códigos de barras, gráficos, colunas, linhas, múltiplos tipos de página e mais.
• Ideal para criar relatórios, faturas e documentos baseados em dados.

Para obter mais detalhes, consulte a documentação do QuestPDF .

Instalando o QuestPDF

Para começar a usar o QuestPDF, instale-o através da linha de comando do NuGet :

Install-Package QuestPDF

Ou, alternativamente, através do gerenciador de pacotes NuGet :

Isso adicionará as bibliotecas necessárias ao seu projeto para gerar PDFs com o QuestPDF.

Adicionando números de página usando o IronPDF

O IronPDF oferece uma maneira fácil de adicionar números de página a PDFs. O código a seguir demonstra como fazer isso:

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // HTML content for the PDF
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";

        // Set up the IronPDF renderer with header for page numbers
        ChromePdfRenderer renderer = new ChromePdfRenderer
        {
            RenderingOptions = 
            {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        };
        
        // Render the HTML as a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        
        // Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // HTML content for the PDF
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";

        // Set up the IronPDF renderer with header for page numbers
        ChromePdfRenderer renderer = new ChromePdfRenderer
        {
            RenderingOptions = 
            {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        };
        
        // Render the HTML as a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        
        // Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf");
    }
}

Imports IronPdf

Module Program
    Sub Main(args As String())
        ' HTML content for the PDF
        Dim html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>"

        ' Set up the IronPDF renderer with header for page numbers
        Dim renderer As New ChromePdfRenderer With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        }
        
        ' Render the HTML as a PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        
        ' Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Imports IronPdf

Module Program
    Sub Main(args As String())
        ' HTML content for the PDF
        Dim html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>"

        ' Set up the IronPDF renderer with header for page numbers
        Dim renderer As New ChromePdfRenderer With {
            .RenderingOptions = New RenderingOptions With {
                .HtmlHeader = New HtmlHeaderFooter With {
                    .HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                }
            }
        }
        
        ' Render the HTML as a PDF
        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        
        ' Save the PDF to a file
        pdf.SaveAs("pageNumbers.pdf")
    End Sub
End Module

Saída

Neste código, criamos um cabeçalho HTML para o documento PDF, onde {page} e {total-pages} representam marcadores dinâmicos para o número da página atual e o total de páginas. O método RenderHtmlAsPdf converte o HTML em um PDF. Essa funcionalidade permite que as páginas sejam ajustadas dinamicamente com base no comprimento do documento.

Como adicionar números de página usando o QuestPDF

No QuestPDF, adicionar números de página pode ser feito de maneira semelhante. Abaixo está o código para adicionar números de página usando o QuestPDF:

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

class Program
{
    static void Main(string[] args)
    {
        // Set the license type for QuestPDF
        QuestPDF.Settings.License = LicenseType.Community;

        // Create a PDF document using the QuestPDF fluent API
        var document = Document.Create(container =>
        {
            // Define a page with content and a header with page numbers
            container.Page(page =>
            {
                page.Content().Text("Hello, QuestPDF!");

                // Add a centered header with page number and total pages
                page.Header().AlignCenter().Text(text =>
                {
                    text.Span("Page ");
                    text.CurrentPageNumber();
                    text.Span(" of ");
                    text.TotalPages();
                });
            });
        });

        // Generate and save the PDF document
        document.GeneratePdf("QuestPdfOutput.pdf");
    }
}

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

class Program
{
    static void Main(string[] args)
    {
        // Set the license type for QuestPDF
        QuestPDF.Settings.License = LicenseType.Community;

        // Create a PDF document using the QuestPDF fluent API
        var document = Document.Create(container =>
        {
            // Define a page with content and a header with page numbers
            container.Page(page =>
            {
                page.Content().Text("Hello, QuestPDF!");

                // Add a centered header with page number and total pages
                page.Header().AlignCenter().Text(text =>
                {
                    text.Span("Page ");
                    text.CurrentPageNumber();
                    text.Span(" of ");
                    text.TotalPages();
                });
            });
        });

        // Generate and save the PDF document
        document.GeneratePdf("QuestPdfOutput.pdf");
    }
}

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set the license type for QuestPDF
		QuestPDF.Settings.License = LicenseType.Community

		' Create a PDF document using the QuestPDF fluent API
		Dim document = Document.Create(Sub(container)
			' Define a page with content and a header with page numbers
			container.Page(Sub(page)
				page.Content().Text("Hello, QuestPDF!")

				' Add a centered header with page number and total pages
				page.Header().AlignCenter().Text(Sub(text)
					text.Span("Page ")
					text.CurrentPageNumber()
					text.Span(" of ")
					text.TotalPages()
				End Sub)
			End Sub)
		End Sub)

		' Generate and save the PDF document
		document.GeneratePdf("QuestPdfOutput.pdf")
	End Sub
End Class

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set the license type for QuestPDF
		QuestPDF.Settings.License = LicenseType.Community

		' Create a PDF document using the QuestPDF fluent API
		Dim document = Document.Create(Sub(container)
			' Define a page with content and a header with page numbers
			container.Page(Sub(page)
				page.Content().Text("Hello, QuestPDF!")

				' Add a centered header with page number and total pages
				page.Header().AlignCenter().Text(Sub(text)
					text.Span("Page ")
					text.CurrentPageNumber()
					text.Span(" of ")
					text.TotalPages()
				End Sub)
			End Sub)
		End Sub)

		' Generate and save the PDF document
		document.GeneratePdf("QuestPdfOutput.pdf")
	End Sub
End Class

Este código QuestPDF define um documento simples com um número de página no cabeçalho. Os métodos CurrentPageNumber() e TotalPages() são usados para gerar dinamicamente o número da página relativo a cada página.

Conclusão

Em conclusão, tanto o IronPDF quanto o QuestPDF oferecem soluções eficazes para adicionar números de página a PDFs em C#. No entanto, o IronPDF oferece uma abordagem mais simplificada e fácil de usar. Sua flexibilidade e facilidade de uso o tornam a escolha ideal para desenvolvedores que precisam adicionar números de página ou manipular PDFs existentes com o mínimo de esforço.

O IronPDF está disponível gratuitamente para desenvolvimento, permitindo que os desenvolvedores o experimentem e o integrem em projetos sem qualquer custo durante a fase de desenvolvimento. Quando estiver pronto para a produção, o licenciamento comercial estará disponível para essas opções de licenciamento.

Ao escolher o IronPDF, os desenvolvedores têm acesso a uma ferramenta confiável e repleta de recursos que simplifica a criação e edição de PDFs, incluindo a inserção de números de página, com o benefício adicional de manutenção e atualizações contínuas.

Para obter mais informações sobre a versão gratuita e o licenciamento comercial do IronPDF, visite o site oficial do IronPDF .