COMPARAçãO

NReco.PdfGenerator vs IronPDF: Guia de Comparação Técnica

Atualizado:

Visão geral do NReco.PdfGenerator

NReco.PdfGenerator é uma biblioteca C# que converte documentos HTML em PDFs utilizando a ferramenta de linha de comando wkhtmltopdf. Ele oferece uma API simples através de sua classe HtmlToPdfConverter, que utiliza wkhtmltopdf para renderização.

A ferramenta wkhtmltopdf utiliza WebKit Qt como seu motor de renderização, em uma versão datada de cerca de 2012. Apesar de amplamente utilizada, o desenvolvimento para wkhtmltopdf cessou em 2020, deixando-a sem atualizações de segurança ou novos recursos. Isso apresenta desafios para equipes que desenvolvem aplicativos modernos com necessidades atuais de CSS e JavaScript.

A versão gratuita do NReco.PdfGenerator inclui marcas d'água nos PDFs gerados, necessitando de uma licença comercial para uso em produção. Obter preços para essas licenças envolve contatar vendas, o que pode complicar os processos de aquisição.

Introdução ao IronPDF

IronPDF é uma biblioteca .NET que usa um moderno motor de renderização baseado em Chromium para converter HTML, CSS e JavaScript em documentos PDF. A classe ChromePdfRenderer serve como a interface principal para conversão de HTML para PDF, oferecendo amplas opções de configuração através da propriedade RenderingOptions.

Ao contrário dos wrappers wkhtmltopdf, o motor de renderização doIronPDFrecebe atualizações regulares para segurança e compatibilidade. A biblioteca é auto-contida, eliminando a necessidade de gerenciar dependências binárias externas em diferentes plataformas.

IronPDF oferece um período de teste com funcionalidade completa (sem marcas d'água), permitindo que as equipes avaliem as capacidades antes de comprar. O licenciamento comercial usa preços publicados e transparentes.

Comparando Motores de Renderização

A principal diferença entre essas bibliotecas reside em seus motores de renderização, impactando segurança e compatibilidade com CSS.

Aspecto NReco.PdfGenerator IronPDF
Motor de renderização WebKit Qt (2012) Cromo (atual)
Segurança 20+ CVEs, abandonado Atualizações de segurança ativas
Suporte a CSS CSS2.1, CSS3 limitado CSS3 completo, Grid, Flexbox
JavaScript ES5 básico ES6+ completo
Dependências Binário wkhtmltopdf externo Autossuficiente
Suporte assíncrono Somente síncrono assíncrono/await completo
Fontes da Web Limitado Fontes completas do Google, @font-face
Teste Gratuito Com marca d'água Funcionalidade completa
Transparência nos Preços Opaco, contatar vendas Preço publicado

NReco.PdfGenerator herda todas as vulnerabilidades de segurança do wkhtmltopdf, incluindo CVEs documentados para falsificação de solicitações do lado do servidor, vulnerabilidades de leitura de arquivos locais e potencial execução remota de código. Com o wkhtmltopdf abandonado desde 2020, não há patches disponíveis para esses problemas.

O motor Chromium doIronPDFoferece suporte aos padrões web atuais, permitindo recursos modernos de CSS, como layouts Grid e Flexbox, variáveis CSS e propriedades personalizadas. A execução de JavaScript suporta sintaxe ES6+, incluindo padrões async/await.

Conversão básica de HTML para PDF

Ambas as bibliotecas lidam com a conversão básica de HTML para PDF, embora com diferentes padrões de API.

Abordagem do NReco.PdfGenerator:

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
$vbLabelText   $csharpLabel

Abordagem do IronPDF:

// NuGet: Install-Package IronPdf
using IronPdf;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

Ambas as bibliotecas requerem código mínimo para conversões básicas. NReco.PdfGenerator retorna um array byte[] que requer operações manuais de arquivo, enquantoIronPDFretorna um objeto PdfDocument com métodos convenientes como SaveAs(). O objetoIronPDFtambém oferece acesso a BinaryData para acesso a arrays de bytes e Stream para operações baseadas em stream.

Para desenvolvedores familiarizados com o fluxo de trabalho de conversão de HTML para PDF, a API doIronPDFparecerá intuitiva, ao mesmo tempo que proporciona capacidades adicionais além da conversão básica.

Conversão de URL para PDF

Converter páginas da web em documentos PDF revela diferenças de API na nomenclatura e semântica dos métodos.

Conversão de URL do NReco.PdfGenerator:

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var pdfBytes = htmlToPdf.GeneratePdfFromFile("https://www.example.com", null);
        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var pdfBytes = htmlToPdf.GeneratePdfFromFile("https://www.example.com", null);
        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
$vbLabelText   $csharpLabel

Conversão de URL do IronPDF:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}
$vbLabelText   $csharpLabel

NReco.PdfGenerator usa GeneratePdfFromFile() tanto para caminhos de arquivo quanto para URLs, o que pode ser semanticamente confuso.IronPDFfornece um método dedicado RenderUrlAsPdf que indica claramente a operação que está sendo realizada.

Tamanho e Margens de Página Personalizados

Documentos profissionais geralmente exigem dimensões de página específicas e configurações de margem. Ambas as bibliotecas suportam essas personalizações com diferentes padrões de configuração.

Configuração de página do NReco.PdfGenerator:

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        htmlToPdf.PageWidth = 210;
        htmlToPdf.PageHeight = 297;
        htmlToPdf.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("custom-size.pdf", pdfBytes);
    }
}
// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        htmlToPdf.PageWidth = 210;
        htmlToPdf.PageHeight = 297;
        htmlToPdf.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("custom-size.pdf", pdfBytes);
    }
}
$vbLabelText   $csharpLabel

Configuração de página do IronPDF:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("custom-size.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("custom-size.pdf");
    }
}
$vbLabelText   $csharpLabel

NReco.PdfGenerator requer a especificação das dimensões da página em milímetros (210×297 para A4) e usa um objeto PageMargins.IronPDFusa o enum PdfPaperSize para tamanhos padrão e fornece propriedades de margem individuais através de RenderingOptions. A classe RenderingOptions centraliza toda a configuração de página, tornando as configurações descobertas através do autocompletar da IDE.

Referência de mapeamento de API

Para equipes considerando a migração do NReco.PdfGenerator para o IronPDF, entender os mapeamentos de API ajuda a estimar o esforço e planejar a transição.

Mapeamentos de Métodos Principais

NReco.PdfGenerator IronPDF
new HtmlToPdfConverter() new ChromePdfRenderer()
GeneratePdf(html) RenderHtmlAsPdf(html)
GeneratePdfFromFile(url, output) RenderUrlAsPdf(url)
GeneratePdfFromFile(path, output) RenderHtmlFileAsPdf(path)
(não suportado) RenderHtmlAsPdfAsync(html)

Mapeamentos de Propriedades de Configuração

NReco.PdfGenerator IronPDF
Orientation = PageOrientation.Landscape RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
Size = PageSize.A4 RenderingOptions.PaperSize = PdfPaperSize.A4
Margins.Top = 10 RenderingOptions.MarginTop = 10
Zoom = 0.9f RenderingOptions.Zoom = 90
PageHeaderHtml = "..." RenderingOptions.HtmlHeader
PageFooterHtml = "..." RenderingOptions.HtmlFooter

Diferenças de Sintaxe de Placeholder

Cabeçalhos e rodapés frequentemente incluem conteúdo dinâmico, como números de página. A sintaxe do placeholder difere entre as bibliotecas:

NReco.PdfGenerator IronPDF Propósito
[page] {page} Número da página atual
[topage] {total-pages} Número total de páginas
[date] {date} Data atual
[time] {time} Current time
[title] {html-title} Título do documento
[webpage] {url} URL de origem

Equipes migrando do NReco.PdfGenerator precisam atualizar todos os templates de cabeçalho e rodapé com a nova sintaxe de placeholder.

Conversão de Valor de Zoom

O NReco.PdfGenerator usa valores flutuantes (0.0-2.0) para zoom, enquanto oIronPDFusa valores percentuais:

// NReco: Zoom = 0.75f means 75%
// IronPDF: Zoom = 75 means 75%
int ironPdfZoom = (int)(nrecoZoom * 100);
// NReco: Zoom = 0.75f means 75%
// IronPDF: Zoom = 75 means 75%
int ironPdfZoom = (int)(nrecoZoom * 100);
$vbLabelText   $csharpLabel

Comparação de Suporte Assíncrono

Aplicações web modernas se beneficiam de operações assíncronas que não bloqueiam threads. Isso é particularmente importante em aplicações ASP.NET Core lidando com solicitações concorrentes.

O NReco.PdfGenerator fornece operações apenas síncronas, que podem bloquear threads do servidor web durante a geração de PDF:

// NReco.PdfGenerator - synchronous only
var pdfBytes = converter.GeneratePdf(html);  // Blocks thread
// NReco.PdfGenerator - synchronous only
var pdfBytes = converter.GeneratePdf(html);  // Blocks thread
$vbLabelText   $csharpLabel

OIronPDFsuporta padrões completos de assíncrono/await:

//IronPDF- async support
var pdf = await renderer.RenderHtmlAsPdfAsync(html);  // Non-blocking
await pdf.SaveAsAsync("output.pdf");
//IronPDF- async support
var pdf = await renderer.RenderHtmlAsPdfAsync(html);  // Non-blocking
await pdf.SaveAsAsync("output.pdf");
$vbLabelText   $csharpLabel

Para aplicativos que geram PDFs em resposta a solicitações HTTP, o suporte assíncrono doIronPDFmelhora a escalabilidade ao liberar threads durante o processo de renderização.

Diferenciações de Dependência e Implantação

O NReco.PdfGenerator requer que o binário wkhtmltopdf esteja disponível no sistema. Isso cria desafios de implantação:

  • Binários específicos para a plataforma devem ser gerenciados (Windows .exe, Linux .so, macOS .dylib)
  • Imagens Docker requerem instalação de wkhtmltopdf
  • Pipelines CI/CD precisam de etapas de provisão de binário
  • Scanners de segurança sinalizam os CVEs conhecidos

OIronPDFé autossuficiente como um pacote NuGet:

#IronPDFinstallation - complete
dotnet add package IronPdf

# NReco.PdfGenerator installation - plus binary management
dotnet add package NReco.PdfGenerator
# Plus: install wkhtmltopdf per platform
#IronPDFinstallation - complete
dotnet add package IronPdf

# NReco.PdfGenerator installation - plus binary management
dotnet add package NReco.PdfGenerator
# Plus: install wkhtmltopdf per platform
SHELL

Equipes migrando do NReco.PdfGenerator podem remover os binários wkhtmltopdf e simplificar seu processo de implantação.

Quando as Equipes Consideram Mudar do NReco.PdfGenerator para o IronPDF

Vários fatores levam as equipes a avaliar oIronPDFcomo uma alternativa ao NReco.PdfGenerator:

Conformidade de Segurança: Organizações com requisitos de segurança enfrentam desafios quando scanners de vulnerabilidade identificam CVEs do wkhtmltopdf. Como o wkhtmltopdf foi abandonado, essas vulnerabilidades não têm caminho de remediação dentro do NReco.PdfGenerator. O mecanismo Chromium do IronPDF, que é mantido ativamente, recebe atualizações de segurança.

Requisitos Modernos de CSS: Projetos que requerem CSS Grid, Flexbox, variáveis CSS ou outras funcionalidades modernas de CSS não podem usar o mecanismo WebKit do wkhtmltopdf de 2012. Designers web muitas vezes produzem layouts que renderizam incorretamente ou não renderizam de forma alguma no NReco.PdfGenerator.

Compatibilidade com JavaScript: Aplicações que geram PDFs com conteúdo renderizado em JavaScript (gráficos, tabelas dinâmicas, valores calculados) precisam de suporte moderno for JavaScript. A limitação ES5 do wkhtmltopdf impede o uso de bibliotecas contemporâneas de JavaScript.

Arquitetura de Aplicação Assíncrona: Aplicações ASP.NET Core se beneficiam da geração assíncrona de PDF para manter a eficiência dos threads. A API somente síncrona do NReco.PdfGenerator pode criar gargalos de escalabilidade.

Simplificação de Implantação: Gerenciar binários wkhtmltopdf específicos para a plataforma em ambientes de desenvolvimento, teste e produção adiciona complexidade operacional. As equipes buscam soluções autossuficientes que simplifiquem os pipelines CI/CD.

Clareza de Preço: O planejamento de orçamento requer custos previsíveis. A precificação opaca do NReco.PdfGenerator (contato com vendas) complica a aquisição, enquanto a precificação publicada doIronPDFpermite um planejamento de orçamento direto.

Comparação de Instalação

Instalação do NReco.PdfGenerator:

Install-Package NReco.PdfGenerator
Install-Package NReco.PdfGenerator
SHELL

Além da instalação e gerenciamento do binário wkhtmltopdf específico para a plataforma.

Instalação do IronPDF:

Install-Package IronPdf
Install-Package IronPdf
SHELL

IronPDF requer uma configuração de chave de licença na inicialização da aplicação:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
$vbLabelText   $csharpLabel

Ambas as bibliotecas suportam .NET Framework 4.6.2+ e .NET Core/.NET 5+, tornando-as compatíveis com o desenvolvimento moderno .NET direcionado ao .NET 10 e C# 14.

Considerações sobre o desempenho

O motor Chromium doIronPDFtem um custo de inicialização na primeira utilização (aproximadamente 1,5 segundos para inicialização do Chromium). Renderizações subsequentes são significativamente mais rápidas. Para aplicações com requisitos de inicialização sensíveis à latência, aquecer o renderizador na inicialização da aplicação evita que esse atraso afete operações voltadas para o usuário:

// Warm up at startup
new ChromePdfRenderer().RenderHtmlAsPdf("<html></html>");
// Warm up at startup
new ChromePdfRenderer().RenderHtmlAsPdf("<html></html>");
$vbLabelText   $csharpLabel

NReco.PdfGenerator também tem sobrecarga de inicialização ao gerar o processo wkhtmltopdf, além de uma sobrecarga de memória contínua devido à gestão de processos externos.

Tomando a Decisão

A escolha entre NReco.PdfGenerator eIronPDFdepende dos seus requisitos específicos:

Considere o NReco.PdfGenerator se: Você já possui fluxos de trabalho baseados em wkhtmltopdf que funcionam corretamente, as detecções do scanner de segurança são aceitáveis no seu ambiente, você não precisa de recursos modernos de CSS ou JavaScript, e pode gerenciar a implantação de binários específicos da plataforma.

Considere oIronPDFse: A conformidade com a segurança exige tratar as CVEs do wkhtmltopdf, seus designs usam recursos modernos de CSS como Grid ou Flexbox, você precisa de suporte para async/await em aplicativos web, deseja simplificar a implantação eliminando binários externos, ou prefere licenciamento e preços transparentes.

Para equipes que desenvolvem aplicativos .NET modernos em 2025 e planejam para 2026, o motor Chromium ativamente mantido doIronPDFfornece uma base para a compatibilidade com os padrões web atuais e futuros.

Primeiros passos com o IronPDF

Para avaliar oIronPDFpara suas necessidades de geração de PDF:

  1. Instale o pacoteIronPDFNuGet: Install-Package IronPdf
  2. Revise o tutorial HTML para PDF para padrões básicos de conversão
  3. Explore a conversão de URL para PDF para captura de páginas web
  4. Configure cabeçalhos e rodapés para documentos profissionais

Os tutoriais do IronPDF fornecem exemplos abrangentes para cenários comuns, e a referência da API documenta todas as classes e métodos disponíveis.

Considerações finais

NReco.PdfGenerator eIronPDFrepresentam eras diferentes da tecnologia de geração de PDFs. NReco.PdfGenerator embrulha o motor WebKit de 2012 do wkhtmltopdf, carregando adiante tanto sua API familiar quanto suas vulnerabilidades de segurança e limitações de renderização.IronPDFusa um motor Chromium moderno com manutenção ativa, suporte aos padrões web atuais e capacidades assíncronas.

Para equipes preocupadas com a conformidade de segurança, requisitos modernos de CSS/JavaScript ou complexidade de implantação, oIronPDFoferece um caminho adiante sem a dívida técnica de dependências abandonadas. A transição requer a atualização de chamadas de API e a sintaxe de espaços reservados, mas elimina a necessidade de gerenciar binários externos e trata vulnerabilidades de segurança documentadas.

Avalie ambas opções com base nos seus requisitos específicos para postura de segurança, fidelidade de renderização, suporte a async e simplicidade de implementação. Entender as diferenças arquitetônicas delineadas nesta comparação ajudará você a tomar uma decisão informada que esteja alinhada com suas necessidades de geração de PDFs e objetivos de modernização.