Installation

There are 2 ways to install SelectPdf Html To Pdf Converter - Community Edition library:

• Using a NuGet package (.NET Framework and .NET Core)

• Downloading assemblies

Installation using Nuget Packages

The easiest way to install Select.HtmlToPdf Community Edition is by using NuGet. A typical installation is two steps:

1. Install exactly one main library package - chosen by target framework.

2. Optionally install one engine companion package (Blink or Chromium) that matches the main package. Skip this step if the default WebKit engine is used.

1. Main library packages (install one)

Select.HtmlToPdf.NetCore

Modern .NET - .NET Framework 4.6.1 / 4.7.2, .NET Core 2.0+ through .NET Standard 2.0, .NET 5 - .NET 10 (Windows only).

https://www.nuget.org/packages/Select.HtmlToPdf.NetCore/

Select.HtmlToPdf

Legacy .NET Framework 2.0 - 4.5.

https://www.nuget.org/packages/Select.HtmlToPdf/

2. Engine companion packages (optional; install alongside the matching main package - see Rendering Engines)

Blink - modern .NET only (net461+ / .NET Core / .NET 5 - .NET 10):

Select.HtmlToPdf.NetCore.Blink

Companion for Select.HtmlToPdf.NetCore.

https://www.nuget.org/packages/Select.HtmlToPdf.NetCore.Blink/

Chromium (CEF) - available for every .NET target supported by Select.HtmlToPdf (see Chromium Engine):

Select.HtmlToPdf.NetCore.Chromium.Windows

Companion for Select.HtmlToPdf.NetCore.

https://www.nuget.org/packages/Select.HtmlToPdf.NetCore.Chromium.Windows/

Select.HtmlToPdf.Chromium.Windows

Companion for Select.HtmlToPdf.

https://www.nuget.org/packages/Select.HtmlToPdf.Chromium.Windows/

• The .NetCore packages cover .NET Framework 4.6.1 / 4.7.2, .NET Core 2.0+ through .NET Standard 2.0, and modern .NET 5 through .NET 10. They currently require Windows; they do not run on Linux, macOS or Xamarin.

• The Blink engine was introduced in SelectPdf v19.1 and requires modern .NET (net461+ or .NET Core 2.0+). The Chromium engine was introduced in SelectPdf v26.2 and is available for every .NET target Select.HtmlToPdf supports.

Installation using Downloaded Assemblies

SelectPdf Html To Pdf Converter for .NET Community Edition can be downloaded from the product site: http://selectpdf.com/community-edition.

SelectPdf Community Edition is shipped as a product archive with the following structure:

Assemblies

Contains the assemblies and related files needed by SelectPdf Library for .NET.

Select.Pdf Html To Pdf Converter is shipped with different versions for CLR 2.0 (.NET 2.0, 3.5) and for CLR 4.0 (.NET 4.0 and above) and for .NET Core and above (.NET 5 - .NET 10).

Documentation

Contains the product documentation in CHM format.

Samples

Contains C# and VB.NET samples that show how to use most of the features the library provides.

Project Setup

To use Select.Pdf Html To Pdf Converter Community Edition in a .NET project, a reference needs to be added to Select.HtmlToPdf.dll. Besides the .NET assembly, an additional file (Select.Html.dep) is also needed. This needs to be manually copied into the bin folder of the application, next to Select.HtmlToPdf.dll. Alternatively, the path to Select.Html.dep can be specified using the HtmlEngineFullPath property of the GlobalProperties class.

If Blink rendering engine is needed (only works with the .NET Core version and with .NET Framework 4.6.1 or above), Blink (Chromium) binaries need to be installed. That can be done via Nuget: https://www.nuget.org/packages/Select.HtmlToPdf.NetCore.Blink/. Alternatively, Blink binaries can be downloaded from SelectPdf website: https://selectpdf.com/free-downloads/. In this case, the Chromium folder needs to be manually copied to the bin folder of the application.

If the Chromium rendering engine is needed, install the companion Chromium.Windows Nuget package that matches the main Select.HtmlToPdf package already referenced in the project. The package deploys the Chromium runtime into the application output folder automatically at build time. See Chromium Engine for the full list of Chromium.Windows packages and for a sample of how to select the engine from code.

GAC Installation

If you plan to install Select.Pdf HtmlToPdf Converter into GAC, the only dll that needs to be added to GAC is Select.HtmlToPdf.dll. The related file (Select.Html.dep) will be automatically copied to GAC as a linked resource, so no additional action is needed for it (this is only valid for the .NET Framework 2.0 and 4.0-4.5 versions).

Dependencies

SelectPdf Html To Pdf Converter Community Edition has specific assemblies depending on the target platform. For some platforms, the library has external dependencies that need to be installed.

.NET Framework 2.0 - Newtonsoft.Json (13.0.3+).

.NET Framework 4.0-4.5 - Newtonsoft.Json (13.0.3+).

.NET Framework 4.6.1 - Newtonsoft.Json (13.0.3+), System.Buffers (4.5.1+), System.Numerics.Vectors (4.5.0+), System.Threading.Tasks.Extensions (4.5.2+).

.NET Framework 4.7.2 - Newtonsoft.Json (13.0.3+), System.Buffers (4.5.1+), System.Numerics.Vectors (4.5.0+), System.Threading.Tasks.Extensions (4.5.2+).

.NET Core 2.0 and above (through .NET Standard 2.0) - Microsoft.Win32.Registry (4.5.0+), Newtonsoft.Json (13.0.3+), System.Buffers (4.5.1+), System.Drawing.Common (4.7.3+), System.Numerics.Vectors (4.5.0+), System.Security.Cryptography.Pkcs (4.5.2+), System.Security.Permissions (4.5.0+), System.Security.Principal.Windows (4.5.1+), System.Text.Encoding.CodePages (4.5.1), System.Threading.Tasks.Extensions (4.5.2+).

Note: All external dependencies can be installed via Nuget.