Getting Started with Windows Forms PDF Viewer (PdfViewerControl)
24 Feb 20233 minutes to read
Adding reference to PdfViewerControl and dependent assemblies
Refer to the Control Dependencies section to get the list of assemblies.
Installing NuGet packages
Adding reference to Syncfusion assemblies through NuGet packages is illustrated in the NuGet Packages section.
NOTE
Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to include a license key in your projects. Please refer to this link to know about registering Syncfusion license key in your Windows Forms application to use our components.
Adding from the installed location
The WinForms PDF Viewer (PdfViewerControl) and dependent assemblies can be found from the below location in your machine.
system drive:\Program Files (x86)\Syncfusion\Essential Studio\21.1.35\precompiledassemblies\21.1.35\
Adding PdfViewerControl to an Application
From v16.3.0x onwards, PDF Viewer uses PDFium as a default rendering engine to render the PDF pages, which is a more robust and promising rendering engine. Refer to this link for more details.
Adding in designer
-
Open your form in the designer. Add the Syncfusion controls to your .NET toolbox in Visual Studio if you haven’t done so already (the install would have automatically done this unless you selected not to complete toolbox integration during installation).
-
Drag the PdfViewerControl from the toolbox onto the form. Appearance and behavior related aspects of the PdfViewerControl can be controlled by setting the appropriate properties through the properties grid.
-
This will add the instance ‘pdfViewerControl1’ to the Designer cs file. The PDF can be loaded in the Form cs file using the Load method.
//Loading the document in the PdfViewerControl pdfViewerControl1.Load("Sample.pdf");
'Loading the document in the PdfViewerControl pdfViewerControl1.Load("Sample.pdf")
Adding manually in code
-
Add Syncfusion.Windows.Forms.PdfViewer namespace.
using Syncfusion.Windows.Forms.PdfViewer;
Imports Syncfusion.Windows.Forms.PdfViewer
-
Create PdfViewerControl instance and load the PDF
//Initializing the PdfViewerControl PdfViewerControl pdfViewerControl1 = new PdfViewerControl(); //Loading the document in the PdfViewerControl pdfViewerControl1.Load("Sample.pdf"); //Add PdfViewerControl to the Form Controls.Add(pdfViewerControl1);
'Initializing the PdfViewerControl Dim pdfViewerControl1 As PdfViewerControl = New PdfViewerControl() 'Loading the document in the PdfViewerControl pdfViewerControl1.Load("Sample.pdf") 'Add PdfViewerControl to the Form Controls.Add(pdfViewerControl1)
Refer to Viewing PDF files for more information.
NOTE
You can also explore our WinForms PDF Viewer example that shows you how to render and configure the PDF Viewer.