IRONSOFTWAREHOME

Como usar as opções de renderização no IronPDF com C#

Curtis Chau
Curtis Chau
Updated: 4 de junho de 2026

As opções de renderização no IronPDF personalizam a geração de PDF por meio da classe ChromePdfRenderer, controlando configurações como margens, cabeçalhos, rodapés, tamanho do papel, execução de JavaScript, e tipos de mídia CSS para criar documentos PDF precisamente formatados a partir de HTML, CSS, e outras fontes de conteúdo.

Início rápido: Aplicar opções de renderização em C#
  1. Instale o IronPDF via Gerenciador de Pacotes NuGet
  2. Crie uma instância ChromePdfRenderer
  3. Configure opções de renderização através da propriedade RenderingOptions
  4. Renderize seu conteúdo (HTML, Markdown, etc.) para PDF
  5. Salve o documento PDF resultante.
  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Copie e execute este trecho de código.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaTipo = IronPdf.Rendering.PdfCssMediaTipo.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
    C#
  3. 3Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita
    arrow pointer

As opções de renderização na geração de PDFs são configurações que determinam como um documento PDF é criado, exibido e impresso. Essas opções incluem renderizar elementos de formulário, habilitar JavaScript, gerar sumários, adicionar cabeçalhos e rodapés, ajustar margens, definir tamanhos de papel e muito mais.

A classe ChromePdfRenderer no IronPDF fornece várias opções de renderização para personalizar a geração de PDF. Inclui PaperFit, um gerenciador que controla o layout do conteúdo nas páginas PDF, oferecendo diferentes estilos como layouts CSS3 responsivos ou feed contínuo. Ao trabalhar com documentos complexos, pode ser necessário mesclar ou dividir PDFs após aplicar as opções de renderização.


Como faço para usar as opções de renderização no IronPDF?

Embora muitas propriedades de opções de renderização sejam projetadas para conversão de HTML para PDF, elas também funcionam com outros tipos de conversão de PDF. Vamos gerar um arquivo Markdown em PDF e configurar a saída usando as opções de renderização. Para conversões de HTML especificamente, aprenda sobre como converter arquivos HTML em PDF ou converter strings HTML em PDF.

Por que devo configurar as opções de renderização?

A configuração das opções de renderização garante que os PDFs sejam gerados com as especificações exatas: tamanhos de papel personalizados, margens específicas, cabeçalhos e rodapés ou JavaScript ativado para conteúdo dinâmico. Esse controle é crucial ao criar novos PDFs para documentos ou relatórios profissionais.

O que acontece quando aplico várias opções de renderização?

Diversas opções de renderização trabalham em conjunto para criar o arquivo PDF final. Cada opção modifica um aspecto específico da renderização, e o IronPDF as aplica sequencialmente durante a conversão. Por exemplo, ao definir ambas as margens e cabeçalhos, o conteúdo do cabeçalho respeita as configurações de margens, a menos que substituído usando a propriedade UseMarginsOnHeaderAndFooter.

using IronPdf;

// Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
// to render HTML/CSS as a PDF document.
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
// Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    // HTML fragment to add a header at the top of every page in the PDF.
    HtmlFragment = "<h1>Header Content</h1>"
};

// Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);

// Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0;

// Define a Markdown string that will be rendered as a PDF.
// Markdown text allows basic formatting like bold and italic styles.
string md = "This is some **bold** and *italic* text.";

// Render the Markdown string to a PDF document.
// The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf");

Exemplo de opções avançadas de renderização

Este exemplo abrangente demonstra a combinação de múltiplas opções de renderização para a geração de documentos profissionais. Essa abordagem é útil quando você precisa adicionar cabeçalhos e rodapés ou trabalhar com tamanhos de papel personalizados :

using IronPdf;
using IronPdf.Rendering;

// Create renderer with advanced options
var renderer = new ChromePdfRenderer();

// Configure paper and layout settings
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set margins for professional layout
renderer.RenderingOptions.MarginTop = 40;    // mm
renderer.RenderingOptions.MarginBottom = 40; // mm
renderer.RenderingOptions.MarginLeft = 20;   // mm
renderer.RenderingOptions.MarginRight = 20;  // mm

// Enable JavaScript for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(2000); // Wait 2 seconds for JS to execute

// Add professional header with page numbers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    Height = 25,
    HtmlFragment = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");
C#

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Quais são todas as opções de renderização disponíveis?

As opções avançadas definem as configurações de renderização de PDF, como margens, orientação do papel, tamanho do papel e muito mais. Compreender essas opções ajuda quando você precisa definir margens personalizadas ou trabalhar com diferentes configurações de viewport e níveis de zoom.

Quais são as opções de renderização mais comumente usadas?

As opções de renderização mais comuns incluem configurações de margem, configuração do tamanho do papel, configuração de cabeçalho/rodapé e ativação do JavaScript . Essas opções atendem à maioria das necessidades de personalização de PDFs. Para conteúdo baseado na web, as opções de renderização em JavaScript garantem que os elementos dinâmicos sejam exibidos corretamente.

Como escolher as opções de renderização corretas?

Escolha as opções de renderização de acordo com suas necessidades: use as configurações de margem para layouts de impressão, habilite o JavaScript para conteúdo web dinâmico, configure cabeçalhos/rodapés para documentos profissionais e ajuste o tamanho do papel para formatos de saída específicos. Ao trabalhar com conteúdo web, considere os tipos de mídia CSS para uma renderização ideal.

Quando devo usar as opções avançadas de renderização?

Utilize opções avançadas de renderização para recursos especializados, como injeção de CSS personalizado, renderização matemática em LaTeX, saída em tons de cinza ou ao trabalhar com aplicações web complexas que exigem tempos de execução específicos de JavaScript . A classe WaitFor fornece controle preciso sobre atrasos de renderização para cenários complexos.

Trabalhando com Elementos de Formulário

Quando o HTML contém elementos de formulário, o IronPDF os converte automaticamente em formulários PDF interativos:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <form>
        <label>Name: <input type='text' name='name' /></label><br>
        <label>Email: <input type='email' name='email' /></label><br>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");

A seguir, encontra-se uma tabela que ilustra as diferentes opções disponíveis.

AulaChromePdfRenderer
DescriçãoUtilizado para definir opções de impressão em PDF, como tamanho do papel, DPI, cabeçalhos e rodapés.
Propriedades/funçõesTipoDescrição
CustomCookiesDictionary<string, string>Cookies personalizados para a renderização HTML. Os cookies não são persistentes entre renderizações e devem ser definidos a cada vez.
PaperFitVirtualPaperLayoutManagerUm gerenciador para configurar layouts de papel virtuais, controlando como o conteúdo será disposto em páginas PDF simulando papel. Inclui opções para Comportamento Padrão do Chrome, Zoom, Layouts CSS3 Responsivos, Ajuste à Página e configurações de página PDF no estilo Feed Contínuo.
UseMarginsOnHeaderAndFooterUseMarginsUtilize os valores de margem do documento principal ao renderizar cabeçalhos e rodapés.
CreatePdfFormsFromHtmlboolConverte todos os elementos de formulário HTML em formulários PDF editáveis. O valor padrão é verdadeiro.
CssMediaTipoPdfCssMediaTipoHabilita os estilos e folhas de estilo CSS "screen" para a mídia. O valor padrão é PdfCssMediaTipo.Screen.
CustomCssUrlstringPermite aplicar uma folha de estilo CSS personalizada ao HTML antes da renderização. Pode ser um caminho de arquivo local ou uma URL remota. Aplicável somente ao renderizar HTML para PDF.
EnableJavaScriptboolPermite a execução de JavaScript e JSON antes da renderização da página. Ideal para impressão a partir de aplicações Ajax/Angular. O valor padrão é falso.
EnableMathematicalLaTexboolPermite a renderização de elementos matemáticos LaTeX.
JavaScriptstringUma string JavaScript personalizada a ser executada após todo o HTML ter sido carregado, mas antes da renderização do PDF.
JavaScriptMessageListenerStringDelegateUm método de retorno de chamada a ser invocado sempre que uma mensagem do console JavaScript do navegador estiver disponível.
FirstPageNumberintNúmero da primeira página a ser usada nos cabeçalhos e rodapés do PDF. O valor padrão é 1.
TableOfContentsTableOfContentsTiposGera um índice de conteúdo no local no documento HTML onde é encontrado um elemento com id "IronPDF-toc".
GrayScaleboolGera um PDF em preto e branco. O valor padrão é falso.
TextHeaderITextHeaderFooterDefine o conteúdo do rodapé de cada página PDF como texto, com suporte para 'mala direta' e conversão automática de URLs em hiperlinks.
TextFooter
HtmlHeaderCabecalhoRodapeHtmlDefine o conteúdo do cabeçalho de cada página PDF como HTML. Suporta 'mala direta'.
HtmlFooter
InputEncodingEncodingA codificação de caracteres de entrada como uma string. O valor padrão é Encoding.UTF8.
MarginTopdoubleMargem superior do PDF ("papel") em milímetros. Defina como zero para impressões sem bordas e comerciais. O valor padrão é 25.
MarginRightdoubleMargem direita do PDF ("papel") em milímetros. Defina como zero para impressões sem bordas e comerciais. O valor padrão é 25.
MarginBottomdoubleMargem inferior do PDF ("papel") em milímetros. Defina como zero para impressões sem bordas e comerciais. O valor padrão é 25.
MarginLeftdoubleMargem esquerda do PDF ("papel") em milímetros. Defina como zero para impressões sem bordas e comerciais. O valor padrão é 25.
OrientacaoDoPapelOrientacaoDePapelPdfA orientação do papel PDF, como Retrato ou Paisagem. O valor padrão é Retrato.
TamanhoDoPapelTamanhoDePapelPdfDefine o tamanho do papel.
SetCustomPaperSizeinCentimetersdoubleDefine o tamanho do papel em centímetros.
SetCustomPaperSizeInInchesDefine o tamanho do papel em polegadas.
SetCustomPaperSizeinMilimetersDefine o tamanho do papel em milímetros.
SetCustomPaperSizeinPixelsOrPointsDefine o tamanho do papel em pixels da tela ou pontos da impressora.
PrintHtmlBackgroundsBooleanIndica se as cores e imagens de fundo do HTML devem ser impressas. O valor padrão é verdadeiro.
RequestContextRequestContextsSolicitar contexto para esta renderização, determinando o isolamento de certos recursos, como cookies.
TimeoutIntegerTempo limite de renderização em segundos. O valor padrão é 60.
TítuloStringNome do Documento PDF e metadados de Título, útil para mail-merge e nomeação automática de arquivos nas extensões IronPDF MVC e Razor.
ForcePaperSizeBooleanForçar que os tamanhos das páginas sejam exatamente os especificados por meio de `IronPDF redimensionando a página após gerar um PDF a partir de HTML. Isso ajuda a corrigir pequenos erros no tamanho da página ao renderizar HTML para PDF.
WaitForWaitForUm objeto wrapper que contém a configuração do mecanismo de espera, permitindo que os usuários aguardem determinados eventos antes de renderizar. Por padrão, ele não aguardará nada.

Pronto para explorar mais funcionalidades? Visite nossa página de tutoriais: Converter PDFs

Perguntas frequentes

Quais são as opções de renderização na geração de PDFs?

As opções de renderização no IronPDF são configurações que controlam como os documentos PDF são criados, exibidos e impressos por meio da classe ChromePdfRenderer. Elas incluem configurações para margens, cabeçalhos, rodapés, tamanho do papel, execução de JavaScript, tipos de mídia CSS, elementos de formulário e sumários, permitindo a personalização precisa da saída em PDF a partir de HTML, CSS e outras fontes de conteúdo.

Como faço para aplicar opções de renderização a um PDF?

Para aplicar opções de renderização no IronPDF: 1) Instale o IronPDF via NuGet, 2) Crie uma instância de ChromePdfRenderer, 3) Configure as opções através da propriedade RenderingOptions, 4) Renderize seu conteúdo (HTML, Markdown, etc.) para PDF e 5) Salve o PDF resultante. Você pode definir várias opções em uma única linha, como margens, tipo de mídia CSS, cabeçalhos e valores de tempo limite.

Posso usar opções de renderização com conteúdo que não seja HTML?

Sim, embora muitas propriedades de opções de renderização sejam projetadas para conversão de HTML para PDF, elas também funcionam com outros tipos de conversão de PDF no IronPDF. Você pode aplicar opções de renderização ao converter Markdown para PDF ou outros formatos compatíveis, obtendo o mesmo nível de controle sobre o PDF final, independentemente do tipo de conteúdo de origem.

O que é o PaperFit e como funciona?

PaperFit é um gerenciador dentro da classe ChromePdfRenderer do IronPDF que controla o layout do conteúdo em páginas PDF. Ele oferece diferentes estilos de renderização, incluindo layouts responsivos em CSS3 ou opções de alimentação contínua, ajudando a garantir que seu conteúdo se ajuste corretamente às páginas PDF de acordo com suas necessidades específicas.

Por que devo configurar as opções de renderização para meus PDFs?

Configurar as opções de renderização no IronPDF garante que seus PDFs sejam gerados com as especificações exatas necessárias para documentos profissionais. Isso inclui tamanhos de papel personalizados, margens específicas, cabeçalhos e rodapés, ou JavaScript habilitado para conteúdo dinâmico. Esse nível de controle é crucial ao criar relatórios, faturas ou qualquer documento que exija formatação precisa.

What is the function of the `PaperFit` option in IronPDF?

`PaperFit` in IronPDF’s `ChromePdfRenderer` controls content layout styles on PDF pages, providing options like responsive CSS3 layouts and continuous feed style setups.

How can IronPDF assist with rendering interactive PDF forms?

IronPDF automatically converts HTML form elements into interactive PDF forms when the `CreatePdfFormsFromHtml` property is set to true.

What is the significance of enabling `PrintHtmlBackgrounds` in IronPDF?

Enabling `PrintHtmlBackgrounds` ensures that all background colors and images defined in HTML are printed in the PDF, maintaining the visual integrity of the document.

Can IronPDF merge or split PDFs after applying rendering options?

Yes, IronPDF supports merging and splitting of PDF documents, which can be useful when combining or breaking down complex documents after rendering.

How does IronPDF handle dynamic web content rendering?

IronPDF handles dynamic web content by enabling JavaScript execution and allowing delays for JavaScript execution using the `WaitFor` class to ensure all interactive elements are fully rendered.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 20,756,830Versão:2026.7recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.7

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.