PRODUCT COMPARISONS

PDFsharp Add Page Numbers to PDF VS IronPDF (Example)

Chipego
Chipego Kalinda
February 19, 2025
Share:

The PDF (Portable Document Format) is a universally accepted format for sharing documents across various platforms. Its ability to preserve formatting, fonts, and layout makes it indispensable for business, legal, and educational purposes. As the need for PDF manipulation grows in software development, the .NET ecosystem provides developers with multiple libraries for working with PDFs. Among them, PDFSharp and IronPDF stand out as powerful solutions for PDF creation and manipulation.

This article will show you how to add page numbers to PDF documents using PDFsharp and IronPDF in C#, and compare the features of both libraries to help you decide which one best suits your needs.

What is IronPDF?

PDFsharp Add Page Numbers to PDF VS IronPDF (Example): Figure 1 - image.png

IronPDF is a powerful .NET library designed for seamless PDF creation, manipulation, and rendering. It stands out for its ability to convert HTML, CSS, and JavaScript directly into high-quality PDFs using a Chromium-based engine. This makes IronPDF an ideal solution for developers who need to convert dynamic web pages or complex HTML content into a well-formatted PDF, preserving the layout and style as it appears in the browser.

Key Features of IronPDF:

  • Converts HTML, JavaScript, and CSS to high-quality PDFs.
  • Enables custom headers, footers, watermarks, and other page elements.
  • Supports merging PDF files and splitting them.
  • Works seamlessly with .NET applications, including ASP.NET and MVC frameworks.
  • Provides precise control over PDF rendering, ensuring content is displayed as intended.
  • Offers a straightforward API for easy integration into projects.

To explore more advanced features and examples, refer to the official IronPDF documentation.

Installing IronPDF

To add IronPDF to your project, use the NuGet package manager in Visual Studio. You can install it using the Visual Command-Line interface or search directly in the NuGet Package Manager.

Command-line installation:

Install-Package IronPdf
Install-Package IronPdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf
$vbLabelText   $csharpLabel

Alternatively, you can search for "IronPDF" in the NuGet Package Manager and install it from there.

What is PDFSharp?

PDFsharp is a versatile .NET library focused on creating and manipulating PDF documents with high flexibility. Unlike other libraries, PDFsharp allows detailed control over the structure and design of PDFs, making it a great choice for developers who want to create documents from scratch or modify existing PDFs. With its rich API, PDFsharp supports a wide array of document manipulation tasks, including adding text, images, tables, and even page numbers.

Key Features of PDFSharp:

  • Creates, reads, and modifies PDF documents.
  • Customizable page events to add elements such as page numbers or footers.
  • Supports adding images, text, tables, and other content.
  • Offers detailed control over PDF layout and structure.
  • Can modify existing PDFs, including merging or splitting documents.
  • Open-source library with flexibility for developers to customize or extend.

To dive deeper into PDFSharp's functionality and usage, check out the PDFSharp GitHub repository.

Installing PDFsharp

To get started with PDFSharp, install the package via NuGet using the command line:

Command-line installation:

Install-Package PDFSharp
Install-Package PDFSharp
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package PDFSharp
$vbLabelText   $csharpLabel

Alternatively, you can search for "PDFSharp" in the NuGet Package Manager and install it from there.

How to Add Page Numbers using IronPDF

IronPDF is a versatile PDF library designed to handle a wide range of PDF operations, including adding page numbers. IronPDF operates internally on a Chromium engine, allowing it to offer precise rendering of HTML content as PDFs. With its simple API, adding page numbers to your PDF is both efficient and straightforward.

The following code is an example of how to add page numbers using IronPDF in C#:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            RenderingOptions = {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                },
            }
        };
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("pageNumbers.pdf");
    }
}
using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
        ChromePdfRenderer renderer = new ChromePdfRenderer()
        {
            RenderingOptions = {
                HtmlHeader = new HtmlHeaderFooter
                {
                    HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"
                },
            }
        };
        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("pageNumbers.pdf");
    }
}
Imports IronPdf
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>"
		Dim renderer As New ChromePdfRenderer() With {
			.RenderingOptions = {
				HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = "<center><i>{page} of {total-pages}</i></center>"}
			}
		}
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
		pdf.SaveAs("pageNumbers.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

Output

PDFsharp Add Page Numbers to PDF VS IronPDF (Example): Figure 2

This code demonstrates how to easily insert page numbers in the header of a PDF document. The HtmlHeaderFooter object is used to specify the header content, and placeholders like {page} and {total-pages} automatically populate with the page number and the total page count respectively.

With this approach, IronPDF simplifies the process of rendering HTML as PDFs while managing page number placement effortlessly.

How to Add Page Numbers using PDFsharp

PDFSharp is a comprehensive library for working with PDFs in C#. It provides tools for creating, modifying, and reading PDFs. Though it is not designed specifically for HTML-to-PDF conversion, it offers robust control over PDF documents, including the ability to add page numbers using custom page events. Whether you wish to add page numbers to just the first page, or second page, a range of pages, or just all of them.

Here’s an example of how to add page numbers using PDFSharp:

using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
internal class Program
{
    static void Main(string[] args)
    {
        // Create a new PDF document
        var doc = new PdfSharp.Pdf.PdfDocument();
        doc.Info.Title = "Page Numbers Example";
        // Create an empty first page
        PdfPage page = doc.AddPage();
        // Add page number in footer
        var gfx = PdfSharp.Drawing.XGraphics.FromPdfPage(page);
        var font = new PdfSharp.Drawing.XFont("Arial", 12);
        gfx.DrawString("Page " + (doc.PageCount), font, PdfSharp.Drawing.XBrushes.Black, new PdfSharp.Drawing.XPoint(500, 770));
        // Save the document
        doc.Save("PdfSharpOutput.pdf");
    }
}
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
internal class Program
{
    static void Main(string[] args)
    {
        // Create a new PDF document
        var doc = new PdfSharp.Pdf.PdfDocument();
        doc.Info.Title = "Page Numbers Example";
        // Create an empty first page
        PdfPage page = doc.AddPage();
        // Add page number in footer
        var gfx = PdfSharp.Drawing.XGraphics.FromPdfPage(page);
        var font = new PdfSharp.Drawing.XFont("Arial", 12);
        gfx.DrawString("Page " + (doc.PageCount), font, PdfSharp.Drawing.XBrushes.Black, new PdfSharp.Drawing.XPoint(500, 770));
        // Save the document
        doc.Save("PdfSharpOutput.pdf");
    }
}
Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a new PDF document
		Dim doc = New PdfSharp.Pdf.PdfDocument()
		doc.Info.Title = "Page Numbers Example"
		' Create an empty first page
		Dim page As PdfPage = doc.AddPage()
		' Add page number in footer
		Dim gfx = PdfSharp.Drawing.XGraphics.FromPdfPage(page)
		Dim font = New PdfSharp.Drawing.XFont("Arial", 12)
		gfx.DrawString("Page " & (doc.PageCount), font, PdfSharp.Drawing.XBrushes.Black, New PdfSharp.Drawing.XPoint(500, 770))
		' Save the document
		doc.Save("PdfSharpOutput.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

Output

PDFsharp Add Page Numbers to PDF VS IronPDF (Example): Figure 3

Conclusion

In summary, IronPDF stands out for its ability to easily add page numbers to existing PDF documents in one concise block of code, giving you full control over how and where your page numbers are displayed. While PDFsharp is a versatile option for creating and manipulating PDFs with fine-grained control, it does lead to a more manual, harder to implement approach to adding page numbers to PDF files.

IronPDF's commercial licensing is available, allowing users to evaluate its features before committing to a purchase.

For more information on IronPDF, visit the documentation page, and for PDFSharp, check out the GitHub repository.

Chipego
Software Engineer
Chipego has a natural skill for listening that helps him to comprehend customer issues, and offer intelligent solutions. He joined the Iron Software team in 2023, after studying a Bachelor of Science in Information Technology. IronPDF and IronOCR are the two products Chipego has been focusing on, but his knowledge of all products is growing daily, as he finds new ways to support customers. He enjoys how collaborative life is at Iron Software, with team members from across the company bringing their varied experience to contribute to effective, innovative solutions. When Chipego is away from his desk, he can often be found enjoying a good book or playing football.
< PREVIOUS
PDFsharp vs QuestPDF (C# PDF Library In-depth Comparison)
NEXT >
IronPDF vs PDFsharp PDF-to-Image Conversion (Code Example)