Como escolher uma biblioteca de geração de documentos for .NET 8

iTextSharp — Não Compatível com .NET 8

iTextSharp (a porta original for .NET do iText) não é atualizado desde 2018. Ele visa apenas o .NET Framework:

erro NU1202: Pacote iTextSharp 5.5.13 não é compatível com net8.0

O caminho de migração é iText 7, que tem uma API diferente e requer conformidade com AGPL (tornar sua aplicação inteira open-source) ou licenciamento comercial. Preços não são publicados — dados de terceiros sugerem $15,000–$210,000/ano.

Envoltórios wkhtmltopdf — Falhas de Carregamento de DLL no .NET 8

Envoltórios C# em torno de wkhtmltopdf (DinkToPdf, Rotativa, NReco.PdfGenerator) falham com erros específicos de plataforma que são exclusivos do modelo de implantação do .NET 8:

DinkToPdf — biblioteca nativa não encontrada:

System.DllNotFoundException: Não foi possível carregar a DLL 'libwkhtmltox'

Rotativa.AspNetCore — requer configuração manual do caminho binário que conflita com a implantação container-first do .NET 8:

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

TuesPechkin / NReco — incompatibilidade de arquitetura:

System.BadImageFormatException: Não foi possível carregar o arquivo ou assembly

Esses erros refletem um problema mais profundo: wkhtmltopdf foi arquivado em julho de 2024 com CVEs não corrigidos. A arquitetura binária nativa é anterior às melhorias de detecção de plataforma do .NET 8. Não há correção — apenas migração para uma biblioteca diferente.

PdfSharp— Falhas do System.Drawing.Common no Linux

PdfSharp depende do System.Drawing.Common, que a Microsoft descontinuou para plataformas não Windows no .NET 6. No .NET 8, isso gera falhas em tempo de execução ao implantar no Linux ou Docker:

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

Desde o início de 2026,PdfSharp6.x tem trabalhado para remover essa dependência, mas o suporte multiplataforma permanece incompleto. Para implantações somente no Windows,PdfSharpfunciona com .NET 8. Para Linux, Docker ou implantações na nuvem, é pouco confiável.

IronPDF— Suporte completo ao .NET 8, multiplataforma

IronPDF visa net8.0 nativamente com renderização Chromium embutida. Sem dependência do System.Drawing.Common, sem gerenciamento de binários nativos, sem configuração específica de plataforma.

Integração mínima de API (o padrão principal do .NET 8):

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

Para equipes utilizando o padrão de controlador, o mesmo código funciona dentro de uma ação do controlador — RenderHtmlAsPdf retorna um PdfDocument que você pode converter para bytes com .BinaryData.

Licenciamento: Licença perpétua a partir de US$ 749 (Lite — 1 desenvolvedor, 1 projeto). Professional: US$ 1.499 (10 desenvolvedores). Enterprise: US$ 2.999 (ilimitado). Publicado em ironpdf.com.

QuestPDF— Compatível com .NET 8, Sem HTML

QuestPDF funciona com .NET 8 sem dependências de plataforma. Sua API fluente em C# cria documentos programaticamente — sem parser HTML, sem mecanismo de CSS, sem mecanismo de navegador:

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

QuestPDF não converte HTML. Se o seu fluxo de trabalho usa modelos HTML (visualizações Razor, exportações de painel, arquivamento de conteúdo da web), você precisa de uma biblioteca diferente. A Licença Comunitária cobre negócios com receita anual inferior a US$ 1 milhão; acima disso, é necessário licenciamento comercial.

iText 7— Compatível com .NET 8, Licenciado AGPL

iText 7 (o sucessor do iTextSharp) suporta .NET 8. O complemento pdfHTML fornece conversão de HTML para PDF com um parser personalizado — não um mecanismo de navegador, então recursos modernos de CSS (Flexbox, Grid) não são renderizados corretamente.

Licenciamento: AGPL para uso open source, licenciamento comercial (assinatura, preços não publicados) para aplicativos proprietários. O iText mudou para licenciamento comercial baseado em assinatura em 2024.

Imagem padrão do Debian (Recomendado)

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app

#IronPDFworks without additional apt-get installs
# Chromium dependencies are handled internally

COPY --from=build /app/publish .

ENV DOTNET_RUNNING_IN_CONTAINER=true
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyApp.dll"]

Imagem Alpine (Pegada menor)

FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
WORKDIR /app

# Alpine requires explicit Chromium dependencies
RUN apk add --no-cache chromium nss freetype harfbuzz ca-certificates ttf-freefont

COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

A imagem do Debian não requer pacotes adicionais. A imagem Alpine é menor mas necessita da instalação explícita da biblioteca Chromium. Para a maioria das implantações, a imagem padrão do Debian é mais simples e confiável.

De iTextSharp para IronPDF

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

De Wrappers do wkhtmltopdf para IronPDF

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

A superfície da API é mais simples em ambos os casos. O principal custo de migração é testar seus modelos HTML existentes contra o novo renderizador para verificar se a saída corresponde às expectativas.