Generate a PDF from HTML in C#
In today’s web-centric world, HTML content serves as the foundation for displaying information across digital platforms. However, HTML documents are dynamic by nature and can appear differently across browsers, devices, and screen sizes. When you need to preserve web content in a consistent, professional format for archiving, sharing, or printing, HTML to PDF conversion becomes invaluable.
PDFs maintain the exact layout, styling, and visual elements of the original web page, ensuring that recipients see your content exactly as intended. This consistency is crucial for generating reports from web applications, creating documentation from online sources, or preserving web content for legal or compliance purposes.
Converting HTML to PDF also addresses accessibility and distribution challenges. While HTML requires a web browser and internet connectivity, PDFs can be opened on virtually any device without additional software dependencies. This makes them ideal for offline viewing and long-term storage.
Streamlining Web Content Conversion with our .NET SDK
What makes HTML to PDF conversion particularly powerful with our SDK is its ability to handle both local HTML files and live web content from URLs. Using Chrome’s headless rendering engine, the SDK can process complex web pages with CSS styling, JavaScript, and dynamic content. This delivers high-fidelity PDF output that accurately represents the original web experience.
Whether you’re building a reporting system that captures dashboard data, creating offline documentation from web resources, or archiving web content for compliance, our SDK provides a robust solution. It handles the complexities of modern web rendering with ease.
Preparing the project
The first step is to initialize the SDK by registering the license. This needs to be done only once during the application’s lifetime and must occur before executing any further logic (see Getting Started with .NET SDK(opens in a new tab) for more details.)
using GdPicture14;
LicenseManager licence = new LicenseManager();licence.RegisterKEY("");Setting up the web browser engine
For HTML to PDF conversion, the SDK can use a Chrome headless browser engine to properly render web content (this is one of multiple strategies available). The SDK provides a convenient method to automatically download and configure the latest Chrome headless shell, ensuring optimal compatibility and performance.
GdPictureDocumentUtilities.SetWebBrowserPath(GdPictureDocumentUtilities.FetchLatestChromeHeadlessShell(Environment.CurrentDirectory));This approach downloads the Chrome headless shell to your application’s current directory and configures the SDK to use it for web content rendering. The download happens only once, and subsequent runs will use the cached version.
Proceeding with the conversion
With the SDK initialized and the browser engine configured, you can begin working with the GdPictureDocumentConverter class. Initialize the converter using a using statement to ensure proper resource management throughout the conversion process.
using GdPictureDocumentConverter converter = new GdPictureDocumentConverter();The SDK offers flexibility in how you load HTML content. You can load from local HTML files, HTML strings in memory, or directly from web URLs. For this example, we’ll demonstrate loading content from a live web URL, which showcases the SDK’s ability to handle real-world web pages with all their complexity.
When loading from HTTP sources, the SDK handles the entire process of fetching the web content, executing any JavaScript, applying CSS styles, and preparing the final rendered output for PDF conversion.
converter.LoadFromHttp(new("https://www.nutrient.io/sdk/dotnet"));Once the HTML content is loaded and rendered, you can export it to PDF format. The saving functionality provides the same flexibility as other SDK operations. You can save to a file path or work with streams depending on your application’s needs. Here, we’ll save the PDF to the application’s working directory.
converter.SaveAsPDF(@"output.pdf");Error handling
The .NET SDK handles errors by providing return codes. Both methods presented in this guide return a GdPictureStatus enum value, which helps with troubleshooting and implementing proper error handling logic. See Handling Errors with .NET SDK Guide for more information.
Conclusion
That’s all it takes to convert HTML content from a web URL into a PDF file! The SDK’s integration with Chrome’s rendering engine ensures that complex web pages are converted with high fidelity. It preserves layouts, fonts, images, and styling perfectly. You can also download this ready-to-use sample package, fully configured to help you explore the .NET SDK’s powerful web content conversion capabilities.