1. IronPDF
  2. Tutoriais
  3. Adicionar cabeçalhos e rodapés
Como adicionar cabeçalhos e rodapés em PDF usando o IronPDF

Adicionar cabeçalhos e rodapés em PDF usando C# e IronPDF

Jordi Bardia
Jordi Bardia
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPDF permite adicionar facilmente cabeçalhos e rodapés a documentos PDF em C# usando métodos como AddTextHeaders e AddTextFooters para texto simples, ou AddHtmlHeaders e AddHtmlFooters para conteúdo baseado em HTML com suporte completo a estilos CSS. Essa poderosa funcionalidade é essencial para a criação de PDFs profissionais com identidade visual consistente, numeração de páginas e metadados do documento.

Precisa incluir números de página, o logotipo da empresa ou a data no início ou no final de cada página de um documento PDF? O IronPDF facilita a aplicação de cabeçalhos e rodapés a PDFs em seu projeto C#. Seja para gerar relatórios, faturas ou qualquer outro documento comercial, os cabeçalhos e rodapés fornecem elementos cruciais de navegação e identificação que melhoram a usabilidade do documento.

Início rápido: Adicionar cabeçalhos e rodapés a PDFs em C#

Adicione cabeçalhos e rodapés aos seus documentos PDF sem esforço usando o IronPDF em C#. Este guia demonstra como aplicar cabeçalhos e rodapés baseados em texto com números de página e texto personalizado em segundos. Use os métodos AddTextHeaders e AddTextFooters para aprimorar sua apresentação em PDF rapidamente. Salve seu PDF atualizado com o mínimo de código, garantindo um acabamento profissional aos seus documentos.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { TextHeader = new IronPdf.TextHeaderFooter { CenterText = "Report • {date}" }, TextFooter = new IronPdf.TextHeaderFooter { RightText = "Page {page} of {total-pages}" } } }
    .RenderHtmlAsPdf("<h1>Hello World!</h1>")
    .SaveAs("withHeadersFooters.pdf");

  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe a biblioteca C# para adicionar cabeçalhos e rodapés.
  2. Carregar um PDF existente ou gerar um novo.
  3. Utilize os métodos `AddTextHeaders` e `AddTextFooters` para adicionar cabeçalhos e rodapés de texto.
  4. Utilize os métodos `AddHtmlHeaders` e `AddHtmlFooters` para adicionar cabeçalhos e rodapés HTML.
  5. Adicione cabeçalhos e rodapés no momento da renderização configurando as `RenderingOptions`

Como adiciono um cabeçalho/rodapé de texto?

Para criar um cabeçalho/rodapé apenas com texto, instancie um objeto TextHeaderFooter, adicione o texto desejado e adicione o objeto ao seu PDF. A classe TextHeaderFooter oferece uma maneira simples de adicionar elementos de texto consistentes em todas as páginas do seu documento. Este método é particularmente útil para cabeçalhos e rodapés simples que não exigem formatação ou estilização complexas.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-add-textheaderfooter.cs
using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")
$vbLabelText   $csharpLabel

Como posso adicionar cabeçalhos/rodapés durante a renderização?

Alternativamente, você pode adicionar um cabeçalho/rodapé diretamente usando o RenderingOptions do renderizador. Isso adiciona o cabeçalho e o rodapé de texto durante o processo de renderização, o que é mais eficiente do que adicioná-los depois que o PDF é criado. Essa abordagem é recomendada quando você já conhece o conteúdo do cabeçalho e do rodapé, pois reduz o tempo de processamento e garante uma formatação consistente desde o início.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-render-with-textheaderfooter.cs
using IronPdf;

// Instantiate renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and add to rendering options
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};


// Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Render PDF with header and footer
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
pdf.SaveAs("renderWithTextHeaderFooter.pdf");
Imports IronPdf

' Instantiate renderer
Dim renderer As New ChromePdfRenderer()

' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Render PDF with header and footer
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
pdf.SaveAs("renderWithTextHeaderFooter.pdf")
$vbLabelText   $csharpLabel

Como posso personalizar as propriedades de texto e divisores?

Na classe TextHeaderFooter, você pode definir o texto para as posições esquerda, central e direita. Além disso, você pode personalizar o tipo e o tamanho da fonte do texto e adicionar um divisor com uma cor personalizada, configurando as propriedades relevantes. Essas opções de personalização permitem que você crie cabeçalhos e rodapés que correspondam à identidade visual da sua empresa ou às diretrizes de estilo do documento. O recurso de linha divisória é particularmente útil para criar uma separação visual entre o cabeçalho/rodapé e o conteúdo principal.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-textheaderfooter-options.cs
using IronPdf;
using IronPdf.Font;
using IronSoftware.Drawing;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Center text", // Set the text in the center
    LeftText = "Left text", // Set left-hand side text
    RightText = "Right text", // Set right-hand side text
    Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic, // Set font
    FontSize = 16, // Set font size
    DrawDividerLine = true, // Draw Divider Line
    DrawDividerLineColor = Color.Red, // Set color of divider line
};
Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing

' Create text header
Private textHeader As New TextHeaderFooter With {
	.CenterText = "Center text",
	.LeftText = "Left text",
	.RightText = "Right text",
	.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
	.FontSize = 16,
	.DrawDividerLine = True,
	.DrawDividerLineColor = Color.Red
}
$vbLabelText   $csharpLabel

Como fica o cabeçalho de texto personalizado?

Exemplo de alinhamento de texto mostrando opções de posicionamento à esquerda, ao centro e à direita.

Quais fontes estão disponíveis por padrão?

Você pode consultar os tipos de fonte disponíveis por padrão na Referência da API do IronPDF . O IronPDF suporta uma ampla variedade de fontes padrão, incluindo Arial, Times New Roman, Helvetica, Courier e suas variações. Se você precisar de fontes personalizadas, saiba mais sobre como gerenciar fontes no IronPDF.

Como faço para definir as margens dos cabeçalhos/rodapés de texto?

Por padrão, os cabeçalhos e rodapés de texto no IronPDF vêm com margens predefinidas. Se você deseja que o cabeçalho do texto ocupe toda a largura do documento PDF, especifique valores de margem iguais a 0. Isso pode ser feito definindo as margens diretamente nas funções AddTextHeaders e AddTextFooters ou através da função RenderingOptions em ChromePdfRenderer. Compreender o controle de margens é crucial para obter layouts perfeitos em pixels, especialmente ao trabalhar com tamanhos de papel personalizados.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-textheaderfooter-margins.cs
using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

pdf.AddTextHeaders(header, 35, 30, 25); // Left Margin = 35, Right Margin  = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25); // Margin values are in mm
Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

Dim header As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

Dim footer As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

pdf.AddTextHeaders(header, 35, 30, 25) ' Left Margin = 35, Right Margin = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25) ' Margin values are in mm
$vbLabelText   $csharpLabel

Como faço para aplicar margens através das opções de renderização?

Se você adicionar valores de margem em RenderingOptions de ChromePdfRenderer, essas margens também serão aplicadas ao cabeçalho e rodapé. Essa abordagem oferece uma maneira centralizada de gerenciar as margens em todo o documento, incluindo cabeçalhos, rodapés e conteúdo principal. Para uma personalização de margens mais avançada, consulte nosso guia sobre como definir margens personalizadas.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-rendering-options-margins.cs
using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Margin values are in mm
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header;
renderer.RenderingOptions.TextFooter = footer;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
Imports IronPdf

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()

Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}

Private footer As New TextHeaderFooter With {.CenterText = "This is the footer!"}

' Margin values are in mm
renderer.RenderingOptions.MarginRight = 30
renderer.RenderingOptions.MarginLeft = 30
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25

' Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header
renderer.RenderingOptions.TextFooter = footer

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
$vbLabelText   $csharpLabel

Por que devo evitar UseMarginsOnHeaderAndFooter?

A propriedade UseMarginsOnHeaderAndFooter em RenderingOptions não é adequada para este caso de uso. Aplica os mesmos valores de margem ao cabeçalho, rodapé e conteúdo principal, o que pode fazer com que o cabeçalho se sobreponha ao corpo do documento. Esta propriedade destina-se principalmente à aplicação de cabeçalhos e rodapés a PDFs existentes usando o método AddTextHeadersAndFooters. Para um melhor controle do layout, considere usar quebras de página para gerenciar o fluxo de conteúdo.

O que é dimensionamento dinâmico de margem?

As margens estáticas representavam um problema quando o conteúdo do cabeçalho variava entre os documentos. Foram necessários ajustes não apenas nas margens do cabeçalho e rodapé, mas também na margem principal do HTML para acomodar diferentes tamanhos de cabeçalho e rodapé. Consequentemente, implementamos um recurso de dimensionamento dinâmico de margens, no qual a altura do cabeçalho e do rodapé se ajusta dinamicamente com base no conteúdo, e o HTML principal se reposiciona de acordo. Essa funcionalidade é particularmente útil ao trabalhar com layouts CSS responsivos. Use o código abaixo para testar essa funcionalidade:

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-dynamic-marigns.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
    // Enable the dynamic height feature
    MaxHeight = HtmlHeaderFooter.FragmentHeight,
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");
pdf.SaveAs("dynamicHeaderSize.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
	.HtmlFragment = "<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
	.MaxHeight = HtmlHeaderFooter.FragmentHeight
}

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")
pdf.SaveAs("dynamicHeaderSize.pdf")
$vbLabelText   $csharpLabel

Como adiciono metadados aos cabeçalhos/rodapés de texto?

Você pode adicionar facilmente metadados como números de página, data e título do PDF incorporando marcadores de posição no seu texto. Esses marcadores são automaticamente substituídos pelos valores correspondentes quando o PDF é renderizado. Essa funcionalidade é essencial para a criação de cabeçalhos e rodapés dinâmicos que se atualizam automaticamente com base nas propriedades do documento. Aqui estão todas as opções de metadados disponíveis:

  • {page}: Número da página atual.
  • {total-pages}: Número total da página.
  • {url}: URL da Web a partir da qual o documento PDF foi gerado.
  • {date}: Data atual.
  • {time}: Hora atual.
  • {html-title}: Título HTML especificado na tag title em HTML.
  • {pdf-title}: Título do PDF especificado nos metadados do PDF.

Quais marcadores devo usar com mais frequência?

Para saber mais sobre {page} e {total-pages}, consulte o Guia de Números de Página do IronPDF . Esses marcadores são os mais usados, pois fornecem informações essenciais de navegação. Os marcadores de data e hora são particularmente úteis para documentos que precisam de registro de data e hora, como relatórios ou faturas.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-mail-merge.cs
using IronPdf;

// Create header and footer
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "{page} of {total-pages}",
    LeftText = "Today's date: {date}",
    RightText = "The time: {time}",
};

TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "Current URL: {url}",
    LeftText = "Title of the HTML: {html-title}",
    RightText = "Title of the PDF: {pdf-title}",
};
Imports IronPdf

' Create header and footer
Private textHeader As New TextHeaderFooter With {
	.CenterText = "{page} of {total-pages}",
	.LeftText = "Today's date: {date}",
	.RightText = "The time: {time}"
}

Private textFooter As New TextHeaderFooter With {
	.CenterText = "Current URL: {url}",
	.LeftText = "Title of the HTML: {html-title}",
	.RightText = "Title of the PDF: {pdf-title}"
}
$vbLabelText   $csharpLabel

Como adiciono cabeçalhos/rodapés em HTML?

Você pode personalizar ainda mais seu cabeçalho/rodapé utilizando HTML e CSS. Para criar um cabeçalho/rodapé HTML, use a classe HtmlHeaderFooter. Essa abordagem oferece máxima flexibilidade, permitindo que você inclua imagens, layouts complexos e conteúdo estilizado em seus cabeçalhos e rodapés. Se você deseja manter os estilos CSS de uma folha de estilo CSS, defina LoadStylesAndCSSFromMainHtmlDocument = true nas propriedades da classe. Isso é particularmente útil ao trabalhar com fontes e ícones da web.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter.cs
using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);
Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)
$vbLabelText   $csharpLabel

Como faço para controlar as margens do cabeçalho/rodapé em HTML?

Assim como os cabeçalhos e rodapés de texto, os métodos AddHtmlHeaders e AddHtmlFooters possuem margens predefinidas. Para aplicar margens personalizadas, utilize uma sobrecarga das funções com os valores de margem especificados. Para que todo o conteúdo ocupe a largura total sem margens, defina as margens na função de sobrecarga como 0. Esse nível de controle é essencial ao criar documentos profissionais com requisitos de layout específicos.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter-margins.cs
// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);
' Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0)
pdf.AddHtmlFooters(footer, 0, 0, 0)
$vbLabelText   $csharpLabel

Posso adicionar cabeçalhos/rodapés HTML durante a renderização?

A adição de cabeçalhos e rodapés também pode ser feita diretamente através do RenderingOptions do renderizador. Isso adiciona o cabeçalho e o rodapé HTML durante o processo de renderização, o que é mais eficiente do que o pós-processamento. Este método é particularmente útil ao gerar PDFs a partir de arquivos HTML ou ao converter URLs em PDF.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter.cs
using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);
Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)
$vbLabelText   $csharpLabel

Quando devo usar cabeçalhos/rodapés de texto em vez de HTML?

Ao decidir entre cabeçalhos/rodapés em texto e em HTML, considere as vantagens e desvantagens. Se você prioriza uma renderização de PDF mais rápida, opte por cabeçalhos/rodapés de texto. Se a personalização e o estilo forem essenciais, escolha cabeçalhos/rodapés em HTML. A diferença no tempo de renderização entre cabeçalhos/rodapés em texto e em HTML é mínima quando os cabeçalhos/rodapés em HTML contêm pouco conteúdo. No entanto, esse valor aumenta conforme o tamanho e o número de elementos nos cabeçalhos/rodapés HTML aumentam.

Quais são as implicações para o desempenho?

Os cabeçalhos/rodapés de texto são renderizados mais rapidamente porque não exigem análise de HTML nem processamento de CSS. Os cabeçalhos/rodapés HTML oferecem mais flexibilidade, mas exigem tempo de renderização adicional proporcional à sua complexidade. Ao trabalhar com documentos extensos ou processamento em lote, a diferença de desempenho torna-se mais perceptível. Para obter o melhor desempenho em cenários de alto volume, consulte nosso guia sobre geração assíncrona de PDFs.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Criar PDFs

Perguntas frequentes

Como adiciono cabeçalhos e rodapés de texto a um PDF em C#?

Com o IronPDF, você pode adicionar cabeçalhos e rodapés de texto usando os métodos `AddTextHeaders` e `AddTextFooters`. Basta instanciar um objeto `TextHeaderFooter`, adicionar o texto desejado e aplicá-lo ao seu PDF. Isso proporciona uma maneira simples de adicionar elementos de texto consistentes, como números de página ou títulos de documentos, em todas as páginas.

Posso incluir números de página nos cabeçalhos ou rodapés dos meus PDFs?

Sim, o IronPDF suporta numeração de páginas dinâmica usando marcadores especiais. Você pode usar {page} para o número da página atual e {total-pages} para o número total de páginas em seus objetos TextHeaderFooter. Por exemplo, definir RightText = "Página {page} de {total-pages}" exibirá automaticamente os números de página corretos em cada página.

É possível adicionar cabeçalhos e rodapés baseados em HTML com estilo CSS?

Com certeza! O IronPDF oferece os métodos AddHtmlHeaders e AddHtmlFooters, que permitem adicionar conteúdo HTML com suporte completo a estilos CSS. Isso possibilita a criação de cabeçalhos e rodapés complexos com texto formatado, imagens e estilos personalizados para combinar com as diretrizes da sua marca.

Qual a maneira mais eficiente de adicionar cabeçalhos e rodapés a PDFs?

A abordagem mais eficiente é adicionar cabeçalhos e rodapés durante o processo de renderização usando as opções de renderização do IronPDF. Ao configurar as propriedades TextHeader e TextFooter no ChromePdfRenderer antes da renderização, você reduz o tempo de processamento em comparação com a adição desses elementos após a criação do PDF.

Posso adicionar conteúdo diferente às seções esquerda, central e direita dos cabeçalhos/rodapés?

Sim, a classe TextHeaderFooter do IronPDF oferece as propriedades LeftText, CenterText e RightText, permitindo que você insira conteúdo diferente em cada seção. Isso lhe dá flexibilidade para organizar informações como datas à esquerda, títulos no centro e números de página à direita.

Como faço para adicionar o logotipo da empresa aos cabeçalhos dos meus PDFs?

Para adicionar o logotipo da sua empresa aos cabeçalhos do seu PDF, use o método AddHtmlHeaders no IronPDF. Você pode incluir uma tag de imagem no seu conteúdo HTML apontando para o arquivo do logotipo, juntamente com qualquer estilo ou posicionamento adicional usando CSS para garantir que ele apareça exatamente onde você deseja.

Posso incluir datas nos cabeçalhos e rodapés dos meus PDFs?

Sim, o IronPDF suporta a inserção dinâmica de datas usando o marcador {date} em objetos TextHeaderFooter. Quando você inclui {date} no texto do cabeçalho ou rodapé, ele será automaticamente substituído pela data atual quando o PDF for gerado.

Jordi Bardia
Jordi Bardia
  Converse agora mesmo com a equipe de engenharia.
Engenheiro de Software
Jordi é extremamente proficiente em Python, C# e C++, e quando não está utilizando suas habilidades na Iron Software, dedica-se à programação de jogos. Compartilhando as responsabilidades por testes, desenvolvimento e pesquisa de produtos, Jordi agrega imenso valor à melhoria contínua dos produtos. Essa experiência diversificada o mantém ...
Leia mais
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.