Installation
The product is delivered either as a ZIP package that you can download from our website or as a NuGet package that can be referenced in your project. Below is a brief overview of the folder structure of the downloadable ZIP package and the contents of the NuGet package.
The ZIP package includes the following main folders:
Lib Folder
The Lib folder contains the HiQPdf Library binaries for .NET Standard 2.0 and .NET Framework 2.0 and 4.0.
The net20 sub-folder contains the assembly built for .NET Framework 2.0, which can be directly referenced in applications targeting .NET Framework 2.0 or .NET Framework 3.5.
The net40 sub-folder contains the assembly built for .NET Framework 4.0, which can be directly referenced in applications targeting .NET Framework 4.0 or later. The sample .NET Framework applications we provide use this assembly to target .NET Framework 4.8.
The netstandard2.0 sub-folder contains the assembly built for .NET Standard 2.0, which can be used in applications targeting .NET 6, 7, 8, 9 or 10. The assembly from this folder can be directly referenced, but it also requires manually installing several dependent NuGet packages and copying the resource files. The recommended method is to install the NuGet package that contains this assembly, which automatically installs the required dependencies.
The sub-folders under Lib also include the HiQPdf.dep and HiQPdf.rda files, which are resource files required, and the XML API reference documentation.
Samples Folder
The Samples folder contains demo projects for .NET Framework and modern .NET (6 and later). It provides ready-to-use code examples for all the major features of the library.
The net48 sub-folder contains ASP.NET MVC, ASP.NET WebForms and WinForms projects targeting .NET Framework 4.8. These projects directly reference the .NET Framework 4.0 assembly from the Lib/net40 folder of the package.
The net8.0 and net10.0 sub-folders contain ASP.NET Core and Console App projects targeting .NET 8.0 and .NET 10.0. These projects reference the HiQPdf package.
NuGet Package
The product is also distributed as a NuGet package, which provides a convenient way to reference the product binaries in .NET projects.
The HiQPdf package contains assemblies for both .NET Framework and .NET Standard and can be referenced in projects targeting .NET Framework, .NET or .NET Standard 2.0 and later.
Our sample projects for .NET 8.0 and .NET 10.0 use this package.