Compatibility

The client library for .NET is compatible with any platform that supports .NET Standard 2.0 and above or .NET Framework 4.0 and above, including the platforms listed below:

• .NET 10, 9, 8, 7, 6, 5, .NET Standard 2.0 and above
• .NET Framework 4.8.1, 4.7.2, 4.6.1, 4.0 and above
• Windows, Linux and macOS
• Azure, Azure App Service and Azure Functions
• Universal Windows Platform (UWP)
• Web, Console and Desktop applications

Getting Started

Before starting to use the Winnovative Client for .NET in your applications, you first have to install the Winnovative Server. The server can be installed as an Azure Cloud Service Worker Role, Azure Cloud Service Web Role, Azure Service Fabric application, IIS ASP.NET web application or Windows service.

Winnovative Server

Winnovative Server can be downloaded from the Winnovative Software Downloads page of the website. The Winnovative Server package contains the server files and detailed installation instructions for each platform.

You can start by installing the Winnovative Server as a Windows service on the local development machine with default options. In this case, the assigned IP address is 127.0.0.1.

After the Winnovative Server is installed, you are ready to use the Winnovative Client Library for .NET in your applications.

C# Code Samples

Copy the C# code lines from the section below to use the HTML to PDF Converter component to create a PDF document from a web page or from an HTML string and save the resulting PDF to a memory buffer for further processing, to a PDF file or send it to the browser for download in ASP.NET applications.

The server IP address is assigned during server installation and it can be omitted from the HtmlToPdfConverter constructor if the server was installed on the localhost IP address 127.0.0.1. There are also variants of the constructor accepting a URL instead of an IP address if the server was installed as a web service in Azure or in IIS.

At the top of your C# source file add the using WinnovativeClient; statement to make available the Winnovative Client API for your .NET application.

// add this using statement at the top of your C# file
using WinnovativeClient;

To convert an HTML string or a URL to a PDF file you can use the C# code below.

// create the converter object in your code where you want to run conversion
// change the serverIP value if the server was installed on a remote machine
string serverIP = "127.0.0.1";
HtmlToPdfConverter converter = new HtmlToPdfConverter(serverIP);

// convert the HTML string to a PDF file
converter.ConvertHtmlToFile("<b>Hello World</b> from Winnovative !", null, "HtmlToFile.pdf");

// convert HTML page from URL to a PDF file
string htmlPageURL = "https://www.winnovative-software.com";
converter.ConvertUrlToFile(htmlPageURL, "UrlToFile.pdf");

To convert an HTML string or a URL to a PDF document in a memory buffer and then save it to a file you can use the C# code below.

// create the converter object in your code where you want to run conversion
// change the serverIP value if the server was installed on a remote machine
string serverIP = "127.0.0.1";
HtmlToPdfConverter converter = new HtmlToPdfConverter(serverIP);

// convert a HTML string to a memory buffer
byte[] htmlToPdfBuffer = converter.ConvertHtml("<b>Hello World</b> from Winnovative !", null);

// write the memory buffer to a PDF file
System.IO.File.WriteAllBytes("HtmlToMemory.pdf", htmlToPdfBuffer);

// convert an URL to a memory buffer
string htmlPageURL = "https://www.winnovative-software.com";
byte[] urlToPdfBuffer = converter.ConvertUrl(htmlPageURL);

// write the memory buffer to a PDF file
System.IO.File.WriteAllBytes("UrlToMemory.pdf", urlToPdfBuffer);

To convert in your ASP.NET Core and ASP.NET MVC applications an HTML string or a URL to a PDF document in a memory buffer and then send it for download to the browser you can use the C# code below.

// create the converter object in your code where you want to run conversion
// change the serverIP value if the server was installed on a remote machine
string serverIP = "127.0.0.1";
HtmlToPdfConverter converter = new HtmlToPdfConverter(serverIP);

// convert a HTML string to a memory buffer
byte[] htmlToPdfBuffer = converter.ConvertHtml("<b>Hello World</b> from Winnovative !", null);

FileResult fileResult = new FileContentResult(htmlToPdfBuffer, "application/pdf");
fileResult.FileDownloadName = "HtmlToPdf.pdf";
return fileResult;

To convert in your ASP.NET Web Forms application a HTML string to a PDF document in a memory buffer and then send it for download to browser you can use the C# code below.

// create the converter object in your code where you want to run conversion
// change the serverIP value if the server was installed on a remote machine
string serverIP = "127.0.0.1";
HtmlToPdfConverter converter = new HtmlToPdfConverter(serverIP);

// convert a HTML string to a memory buffer
byte[] htmlToPdfBuffer = converter.ConvertHtml("<b>Hello World</b> from Winnovative !", null);

HttpResponse httpResponse = HttpContext.Current.Response;
httpResponse.AddHeader("Content-Type", "application/pdf");
httpResponse.AddHeader("Content-Disposition",
    String.Format("attachment; filename=HtmlToPdf.pdf; size={0}",
    htmlToPdfBuffer.Length.ToString()));
httpResponse.BinaryWrite(htmlToPdfBuffer);
httpResponse.End();

Free Trial

You can download the full Winnovative Client for .NET evaluation package from the Winnovative Software Downloads page of the website.

The evaluation package for .NET contains the product binaries and demo projects with full C# code for .NET Framework and .NET Core.

There are separate demo projects for each major component of the library, including HTML to PDF, Word to PDF, Excel to PDF, PDF to Text, PDF to Image, PDF to HTML and PDF Images Extractor.

You can evaluate the library for free for as long as needed to ensure that the solution fits your application requirements.

Licensing

Winnovative Software licenses are perpetual, which means they never expire for a given product version and include free maintenance for the first year. You can find more details about licensing on the website.

The same license keys for Winnovative software work with both the regular libraries for .NET and Winnovative Client for .NET. For example, a license key for Winnovative PDF Toolkit PRO works with all components of the client library, while a license for HTML to PDF Converter works only with that specific component of the client library.

Support

For technical and sales questions or for general inquiries about our software and company, you can contact us using the email addresses provided on the contact page of the website.