PDFsharp vs QuestPDF (Comparação detalhada da biblioteca PDF em C#)

Principais funcionalidades do PDFsharp

• Criação e edição de PDFs: Gere novos PDFs ou modifique os existentes.
• Desenho gráfico: Inclui suporte para desenho de formas, texto e imagens.
• Código aberto: Licenciado sob a licença MIT, o que permite seu uso e modificação gratuitos.

Instalação

Utilizando o gerenciador de pacotes NuGet , é fácil instalar o PDFsharp em seus projetos. Basta executar a seguinte linha no Console do Gerenciador de Pacotes NuGet :

Install-Package PDFsharp

Exemplo de código PDFsharp

Agora, vamos dar uma olhada em como o PDFsharp pode lidar com a criação de um novo documento PDF a partir de uma URL específica. Como o PDFsharp, por si só, não consegue lidar com a conversão de HTML ou URL para PDF, precisaremos integrar um mecanismo de renderização web, como o HtmlRenderer.PdfSharp. Além disso, usaremos o HttpClient para recuperar o conteúdo HTML da URL fornecida.

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using PdfSharp.Pdf;
using TheArtOfDev.HtmlRenderer.PdfSharp;

public class Program
{
    static async Task Main(string[] args)
    {
        // Ensure proper encoding support
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Generate PDF from the fetched HTML content
            var pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4);
            pdf.Save("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using PdfSharp.Pdf;
using TheArtOfDev.HtmlRenderer.PdfSharp;

public class Program
{
    static async Task Main(string[] args)
    {
        // Ensure proper encoding support
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Generate PDF from the fetched HTML content
            var pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4);
            pdf.Save("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

Imports System
Imports System.Net.Http
Imports System.Text
Imports System.Threading.Tasks
Imports PdfSharp.Pdf
Imports TheArtOfDev.HtmlRenderer.PdfSharp

Public Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Ensure proper encoding support
		Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

		Dim url As String = "https://www.apple.com"

		' Fetch HTML content from the URL
		Using client As New HttpClient()
			Dim htmlContent As String = Await client.GetStringAsync(url)

			' Generate PDF from the fetched HTML content
			Dim pdf = PdfGenerator.GeneratePdf(htmlContent, PdfSharp.PageSize.A4)
			pdf.Save("output.pdf")

			Console.WriteLine("PDF created successfully as 'output.pdf'.")
		End Using
	End Function
End Class

Arquivo PDF de saída

Como você pode ver, embora o PDFsharp possa ser usado para converter conteúdo HTML e páginas da web em arquivos PDF, ele precisa da ajuda de bibliotecas adicionais e não consegue manter o CSS e a formatação do site original. Apesar de ser uma ótima biblioteca gratuita para desenvolvedores de PDF, ela carece de alguns recursos mais avançados encontrados em bibliotecas pagas, como o IronPDF.

Principais funcionalidades do QuestPDF

• API Fluente: Oferece uma abordagem declarativa para definir layouts de documentos.
• Sistema de layout moderno: Inspirado no CSS, ele suporta grades, componentes e estruturas de layout flexíveis.
• Alto desempenho: Otimizado para renderizar documentos grandes e complexos rapidamente.

Instalação

Graças à disponibilidade desta biblioteca como um pacote NuGet , a instalação é um processo simples, que requer apenas uma linha de comando no Console NuGet :

Install-Package QuestPDF

Exemplo de código QuestPDF

Agora é hora de ver como o QuestPDF lidará com a conversão do nosso URL de exemplo para o formato PDF. Embora o QuestPDF não ofereça suporte nativo à conversão de URL para PDF, você pode usar um cliente HTTP para obter o conteúdo HTML e renderizá-lo em um PDF usando a API fluente do QuestPDF.

using System;
using System.Net.Http;
using System.Threading.Tasks;
using HtmlAgilityPack;
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

public class Program
{
    static async Task Main(string[] args)
    {
        // Configure QuestPDF to use the community license
        QuestPDF.Settings.License = LicenseType.Community;

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Parse the HTML content using HtmlAgilityPack
            var htmlDoc = new HtmlDocument();
            htmlDoc.LoadHtml(htmlContent);

            // Extract meaningful content (e.g., text inside <body>)
            var bodyContent = htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText ?? "No content found";

            // Generate PDF using QuestPDF
            Document.Create(container =>
            {
                container.Page(page =>
                {
                    page.Size(PageSizes.A4);
                    page.Margin(20);
                    page.Content().Text(bodyContent);
                });
            }).GeneratePdf("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;
using HtmlAgilityPack;
using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

public class Program
{
    static async Task Main(string[] args)
    {
        // Configure QuestPDF to use the community license
        QuestPDF.Settings.License = LicenseType.Community;

        string url = "https://www.apple.com";

        // Fetch HTML content from the URL
        using (HttpClient client = new HttpClient())
        {
            string htmlContent = await client.GetStringAsync(url);

            // Parse the HTML content using HtmlAgilityPack
            var htmlDoc = new HtmlDocument();
            htmlDoc.LoadHtml(htmlContent);

            // Extract meaningful content (e.g., text inside <body>)
            var bodyContent = htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText ?? "No content found";

            // Generate PDF using QuestPDF
            Document.Create(container =>
            {
                container.Page(page =>
                {
                    page.Size(PageSizes.A4);
                    page.Margin(20);
                    page.Content().Text(bodyContent);
                });
            }).GeneratePdf("output.pdf");

            Console.WriteLine("PDF created successfully as 'output.pdf'.");
        }
    }
}

Imports System
Imports System.Net.Http
Imports System.Threading.Tasks
Imports HtmlAgilityPack
Imports QuestPDF.Fluent
Imports QuestPDF.Helpers
Imports QuestPDF.Infrastructure

Public Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Configure QuestPDF to use the community license
		QuestPDF.Settings.License = LicenseType.Community

		Dim url As String = "https://www.apple.com"

		' Fetch HTML content from the URL
		Using client As New HttpClient()
			Dim htmlContent As String = Await client.GetStringAsync(url)

			' Parse the HTML content using HtmlAgilityPack
			Dim htmlDoc = New HtmlDocument()
			htmlDoc.LoadHtml(htmlContent)

			' Extract meaningful content (e.g., text inside <body>)
			Dim bodyContent = If(htmlDoc.DocumentNode.SelectSingleNode("//body")?.InnerText, "No content found")

			' Generate PDF using QuestPDF
			Document.Create(Sub(container)
				container.Page(Sub(page)
					page.Size(PageSizes.A4)
					page.Margin(20)
					page.Content().Text(bodyContent)
				End Sub)
			End Sub).GeneratePdf("output.pdf")

			Console.WriteLine("PDF created successfully as 'output.pdf'.")
		End Using
	End Function
End Class

Arquivo PDF de saída

Assim como o PDFSharp, embora o QuestPDF possa ser utilizado para converter conteúdo HTML em PDF com a ajuda de bibliotecas externas como o HtmlAgilityPack, ele não consegue manter nenhum estilo ou formatação CSS. Embora o QuestPDF seja uma ótima opção para quem deseja criar documentos PDF do zero, a conversão de HTML para PDF não é o ponto forte desta biblioteca.

Principais características do IronPDF

• HTML para PDF: Converta facilmente páginas da web inteiras ou strings HTML em PDFs.
• Conformidade com PDF/A: Gere documentos que estejam em conformidade com os padrões de arquivamento de longo prazo.
• Segurança avançada: Suporta criptografia, proteção por senha e assinaturas digitais .
• Edição de PDFs: Modifique, mescle e divida arquivos PDF existentes.
• Multiplataforma: Totalmente compatível com .NET Framework, .NET Core e .NET 5+.

Instalação

Para instalar o IronPDF, utilize o Gerenciador de Pacotes NuGet no Visual Studio:

Utilizando o Gerenciador de Pacotes NuGet :

1. Abra seu projeto no Visual Studio.
2. Clique com o botão direito do mouse no projeto no Solution Explorer e selecione "Gerenciar Pacotes NuGet ".
3. Procure por "IronPDF" e clique em "Instalar".

Utilizando o Console do Gerenciador de Pacotes NuGet :

Install-Package IronPdf

Exemplo: Converter URL para PDF usando o IronPDF

O IronPDF fornece uma API simples e direta para converter URLs em PDFs . Eis um exemplo:

using IronPdf;

public class PdfConverter
{
    public static void Main(string[] args)
    {
        // Create a renderer with IronPdf
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Render the URL as a PDF
        PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.apple.com");

        // Save the PDF
        pdf.SaveAs("url.pdf");
    }
}

using IronPdf;

public class PdfConverter
{
    public static void Main(string[] args)
    {
        // Create a renderer with IronPdf
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Render the URL as a PDF
        PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.apple.com");

        // Save the PDF
        pdf.SaveAs("url.pdf");
    }
}

Imports IronPdf

Public Class PdfConverter
	Public Shared Sub Main(ByVal args() As String)
		' Create a renderer with IronPdf
		Dim renderer As New ChromePdfRenderer()

		' Render the URL as a PDF
		Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.apple.com")

		' Save the PDF
		pdf.SaveAs("url.pdf")
	End Sub
End Class

Arquivo PDF de saída

O exemplo de código acima demonstra como o IronPDF pode converter facilmente o conteúdo de uma URL em PDF com apenas algumas linhas de código. Como você pode ver, não apenas converteu o HTML, mas também o estilo e os layouts CSS, garantindo que o PDF de saída permaneça fiel à formatação original. Por meio do mecanismo de renderização ChromePdfRenderer , o IronPDF produz documentos PDF com qualidade impecável, que não perdem a qualidade original do conteúdo durante o processo de conversão.

Como pode ser visto aqui, o IronPDF é uma excelente opção para conversão de HTML para PDF, assim como para a conversão de outros tipos de documentos para PDF. Ele realiza conversões de alta qualidade em um bloco de código conciso e fácil de implementar.

Facilidade de uso

O PDFsharp é simples e fácil de usar, o que o torna uma excelente opção para iniciantes ou desenvolvedores com necessidades básicas em PDF. Sua abordagem processual permite configuração e implementação rápidas para tarefas como adicionar texto, formas ou imagens a um PDF. No entanto, é necessária uma biblioteca externa para lidar com as tarefas de conversão de HTML e URL para PDF.

O QuestPDF, por outro lado, oferece uma abordagem mais moderna com sua API fluente. Desenvolvedores com experiência em web design ou design de interface do usuário acharão intuitivo, mas os iniciantes podem enfrentar uma pequena curva de aprendizado enquanto se acostumam com a filosofia de design centrada no layout. Novamente, faltam ferramentas integradas para lidar com conversões de HTML para PDF.

O IronPDF oferece a experiência mais fácil para conversão de HTML em PDF e recursos avançados de PDF. Sua API intuitiva reduz o tempo de implementação e oferece documentação e exemplos robustos. O IronPDF consegue lidar com a conversão de muitos tipos diferentes de documentos para PDF, como o exemplo de URL para PDF que vimos neste artigo, tudo isso sem qualquer perda de qualidade do documento.

Desempenho

O desempenho é um fator crítico, especialmente para aplicações que precisam gerar PDFs dinamicamente. O PDFsharp é adequado para documentos pequenos e simples, mas apresenta dificuldades com layouts complexos ou de grande escala.

O QuestPDF se destaca na renderização de documentos dinâmicos e visualmente atraentes. É otimizado para lidar com layouts estruturados com alta eficiência.

O IronPDF oferece um equilíbrio excepcional entre desempenho e funcionalidade, especialmente para aplicações que exigem renderização de HTML, CSS e suporte a JavaScript . Ele também é altamente capaz de lidar com tarefas em PDF de nível empresarial com facilidade.