Criar PDF em ASP.NET: iTextSharp vs IronPDF

Quais são as principais diferenças entre o iTextSharp e o IronPDF?

iTextSharp é uma versão .NET da biblioteca Java iText, que oferece criação programática de PDFs através de sua classe de documento e manipulação de conteúdo de baixo nível em PDFs. Embora seja uma ferramenta poderosa, o uso do iTextSharp exige compreensão da estrutura de documentos PDF, manipulação de objetos do documento e posicionamento manual de elementos usando coordenadas e especificações de tamanho da página. A API é verbosa por necessidade -- a biblioteca expõe toda a complexidade da especificação PDF, o que significa que há muito a aprender antes de produzir um resultado final refinado.

O IronPDF adota uma abordagem diferente, focando na conversão de HTML para PDF usando um mecanismo de renderização do Chrome. Os desenvolvedores podem gerar arquivos PDF usando HTML e CSS, tornando a criação de PDFs tão simples quanto projetar uma página da web. O IronPDF gerencia a lógica de geração de PDFs nos bastidores, permitindo que você produza documentos com estilo moderno e suporte a JavaScript . Como o processo de renderização é baseado no Chromium, qualquer layout que funcione em um navegador moderno será reproduzido fielmente na saída em PDF — incluindo flexbox, grid, fontes da web e conteúdo gerado por JavaScript.

A consequência prática dessa diferença arquitetônica é que o iTextSharp beneficia os desenvolvedores que desejam um controle preciso, em nível de coordenadas, sobre cada byte em um arquivo PDF, enquanto o IronPDF beneficia os desenvolvedores que desejam produzir documentos visualmente refinados rapidamente, usando as habilidades que já possuem. Para a maioria dos cenários de aplicações web — faturas, relatórios, confirmações de pedidos e exportações de dados — a abordagem HTML é mais rápida de construir e mais fácil de manter.

Como instalar essas bibliotecas em um projeto .NET ?

A instalação de qualquer uma das bibliotecas começa com o Gerenciador de Pacotes NuGet . Para o iTextSharp, observe que as versões mais recentes do iText operam sob a licença AGPL , que exige que você torne seu aplicativo de código aberto ou adquira uma licença comercial:

# Install iTextSharp via Package Manager Console
Install-Package iTextSharp

# Install iTextSharp via Package Manager Console
Install-Package iTextSharp

Para o IronPDF, você pode instalá-lo através do Console do Gerenciador de Pacotes NuGet , da CLI do .NET ou pesquisando diretamente na interface do NuGet do Visual Studio:

Install-Package IronPdf

Após a instalação, o IronPDF está pronto para uso com uma única instrução using. Nenhuma configuração adicional é necessária para a geração básica de PDFs. Para cenários avançados — como definir uma chave de licença , configurar opções de renderização ou gerar PDFs em um ambiente de nuvem — consulte a documentação do IronPDF . O IronPDF oferece suporte a implantações em Linux, macOS e Windows, incluindo ambientes conteinerizados executados em Docker ou Kubernetes, o que o torna ideal para aplicações ASP.NET modernas e nativas da nuvem.

Como criar um documento PDF básico com cada biblioteca?

A maneira mais clara de entender a diferença entre as APIs é criar um PDF simples com um "Olá, Mundo!" usando as duas bibliotecas lado a lado.

using iTextSharp.text;
using iTextSharp.text.pdf;

var memoryStream = new MemoryStream();
Document pdfDoc = new Document(PageSize.A4, 25, 25, 25, 15);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
pdfDoc.Open();

var paragraph = new Paragraph("Hello World - PDF Document");
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16);
pdfDoc.Add(paragraph);
pdfDoc.Add(new Paragraph("Creating PDF documents with iTextSharp"));

pdfDoc.Close();

// Return as a downloadable file
var pdfBytes = memoryStream.ToArray();

using iTextSharp.text;
using iTextSharp.text.pdf;

var memoryStream = new MemoryStream();
Document pdfDoc = new Document(PageSize.A4, 25, 25, 25, 15);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
pdfDoc.Open();

var paragraph = new Paragraph("Hello World - PDF Document");
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16);
pdfDoc.Add(paragraph);
pdfDoc.Add(new Paragraph("Creating PDF documents with iTextSharp"));

pdfDoc.Close();

// Return as a downloadable file
var pdfBytes = memoryStream.ToArray();

Imports iTextSharp.text
Imports iTextSharp.text.pdf

Dim memoryStream As New MemoryStream()
Dim pdfDoc As New Document(PageSize.A4, 25, 25, 25, 15)
Dim writer As PdfWriter = PdfWriter.GetInstance(pdfDoc, memoryStream)
pdfDoc.Open()

Dim paragraph As New Paragraph("Hello World - PDF Document")
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16)
pdfDoc.Add(paragraph)
pdfDoc.Add(New Paragraph("Creating PDF documents with iTextSharp"))

pdfDoc.Close()

' Return as a downloadable file
Dim pdfBytes As Byte() = memoryStream.ToArray()

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
");

var pdfBytes = pdf.BinaryData;

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
");

var pdfBytes = pdf.BinaryData;

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
")

Dim pdfBytes = pdf.BinaryData

Como criar PDFs estilizados com imagens e CSS?

Os documentos formatados revelam a diferença mais significativa entre as duas bibliotecas. Ao gerar faturas, relatórios ou documentos personalizados, o estilo baseado em CSS no IronPDF reduz drasticamente a quantidade de código necessária.

using IronPdf;

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
";

var renderer = new ChromePdfRenderer();
var pdfDocument = renderer.RenderHtmlAsPdf(html);
var pdfBytes = pdfDocument.BinaryData;

using IronPdf;

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
";

var renderer = new ChromePdfRenderer();
var pdfDocument = renderer.RenderHtmlAsPdf(html);
var pdfBytes = pdfDocument.BinaryData;

Imports IronPdf

Dim html As String = "
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
"

Dim renderer As New ChromePdfRenderer()
Dim pdfDocument = renderer.RenderHtmlAsPdf(html)
Dim pdfBytes = pdfDocument.BinaryData

using iTextSharp.text;
using iTextSharp.text.pdf;

var output = new MemoryStream();
var document = new Document(PageSize.A4);
PdfWriter.GetInstance(document, output);
document.Open();

// Header -- manual font and color setup
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20,
    new BaseColor(255, 255, 255));
var headerParagraph = new Paragraph("Invoice #2024-001", titleFont);
document.Add(headerParagraph);

// Table -- each cell must be created individually
PdfPTable table = new PdfPTable(4);
table.WidthPercentage = 100;

string[] headers = { "Item", "Quantity", "Unit Price", "Total" };
foreach (var h in headers)
{
    var cell = new PdfPCell(new Phrase(h,
        FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)));
    cell.BackgroundColor = new BaseColor(242, 242, 242);
    table.AddCell(cell);
}

table.AddCell("PDF License");
table.AddCell("1");
table.AddCell("$599");
table.AddCell("$599");
document.Add(table);

var totalFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14);
document.Add(new Paragraph("Grand Total: $798", totalFont));
document.Close();

using iTextSharp.text;
using iTextSharp.text.pdf;

var output = new MemoryStream();
var document = new Document(PageSize.A4);
PdfWriter.GetInstance(document, output);
document.Open();

// Header -- manual font and color setup
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20,
    new BaseColor(255, 255, 255));
var headerParagraph = new Paragraph("Invoice #2024-001", titleFont);
document.Add(headerParagraph);

// Table -- each cell must be created individually
PdfPTable table = new PdfPTable(4);
table.WidthPercentage = 100;

string[] headers = { "Item", "Quantity", "Unit Price", "Total" };
foreach (var h in headers)
{
    var cell = new PdfPCell(new Phrase(h,
        FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)));
    cell.BackgroundColor = new BaseColor(242, 242, 242);
    table.AddCell(cell);
}

table.AddCell("PDF License");
table.AddCell("1");
table.AddCell("$599");
table.AddCell("$599");
document.Add(table);

var totalFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14);
document.Add(new Paragraph("Grand Total: $798", totalFont));
document.Close();

Imports iTextSharp.text
Imports iTextSharp.text.pdf

Dim output As New MemoryStream()
Dim document As New Document(PageSize.A4)
PdfWriter.GetInstance(document, output)
document.Open()

' Header -- manual font and color setup
Dim titleFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20, New BaseColor(255, 255, 255))
Dim headerParagraph As New Paragraph("Invoice #2024-001", titleFont)
document.Add(headerParagraph)

' Table -- each cell must be created individually
Dim table As New PdfPTable(4)
table.WidthPercentage = 100

Dim headers As String() = {"Item", "Quantity", "Unit Price", "Total"}
For Each h As String In headers
    Dim cell As New PdfPCell(New Phrase(h, FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)))
    cell.BackgroundColor = New BaseColor(242, 242, 242)
    table.AddCell(cell)
Next

table.AddCell("PDF License")
table.AddCell("1")
table.AddCell("$599")
table.AddCell("$599")
document.Add(table)

Dim totalFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14)
document.Add(New Paragraph("Grand Total: $798", totalFont))
document.Close()

Como lidar com a geração de PDFs no lado do servidor em ASP.NET?

Ambas as bibliotecas suportam a geração de PDFs no lado do servidor para aplicações ASP.NET . O padrão para retornar um PDF como um arquivo para download é semelhante, independentemente da biblioteca que gera os bytes. Os principais aspectos a serem considerados para uso em produção são gerenciamento de memória, segurança de threads e configuração de resposta. Ambas as bibliotecas usam fluxos em memória, portanto, você deve garantir que não esteja mantendo PDFs grandes na memória por mais tempo do que o necessário. O ChromePdfRenderer do IronPDF é projetado para ser instanciado por solicitação, então não há estado compartilhado para se preocupar entre solicitações concorrentes.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("invoice/{id}")]
    public IActionResult GenerateInvoice(int id)
    {
        var html = BuildInvoiceHtml(id); // your HTML template

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;

        var pdf = renderer.RenderHtmlAsPdf(html);

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

    private static string BuildInvoiceHtml(int id)
    {
        return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>";
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("invoice/{id}")]
    public IActionResult GenerateInvoice(int id)
    {
        var html = BuildInvoiceHtml(id); // your HTML template

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;

        var pdf = renderer.RenderHtmlAsPdf(html);

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

    private static string BuildInvoiceHtml(int id)
    {
        return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>";
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class PdfController
    Inherits ControllerBase

    <HttpGet("invoice/{id}")>
    Public Function GenerateInvoice(id As Integer) As IActionResult
        Dim html As String = BuildInvoiceHtml(id) ' your HTML template

        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20

        Dim pdf = renderer.RenderHtmlAsPdf(html)

        Return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
    End Function

    Private Shared Function BuildInvoiceHtml(id As Integer) As String
        Return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>"
    End Function
End Class

Como migrar do iTextSharp para o IronPDF?

A migração de um projeto iTextSharp existente para o IronPDF segue um padrão simples:

1. Substitua o código do modelo de documento por modelos HTML. Em vez de construir objetos de Paragraph, PdfPTable, e PdfPCell, construa uma string HTML ou carregue um arquivo HTML. Suas folhas de estilo CSS existentes e vistas parciais Razor podem ser reutilizadas diretamente.
2. Troque a chamada de renderização. Substitua PdfWriter.GetInstance(doc, stream) por new ChromePdfRenderer().RenderHtmlAsPdf(html).
3. Atualize a extração de bytes. Substitua memoryStream.ToArray() por pdf.BinaryData.
4. Transfira configurações avançadas. Características do iTextSharp como margens de página, criptografia e metadados de documento têm equivalentes diretos nas APIs RenderingOptions e PdfDocument do IronPDF.
5. Valide a fidelidade da saída. Execute ambas as saídas lado a lado em documentos representativos. O IronPDF geralmente produz melhores resultados visuais porque utiliza um mecanismo de renderização completo do navegador, em vez de um mecanismo de layout nativo do PDF.

Para equipes com modelos HTML existentes (de geradores de e-mail, visualizações Razor ou construtores de relatórios), a migração geralmente pode ser concluída em horas, em vez de dias. O IronPDF pode renderizar visualizações Razor diretamente em PDF dentro do ASP.NET Core, o que acelera ainda mais a migração. As equipes que investiram em design de documentos baseado em CSS — por exemplo, usando folhas de estilo de impressão para controlar quebras de página e margens — descobrirão que essas habilidades são diretamente transferíveis para o IronPDF.

Consulte o guia de migração do IronPDF para obter padrões detalhados que abrangem criptografia, carimbo e outros recursos avançados do iTextSharp.

Qual biblioteca você deve escolher?

Para desenvolvedores que estão iniciando novos projetos ou migrando do iTextSharp, os seguintes fatores se aplicam:

Licenciamento: O iTextSharp utiliza a licença AGPL para suas versões mais recentes, o que exige que você torne seu aplicativo de código aberto ou adquira uma licença comercial do iText Group. O IronPDF oferece licenciamento comercial direto, sem obrigações de código aberto. Se o seu projeto for de código fechado ou comercial, essa distinção por si só pode determinar sua escolha.

Curva de Aprendizagem: A abordagem baseada em HTML do IronPDF significa menos tempo gasto aprendendo APIs específicas de PDF. Se sua equipe conhece HTML e CSS, a geração de PDFs com o IronPDF começa imediatamente. Não há necessidade de estudar sistemas de coordenadas PDF, codificação de glifos ou incorporação de fontes -- o IronPDF lida com tudo isso de forma transparente.

Cobertura de recursos: O IronPDF oferece suporte à conformidade com PDF/A , preenchimento de formulários , marca d'água e muito mais — tudo a partir de um único pacote NuGet . Funcionalidades avançadas como assinaturas digitais e fusão de PDFs também estão incluídas sem dependências adicionais.

Caminho de migração: A migração do iTextSharp para o IronPDF envolve a substituição do código de manipulação de documentos por modelos HTML e a atualização da chamada de renderização. A qualidade da saída é normalmente superior porque o IronPDF utiliza um mecanismo de navegador completo, e o código resultante é significativamente mais curto e mais fácil de manter.

Para obter informações básicas sobre como funcionam os mecanismos de renderização de PDF e o que os diferencia, a documentação da Mozilla sobre PDFs e os recursos de especificação de PDF da Adobe fornecem um contexto útil. O site oficial do iText Group descreve os termos da AGPL em detalhes.

Quais são os seus próximos passos?

Para começar a usar o IronPDF em seu projeto ASP.NET :

1. Instale o pacote NuGet: Install-Package IronPdf
2. Adicione using IronPdf; ao seu arquivo
3. Crie um ChromePdfRenderer e chame RenderHtmlAsPdf() com seu HTML
4. Retorne pdf.BinaryData como um FileResult do seu controlador

Explore estes recursos para aprofundar o seu conhecimento:

• Documentação do IronPDF HTML para PDF -- opções completas de renderização e exemplos
• Guia de geração de PDFs do ASP.NET Core -- Padrões de renderização de visualização e controlador Razor
• Segurança e criptografia de PDF -- proteção por senha e permissões
• Fusão e divisão de PDFs -- combinando vários documentos
• Teste gratuito do IronPDF -- experimente todos os recursos sem marca d'água durante o desenvolvimento.