Class PdfDocument

Inheritance

System.Object

PdfClientAccessor

PdfDocument

Implements

IPdfDocumentId

System.IDisposable

Namespace: IronPdf

Assembly: IronPdf.dll

Syntax

public class PdfDocument : PdfClientAccessor, IPdfDocumentId

Constructors

PdfDocument(Byte[], String, String)

Opens an existing PDF document for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public PdfDocument(byte[] PdfData, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.Byte[]	PdfData	The PDF file data as byte array.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Exceptions

Type	Condition
System.IO.IOException	Exception thrown if can not be opened.

PdfDocument(Stream, String, String)

Opens an existing PDF document for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public PdfDocument(Stream PdfDataStream, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.IO.Stream	PdfDataStream	The PDF file data as a Stream.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Exceptions

Type	Condition
System.IO.IOException	Exception thrown if can not be opened.

PdfDocument(String, String, String)

Opens an existing PDF document for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public PdfDocument(string PdfFilePath, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.String	PdfFilePath	The PDF file path.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Exceptions

Type	Condition
System.IO.IOException	Exception thrown if can not be opened.
System.ArgumentException	`PdfFilePath` is null, empty, or consists only of white-space characters.

PdfDocument(Uri, String, String)

Opens an existing PDF document from the specified Uri for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public PdfDocument(Uri PdfUri, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.Uri	PdfUri	The Uri to the PDF.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Exceptions

Type	Condition
IronPdfProductException	Exception thrown if PDF cannot be found at URI or if password is incorrect.

Properties

Annotations

Annotations collection

Declaration

public PdfAnnotationCollection Annotations { get; }

Property Value

Type	Description
PdfAnnotationCollection

Attachments

Collection of attachments contained within the pdf document

Declaration

public PdfAttachmentCollection Attachments { get; }

Property Value

Type	Description
PdfAttachmentCollection

BinaryData

Saves the PDF as byte array, including any changes. For incremental saves, see BinaryDataIncremental

Declaration

public byte[] BinaryData { get; }

Property Value

Type	Description
System.Byte[]	The PDF file as a byte array.

BinaryDataIncremental

Saves the PDF as byte array with changes appended to the end of the file. For non-incremental saves, see BinaryData

For information on how to enable incremental saves see SaveAsRevision(String)

Declaration

public byte[] BinaryDataIncremental { get; }

Property Value

Type	Description
System.Byte[]	The PDF file as a byte array.

Bookmarks

Hierarchy of navigational bookmarks contained at the top level of the document

Declaration

public PdfBookMarkCollection Bookmarks { get; }

Property Value

Type	Description
PdfBookMarkCollection

Form

Gets an object returning any PDF editable form fields which can have their values both read and set programmatically.

Declaration

public PdfForm Form { get; }

Property Value

Type	Description
PdfForm	The form.

MetaData

MetaData information settings for the PDF.

Allows File meta-data to be read and set including: Authors, File Dates, Keywords, Title and Subject

Declaration

public PdfMetaData MetaData { get; }

Property Value

Type	Description
PdfMetaData	MetaData settings for this PDF as an instance of PdfMetaData

OwnerPassword

Sets the owner password and enables 128-bit encryption of PDF content. An owner password is one used to enable and disable all other security settings.

OwnerPassword must be set to a non empty string value forAllowUserCopyPasteContent,AllowUserAnnotations,AllowUserFormData,AllowUserPrinting andAllowUserEdits to be restricted.

Declaration

public string OwnerPassword { get; set; }

Property Value

Type	Description
System.String

PageCount

Gets the number of pages in the PDF document.

Declaration

public int PageCount { get; }

Property Value

Type	Description
System.Int32	The page count.

Pages

Gets the list of pages in the PDF document.

Declaration

public PdfPagesCollection Pages { get; }

Property Value

Type	Description
PdfPagesCollection

Password

Sets a Password used to protect and encrypt the PDF File. Setting a password will cause IronPDF to automatically protect the PDF file content using strong 128 bit encryption. Setting the password to null will remove any existing password.

Declaration

public string Password { get; set; }

Property Value

Type	Description
System.String

RevisionCount

Number of revisions available in the document. See SaveAsRevision(String)

Declaration

public int RevisionCount { get; }

Property Value

Type	Description
System.Int32

SecuritySettings

Advanced security settings for the PDF.

Allows the developer to control user access passwords, encryption, and also who may edit, print and copy content from the PDF document

Declaration

public PdfSecuritySettings SecuritySettings { get; }

Property Value

Type	Description
PdfSecuritySettings	Advanced security settings for this PDF as an instance of PdfSecuritySettings

Stream

Gets the binary data for the full PDF file as a Stream.

This Stream is System.IDisposable and should be disposed with "using" or "Dispose()" methods.

Declaration

public MemoryStream Stream { get; }

Property Value

Type	Description
System.IO.MemoryStream	The PDF file as a new MemoryStream which is System.IDisposable and should be disposed with "using" or "Dispose()" methods.

Methods

AddBackgroundPdf(PdfDocument, Int32)

Adds a background to each page of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdf(PdfDocument BackgroundPdf, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
PdfDocument	BackgroundPdf	The Background PDF as a PdfDocument.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdf(String, Int32)

Adds a background to each page of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdf(string BackgroundPdfPath, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.String	BackgroundPdfPath	The background PDF's file path.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPage(Int32, PdfDocument, Int32)

Adds the background to one page of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPage(int ToPageIndex, PdfDocument BackgroundPdf, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	ToPageIndex	Index (zero-based page number) of the page of this PDF to which the background will be applied to.
PdfDocument	BackgroundPdf	The Background PDF as a PdfDocument.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPage(Int32, String, Int32)

Adds the background to one page of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPage(int ToPageIndex, string BackgroundPdfPath, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	ToPageIndex	Index (zero-based page number) of the page of this PDF to which the background will be applied to.
System.String	BackgroundPdfPath	The background PDF path.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPageRange(IEnumerable<Int32>, PdfDocument, Int32)

Adds the background to specified pages of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPageRange(IEnumerable<int> ToPageIndexes, PdfDocument BackgroundPdf, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ToPageIndexes	A list of Indexes (zero-based page numbers) of pages in this PDF to which the background will be applied to.
PdfDocument	BackgroundPdf	The Background PDF as a PdfDocument.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPageRange(IEnumerable<Int32>, String, Int32)

Adds the background to specified pages of this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPageRange(IEnumerable<int> ToPageIndexes, string BackgroundPdfPath, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ToPageIndexes	A list of Indexes (zero-based page numbers) of pages in this PDF to which the background will be applied to.
System.String	BackgroundPdfPath	The background PDF path.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPageRange(Int32, Int32, PdfDocument, Int32)

Adds the background to a range of pages in this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPageRange(int StartPageIndex, int EndPageIndex, PdfDocument BackgroundPdf, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	StartPageIndex	First index (zero-based page number) to start adding backgrounds to .
System.Int32	EndPageIndex	Last index (zero-based page number) to end adding backgrounds to.
PdfDocument	BackgroundPdf	The Background PDF as a PdfDocument.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddBackgroundPdfToPageRange(Int32, Int32, String, Int32)

Adds the background to a range of pages in this PDF. The background is copied from a page in another PDF document.

Declaration

public PdfDocument AddBackgroundPdfToPageRange(int StartPageIndex, int EndPageIndex, string BackgroundPdfPath, int BackgroundPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	StartPageIndex	First index (zero-based page number) to start adding backgrounds to .
System.Int32	EndPageIndex	Last index (zero-based page number) to end adding backgrounds to.
System.String	BackgroundPdfPath	The background PDF path.
System.Int32	BackgroundPdfPageIndex	Index (zero-based page number) to copy from the BackgroundPdf.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdf(PdfDocument, Int32)

Adds an overlay to each page of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdf(PdfDocument OverlayPdf, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
PdfDocument	OverlayPdf	The overlay PDF as a PdfDocument.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdf(String, Int32)

Adds an overlay to each page of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdf(string OverlayPdfPath, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.String	OverlayPdfPath	The background PDF's file path.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPage(Int32, PdfDocument, Int32)

Adds an overlay to one page of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPage(int ToPageIndex, PdfDocument OverlayPdf, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	ToPageIndex	Index (zero-based page number) of the page of this PDF to which the foreground will be applied to.
PdfDocument	OverlayPdf	The overlay PDF as a PdfDocument.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPage(Int32, String, Int32)

Adds an overlay to one page of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPage(int ToPageIndex, string OverlayPdfPath, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	ToPageIndex	Index (zero-based page number) of the page of this PDF to which the foreground will be applied to.
System.String	OverlayPdfPath	The overlay PDF path.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPageRange(IEnumerable<Int32>, PdfDocument, Int32)

Adds an overlay to a range or pages of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPageRange(IEnumerable<int> ToPageIndexes, PdfDocument OverlayPdf, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ToPageIndexes	A list of Indexes (zero-based page numbers) of pages in this PDF to which the overlay will be applied to.
PdfDocument	OverlayPdf	The overlay PDF as a PdfDocument.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPageRange(IEnumerable<Int32>, String, Int32)

Adds an overlay to a range or pages of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPageRange(IEnumerable<int> ToPageIndexes, string OverlayPdfPath, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ToPageIndexes	A list of Indexes (zero-based page numbers) of pages in this PDF to which the overlay will be applied to.
System.String	OverlayPdfPath	The overlay PDF path.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPageRange(Int32, Int32, PdfDocument, Int32)

Adds an overlay to a range or pages of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPageRange(int StartPageIndex, int EndPageIndex, PdfDocument OverlayPdf, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	StartPageIndex	First index (zero-based page number) to start adding overlays to .
System.Int32	EndPageIndex	Last index (zero-based page number) to end adding overlays to.
PdfDocument	OverlayPdf	The overlay PDF as a PdfDocument.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddForegroundOverlayPdfToPageRange(Int32, Int32, String, Int32)

Adds an overlay to a range or pages of this PDF. The foreground overlay is copied from a page in another PDF document.

Declaration

public PdfDocument AddForegroundOverlayPdfToPageRange(int StartPageIndex, int EndPageIndex, string OverlayPdfPath, int OverlayPdfPageIndex = 0)

Parameters

Type	Name	Description
System.Int32	StartPageIndex	First index (zero-based page number) to start adding overlays to .
System.Int32	EndPageIndex	Last index (zero-based page number) to end adding overlays to.
System.String	OverlayPdfPath	The overlay PDF path.
System.Int32	OverlayPdfPageIndex	Index (zero-based page number) to copy from the Overlay PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddHtmlFooters(HtmlHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>)

Stamps HTML page footers on top of an existing Pdf.

Declaration

public PdfDocument AddHtmlFooters(HtmlHeaderFooter Footer, double MarginLeft, double MarginRight, double MarginBottom, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddFootersTo = null)

Parameters

Type	Name	Description
HtmlHeaderFooter	Footer	A new instance of IronPdf.HtmlHeaderFooter that defines the footer content and layout.
System.Double	MarginLeft	The left margin of the footer on the page in mm.
System.Double	MarginRight	The right margin of the footer on the page in mm.
System.Double	MarginBottom	The bottom margin of the footer on the page in mm.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddFootersTo	Optional. The PageIndexes (zero-based page numbers) to which the footer will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddHtmlFooters(HtmlHeaderFooter, Int32, IEnumerable<Int32>)

Stamps HTML page footers on top of an existing Pdf.

Positioning can be adjusted using the AddHtmlFooters(HtmlHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>) overload of this method.

Declaration

public PdfDocument AddHtmlFooters(HtmlHeaderFooter Footer, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddFootersTo = null)

Parameters

Type	Name	Description
HtmlHeaderFooter	Footer	A new instance of IronPdf.HtmlHeaderFooter that defines the footer content and layout.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddFootersTo	Optional. The PageIndexes (zero-based page numbers) to which the footer will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddHtmlHeaders(HtmlHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>)

Stamps HTML page headers on top of an existing Pdf.

Declaration

public PdfDocument AddHtmlHeaders(HtmlHeaderFooter Header, double MarginLeft, double MarginRight, double MarginTop, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddHeadersTo = null)

Parameters

Type	Name	Description
HtmlHeaderFooter	Header	A new instance of IronPdf.HtmlHeaderFooter that defines the header content and layout.
System.Double	MarginLeft	The left margin of the header on the page in mm.
System.Double	MarginRight	The right margin of the header on the page in mm.
System.Double	MarginTop	The top margin of the header on the page in mm.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddHeadersTo	Optional. The PageIndexes (zero-based page numbers) to which the header will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddHtmlHeaders(HtmlHeaderFooter, Int32, IEnumerable<Int32>)

Stamps HTML page headers on top of an existing PDF.

Positioning can be adjusted using the AddHtmlHeaders(HtmlHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>) to specify header margins

Declaration

public PdfDocument AddHtmlHeaders(HtmlHeaderFooter Header, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddHeadersTo = null)

Parameters

Type	Name	Description
HtmlHeaderFooter	Header	A new instance of IronPdf.HtmlHeaderFooter that defines the header content and layout.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddHeadersTo	Optional. The PageIndexes (zero-based page numbers) to which the header will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddHtmlHeadersAndFooters(ChromePdfRenderOptions, IEnumerable<Int32>)

Stamps HTML headers and footers on top of an existing PDF using the specified render options and optional list of page indices.

Declaration

public PdfDocument AddHtmlHeadersAndFooters(ChromePdfRenderOptions Options, IEnumerable<int> PageIndexes = null)

Parameters

Type	Name	Description
ChromePdfRenderOptions	Options	Render options for the HTML headers and footers
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	Optional list of page indices to apply headers and footers to. Defaults to all pages

Returns

Type	Description
PdfDocument	Pdf document

AddTextFooters(TextHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>)

Stamps page footers on top of an existing Pdf.

Declaration

public PdfDocument AddTextFooters(TextHeaderFooter Footer, double MarginLeft, double MarginRight, double MarginBottom, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddFootersTo = null)

Parameters

Type	Name	Description
TextHeaderFooter	Footer	A new instance of IronPdf.SimpleHeaderFooter that defines the footer content and layout.
System.Double	MarginLeft	The left margin of the footer on the page in mm.
System.Double	MarginRight	The right margin of the footer on the page in mm.
System.Double	MarginBottom	The bottom margin of the footer on the page in mm.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddFootersTo	Optional. The PageIndexes (zero-based page numbers) to which the footer will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddTextFooters(TextHeaderFooter, Int32, IEnumerable<Int32>)

Stamps page footers on top of an existing Pdf.

Positioning can be adjusted using the AddTextFooters(TextHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>) overload of this method.

Declaration

public PdfDocument AddTextFooters(TextHeaderFooter Footer, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddFootersTo = null)

Parameters

Type	Name	Description
TextHeaderFooter	Footer	A new instance of IronPdf.TextHeaderFooter that defines the footer content.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddFootersTo	Optional. The PageIndexes (zero-based page numbers) to which the footer will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddTextHeaders(TextHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>)

Stamps page headers on top of an existing Pdf.

Declaration

public PdfDocument AddTextHeaders(TextHeaderFooter Header, double MarginLeft, double MarginRight, double MarginTop, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddHeadersTo = null)

Parameters

Type	Name	Description
TextHeaderFooter	Header	A new instance of IronPdf.SimpleHeaderFooter that defines the header content and layout.
System.Double	MarginLeft	The left margin of the header on the page in mm.
System.Double	MarginRight	The right margin of the header on the page in mm.
System.Double	MarginTop	The top margin of the header on the page in mm.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddHeadersTo	Optional. The PageIndexes (zero-based page numbers) to which the header will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddTextHeaders(TextHeaderFooter, Int32, IEnumerable<Int32>)

Stamps page headers on top of an existing Pdf.

Positioning can be adjusted using the AddTextHeaders(TextHeaderFooter, Double, Double, Double, Int32, IEnumerable<Int32>) overload of this method.

Declaration

public PdfDocument AddTextHeaders(TextHeaderFooter Header, int FirstPageNumber = 1, IEnumerable<int> PageIndexesToAddHeadersTo = null)

Parameters

Type	Name	Description
TextHeaderFooter	Header	A new instance of IronPdf.TextHeaderFooter that defines the header content and layout.
System.Int32	FirstPageNumber	Optional. The number of first page for {page} mail-merge.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToAddHeadersTo	Optional. The PageIndexes (zero-based page numbers) to which the header will be added.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

AddTextHeadersAndFooters(ChromePdfRenderOptions, IEnumerable<Int32>)

Stamps text headers and footers on top of an existing PDF using the specified render options and optional list of page indices.

Declaration

public PdfDocument AddTextHeadersAndFooters(ChromePdfRenderOptions Options, IEnumerable<int> PageIndexes = null)

Parameters

Type	Name	Description
ChromePdfRenderOptions	Options	Render options for the text headers and footers
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	Optional list of page indices to apply headers and footers to. Defaults to all pages

Returns

Type	Description
PdfDocument	Pdf document

AppendPdf(PdfDocument)

Appends another PDF to the end of the current PdfDocument If AnotherPdfFile contains form fields, those fields will be appended with '' in the resulting PDF. e.g. 'Name' will be 'Name'

Declaration

public PdfDocument AppendPdf(PdfDocument AnotherPdfFile)

Parameters

Type	Name	Description
PdfDocument	AnotherPdfFile	PdfDocument to append.

Returns

Type	Description
PdfDocument	A new PdfDocument

ApplyMultipleStamps(IEnumerable<Stamper>, IEnumerable<Int32>)

Edits the PDF by applying multiple Stamper's rendered Html to only selected page(s).

Declaration

public PdfDocument ApplyMultipleStamps(IEnumerable<Stamper> Stampers, IEnumerable<int> PageIndexesToStamp = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Stamper>	Stampers	A list of Stamper objects, each with their own HTML stamp, to all be stamped onto the PDF.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToStamp	The page indexes (zero-based page number) to apply the stamps to.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyMultipleStamps(IEnumerable<Stamper>, Int32)

Edits the PDF by applying multiple Stamper's rendered Html to a single page.

Declaration

public PdfDocument ApplyMultipleStamps(IEnumerable<Stamper> Stampers, int PageIndexToStamp)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Stamper>	Stampers	A list of Stamper objects, each with their own HTML stamp, to all be stamped onto the PDF.
System.Int32	PageIndexToStamp	The page index (zero-based page number) to apply the stamps to.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyMultipleStampsAsync(IEnumerable<Stamper>)

Asynchronously edits the PDF by applying multiple Stamper's rendered Html to every page.

Declaration

public Task<PdfDocument> ApplyMultipleStampsAsync(IEnumerable<Stamper> Stampers)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Stamper>	Stampers	A list of Stamper objects, each with their own HTML stamp, to all be stamped onto the PDF.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyMultipleStampsAsync(IEnumerable<Stamper>, IEnumerable<Int32>)

Asynchronously edits the PDF by applying multiple Stamper's rendered Html to only selected page(s).

Declaration

public Task<PdfDocument> ApplyMultipleStampsAsync(IEnumerable<Stamper> Stampers, IEnumerable<int> PageIndexesToStamp)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Stamper>	Stampers	A list of Stamper objects, each with their own HTML stamp, to all be stamped onto the PDF.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToStamp	The page indexes (zero-based page number) to apply the stamps to.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyMultipleStampsAsync(IEnumerable<Stamper>, Int32)

Asynchronously edits the PDF by applying multiple Stamper's rendered Html to a single page.

Declaration

public Task<PdfDocument> ApplyMultipleStampsAsync(IEnumerable<Stamper> Stampers, int PageIndexToStamp)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Stamper>	Stampers	A list of Stamper objects, each with their own HTML stamp, to all be stamped onto the PDF.
System.Int32	PageIndexToStamp	The page index (zero-based page number) to apply the stamps to.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyStamp(Stamper)

Edits the PDF by applying the Stamper's rendered Html to every page.

Declaration

public PdfDocument ApplyStamp(Stamper Stamper)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyStamp(Stamper, IEnumerable<Int32>)

Edits the PDF by applying the Stamper's rendered Html to only selected page(s).

Declaration

public PdfDocument ApplyStamp(Stamper Stamper, IEnumerable<int> PageIndexesToStamp)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToStamp	The list of page indexes (zero-based page number) to apply the stamp to.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyStamp(Stamper, Int32)

Edits the PDF by applying the Stamper's rendered Html to a single page.

Declaration

public PdfDocument ApplyStamp(Stamper Stamper, int PageIndexToStamp)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.
System.Int32	PageIndexToStamp	The page index (zero-based page number) to apply the stamp to.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyStampAsync(Stamper)

Asynchronously edits the PDF by applying the Stamper's rendered Html to every page.

Declaration

public Task<PdfDocument> ApplyStampAsync(Stamper Stamper)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

Remarks

Please wait for the task to be completed before saving to file!

ApplyStampAsync(Stamper, IEnumerable<Int32>)

Asynchronously edits the PDF by applying the Stamper's rendered Html to only selected page(s).

Declaration

public Task<PdfDocument> ApplyStampAsync(Stamper Stamper, IEnumerable<int> PageIndexesToStamp)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexesToStamp	The page indexes (zero-based page number) to apply the stamps to.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

Remarks

Please wait for the task to be completed before saving to file!

ApplyStampAsync(Stamper, Int32)

Asynchronously edits the PDF by applying the Stamper's rendered Html to a single page.

Declaration

public Task<PdfDocument> ApplyStampAsync(Stamper Stamper, int PageIndexToStamp)

Parameters

Type	Name	Description
Stamper	Stamper	The Stamper object that has the HTML to be stamped onto the PDF.
System.Int32	PageIndexToStamp	The page index (zero-based page number) to apply the stamp to.

Returns

Type	Description
System.Threading.Tasks.Task<PdfDocument>	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

Remarks

Please wait for the task to be completed before saving to file!

ApplyWatermark(String, Int32, VerticalAlignment, HorizontalAlignment)

Adds Watermark to PDF, Please use ApplyStamp(Stamper) for more control.

For more information and a code example please visit: https://ironpdf.com/tutorials/csharp-edit-pdf-complete-tutorial/#add-a-watermark-to-a-pdf

Declaration

public PdfDocument ApplyWatermark(string html, int opacity = 50, VerticalAlignment verticalAlignment, HorizontalAlignment horizontalAlignment)

Parameters

Type	Name	Description
System.String	html	The HTML fragment which will be stamped onto your PDF.
System.Int32	opacity	Watermark transparent value. 0 is invisible, 100 if fully opaque.
VerticalAlignment	verticalAlignment	The vertical alignment of the watermark relative to the page.
HorizontalAlignment	horizontalAlignment	The horizontal alignment of the watermark relative to the page.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

ApplyWatermark(String, Int32, Int32, VerticalAlignment, HorizontalAlignment)

Adds Watermark to PDF, Please use ApplyStamp(Stamper) for more control.

For more information and a code example please visit: https://ironpdf.com/tutorials/csharp-edit-pdf-complete-tutorial/#add-a-watermark-to-a-pdf

Declaration

public PdfDocument ApplyWatermark(string html, int rotation, int opacity = 50, VerticalAlignment verticalAlignment, HorizontalAlignment horizontalAlignment)

Parameters

Type	Name	Description
System.String	html	The HTML fragment which will be stamped onto your PDF.
System.Int32	rotation	Rotates the watermark clockwise from 0 to 360 degrees as specified.
System.Int32	opacity	Watermark transparent value. 0 is invisible, 100 if fully opaque.
VerticalAlignment	verticalAlignment	The vertical alignment of the watermark relative to the page.
HorizontalAlignment	horizontalAlignment	The horizontal alignment of the watermark relative to the page.

Returns

Type	Description
PdfDocument	Returns this PdfDocument, allowing for a 'fluent' (LINQ like) chained in-line code style

CompressImages(Int32, Boolean)

Compress existing images using JPG encoding and the specified settings

Declaration

public void CompressImages(int Quality, bool ScaleToVisibleSize = true)

Parameters

Type	Name	Description
System.Int32	Quality	Quality (1 - 100) to use during compression
System.Boolean	ScaleToVisibleSize	Scale down the image resolution according to its visible size in the PDF document

Exceptions

Type	Condition
System.ArgumentOutOfRangeException	Argument out of range

ConvertToPdfA(PdfAVersions)

Convert the current document into the specified PDF-A standard format

Declaration

public PdfDocument ConvertToPdfA(PdfAVersions PdfAVersion)

Parameters

Type	Name	Description
PdfAVersions	PdfAVersion	PDF-A standard format

Returns

Type	Description
PdfDocument	A PDF/A compliant reference to this document

CopyPage(Int32)

Creates a new PDF by copying a page from this PdfDocument.

Declaration

public PdfDocument CopyPage(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
PdfDocument	A new PdfDocument

CopyPages(IEnumerable<Int32>)

Creates a new PDF by copying a range of pages from this PdfDocument.

Declaration

public PdfDocument CopyPages(IEnumerable<int> PageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	An IEnumerable of page indexes to copy into the new PDF.

Returns

Type	Description
PdfDocument	A new PdfDocument

CopyPages(Int32, Int32)

Creates a new PDF by copying a range of pages from this PdfDocument.

Declaration

public PdfDocument CopyPages(int StartIndex, int EndIndex)

Parameters

Type	Name	Description
System.Int32	StartIndex	The index of the first PDF page to copy.. Note: Page 1 has index 0
System.Int32	EndIndex	The index of the last PDF page to copy.>

Returns

Type	Description
PdfDocument	A new PdfDocument

Dispose()

Releases used resources.

Declaration

public void Dispose()

DrawBitmap(AnyBitmap, IEnumerable<Int32>, IEnumerable<Double>, IEnumerable<Double>, IEnumerable<Double>, IEnumerable<Double>, PixelFormat)

Draw a bitmap multiple times according to the specified parameters; all occurrences of the bitmap will share a single data stream

Declaration

public void DrawBitmap(AnyBitmap bitmap, IEnumerable<int> page_indices, IEnumerable<double> xs, IEnumerable<double> ys, IEnumerable<double> desired_widths, IEnumerable<double> desired_heights, PixelFormat format)

Parameters

Type	Name	Description
IronSoftware.Drawing.AnyBitmap	bitmap	AnyBitmap to draw
System.Collections.Generic.IEnumerable<System.Int32>	page_indices	Target page indices
System.Collections.Generic.IEnumerable<System.Double>	xs	X coordinates
System.Collections.Generic.IEnumerable<System.Double>	ys	Y coordinates
System.Collections.Generic.IEnumerable<System.Double>	desired_widths	Desired widths
System.Collections.Generic.IEnumerable<System.Double>	desired_heights	Desired heights
PixelFormat	format	Pixel format

DrawBitmap(AnyBitmap, Int32, Double, Double, Double, Double, PixelFormat)

Draw a bitmap a single time according to the specified parameters

Declaration

public void DrawBitmap(AnyBitmap bitmap, int page_index, double x, double y, double desired_width, double desired_height, PixelFormat format)

Parameters

Type	Name	Description
IronSoftware.Drawing.AnyBitmap	bitmap	Bitmap to draw
System.Int32	page_index	Page index
System.Double	x	X coordinate
System.Double	y	Y coordinate
System.Double	desired_width	Desired width
System.Double	desired_height	Desired Height
PixelFormat	format	Pixel format

ExtractAllBitmaps()

Finds all embedded Images from within the PDF and returns then as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractAllBitmaps()

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap

ExtractAllImages()

Finds all embedded Images from within the PDF and returns then as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractAllImages()

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap

ExtractAllRawImages()

Extracts all images from a PDf document. Images are returned as their raw data in as Byte Arrays (byte[])

Declaration

public List<byte[]> ExtractAllRawImages()

Returns

Type	Description
System.Collections.Generic.List<System.Byte[]>	An Enumerable of Byte Arrays. Each Byte Array represents one image.

ExtractAllText()

Extracts the written text content from the PDF and returns it as a string.

Pages are be separated by 4 consecutive Environment.NewLines

Declaration

public string ExtractAllText()

Returns

Type	Description
System.String	All text in the PDF as a string.

ExtractBitmapsFromPage(Int32)

Finds all embedded Images from within one page of the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractBitmapsFromPage(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractBitmapsFromPages(IEnumerable<Int32>)

Finds all embedded Images from within a specified pages in the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractBitmapsFromPages(IEnumerable<int> PageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	An IEnumerable list of page indexes.

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	IEnumerable of AnyBitmap. The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractBitmapsFromPages(Int32, Int32)

Finds all embedded Images from within a range of pages in the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractBitmapsFromPages(int StartIndex, int EndIndex)

Parameters

Type	Name	Description
System.Int32	StartIndex	The index of the first PDF page to extract images from.. Note: Page 1 has index 0
System.Int32	EndIndex	The index of the last PDF page to extract images from.

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractImagesFromPage(Int32)

Finds all embedded Images from within one page of the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractImagesFromPage(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractImagesFromPages(IEnumerable<Int32>)

Finds all embedded Images from within a specified pages in the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractImagesFromPages(IEnumerable<int> PageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	An IEnumerable list of page indexes.

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractImagesFromPages(Int32, Int32)

Finds all embedded Images from within a range of pages in the PDF and returns them as IronSoftware.Drawing.AnyBitmap objects

Declaration

public List<AnyBitmap> ExtractImagesFromPages(int StartIndex, int EndIndex)

Parameters

Type	Name	Description
System.Int32	StartIndex	The index of the first PDF page to extract images from.. Note: Page 1 has index 0
System.Int32	EndIndex	The index of the last PDF page to extract images from.

Returns

Type	Description
System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap>	The extracted images as IronSoftware.Drawing.AnyBitmap Objects

ExtractRawImagesFromPage(Int32)

Finds all embedded Images from within one page of the PDF and returns them as raw image byte array objects

Declaration

public List<byte[]> ExtractRawImagesFromPage(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
System.Collections.Generic.List<System.Byte[]>	List of raw image byte array.

ExtractRawImagesFromPages(IEnumerable<Int32>)

Finds all embedded Images from specified pages in the PDF and returns them as raw image byte array objects objects

Declaration

public List<byte[]> ExtractRawImagesFromPages(IEnumerable<int> PageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	An IEnumerable list of page indexes.

Returns

Type	Description
System.Collections.Generic.List<System.Byte[]>	List of raw image byte array.

ExtractRawImagesFromPages(Int32, Int32)

Finds all embedded Images from within a range of pages in the PDF and returns them as raw image byte array objects

Declaration

public List<byte[]> ExtractRawImagesFromPages(int StartIndex, int EndIndex)

Parameters

Type	Name	Description
System.Int32	StartIndex	The index of the first PDF page to extract images from.. Note: Page 1 has index 0
System.Int32	EndIndex	The index of the last PDF page to extract images from.

Returns

Type	Description
System.Collections.Generic.List<System.Byte[]>	List of raw image byte array.

ExtractTextFromPage(Int32)

Extracts the text content from one page of the PDF and returns it as a string.

Declaration

public string ExtractTextFromPage(int pageIndex)

Parameters

Type	Name	Description
System.Int32	pageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
System.String	The text extracted from the PDF page as a string.

ExtractTextFromPages(IEnumerable<Int32>)

Extracts the written text content from specified pages in the PDF PDF and returns it as a string. Pages will be separated by 4 consecutive Environment.NewLines

Declaration

public string ExtractTextFromPages(IEnumerable<int> pageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	pageIndexes	An IEnumerable list of page indexes.

Returns

Type	Description
System.String	The text extracted from the PDF pages as a string.

ExtractTextFromPages(Int32, Int32)

Extracts the written text content from a range of pages within the PDF and returns it as a string. Pages will be separated by 4 consecutive Environment.NewLines

Declaration

public string ExtractTextFromPages(int startIndex, int endIndex)

Parameters

Type	Name	Description
System.Int32	startIndex	The start page index. Note: Page 1 has index 0
System.Int32	endIndex	The end page index. Note: The last page has index `PageCount -1`

Returns

Type	Description
System.String	The text extracted from the PDF pages as a string.

Finalize()

Finalizer

Declaration

protected override void Finalize()

Flatten(IEnumerable<Int32>)

Flattens a document (make the fields such as Forms Fields non-editable and non-accessible).

Declaration

public void Flatten(IEnumerable<int> Pages = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	Pages	Optional page indices to flatten (defaults to all pages)

FromFile(String, String, String)

Opens an existing PDF document for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public static PdfDocument FromFile(string PdfFilePath, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.String	PdfFilePath	The PDF file path.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Returns

Type	Description
PdfDocument	An IronPdf.PdfDocument object as loaded from the file path.

Exceptions

Type	Condition
System.IO.IOException	Exception thrown if can not be opened.
System.ArgumentException	`PdfFilePath` is null, empty, or consists only of white-space characters.

FromUrl(Uri, String, String)

Opens a PDF stored on a URL for editing.

Adding a using declaration is not required. But can be used if you want to explicitly dispose. See: https://iron.helpscoutdocs.com/article/281-ironpdf-using

Declaration

public static PdfDocument FromUrl(Uri Uri, string Password = "", string OwnerPassword = "")

Parameters

Type	Name	Description
System.Uri	Uri	The URI to the PDF.
System.String	Password	Optional user password if the PDF document is encrypted.
System.String	OwnerPassword	Optional password if the PDF document is protected by owner (printing, modifying restrictions etc..).

Returns

Type	Description
PdfDocument	An IronPdf.PdfDocument object as loaded from the file path.

Exceptions

Type	Condition
IronPdfProductException	Exception thrown if cannot read the PDF due to incorrect uri or password.

GetPageRotation(Int32)

Gets the rotation of a PDF page in degrees.

Declaration

public PdfPageRotation GetPageRotation(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page to inspect. PageIndex is a 'Zero based' page number, the first page being 0.

Returns

Type	Description
PdfPageRotation	Degrees of rotation

GetPrintDocument(PrinterSettings, PrintController)

Returns a System.Drawing.Printing.PrintDocument for the PDF allowing developers granular control over sending the PDF to a Printer.

An assembly reference to System.Drawing is required in your project.

Note: 'GetPrintDocument(PrinterSettings, PrintController)' is only supported on: 'Windows'.

Printer settings. Note: If you create a new PrinterSettings() we recommend setting printerSettings.DefaultPageSettings.Margins = new Margins(0, 0, 0, 0); custom printController such as PreviewPrintController for a GUI print preview

Declaration

public PrintDocument GetPrintDocument(PrinterSettings printerSettings = null, PrintController printController = null)

Parameters

Type	Name	Description
System.Drawing.Printing.PrinterSettings	printerSettings
System.Drawing.Printing.PrintController	printController

Returns

Type	Description
System.Drawing.Printing.PrintDocument	A System.Drawing.Printing.PrintDocument.

Exceptions

Type	Condition
System.Exception	IronPdf must be licensed to use this feature.

GetRevision(Int32)

Creates a copy of this document at the specified revision number. See SaveAsRevision(String)

Declaration

public PdfDocument GetRevision(int index)

Parameters

Type	Name	Description
System.Int32	index	Revision number. Revision 0 represents the original document, revision 1 is the first revision, etc.

Returns

Type	Description
PdfDocument	A copy of the specified revision of this document

GetVerifiedSignatures()

Returns a list of VerifiedSignature.

Declaration

public List<VerifiedSignature> GetVerifiedSignatures()

Returns

Type	Description
System.Collections.Generic.List<VerifiedSignature>	list of VerifiedSignature

InsertPdf(PdfDocument, Int32)

Inserts another PDF into the current PdfDocument, starting at a given Page Index. If AnotherPdfFile contains form fields, those fields will be appended with '' in the resulting PDF. e.g. 'Name' will be 'Name'

Declaration

public PdfDocument InsertPdf(PdfDocument AnotherPdfFile, int AtIndex = 0)

Parameters

Type	Name	Description
PdfDocument	AnotherPdfFile	Another PdfDocument.
System.Int32	AtIndex	Index at which to insert the new content. Note: Page 1 has index 0...

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

Merge(PdfDocument, PdfDocument)

Static method that joins (concatenates) 2 PDF documents together into one PDF document. If the PDF contains form fields the form field in the resulting PDF's name will be appended with '_{index}' e.g. 'Name' will be 'Name_0'

Declaration

public static PdfDocument Merge(PdfDocument A, PdfDocument B)

Parameters

Type	Name	Description
PdfDocument	A	A PDF
PdfDocument	B	A Seconds PDF

Returns

Type	Description
PdfDocument	A new, merged PdfDocument

Merge(IEnumerable<PdfDocument>)

Static method that joins (concatenates) multiple PDF documents together into one compiled PDF document. If the PDF contains form fields the form field in the resulting PDF's name will be appended with '_{index}' e.g. 'Name' will be 'Name_0'

Declaration

public static PdfDocument Merge(IEnumerable<PdfDocument> Documents)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<PdfDocument>	Documents	A IEnumerable of PdfDocument. To merge existing PDF files you may use the PdfDocument.FromFile static method in conjunction with Merge.

Returns

Type	Description
PdfDocument	A new, merged PdfDocument

PageToBitmap(Int32, Int32)

Renders a single page of the PDF to a IronSoftware.Drawing.AnyBitmap object.

Please add an assembly reference to IronSoftware.Drawing.AnyBitmap to use this "PDF To Image" method

Declaration

public AnyBitmap PageToBitmap(int pageIndex, int DPI = 96)

Parameters

Type	Name	Description
System.Int32	pageIndex	The zero based page number to be converted to an image. E.g. Page 1 has a pageIndex of 0
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
IronSoftware.Drawing.AnyBitmap	A IronSoftware.Drawing.AnyBitmap of the rendered PDF page.

Remarks

The DPI will be ignored under Linux and macOS.

PageToBitmap(Int32, Nullable<Int32>, Nullable<Int32>, Int32)

Renders a single page of the PDF to a IronSoftware.Drawing.AnyBitmap object.

Please add an assembly reference to IronSoftware.Drawing.AnyBitmap to use this "PDF To Image" method

Declaration

public AnyBitmap PageToBitmap(int pageIndex, Nullable<int> imageMaxWidth, Nullable<int> imageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.Int32	pageIndex	The zero based page number to be converted to an image. E.g. Page 1 has a pageIndex of 0
System.Nullable<System.Int32>	imageMaxWidth	The target maximum width of the output images.
System.Nullable<System.Int32>	imageMaxHeight	The target maximum height of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
IronSoftware.Drawing.AnyBitmap	A IronSoftware.Drawing.AnyBitmap of the rendered PDF page.

Remarks

The DPI will be ignored under Linux and macOS.

PrependPdf(PdfDocument)

Adds another PDF to the beginning of the current PdfDocument If AnotherPdfFile contains form fields, those fields will be appended with '' in the resulting PDF. e.g. 'Name' will be 'Name'

Declaration

public PdfDocument PrependPdf(PdfDocument AnotherPdfFile)

Parameters

Type	Name	Description
PdfDocument	AnotherPdfFile	PdfDocument to prepend.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

Print()

Prints this PDF by sending it to the computer's printer.

For advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

if true print preview dialogs will be displayed to the user. Default value is false.

Note: 'Print()' is only supported on: 'Windows'.

Declaration

public int Print()

Returns

Type	Description
System.Int32	The number of printed pages.

Print(Boolean)

Declaration

public int Print(bool showPreview)

Parameters

Type	Name	Description
System.Boolean	showPreview

Returns

Type	Description
System.Int32

Print(Int32)

Prints this PDF by sending it to the computer's printer.

For even more advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

Note: 'Print(Int32)' is only supported on: 'Windows'.

the horizontal and vertical PDF resolutions, in dots per inch. if -1 print with default printer resolution. Default value is -1.

Declaration

public int Print(int dpi)

Parameters

Type	Name	Description
System.Int32	dpi

Returns

Type	Description
System.Int32	The number of printed pages.

Print(Int32, Boolean)

Declaration

public int Print(int dpi, bool showPreview)

Parameters

Type	Name	Description
System.Int32	dpi
System.Boolean	showPreview

Returns

Type	Description
System.Int32

Print(Int32, Int32, String, String, PrintController)

Prints this PDF by sending it to the computer's printer.

For even more advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

Note: 'Print(Int32, Int32, String, String, PrintController)' is only supported on: 'Windows'.

the horizontal PDF resolution, in dots per inch.the vertical PDF resolution, in dots per inch.the name of a printer, setnull or an empty string ("") to use default print. Default value is null.the file path, when printing to a file, set or an empty string ("") for printing output is sent to a port instead of the filePath. The default value is null. custom printController such as PreviewPrintController for a GUI print preview

Declaration

public int Print(int dpiX, int dpiY, string printerName = null, string filePath = null, PrintController customPrintController = null)

Parameters

Type	Name	Description
System.Int32	dpiX
System.Int32	dpiY
System.String	printerName
System.String	filePath
System.Drawing.Printing.PrintController	customPrintController

Returns

Type	Description
System.Int32	The number of printed pages.

Print(Int32, String, String)

Prints this PDF by sending it to the computer's printer.

For even more advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

Note: 'Print(Int32, String, String)' is only supported on: 'Windows'.

the horizontal and vertical PDF resolutions, in dots per inch. if -1 print with default printer resolution. Default value is -1.the name of a printer, setnull or an empty string ("") to use default print. Default value is null.the file path, when printing to a file, set or an empty string ("") for printing output is sent to a port instead of the filePath. The default value is null.

Declaration

public int Print(int dpi, string printerName = null, string filePath = null)

Parameters

Type	Name	Description
System.Int32	dpi
System.String	printerName
System.String	filePath

Returns

Type	Description
System.Int32	The number of printed pages.

Print(Int32, String, String, Boolean)

Declaration

public int Print(int dpi, string printerName = null, string filePath = null, bool showPreview = false)

Parameters

Type	Name	Description
System.Int32	dpi
System.String	printerName
System.String	filePath
System.Boolean	showPreview

Returns

Type	Description
System.Int32

Print(String)

Prints this PDF by sending it to the computer's printer.

For even more advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

Note: 'Print(String)' is only supported on: 'Windows'.

the name of a printer, setnull or an empty string ("") to use default print. Default value is null.

Declaration

public int Print(string printerName)

Parameters

Type	Name	Description
System.String	printerName

Returns

Type	Description
System.Int32	The number of printed pages.

Print(String, Boolean)

Declaration

public int Print(string printerName, bool showPreview)

Parameters

Type	Name	Description
System.String	printerName
System.Boolean	showPreview

Returns

Type	Description
System.Int32

PrintToFile(Int32, String)

Prints this PDF by sending it to the computer's printer.

For advanced real-world printing options please see overloads of this method and also GetPrintDocument(PrinterSettings, PrintController).

Note: 'PrintToFile(Int32, String)' is only supported on: 'Windows'.

the horizontal and vertical PDF resolutions, in dots per inch. if -1 print with default printer resolution. Default value is -1.output file path, if set to null or an empty string ("") default filePath will be random GUID.

Declaration

public int PrintToFile(int dpi, string filePath = null)

Parameters

Type	Name	Description
System.Int32	dpi
System.String	filePath

Returns

Type	Description
System.Int32	The number of printed pages.

PrintToFile(Int32, String, Boolean)

Declaration

public int PrintToFile(int dpi, string filePath = null, bool showPreview = false)

Parameters

Type	Name	Description
System.Int32	dpi
System.String	filePath
System.Boolean	showPreview

Returns

Type	Description
System.Int32

PrintToFile(String)

Prints this PDF by sending it to the computer's printer.

For advanced real-world printing options please see overloads GetPrintDocument(PrinterSettings, PrintController).

Note: 'PrintToFile(String)' is only supported on: 'Windows'.

output file path, if set to null or an empty string ("") default filePath will be random GUID.

Declaration

public int PrintToFile(string filePath)

Parameters

Type	Name	Description
System.String	filePath

Returns

Type	Description
System.Int32	The number of printed pages.

PrintToFile(String, Boolean)

Declaration

public int PrintToFile(string filePath, bool showPreview = false)

Parameters

Type	Name	Description
System.String	filePath
System.Boolean	showPreview

Returns

Type	Description
System.Int32

RasterizeToImageFiles(String, ImageType, Int32)

Renders the PDF and exports image Files in convenient formats. 1 image file is created for each page.

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] RasterizeToImageFiles(string FileNamePattern, ImageType ImageFileType, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.png
ImageType	ImageFileType	Type of the image file. If not specified, a best guess will be taken from the FileNamePattern file extension
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

RasterizeToImageFiles(String, IEnumerable<Int32>, ImageType, Int32)

Renders the PDF and exports image Files in convenient formats. Page Numbers may be specified. 1 image file is created for each page.

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] RasterizeToImageFiles(string FileNamePattern, IEnumerable<int> PageIndexes, ImageType ImageFileType, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.png
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render as images.
ImageType	ImageFileType	Type of the image file. If not specified, a best guess will be taken from the FileNamePattern file extension
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

RasterizeToImageFiles(String, IEnumerable<Int32>, Nullable<Int32>, Nullable<Int32>, ImageType, Int32)

Renders the PDF and exports image Files in convenient formats. Page Numbers may be specified. 1 image file is created for each page.

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] RasterizeToImageFiles(string FileNamePattern, IEnumerable<int> PageIndexes, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, ImageType ImageFileType, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.png
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render as images.
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
ImageType	ImageFileType	Type of the image file. If not specified, a best guess will be taken from the FileNamePattern file extension
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

RasterizeToImageFiles(String, Nullable<Int32>, Nullable<Int32>, ImageType, Int32)

Renders the PDF and exports image Files in convenient formats. Image dimensions may be specified. 1 image file is created for each page.

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] RasterizeToImageFiles(string FileNamePattern, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, ImageType ImageFileType, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.png
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
ImageType	ImageFileType	Type of the image file. If not specified, a best guess will be taken from the FileNamePattern file extension
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

RemovePage(Int32)

Removes a page from the PDF at the given index.

Declaration

public PdfDocument RemovePage(int PageIndex)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page. Note: Page 1 has index 0...

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

RemovePages(IEnumerable<Int32>)

Removes a range of pages from the PDF

Declaration

public PdfDocument RemovePages(IEnumerable<int> PageIndexes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of pages indexes to remove.

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

RemovePages(Int32, Int32)

Removes a range of pages from the PDF

Declaration

public PdfDocument RemovePages(int StartIndex, int EndIndex)

Parameters

Type	Name	Description
System.Int32	StartIndex	The start index. Note: Page 1 has index 0
System.Int32	EndIndex	The end index. Note: The last page has index `PageCount -1`

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

RemoveSignatures()

Remove all digital signatures from the PDF document

Declaration

public void RemoveSignatures()

ReplaceTextOnAllPages(String, String)

Replace the specified old text with new text on all pages

Declaration

public void ReplaceTextOnAllPages(string oldText, string newText)

Parameters

Type	Name	Description
System.String	oldText	Old text to remove
System.String	newText	New text to add

ReplaceTextOnPage(Int32, String, String)

Replace the specified old text with new text on a given page

Declaration

public void ReplaceTextOnPage(int pageIndex, string oldText, string newText)

Parameters

Type	Name	Description
System.Int32	pageIndex	Page index to search for old text to replace
System.String	oldText	Old text to remove
System.String	newText	New text to add

ReplaceTextOnPages(Int32[], String, String)

Replace the specified old text with new text on specified pages

Declaration

public void ReplaceTextOnPages(int[] pageIndexes, string oldText, string newText)

Parameters

Type	Name	Description
System.Int32[]	pageIndexes	Indexes if pages to search for old text to replace
System.String	oldText	Old text to remove
System.String	newText	New text to add

Resize(Length, Length, IEnumerable<Int32>)

Resizes the PdfDocument to the specified width, height, and desired measurement unit. This will scale existing page contents to fit the new page dimensions, this may cause distortion in cases where Width-to-height ratio is different.

Declaration

public void Resize(Length PageWidth, Length PageHeight, IEnumerable<int> Pages = null)

Parameters

Type	Name	Description
Length	PageWidth	The width of the resized PdfDocument.
Length	PageHeight	The height of the resized PdfDocument.
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The page(s) to resize, if not specified all pages will be resized

Resize(PdfPaperSize, IEnumerable<Int32>)

Resizes the PDF document to the specified paper size.

Declaration

public void Resize(PdfPaperSize PdfPaperSize, IEnumerable<int> Pages = null)

Parameters

Type	Name	Description
PdfPaperSize	PdfPaperSize	The size to resize the PDF document to.
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The page(s) to resize, if not specified all pages will be resized

Remarks

The available paper sizes are defined in the PdfPaperSize enumeration.

Resize(Double, Double, MeasurementUnit, IEnumerable<Int32>)

Declaration

public void Resize(double PageWidth, double PageHeight, MeasurementUnit MeasurementUnit, IEnumerable<int> Pages = null)

Parameters

Type	Name	Description
System.Double	PageWidth	The width of the resized PdfDocument.
System.Double	PageHeight	The height of the resized PdfDocument.
MeasurementUnit	MeasurementUnit	The measurement unit for the width and height values.
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The page(s) to resize, if not specified all pages will be resized

ResizePage(Int32, Double, Double)

Resize a page to the specified dimensions (in millimeters)

Declaration

public void ResizePage(int PageIndex, double PageWidth, double PageHeight)

Parameters

Type	Name	Description
System.Int32	PageIndex	Page index to resize
System.Double	PageWidth	Desired page width, in millimeters
System.Double	PageHeight	Desired page height, in millimeters

SaveAs(String, Boolean)

Saves the PdfDocument to a file.

Declaration

public PdfDocument SaveAs(string FileName, bool SaveAsRevision = false)

Parameters

Type	Name	Description
System.String	FileName	Target file path
System.Boolean	SaveAsRevision	Append changes to the end of the PDF rather than overwriting existing objects. See also SaveAsRevision(String)

Returns

Type	Description
PdfDocument	This PdfDocument for fluid code notation; if SaveAsRevision is enabled, the returned PdfDocument will be a new revision

SaveAsPdfA(String, PdfAVersions)

Saves the PdfDocument as a PDF/A Compliant PDF File

For more information see the: IronPDF PDFA How-To Guide

Note: All of non-embedded fonts are embedded as Helvetica Font which is one of 14 standard fonts provided by Adobe.

Declaration

public PdfDocument SaveAsPdfA(string FileName, PdfAVersions PdfAVersion)

Parameters

Type	Name	Description
System.String	FileName	Target file path
PdfAVersions	PdfAVersion	Version of exported PDF/A

Returns

Type	Description
PdfDocument	A PDF/A compliant reference to this document

SaveAsRevision(String)

Saves current changes as a revision and returns the revised the document, optionally also saving the document to disk

Declaration

public PdfDocument SaveAsRevision(string FileName = null)

Parameters

Type	Name	Description
System.String	FileName	Optional file path

Returns

Type	Description
PdfDocument	The revised PdfDocument, ready for a new set of changes

SetAllPageRotations(PdfPageRotation)

Set rotation degree to all pages of the PdfDocument by a specified degree.

Declaration

public void SetAllPageRotations(PdfPageRotation Rotation)

Parameters

Type	Name	Description
PdfPageRotation	Rotation	Degrees of rotation

SetPageRotation(Int32, PdfPageRotation)

Set rotation degree to one page of the PdfDocument by a specified degree.

Declaration

public void SetPageRotation(int PageIndex, PdfPageRotation Rotation)

Parameters

Type	Name	Description
System.Int32	PageIndex	Index of the page to rotate. PageIndex is a 'Zero based' page number, the first page being 0.
PdfPageRotation	Rotation	Degrees of rotation

SetPageRotations(IEnumerable<Int32>, PdfPageRotation)

Set rotation degree to selected pages of the PdfDocument by a specified degree.

Declaration

public void SetPageRotations(IEnumerable<int> PageIndexes, PdfPageRotation Rotation)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	Indexes of the pages to rotate in an IEnumerable, list or array. PageIndex is a 'Zero based' page number, the first page being 0.
PdfPageRotation	Rotation	Degrees of rotation

Sign(PdfSignature, PdfDocument.SignaturePermissions)

Signs the PDF with digital signature with advanced options.

Note that the PDF will not be fully signed until Saved using SaveAs(String, Boolean), TrySaveAs(String), Stream or BinaryData. Multiple certificates may be used.

Declaration

public PdfDocument Sign(PdfSignature Signature, PdfDocument.SignaturePermissions Permissions)

Parameters

Type	Name	Description
PdfSignature	Signature	The PdfSignature.
PdfDocument.SignaturePermissions	Permissions	Permissions regarding modifications to the document after the digital signature is applied

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

SignWithFile(String, String, String, PdfDocument.SignaturePermissions)

Sign PDF with digital signature certificate. For more advanced options please see IronPdf.PdfDocument.SignPdfWithDigitalSignature(IronPdf.Signing.PdfSignature,IronPdf.PdfDocument.SignaturePermissions)

Note that the PDF will not be fully signed until Saved using SaveAs(String, Boolean), TrySaveAs(String), Stream or BinaryData. Multiple certificates may be used.

Declaration

public PdfDocument SignWithFile(string CertificateFilePath, string Password, string TimeStampUrl = null, PdfDocument.SignaturePermissions Permissions)

Parameters

Type	Name	Description
System.String	CertificateFilePath	The file path to a .pfx or .p12 digital signing certificate which may be generated using Adobe Acrobat Viewer.
System.String	Password	The certificate password as a String.
System.String	TimeStampUrl	Url to use for timestamping
PdfDocument.SignaturePermissions	Permissions	Permissions regarding modifications to the document after the digital signature is applied

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

SignWithStore(String, StoreLocation, PdfDocument.SignaturePermissions)

Signs the PDF with digital signature extracted from your computer's signature storage.

Note that the PDF will not be fully signed until Saved using SaveAs(String, Boolean), TrySaveAs(String), Stream or BinaryData. Multiple certificates may be used.

Declaration

public PdfDocument SignWithStore(string Thumbprint, StoreLocation StoreLocation, PdfDocument.SignaturePermissions Permissions)

Parameters

Type	Name	Description
System.String	Thumbprint	Thumbprint of a signature in your local computer's signature storage
System.Security.Cryptography.X509Certificates.StoreLocation	StoreLocation	Computer storage location
PdfDocument.SignaturePermissions	Permissions	Permissions regarding modifications to the document after the digital signature is applied

Returns

Type	Description
PdfDocument	Returns this PdfDocument object, allowing for a 'fluent' (LINQ like) chained in-line code style

ToBitmap(IEnumerable<Int32>, Int32)

Rasterizes (renders) the PDF into IronSoftware.Drawing.AnyBitmap objects.

Specific pages may be selected using the PageIndexes parameter.

Please add an assembly reference to IronSoftware.Drawing.AnyBitmap to use this "PDF To Image" method

Declaration

public AnyBitmap[] ToBitmap(IEnumerable<int> pageIndexes, int DPI = 96)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	pageIndexes	Specific zero based page index may be given to only convert part of the PDF document to images
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
IronSoftware.Drawing.AnyBitmap[]	An array of IronSoftware.Drawing.AnyBitmap image objects which can be saved, manipulated, displayed or edited programmatically.

Remarks

The DPI will be ignored under Linux and macOS.

ToBitmap(Int32)

Rasterizes (renders) the PDF into IronSoftware.Drawing.AnyBitmap objects. 1 Bitmap for each page.

Please add an assembly reference to IronSoftware.Drawing.AnyBitmap to use this "PDF To Image" method.

Please Dispose() each Bitmap object after use.

Declaration

public AnyBitmap[] ToBitmap(int DPI = 96)

Parameters

Type	Name	Description
System.Int32	DPI	The resolution of the output Bitmap in 'Dots Per Inch'. Higher DPI creates larger bitmap files of higher image quality.

Returns

Type	Description
IronSoftware.Drawing.AnyBitmap[]	An array of IronSoftware.Drawing.AnyBitmap image objects which can be saved, manipulated, displayed or edited programmatically.

Remarks

The DPI may be ignored on some Linux distros.

ToBitmap(Nullable<Int32>, Nullable<Int32>, IEnumerable<Int32>, Int32)

Rasterizes (renders) the PDF into IronSoftware.Drawing.AnyBitmap objects.

Specific pages may be selected using the PageIndexes parameter. The Widths and Height of the output images may be specified.

Please add an assembly reference to IronSoftware.Drawing.AnyBitmap to use this "PDF To Image" method

Declaration

public AnyBitmap[] ToBitmap(Nullable<int> imageMaxWidth, Nullable<int> imageMaxHeight, IEnumerable<int> pageIndexes = null, int DPI = 96)

Parameters

Type	Name	Description
System.Nullable<System.Int32>	imageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	imageMaxHeight	The target maximum height(in pixel) of the output images.
System.Collections.Generic.IEnumerable<System.Int32>	pageIndexes	Specific zero based page index may be given to only convert part of the PDF document to images
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
IronSoftware.Drawing.AnyBitmap[]	An array of IronSoftware.Drawing.AnyBitmap image objects which can be saved, manipulated, displayed or edited programmatically.

Remarks

The DPI will be ignored under Linux and macOS.

ToJpegImages(String, IEnumerable<Int32>, Int32)

Renders the pages of the PDF as JPEG files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToJpegImages(string FileNamePattern, IEnumerable<int> PageIndexes, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.jpg
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render as images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToJpegImages(String, IEnumerable<Int32>, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as JPEG files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToJpegImages(string FileNamePattern, IEnumerable<int> PageIndexes, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.jpg
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render as images.
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToJpegImages(String, Int32)

Renders the pages of the PDF as JPEG files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToJpegImages(string FileNamePattern, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.jpg
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToJpegImages(String, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as JPEG files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToJpegImages(string FileNamePattern, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_page_*.jpg
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToMultiPageTiffImage(String, IEnumerable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) file and saves it to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string ToMultiPageTiffImage(string FileName, IEnumerable<int> PageIndexes = null, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileName	A full file path for the output file. E.g. C:\images\pdf_pages.tiff
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page number to render
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String	A file path of the image file created.

Remarks

The DPI will be ignored under Linux and macOS.

ToMultiPageTiffImage(String, IEnumerable<Int32>, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) file and saves it to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToMultiPageTiffImage(string FileName, IEnumerable<int> PageIndexes, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileName	A full file path for the output file. E.g. C:\images\pdf_pages.tiff
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to number to render
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToMultiPageTiffImage(String, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) file and saves it to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToMultiPageTiffImage(string FileName, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileName	A full file path for the output file. E.g. C:\images\pdf_pages.tiff
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToPngImages(String, IEnumerable<Int32>, Int32)

Renders the pages of the PDF as PNG (Portable Network Graphic) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToPngImages(string FileNamePattern, IEnumerable<int> PageIndexes, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.png
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render as images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToPngImages(String, IEnumerable<Int32>, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as PNG (Portable Network Graphic) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToPngImages(string FileNamePattern, IEnumerable<int> PageIndexes, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.png
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page numbe to render
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToPngImages(String, Int32)

Renders the pages of the PDF as PNG (Portable Network Graphic) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToPngImages(string FileNamePattern, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.png
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToPngImages(String, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as PNG (Portable Network Graphic) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToPngImages(string FileNamePattern, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.png
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToString()

Represent PDF document as a document id string

Declaration

public override string ToString()

Returns

Type	Description
System.String

ToTiffImages(String, IEnumerable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToTiffImages(string FileNamePattern, IEnumerable<int> PageIndexes, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.tiff
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page number to render
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToTiffImages(String, IEnumerable<Int32>, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToTiffImages(string FileNamePattern, IEnumerable<int> PageIndexes, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.tiff
System.Collections.Generic.IEnumerable<System.Int32>	PageIndexes	A list of the specific zero based page number to render
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToTiffImages(String, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToTiffImages(string FileNamePattern, int DPI)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.tiff
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

ToTiffImages(String, Nullable<Int32>, Nullable<Int32>, Int32)

Renders the pages of the PDF as TIFF (Tagged Image File Format / Tif) files and saves them to disk.

Specific image dimensions and page numbers may be given as optional parameters

FileNamePattern should normally contain an asterisk (*) character which will be substituted for the page numbers

Declaration

public string[] ToTiffImages(string FileNamePattern, Nullable<int> ImageMaxWidth, Nullable<int> ImageMaxHeight, int DPI = 96)

Parameters

Type	Name	Description
System.String	FileNamePattern	A full or partial file path for the output files containing an asterisk. E.g. C:\images\pdf_pages_*.tiff
System.Nullable<System.Int32>	ImageMaxWidth	The target maximum width(in pixel) of the output images.
System.Nullable<System.Int32>	ImageMaxHeight	The target maximum height(in pixel) of the output images.
System.Int32	DPI	The desired resolution of the output Images.

Returns

Type	Description
System.String[]	An array of the file paths of the image files created.

Remarks

The DPI will be ignored under Linux and macOS.

TrySaveAs(String)

Attempt to save the PdfDocument to a file.

Declaration

public bool TrySaveAs(string FileName)

Parameters

Type	Name	Description
System.String	FileName	File Path

Returns

Type	Description
System.Boolean	}`true` if the file was saved successfully. `false` if an error occurred (e.g. file was locked or insufficient permissions).

VerifyPdfSignatures()

Verifies all the PDF signatures for this PDF document and returns true if there are no invalid signatures.

Declaration

public bool VerifyPdfSignatures()

Returns

Type	Description
System.Boolean	`true` if all digital signatures for this PDF document are currently valid. Editing a PDF document in any way will invalidate signatures.

VerifyPdfSignaturesInFile(String)

Verifies all the PDF signatures for a PDF file (by file path) and returns true if there are no invalid signatures.

Declaration

public static bool VerifyPdfSignaturesInFile(string PdfFilePath)

Parameters

Type	Name	Description
System.String	PdfFilePath	The full or relative PDF file path.

Returns

Type	Description
System.Boolean	`true` if all digital signatures for the PDF document are currently valid. Editing a PDF document in any way will invalidate signatures.

Implements

IPdfDocumentId

System.IDisposable