Class HtmlHeaderFooter
A HTML Header or Footer which will be printed onto every page of the PDF. This can be used to override
When using HtmlHeaderFooter it is important to set HtmlFragment
Merge meta-data into your HTML using any of these placeholder strings: {page} {total-pages} {url} {date} {time} {html-title} {pdf-title}
Implements
Inherited Members
Namespace: IronPdf
Assembly: IronPdf.dll
Syntax
public class HtmlHeaderFooter : TextHeaderFooter, ITextHeaderFooter, ICloneableConstructors
HtmlHeaderFooter()
Declaration
public HtmlHeaderFooter()Fields
FragmentHeight
When MaxHeight is set to this values, the renderer will make sure that the margins of the page are adjusted to fit the HTML fragment.
Declaration
public const int FragmentHeight = 2147483647Field Value
| Type | Description |
|---|---|
| System.Int32 |
Properties
BaseUrl
The Base URL all URLS in the HtmlFragment will be relative to. This includes 'src' attributes on images, scripts, style-sheets and also hrefs on hyper-links.
Note: A base URL that points to a directory should end with a slash.
Base URL accepts file paths as well as URLS. If no BaseUrl is given, the HtmlHeaderFooter BaseUrl will be inherited from the main HTML document where possible.
Declaration
public string BaseUrl { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
HtmlFragment
The HTML which will be used to render the Header or Footer should be an HTML snippet rather than a complete document. It may contain styles & images.
Merge meta-data into the HtmlFragment by putting any of these placeholder strings into the text: {page} {total-pages} {url} {date} {time} {html-title} {pdf-title}. An alternative mail-merge style using the pattern <span class='total-pages'></span> is also supported.
HtmlFragment is a stand-alone HTML document which does not inherit styles or settings from your
main HTML content unless LoadStylesAndCSSFromMainHtmlDocument is set true
Declaration
public string HtmlFragment { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
LoadStylesAndCSSFromMainHtmlDocument
Loads style code blocks and links to CSS style sheets from the main HTML document (which provides the PDF content) into the HtmlHeaderFooter .
By default, HTML Headers and Footers are stand-
alone HTML documents with their own default styles. Setting LoadStylesAndCSSFromMainHtmlDocument to true will attempt to load all STYLE and LINK tags
from the main HTML document (which renders teh PDF) into the HtmlHeaderFooter.
If your main HTML document contains complex CSS frameworks, styles the HEAD or BODY element heavily or loads CSS from javascript then this method may not work as intended.
This feature is not available for RenderUrlAsPdf methods. It works for RenderHtmlAsPdf, HTMLToPdf and HtmlFileToPdf conversions only.
It is often preferable to load style sheets explicitly into your HTML Headers and Footers as STYLE and LINK tags within the HtmlFragment for granular control
Not supported in Docker mode.Declaration
public bool LoadStylesAndCSSFromMainHtmlDocument { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
MaxHeight
Maximum Height of the HTML Header / Footer in millimeters. This value must be set sufficiently high to display the full HTML header / footer content.
Declaration
public Nullable<int> MaxHeight { get; set; }Property Value
| Type | Description |
|---|---|
| System.Nullable<System.Int32> |
Methods
Clone()
Supports System.ICloneable. Creates a deep copy of this class instance.
Declaration
public object Clone()Returns
| Type | Description |
|---|---|
| System.Object | A deep clone of this instance. Use explicit casting to convert object back to the intended type. |