🎯 Why Modern Applications Need a Document → PDF Engine
| Business Pain | What Happens Without Sheetize |
|---|---|
| Fragmented Reporting Sources | Data lives in spreadsheets, CSV dumps, e‑books, and HTML pages; each requires a custom PDF renderer. |
| Manual Export/Print | Users click “Print” in each app, copy‑pasting tables into Word or Adobe, which is error‑prone and time‑consuming. |
| Inconsistent Styling & Branding | Fonts, colors, headers/footers differ across sources, breaking corporate identity. |
| Scalability Bottlenecks | Ad‑hoc scripts can’t keep up with nightly batch jobs that produce thousands of PDFs. |
Solution: Sheetize PDF Converter for .NET – a single, royalty‑free library that preserves layout, metadata, and embedded media while converting any of the following document formats directly to PDF:
- Spreadsheets: Xlsx, Xlsb, Xlsm, Xltm, Xlam, Excel97To2003, Excel95, SpreadsheetML, Xlt, Csv, Tsv, SqlScript, Dif
- Markup & E‑books: Xml, Epub, Azw3, Html, MHtml
- Other: Json (rendered as a formatted table or pre‑styled report)
All conversions are performed with zero‑pain code and full .NET Framework compatibility.
🚀 Core Benefits at a Glance
| Feature | Benefit |
|---|---|
| One‑Click Document → PDF | Export any supported file into a print‑ready PDF in seconds – ideal for APIs, email attachments, and archiving. |
| Preserve Metadata & Images | Titles, authors, custom properties, and embedded pictures survive the conversion unchanged. |
| High‑Fidelity Rendering | Cell styles, fonts, colors, merged cells, and hyperlinks are reproduced faithfully in the PDF. |
| Cross‑Platform | Works on .NET 8, .NET Framework 4.x, Azure Functions, AWS Lambda, and on‑prem servers. |
| Streaming API | Convert using streams to avoid temporary files, enabling massive parallel processing. |
| Transparent Licensing | Perpetual runtime license, free updates, no per‑seat fees. |
| Performance‑Optimized | Bench‑marked to generate > 150 PDFs/sec on a 8‑core VM. |
📄 Converting a Spreadsheet → PDF – 5‑Line Sample
using Sheetize;
// 1️⃣ Load the license (free trial – no credit‑card required)
var license = new Sheetize.License();
license.SetLicense(@"C:\Sheetize.PdfConverter_for_.NET.lic");
// 2️⃣ Define input (any spreadsheet format)
var loadOpts = new LoadOptions
{
InputFile = @"C:\Data\Financials.xlsx"
};
// 3️⃣ Define PDF output options
var saveOpts = new PdfSaveOptions
{
OutputFile = @"C:\Exports\Financials.pdf"
};
// 4️⃣ Execute conversion
SpreadsheetConverter.Process(loadOpts, saveOpts);
Console.WriteLine("✅ Spreadsheet exported to PDF.");
Result: A paginated, searchable PDF that mirrors the original workbook—including styled cells, merged ranges, charts, and embedded images—ready for distribution or archiving.
📦 Converting JSON → PDF (e.g., JSON Report → PDF) – 5‑Line Sample
using Sheetize;
// License
var license = new Sheetize.License();
license.SetLicense(@"C:\Sheetize.PdfConverter_for_.NET.lic");
// Load JSON source (could be a stream, a string, or a file)
var loadOpts = new LoadOptions
{
InputFile = @"C:\Exports\Report.json"
};
// PDF output configuration
var saveOpts = new PdfSaveOptions
{
OutputFile = @"C:\Results\Report_FromJson.pdf"
};
SpreadsheetConverter.Process(loadOpts, saveOpts);
Console.WriteLine("✅ JSON data rendered into PDF.");
Result: A clean, printable PDF where each JSON array becomes a table, keys become column headers, and numeric values are right‑aligned. You can also embed images encoded in the JSON (Base‑64) directly into the PDF.
Tip: Switch
PdfSaveOptionsproperties (e.g.,HeaderTemplate,FooterTemplate) to inject company logos, page numbers, or watermarks.
🛡️ Robust Error Handling & Validation
The following pattern guarantees that the destination is always PDF and validates both source and target extensions before invoking the library.
using Sheetize;
using System;
using System.IO;
using System.Linq;
try
{
// 1️⃣ License validation
var license = new Sheetize.License();
license.SetLicense(@"C:\Licenses\Sheetize.PdfConverter_for_.NET.lic");
// 2️⃣ Input & output paths
string inputPath = @"C:\Input\Catalog.epub";
string outputPath = @"C:\Output\Catalog.pdf";
// 3️⃣ Supported input extensions
var docExts = new[]
{
".xlsx",".xlsb",".xlsm",".xltm",".xlam",".xls",".xml",
".csv",".tsv",".sqlscript",".dif",".epub",".azw3",
".html",".mhtml",".json"
};
// 4️⃣ Validate output is PDF
if (!Path.GetExtension(outputPath).Equals(".pdf", StringComparison.OrdinalIgnoreCase))
throw new InvalidOperationException("Output must be a PDF file.");
// 5️⃣ Validate input extension
if (!docExts.Contains(Path.GetExtension(inputPath).ToLower()))
throw new NotSupportedException($"Unsupported input file type: {inputPath}");
// 6️⃣ Build options
var loadOpts = new LoadOptions { InputFile = inputPath };
var saveOpts = new PdfSaveOptions
{
OutputFile = outputPath
};
// 7️⃣ Execute conversion
SpreadsheetConverter.Process(loadOpts, saveOpts);
Console.WriteLine($"✅ Conversion succeeded: {outputPath}");
}
catch (Exception ex)
{
// Centralized logging (Serilog, NLog, Azure AppInsights, etc.)
Console.Error.WriteLine($"❌ Conversion failed: {ex.GetType().Name} – {ex.Message}");
// Re‑throw if you want upstream handling
// throw;
}
🎬 Real‑World Scenarios Powered by Sheetize PDF Converter
| # | Scenario | Input | Output | Business Outcome |
|---|---|---|---|---|
| 1️⃣ | Regulatory Reporting | XLSX, CSV, SqlScript | PDF (signed, timestamped) | Automated compliance PDFs without manual copy‑pasting. |
| 2️⃣ | E‑book Distribution | EPUB, AZW3 | PDF (print‑ready) | Provide royalty‑free PDF versions for academic libraries. |
| 3️⃣ | Invoice Generation | JSON (order data) | PDF (invoice template) | One‑click PDF invoices sent via email, reducing billing cycle time. |
| 4️⃣ | Marketing Collateral | HTML, MHTML | PDF (brand‑consistent) | Convert web‑pages into high‑resolution PDFs for offline sales decks. |
| 5️⃣ | Legacy Document Archival | Excel97To2003, Excel95, Dif | PDF (lossless) | Preserve old office files in a searchable, future‑proof format. |
📈 Performance & Scaling Tips
| Tip | How It Helps |
|---|---|
Reuse the License object | Avoids repeated I/O; speeds up batch jobs by ~12 %. |
Use the streaming API (LoadOptions.InputStream / PdfSaveOptions.OutputStream) | Eliminates temporary files → lower disk I/O, higher throughput. |
Parallel Execution (Parallel.ForEach) | Safely run many conversions concurrently on multi‑core servers. |
Disable Unused Features (IncludeComments = false, EmbedFonts = false when not required) | Reduces PDF size and conversion time. |
📦 Getting Started in Minutes
# 1️⃣ Install the NuGet package
dotnet add package Sheetize
# 2️⃣ Grab a free trial licence (no credit‑card needed)
# https://purchase.sheetize.com/temp-license/113911
# 3️⃣ Place the .lic file in your project (e.g., ./Licenses/Sheetize.PdfConverter_for_.NET.lic)
# 4️⃣ Use the code snippets above – compile and watch PDFs appear!
Frequently Asked Questions
| Question | Answer |
|---|---|
| Does the library support .NET 8? | Yes – fully tested on .NET 8, .NET Framework 4.x |
| Can I control PDF security (password, encryption)? | PdfSaveOptions exposes Password, OwnerPassword, and EncryptPdf flags. |
| What about large files (≥ 500 MB)? | Use the streaming API; the library processes data in chunks, keeping memory footprint under 200 MB. |
| Is metadata (author, title) kept in the PDF? | Set IncludeMetadata = true to embed source document properties into the PDF’s XMP block. |
| Do you offer enterprise support? | Paid licenses include 24/7 email/Slack support, SLA‑backed bug fixes, and optional on‑prem deployment assistance. |
📣 Call‑to‑Action
- Download the NuGet package (
dotnet add package Sheetize). - Run the “Hello‑PDF” console app using the samples above.
- Contact our sales team for a custom enterprise plan (unlimited conversions, dedicated support, on‑prem licensing).
➡️ Grab your trial now: https://purchase.sheetize.com/temp-license/113911