 | |
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 SelectPdf Html to Pdf Converter is by using a Nuget Package. Create your project, go to Nuget Package Manager and install one of the following packages:
.NET Framework version - AnyCPU (.NET 2.0 and .NET 4.0-4.5) - Select.HtmlToPdf: https://www.nuget.org/packages/Select.HtmlToPdf/.
.NET Core version - Windows only (and .NET 4.6.1 and .NET 4.7.2) - Select.HtmlToPdf.NetCore: https://www.nuget.org/packages/Select.HtmlToPdf.NetCore/.
.NET Core version with Blink rendering engine - Windows only (and .NET 4.6.1 and .NET 4.7.2)- Select.HtmlToPdf.NetCore.Blink: https://www.nuget.org/packages/Select.HtmlToPdf.NetCore.Blink/.
Note: The .NET Core version is for .NET Core 2.0 or above through .NET Standard 2.0. Currently it requires a Windows system to run. It does not work on Linux or Mac or Xamarin.
Note 2: Blink rendering engine only works with .NET Core version and with .NET Framework starting with 4.6.1. Blink rendering engine was introduced with SelectPdf v19.1.
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.
- 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.
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 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).
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 - No external dependencies.
.NET Framework 4.0-4.5 - No external dependencies.
.NET Framework 4.6.1 - Newtonsoft.Json (12.0.1+), System.Buffers (4.5.0+), System.Numerics.Vectors (4.5.0+), System.Threading.Tasks.Extensions (4.5.2+).
.NET Framework 4.7.2 - Newtonsoft.Json (12.0.1+), System.Buffers (4.5.0+), System.Numerics.Vectors (4.5.0+), System.Threading.Tasks.Extensions (4.5.2+).
.NET Core 2.0 and above (through .NET Standard 2.0) - Newtonsoft.Json (12.0.1+), System.Buffers (4.5.0+), System.Drawing.Common (4.5.1+), System.Numerics.Vectors (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.
See Also