Converter HTML para PDF em ASP.NET Core com C# -- Guia IronPDF

Qual é a aparência do PDF gerado?

A classe ChromePdfRenderer lida com toda a renderização complexa, garantindo que sua estrutura HTML, estilos CSS e até mesmo JavaScript sejam renderizados corretamente na saída PDF final. O valor de retorno é um objeto PdfDocument cuja propriedade BinaryData você pode transmitir diretamente para o navegador como um download de arquivo.

Como converter strings HTML dinâmicas?

Ao trabalhar com conteúdo dinâmico, como relatórios baseados em banco de dados, use RenderHtmlAsPdf para converter strings HTML diretamente. Este método aceita qualquer marcação HTML válida e retorna um PDF totalmente renderizado:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = BuildDynamicHtml() ' your method to generate HTML
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("dynamic-report.pdf")

Essa abordagem funciona bem para gerar documentos PDF a partir de modelos HTML preenchidos com dados em tempo real, envios de formulários ou qualquer conteúdo gerado dinamicamente. O mecanismo de renderização preserva todo o estilo CSS, incluindo fontes personalizadas, cores e formatação de tabelas. Quando seu HTML faz referência a folhas de estilo ou imagens externas usando caminhos relativos, passe um baseUrl como o segundo argumento para que o renderizador possa resolver esses ativos corretamente.

Como converter arquivos HTML estáticos do disco?

Para modelos HTML armazenados como arquivos físicos, use RenderHtmlFileAsPdf para convertê-los sem carregá-los na memória primeiro. Isso é eficiente para modelos grandes e evita concatenação de strings:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html")
pdf.SaveAs("report.pdf")

Este método resolve automaticamente os caminhos relativos para folhas de estilo CSS, imagens e outros recursos externos referenciados no arquivo. Ele funciona bem quando sua equipe de design mantém arquivos de modelo HTML separados, fora da base de código C# do aplicativo. O método suporta consultas de mídia CSS para impressão e fontes personalizadas , de modo que os modelos criados para ambientes de impressão sejam renderizados fielmente sem configuração adicional.

Como converter um URL de página da web em PDF?

Para capturar uma página web ao vivo ou renderizar uma página acessível por URL como PDF, use RenderUrlAsPdf. Este método inicia o mecanismo do Chrome, navega até o URL, aguarda o carregamento completo da página e, em seguida, captura a saída renderizada:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
Dim pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")
pdf.SaveAs("webpage.pdf")

A opção WaitFor.RenderDelay diz ao renderizador para pausar após o carregamento da página antes de capturar. Isso é valioso para aplicativos de página única que constroem seu DOM por meio de JavaScript após a chegada da resposta HTML inicial. Definir EnableJavaScript = true ativa o mecanismo completo do JavaScript do Chrome, para que gráficos, grades de dados e outros componentes renderizados em JavaScript apareçam no PDF exatamente como aparecem em um navegador.

Qual é a aparência da interface do formulário?

Como os dados do formulário aparecem no PDF gerado?

Para cenários de documentos mais complexos, você pode integrar formulários PDF ou editar modelos PDF existentes com campos pré-preenchidos. A biblioteca também oferece suporte a assinaturas digitais para documentos e contratos legais, permitindo adicionar assinaturas criptograficamente verificáveis ​​a qualquer documento gerado.

Um aspecto importante a considerar ao incorporar dados do usuário em strings HTML é a higienização. Sempre utilize caracteres de escape para strings fornecidas pelo usuário antes de inseri-las no HTML para evitar problemas de injeção de código. Uma chamada simples System.Web.HttpUtility.HtmlEncode(model.CustomerName) em cada campo mantém o modelo seguro antes de passá-lo para o renderizador.

Como configurar cabeçalhos, rodapés e marcas d'água?

Documentos PDF profissionais geralmente exigem cabeçalhos e rodapés em todas as páginas, além de marcas d'água para documentos rascunho ou confidenciais. IronPDF lida com ambos através de propriedades no objeto RenderingOptions e o método ApplyWatermark no resultante PdfDocument:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 20,
    .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>", 30, VerticalAlignment.Middle, HorizontalAlignment.Center)
pdf.SaveAs("report-with-watermark.pdf")

Os espaços reservados {page} e {total-pages} no HTML do rodapé são automaticamente substituídos no momento da renderização, para que você obtenha números de página corretos sem qualquer pós-processamento. Você também pode adicionar números de página , imagens de fundo ou sobreposições em primeiro plano , e carimbos de texto ou imagem personalizados .

Como usar o CSS Print Media para controlar o layout de PDFs?

Para garantir que sua saída em PDF corresponda às expectativas, use regras de CSS @media print e a configuração PdfCssMediaType.Print. O IronPDF oferece suporte completo ao controle de quebras de página e tamanhos de papel personalizados :

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
renderer.RenderingOptions.ViewPortWidth = 1024
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

Dim html As String = "
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

O uso de CSS para impressão garante que seus documentos PDF mantenham a formatação profissional, ocultando elementos desnecessários da web, como menus de navegação ou botões interativos. Definindo CssMediaType = PdfCssMediaType.Print informa ao renderizador para aplicar suas regras @media print em vez dos estilos de tela, o que normalmente remove decorações de plano de fundo e ajusta a tipografia para saída de impressão. Você também pode configurar margens personalizadas por página e controlar a orientação e rotação da página para relatórios em formato amplo ou rotacionados.

A especificação W3C CSS Paged Media define como propriedades como @page, page-break-before e widows devem se comportar na saída em páginas. O mecanismo Chrome do IronPDF segue essa especificação de perto, portanto, os estilos escritos de acordo com o padrão CSS são traduzidos com precisão para o PDF sem ajustes manuais.