ceTe.DynamicPDF.HtmlConverter.NET 3.4.0

DynamicPDF HTMLConverter for .NET

DynamicPDF HTMLConverter for .NET enables you to easily generate PDF documents from HTML content or URLs. It uses the Chromium engine internally to render HTML with high fidelity.

Note

This library uses Chromium binaries downloaded from:

https://googlechromelabs.github.io/chrome-for-testing/

DynamicPDF does not build Chromium. You may also configure the library to use an existing Chromium installation available on your system instead of the bundled binaries.

Contents

• Introduction
• Deployment
• Dependencies
• DynamicPDF Converter Service
• Help Documentation
• Examples
• Licensing

Introduction

DynamicPDF HTMLConverter for .NET allows you to create PDF documents from HTML text or web URLs with ease while leveraging the Chromium rendering engine for accurate HTML-to-PDF conversion.

Deployment

Simply reference DynamicPDF.HTMLConverter.dll in your .NET application.

.NET Assembly

The library targets .NET Standard 2.0, making it compatible with:

• .NET Framework
• .NET Core
• .NET 5+
• Any platform supporting .NET Standard 2.0

The accompanying XML documentation file is used for IntelliSense and does not need to be distributed with your application.

Dependencies

The HTMLConverter requires Chromium to render HTML.

You have two options:

• Use the ceTe.DynamicPDF.HtmlToPDFResources NuGet package, which contains the Chromium binaries provided by DynamicPDF.
• Configure the library to use an existing Chromium installation already available on your system.

DynamicPDF Converter Service

When your application runs under a user account with restricted access to system resources (for example, an IIS application pool), DynamicPDF HTMLConverter requires a Windows service to perform HTML-to-PDF conversions.

DynamicPDF.HTMLConverter.dll automatically detects and uses the service when it is available. If you are using the DynamicPDF Converter for .NET product, please follow the installation and usage instructions provided with that product, as both versions use the same Windows service.

Note

If you are already using DynamicPDF Converter for .NET, follow the installation instructions provided with that product. Both products use the same Windows service.

Installing the Converter Service

1. Uninstall any previous version of the DynamicPDF Converter service.

2. Locate the DPDFConverterService folder.

3. Copy the following files to a permanent location:

   • DynamicPDF.Converter.Service.exe
   • DynamicPDF.Converter.Service.exe.config
   • ReadMe.txt

4. Open Command Prompt as Administrator.

5. Navigate to the folder containing the service files.

6. Run:

DynamicPDF.Converter.Service.exe /r

7. When prompted, enter the credentials for a Windows user account under which the service will run.

Uninstalling the Converter Service

Open Command Prompt as Administrator, navigate to the service directory, and run:

DynamicPDF.Converter.Service.exe /u

Help Documentation

Complete documentation and API reference:

https://www.dynamicpdf.com/docs/dotnet/html-converter-welcome

Examples

Sample projects are available on GitHub:

https://github.com/DynamicPDF/html-converter-dotnet-core

Licensing

DynamicPDF HTMLConverter is licensed under the DynamicPDF Essentials End User License Agreement (EULA).

For complete licensing information:

https://www.dynamicpdf.com/Company/LicenseAgreement/EULA.pdf