How to paginate an image in PDF using C# and VB.NET
Syncfusion Essential PDF is a .NET PDF library used to create, read, and edit PDF documents. Using this library, you can allow a large image to paginate across multiple pages in the PDF document using C# and VB.NET.
Steps to draw paginated image on PDF programmatically:
- Create a new C# console application project.
- Install the Syncfusion.Pdf.WinForms NuGet packages as reference to your .NET Framework application from NuGet.org.
- Include the following namespaces in the Program.cs file.
C#
using Syncfusion.Pdf; using Syncfusion.Pdf.Graphics;
VB.NET
Imports Syncfusion.Pdf Imports Syncfusion.Pdf.Graphics
- Use the following code snippet to create PDF and draw image on it.
C#
//Create a document
PdfDocument doc = new PdfDocument();
//Add new page
PdfPage page = doc.Pages.Add();
//Load a bitmap
PdfBitmap image = new PdfBitmap( "Autumn Leaves.jpg");
//Set layout property to break the element across the pages
PdfLayoutFormat format = new PdfLayoutFormat();
format.Break = PdfLayoutBreakType.FitPage;
format.Layout = PdfLayoutType.Paginate;
//Draw image
image.Draw(page, 20, 400, format);
//Save the PDF
doc.Save("ImagePagination.pdf");
doc.Close(true);
//This will open the PDF file so, the result will be seen in default PDF viewer
Process.Start("ImagePagination.pdf");
VB.NET
'Create a document
Dim doc As New PdfDocument()
'Add new page
Dim page As PdfPage = doc.Pages.Add()
'Load a bitmap
Dim image As New PdfBitmap("Autumn Leaves.jpg")
'Set layout property to break the element across the pages.
Dim format As New PdfLayoutFormat()
format.Break = PdfLayoutBreakType.FitPage
format.Layout = PdfLayoutType.Paginate
'Draw image
image.Draw(page, 20, 400, format)
'Save the PDF
doc.Save("ImagePagination.pdf")
doc.Close(True)
'This will open the PDF file so, the result will be seen in default PDF viewer
Process.Start("ImagePagination.pdf")
A complete working sample can be downloaded from ImagePaginationSample.zip
By executing the program, you will get the PDF document as follows. 
Take a moment to peruse the documentation for working with images, where you will find other options like inserting, replacing image in PDF document, and image masking.
Refer here to explore the rich set of Syncfusion Essential PDF features.
Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, include a license key in your projects. Refer to link to learn about generating and registering Syncfusion license key in your application to use the components without trail message.
