Crie um gerador de PDF em .NET Core com IronPDF.

O que torna um gerador de PDF .NET Core confiável?

Um gerador de PDF confiável for .NET Core deve oferecer renderização baseada no Chrome para conversão precisa de HTML para PDF, suportar implantação multiplataforma sem dependências nativas e fornecer uma API completa para criar, editar e manipular documentos PDF em ambientes conteinerizados.

O IronPDF fornece uma biblioteca PDF baseada no Chrome e no .NET Core que converte HTML em PDF sem dependências nativas, permitindo uma implantação tranquila em Docker e compatibilidade entre plataformas para engenheiros que desenvolvem aplicativos em contêineres.

A criação de documentos PDF em aplicações .NET Core requer uma biblioteca PDF que manipule conteúdo HTML, mantenha a formatação e ofereça suporte à implantação multiplataforma. Seja você um desenvolvedor de APIs web ASP.NET Core ou de aplicativos de console, um gerador de PDF .NET Core confiável simplifica o processo de criação de documentos a partir de diversas fontes.

Inicie um teste gratuito e descubra por que os desenvolvedores escolhem o IronPDF para geração de PDFs de missão crítica em ambientes de produção.

IronPDF se destaca como uma biblioteca PDF completa for .NET Core . Ele utiliza um mecanismo de renderização do Chrome para criar documentos PDF com precisão perfeita em cada pixel. Essa abordagem permite que você utilize seus conhecimentos de HTML e CSS para gerar arquivos PDF sem precisar aprender APIs complexas de layout de PDF. A extensa documentação e os exemplos de código da biblioteca facilitam a implementação.

Como o IronPDF simplifica a geração de documentos PDF no .NET Core?

O IronPDF transforma a tarefa tradicionalmente complexa de geração de PDFs em um código simples que qualquer desenvolvedor .NET pode implementar. A biblioteca utiliza a classe ChromePdfRenderer para converter strings HTML , arquivos ou URLs diretamente para o formato PDF. Essa abordagem de API fluente oferece amplas opções de personalização , mantendo o alto desempenho em diferentes plataformas.

O verdadeiro poder reside na forma como o IronPDF lida com a conversão de conteúdo HTML em arquivos PDF profissionais. Em vez de posicionar ou desenhar elementos manualmente, você escreve HTML padrão com estilos CSS, e a biblioteca cuida da conversão. Os arquivos PDF resultantes são documentos completos, nos quais os usuários podem selecionar e pesquisar texto , e não apenas imagens de uma página.

Além da geração básica de PDFs, as ferramentas avançadas de edição do IronPDF permitem mesclar documentos , adicionar marcas d'água , inserir anotações e muito mais.

O padrão principal é: criar um ChromePdfRenderer, configurar seu RenderingOptions, chamar um dos três métodos de renderização (RenderHtmlAsPdf, RenderHtmlFileAsPdf ou RenderUrlAsPdf) e salvar o PdfDocument resultante. Os três métodos retornam o mesmo tipo de objeto, portanto o código de pós-processamento é reutilizável independentemente da origem.

Como instalar o IronPDF através do gerenciador de pacotes NuGet ?

Para começar a usar o IronPDF no Visual Studio, basta instalar um único pacote NuGet . Abra o Console do Gerenciador de Pacotes NuGet e execute:

Install-Package IronPdf

Install-Package IronPdf

Ou, usando a CLI do .NET :

dotnet add package IronPdf

dotnet add package IronPdf

Este pacote único fornece toda a funcionalidade necessária para criar, editar e gerar arquivos PDF em aplicações .NET Core . A instalação configura automaticamente o projeto para geração de PDFs em ambientes Windows, Linux e Docker. Os ambientes de execução suportados incluem .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5 até .NET 10 e .NET Standard 2.0+.

Como criar seu primeiro documento PDF a partir de HTML?

O exemplo abaixo cria um documento de fatura dinâmico a partir de uma string HTML — um padrão que pode ser diretamente aplicado a qualquer tipo de documento que combine um modelo fixo com dados em tempo de execução:

using IronPdf;
using System.Text;

// Configure the Chrome renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Build HTML content with embedded CSS and dynamic data
var htmlBuilder = new StringBuilder();
htmlBuilder.Append(@"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; font-size: 14px; }
            .invoice-header { background: #f0f0f0; padding: 20px; }
            table { width: 100%; border-collapse: collapse; }
            th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
        </style>
    </head>
    <body>
        <div class='invoice-header'>
            <h1>Invoice #INV-2024-001</h1>
            <p>Date: " + DateTime.Nãow.ToString("MM/dd/yyyy") + @"</p>
        </div>
        <table>
            <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>");

for (int i = 0; i < 3; i++)
{
    htmlBuilder.Append($"<tr><td>Product #{i + 1}</td><td>{i + 1}</td><td>$25.00</td></tr>");
}

htmlBuilder.Append(@"
        </table>
        <p><strong>Total: $75.00</strong></p>
    </body>
    </html>");

// Convert HTML string to a PDF document and save
PdfDocument pdfDoc = renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
pdfDoc.SaveAs("invoice.pdf");

using IronPdf;
using System.Text;

// Configure the Chrome renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Build HTML content with embedded CSS and dynamic data
var htmlBuilder = new StringBuilder();
htmlBuilder.Append(@"
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; font-size: 14px; }
            .invoice-header { background: #f0f0f0; padding: 20px; }
            table { width: 100%; border-collapse: collapse; }
            th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
        </style>
    </head>
    <body>
        <div class='invoice-header'>
            <h1>Invoice #INV-2024-001</h1>
            <p>Date: " + DateTime.Nãow.ToString("MM/dd/yyyy") + @"</p>
        </div>
        <table>
            <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>");

for (int i = 0; i < 3; i++)
{
    htmlBuilder.Append($"<tr><td>Product #{i + 1}</td><td>{i + 1}</td><td>$25.00</td></tr>");
}

htmlBuilder.Append(@"
        </table>
        <p><strong>Total: $75.00</strong></p>
    </body>
    </html>");

// Convert HTML string to a PDF document and save
PdfDocument pdfDoc = renderer.RenderHtmlAsPdf(htmlBuilder.ToString());
pdfDoc.SaveAs("invoice.pdf");

Imports IronPdf
Imports System.Text

' Configure the Chrome renderer
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4

' Build HTML content with embedded CSS and dynamic data
Dim htmlBuilder As New StringBuilder()
htmlBuilder.Append("
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; font-size: 14px; }
            .invoice-header { background: #f0f0f0; padding: 20px; }
            table { width: 100%; border-collapse: collapse; }
            th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
        </style>
    </head>
    <body>
        <div class='invoice-header'>
            <h1>Invoice #INV-2024-001</h1>
            <p>Date: " & DateTime.Now.ToString("MM/dd/yyyy") & "</p>
        </div>
        <table>
            <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>")

For i As Integer = 0 To 2
    htmlBuilder.Append($"<tr><td>Product #{i + 1}</td><td>{i + 1}</td><td>$25.00</td></tr>")
Next

htmlBuilder.Append("
        </table>
        <p><strong>Total: $75.00</strong></p>
    </body>
    </html>")

' Convert HTML string to a PDF document and save
Dim pdfDoc As PdfDocument = renderer.RenderHtmlAsPdf(htmlBuilder.ToString())
pdfDoc.SaveAs("invoice.pdf")

Observe como o CSS reside dentro do bloco <style> e é aplicado automaticamente durante a renderização. O método RenderHtmlAsPdf retorna um objeto PdfDocument, dando controle total sobre o arquivo gerado. Para cenários mais avançados, explore margens e tamanhos de papel personalizados. Ambas as opções permitem personalizar a saída para corresponder às especificações exatas de impressão ou às diretrizes da marca, sem alterar o modelo HTML subjacente.

Como gerar arquivos PDF a partir de URLs e páginas da web?

O IronPDF se destaca na conversão de páginas da web existentes em arquivos PDF. Essa funcionalidade é valiosa ao gerar documentos PDF a partir de painéis de relatórios ou formulários online:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Wait for all assets to finish loading before capturing
renderer.RenderingOptions.WaitFor.RenderDelay(1000);

PdfDocument pdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

string filePath = Path.Combine(Directory.GetCurrentDirectory(), "webpage.pdf");
pdfDocument.SaveAs(filePath);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Wait for all assets to finish loading before capturing
renderer.RenderingOptions.WaitFor.RenderDelay(1000);

PdfDocument pdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

string filePath = Path.Combine(Directory.GetCurrentDirectory(), "webpage.pdf");
pdfDocument.SaveAs(filePath);

Imports IronPdf
Imports System.IO

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

' Wait for all assets to finish loading before capturing
renderer.RenderingOptions.WaitFor.RenderDelay(1000)

Dim pdfDocument As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

Dim filePath As String = Path.Combine(Directory.GetCurrentDirectory(), "webpage.pdf")
pdfDocument.SaveAs(filePath)

A biblioteca gerencia a execução de JavaScript , carrega imagens e folhas de estilo externas e mantém o layout responsivo durante a conversão. Saiba mais sobre como converter URLs em PDF no guia de URL para PDF . Você também pode configurar os cabeçalhos de solicitação HTTP para autenticação e gerenciar cookies para conteúdo baseado em sessão.

Quais recursos avançados de PDF estão disponíveis para relatórios complexos?

Documentos PDF profissionais geralmente exigem cabeçalhos, rodapés e campos de formulário interativos além do conteúdo básico. O IronPDF oferece métodos para adicionar cabeçalhos, rodapés e marcas d'água . A API de cabeçalhos e rodapés oferece controle total sobre a apresentação do documento:

var renderer = new ChromePdfRenderer();

// Company header on every page
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center;font-weight:bold;'>Company Report</div>"
};

// Automatic page numbering in footer
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:right;'>Page {page} of {total-pages}</div>"
};

// Render an HTML form as a fillable PDF form
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='text' name='name' placeholder='Enter your name'/>
        <label>Email:</label>
        <input type='email' name='email' placeholder='email@example.com'/>
        <button type='submit'>Submit</button>
    </form>";

PdfDocument formDocument = renderer.RenderHtmlAsPdf(formHtml);
formDocument.SaveAs("form.pdf");

var renderer = new ChromePdfRenderer();

// Company header on every page
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center;font-weight:bold;'>Company Report</div>"
};

// Automatic page numbering in footer
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:right;'>Page {page} of {total-pages}</div>"
};

// Render an HTML form as a fillable PDF form
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='text' name='name' placeholder='Enter your name'/>
        <label>Email:</label>
        <input type='email' name='email' placeholder='email@example.com'/>
        <button type='submit'>Submit</button>
    </form>";

PdfDocument formDocument = renderer.RenderHtmlAsPdf(formHtml);
formDocument.SaveAs("form.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Company header on every page
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center;font-weight:bold;'>Company Report</div>"
}

' Automatic page numbering in footer
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:right;'>Page {page} of {total-pages}</div>"
}

' Render an HTML form as a fillable PDF form
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Dim formHtml As String = "
    <form>
        <label>Name:</label>
        <input type='text' name='name' placeholder='Enter your name'/>
        <label>Email:</label>
        <input type='email' name='email' placeholder='email@example.com'/>
        <button type='submit'>Submit</button>
    </form>"

Dim formDocument As PdfDocument = renderer.RenderHtmlAsPdf(formHtml)
formDocument.SaveAs("form.pdf")

Este exemplo demonstra como aplicar cabeçalhos consistentes em todas as páginas e criar campos de formulário interativos dentro do documento PDF. O mecanismo lida automaticamente com a numeração de páginas e a renderização de campos de formulário. Para relatórios complexos, implemente sumários , marcadores e quebras de página personalizadas .

Formulário PDF interativo com cabeçalho "Relatório da Empresa", campos de entrada de Nãome e E-mail com estilo profissional, bordas visíveis e texto de exemplo, botão Enviar com efeito de foco, demonstrando a capacidade do IronPDF de converter formulários HTML em documentos PDF preenchíveis, preservando o estilo e a funcionalidade.

Como melhorar o desempenho com operações assíncronas no ASP.NET Core?

Para aplicações web que lidam com múltiplas solicitações de geração de PDF, as operações assíncronas melhoram a capacidade de resposta, liberando threads enquanto o mecanismo do Chrome renderiza:

using IronPdf;
using Microsoft.AspNetCore.Mvc;

// Reusable async PDF generation helper
async Task<byte[]> GeneratePdfAsync(string htmlContent)
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
    PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);
    return pdf.BinaryData;
}

// ASP.NET Core minimal API endpoint
app.MapPost("/invoices", async ([FromBody] InvoiceData data) =>
{
    string html = BuildInvoiceHtml(data);
    byte[] pdfBytes = await GeneratePdfAsync(html);
    return Results.File(pdfBytes, "application/pdf", "invoice.pdf");
});

using IronPdf;
using Microsoft.AspNetCore.Mvc;

// Reusable async PDF generation helper
async Task<byte[]> GeneratePdfAsync(string htmlContent)
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
    PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);
    return pdf.BinaryData;
}

// ASP.NET Core minimal API endpoint
app.MapPost("/invoices", async ([FromBody] InvoiceData data) =>
{
    string html = BuildInvoiceHtml(data);
    byte[] pdfBytes = await GeneratePdfAsync(html);
    return Results.File(pdfBytes, "application/pdf", "invoice.pdf");
});

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

' Reusable async PDF generation helper
Async Function GeneratePdfAsync(htmlContent As String) As Task(Of Byte())
    Dim renderer As New ChromePdfRenderer()
    renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
    Dim pdf As PdfDocument = Await renderer.RenderHtmlAsPdfAsync(htmlContent)
    Return pdf.BinaryData
End Function

' ASP.NET Core minimal API endpoint
app.MapPost("/invoices", Async Function(<FromBody> data As InvoiceData) As Task(Of IResult)
    Dim html As String = BuildInvoiceHtml(data)
    Dim pdfBytes As Byte() = Await GeneratePdfAsync(html)
    Return Results.File(pdfBytes, "application/pdf", "invoice.pdf")
End Function)

Esse padrão permite que aplicativos ASP.NET Core gerem arquivos PDF sem bloquear o pool de threads. A saída em formato de array de bytes funciona para endpoints de API que retornam arquivos diretamente para os clientes. Para operações em lote, considere o processamento paralelo para renderizar vários documentos simultaneamente e fluxos de memória para reduzir a sobrecarga de leitura/gravação em disco.

O método Results.File() define o tipo de conteúdo application/pdf correto para que os navegadores solicitem o download ou exibam o arquivo diretamente. Para mais informações sobre padrões assíncronos no ASP.NET Core, consulte a documentação oficial da Microsoft .

Quais são as principais considerações de implantação?

O IronPDF suporta implantação em diversos ambientes. Para contêineres Docker, inclua as dependências necessárias em um Dockerfile , conforme descrito no guia de implantação do Docker. A biblioteca funciona no Windows Server , em distribuições Linux e em plataformas de nuvem como Azure e AWS . Cada ambiente pode exigir configurações específicas para fontes e renderização, mas a API principal permanece consistente.

Para implantações em contêineres, considere usar o IronPDF como um contêiner remoto para separar a geração de PDFs da aplicação principal. Essa abordagem melhora a escalabilidade e permite uma melhor gestão de recursos. A documentação da Microsoft sobre a implementação do .NET Core aborda práticas recomendadas adicionais para ambientes de produção.

Está pronto para começar a criar seu gerador de PDF for .NET Core ?

O IronPDF transforma a geração de PDFs no .NET Core de um desafio complexo em uma implementação simples. Com suporte para conteúdo HTML, um conjunto robusto de recursos e comportamento consistente em todas as plataformas, ele é ideal para desenvolvedores que precisam gerar documentos PDF de forma confiável. Os recursos de segurança da biblioteca, incluindo criptografia e assinaturas digitais, garantem que os documentos atendam aos requisitos de conformidade.

Comece com um teste gratuito para explorar todos os recursos sem limitações. A documentação fornece exemplos e guias abrangentes para ajudar a criar arquivos PDF profissionais que atendam aos requisitos exatos. Seja para criar sistemas de faturamento, gerar relatórios ou converter conteúdo web existente, o IronPDF oferece as ferramentas para entregar resultados perfeitos em cada detalhe.

Para implantações em produção, explore opções de licenciamento que se adequem à escala do projeto. Uma biblioteca de PDFs de qualidade traz benefícios através da redução do tempo de desenvolvimento e da obtenção de resultados consistentes e profissionais em todas as aplicações .NET . A equipe de suporte e os guias de solução de problemas do IronPDF garantem que você nunca fique preso ao implementar a funcionalidade de PDF.