Choisir une bibliothèque de génération de documents pour .NET 8

iTextSharp - Non compatible avec .NET 8

iTextSharp (le portage .NET original d'iText) n'a pas été mis à jour depuis 2018. Il cible uniquement le .NET Framework :

erreur NU1202 : Le paquet iTextSharp 5.5.13 n'est pas compatible avec net8.0

Le chemin de migration est iText 7, qui a une API différente et nécessite soit la conformité AGPL (open-source de l'ensemble de l'application), soit une licence commerciale. Le prix n'est pas publié - des données de tiers suggèrent 15 000 à 210 000 dollars par an.

wkhtmltopdf Wrappers - DLL Loading Failures on .NET 8 (en anglais)

Les wrappers C# autour de wkhtmltopdf (DinkToPdf, Rotativa, NReco.PdfGenerator) échouent avec des erreurs spécifiques à la plateforme qui sont propres au modèle de déploiement de .NET 8 :

DinkToPdf - bibliothèque native non trouvée :

System.DllNotFoundException : Impossible de charger la DLL 'libwkhtmltox'

Rotativa.AspNetCore - nécessite une configuration manuelle du chemin binaire qui entre en conflit avec le déploiement en conteneur de .NET 8 :

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

// This pattern requires deploying wkhtmltopdf binaries alongside your app
// and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf");

' This pattern requires deploying wkhtmltopdf binaries alongside your app
' and breaks in Docker containers without explicit path configuration
RotativaConfiguration.Setup(env.WebRootPath, "wkhtmltopdf")

TuesPechkin / NReco - inadéquation de l'architecture :

System.BadImageFormatException : Impossible de charger le fichier ou l'assemblage

Ces erreurs reflètent un problème plus profond : wkhtmltopdf a été archivé en juillet 2024 avec des CVE non corrigées. L'architecture binaire native est antérieure aux améliorations de la détection de plateforme de .NET 8. Il n'y a pas de solution - seulement une migration vers une autre bibliothèque.

PdfSharp - System.Drawing.Common Failures on Linux (en anglais)

PdfSharp dépend de System.Drawing.Common, que Microsoft a déprécié pour les plateformes non Windows dans .NET 6. Dans .NET 8, cela produit des échecs d'exécution lors du déploiement sur Linux ou Docker :

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

using PdfSharp.Pdf;
using PdfSharp.Drawing;

var document = new PdfDocument();
// PlatformNotSupportedException on Linux:
// System.Drawing.Common is not supported on this platform

Imports PdfSharp.Pdf
Imports PdfSharp.Drawing

Dim document As New PdfDocument()
' PlatformNotSupportedException on Linux:
' System.Drawing.Common is not supported on this platform

PdfSharp 6.x s'efforce de supprimer cette dépendance, mais la prise en charge multiplateforme reste incomplète au début de l'année 2026. Pour les déploiements sous Windows uniquement, PdfSharp fonctionne avec .NET 8. Pour Linux, Docker ou les déploiements dans le nuage, il n'est pas fiable.

IronPDF- Prise en charge complète de .NET 8, multiplateforme

IronPDF cible net8.0 nativement avec un rendu Chromium intégré. Pas de dépendance System.Drawing.Common, pas de gestion native des binaires, pas de configuration spécifique à la plateforme.

Intégration minimale des API (le principal modèle de .NET 8) :

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

using IronPdf;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/invoice/{id}/pdf", async (int id, InvoiceService service) =>
{
    var invoice = await service.GetInvoiceAsync(id);
    var renderer = new ChromePdfRenderer();

    var pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml());

    return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
});

app.Run();

Imports IronPdf

Dim builder = WebApplication.CreateBuilder(args)
Dim app = builder.Build()

app.MapGet("/invoice/{id}/pdf", Async Function(id As Integer, service As InvoiceService) 
    Dim invoice = Await service.GetInvoiceAsync(id)
    Dim renderer = New ChromePdfRenderer()

    Dim pdf = renderer.RenderHtmlAsPdf(invoice.ToHtml())

    Return Results.File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
End Function)

app.Run()

Pour les équipes utilisant le modèle de contrôleur, le même code fonctionne à l'intérieur d'une action de contrôleur - RenderHtmlAsPdf renvoie un PdfDocument que vous pouvez convertir en octets avec .BinaryData.

Licence: Licence perpétuelle à partir de 749 $ (Lite - 1 développeur, 1 projet). Professionnel : 1 499 $ (10 développeurs). Enterprise : 2 999 $ (Unlimited). Publié sur ironpdf.com.

QuestPDF - Compatible .NET 8, Pas de HTML

QuestPDF fonctionne avec .NET 8 sans dépendance de plateforme. Son API C# fluide construit des documents de manière programmatique - pas d'analyseur HTML, pas de moteur CSS, pas de moteur de navigateur :

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

using QuestPDF.Fluent;
using QuestPDF.Infrastructure;

QuestPDF.Settings.License = LicenseType.Community; // Free under $1M revenue

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(col =>
        {
            col.Item().Text("Q4 Report").FontSize(24).Bold();
            col.Item().Table(table =>
            {
                table.ColumnsDefinition(c => { c.RelativeColumn(2); c.RelativeColumn(1); c.RelativeColumn(1); });
                table.Header(h =>
                {
                    h.Cell().Text("Metric").Bold();
                    h.Cell().Text("Value").Bold();
                    h.Cell().Text("Change").Bold();
                });
                table.Cell().Text("Revenue"); table.Cell().Text("$1.2M"); table.Cell().Text("+12%");
                table.Cell().Text("Users"); table.Cell().Text("45,230"); table.Cell().Text("+23%");
            });
        });
    });
}).GeneratePdf("report.pdf");

Imports QuestPDF.Fluent
Imports QuestPDF.Infrastructure

QuestPDF.Settings.License = LicenseType.Community ' Free under $1M revenue

Document.Create(Sub(container)
    container.Page(Sub(page)
        page.Size(PageSizes.A4)
        page.Margin(2, Unit.Centimetre)
        page.Content().Column(Sub(col)
            col.Item().Text("Q4 Report").FontSize(24).Bold()
            col.Item().Table(Sub(table)
                table.ColumnsDefinition(Sub(c)
                    c.RelativeColumn(2)
                    c.RelativeColumn(1)
                    c.RelativeColumn(1)
                End Sub)
                table.Header(Sub(h)
                    h.Cell().Text("Metric").Bold()
                    h.Cell().Text("Value").Bold()
                    h.Cell().Text("Change").Bold()
                End Sub)
                table.Cell().Text("Revenue")
                table.Cell().Text("$1.2M")
                table.Cell().Text("+12%")
                table.Cell().Text("Users")
                table.Cell().Text("45,230")
                table.Cell().Text("+23%")
            End Sub)
        End Sub)
    End Sub)
End Sub).GeneratePdf("report.pdf")

QuestPDF ne convertit pas le HTML. Si votre flux de travail utilise des modèles HTML (vues Razor, exportation de tableaux de bord, archivage de contenu web), vous avez besoin d'une autre bibliothèque. La licence communautaire couvre les entreprises dont le chiffre d'affaires annuel est inférieur à 1 million de dollars ; la traduction doit rester professionnelle, en préservant l'exactitude technique tout en expliquant les caractéristiques et les avantages de ces outils de développement.

iText 7 - Compatible .NET 8, Licence AGPL

iText 7 (le successeur de iTextSharp) prend en charge .NET 8. Le module complémentaire pdfHTML assure la conversion HTML-PDF à l'aide d'un analyseur personnalisé - et non d'un moteur de navigateur, de sorte que les fonctionnalités CSS modernes (Flexbox, Grid) ne s'affichent pas correctement.

Licence : AGPL pour l'utilisation de logiciels libres, licence commerciale (abonnement, prix non publié) pour les applications propriétaires. iText est passé aux licences commerciales par abonnement en 2024.

Image Debian standard (recommandée)

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app

#IronPDFworks without additional apt-get installs
# Chromium dependencies are handled internally

COPY --from=build /app/publish .

ENV DOTNET_RUNNING_IN_CONTAINER=true
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyApp.dll"]

Image alpine (plus petite empreinte)

FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
WORKDIR /src
COPY ["MyApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
WORKDIR /app

# Alpine requires explicit Chromium dependencies
RUN apk add --no-cache chromium nss freetype harfbuzz ca-certificates ttf-freefont

COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

L'image Debian ne nécessite aucun paquet supplémentaire. L'image Alpine est plus petite mais nécessite l'installation explicite de la bibliothèque Chromium. Pour la plupart des déploiements, l'image Debian standard est plus simple et plus fiable.

De iTextSharp à IronPDF

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

// Before (iTextSharp — doesn't compile against net8.0)
using iTextSharp.text;
using iTextSharp.text.pdf;

var doc = new Document();
PdfWriter.GetInstance(doc, new FileStream("output.pdf", FileMode.Create));
doc.Open();
doc.Add(new Paragraph("Hello World"));
doc.Close();

// After (IronPDF — targets net8.0)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>");
pdf.SaveAs("output.pdf");

Imports iTextSharp.text
Imports iTextSharp.text.pdf
Imports IronPdf
Imports System.IO

' Before (iTextSharp — doesn't compile against net8.0)
Dim doc As New Document()
PdfWriter.GetInstance(doc, New FileStream("output.pdf", FileMode.Create))
doc.Open()
doc.Add(New Paragraph("Hello World"))
doc.Close()

' After (IronPDF — targets net8.0)
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<p>Hello World</p>")
pdf.SaveAs("output.pdf")

Du wkhtmltopdf Wrappers à IronPDF

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

// Before (DinkToPdf — DllNotFoundException on .NET 8)
var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument
{
    Objects = { new ObjectSettings { HtmlContent = html } }
};
var bytes = converter.Convert(doc);

// After (IronPDF — native .NET 8 support)
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var bytes = pdf.BinaryData;

Imports IronPdf

' Before (DinkToPdf — DllNotFoundException on .NET 8)
Dim converter = New SynchronizedConverter(New PdfTools())
Dim doc = New HtmlToPdfDocument With {
    .Objects = {New ObjectSettings With {.HtmlContent = html}}
}
Dim bytes = converter.Convert(doc)

' After (IronPDF — native .NET 8 support)
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)
bytes = pdf.BinaryData

La surface de l'API est plus simple dans les deux cas. Le principal coût de migration consiste à tester vos modèles HTML existants avec le nouveau moteur de rendu afin de vérifier que le résultat correspond aux attentes.