Auswahl einer Dokumentenerstellungsbibliothek for .NET 8

iText— Nicht kompatibel mit .NET 8

iText (der ursprüngliche .NET-Port von iText) wurde seit 2018 nicht mehr aktualisiert. Es zielt nur auf das .NET Framework:

fehler NU1202: Das Paket iTextSharp 5.5.13 ist nicht kompatibel mit net8.0

Der Migrationsweg ist iText, das eine andere API hat und entweder die AGPL-Konformität (Open-Source für Ihre gesamte Anwendung) oder eine kommerzielle Lizenzierung erfordert. Die Preise werden nicht veröffentlicht - Daten von Drittanbietern deuten auf $15.000-$210.000/Jahr hin.

wkhtmltopdf Wrappers - DLL-Ladefehler unter .NET 8

C#-Wrapper um wkhtmltopdf (DinkToPdf, Rotativa, NReco.PdfGenerator) schlagen mit plattformspezifischen Fehlern fehl, die nur im .NET 8-Bereitstellungsmodell auftreten:

DinkToPdf - native Bibliothek nicht gefunden:

System.DllNotFoundException: DLL 'libwkhtmltox' kann nicht geladen werden

Rotativa.AspNetCore - erfordert eine manuelle Konfiguration des Binärpfads, die mit der Container-First-Bereitstellung von .NET 8 in Konflikt steht:

// 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 - Unstimmigkeiten in der Architektur:

System.BadImageFormatException: Datei oder Baugruppe konnte nicht geladen werden

Diese Fehler spiegeln ein tiefer liegendes Problem wider: wkhtmltopdf wurde im Juli 2024 archiviert mit ungepatchten CVEs. Die native Binärarchitektur ist älter als die Verbesserungen der Plattformerkennung von .NET 8. Es gibt keinen Fix - nur die Migration zu einer anderen Bibliothek.

PDFSharp— System.Drawing.Common-Fehler unter Linux

PDFSharp ist abhängig von System.Drawing.Common, das Microsoft für Nicht-Windows-Plattformen in .NET 6 eingestellt hat. In .NET 8 führt dies zu Laufzeitfehlern bei der Bereitstellung unter Linux oder 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 arbeitet daran, diese Abhängigkeit zu entfernen, aber die plattformübergreifende Unterstützung ist bis Anfang 2026 noch unvollständig. Für Windows-only Bereitstellungen funktioniertPDFSharpmit .NET 8. Für Linux, Docker oder Cloud-Bereitstellungen ist es unzuverlässig.

IronPDF- Volle Unterstützung for .NET 8, plattformübergreifend

IronPDF zielt nativ auf net8.0 mit eingebetteter Chromium-Darstellung. Keine System.Drawing.Common-Abhängigkeit, keine native Binärverwaltung, keine plattformspezifische Konfiguration.

Minimale API-Integration (das primäre .NET 8-Muster):

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()

Für Teams, die das Controller-Muster verwenden, funktioniert derselbe Code innerhalb einer Controller-Aktion — RenderHtmlAsPdf gibt ein PdfDocument zurück, das Sie mit .BinaryData in Bytes umwandeln können.

Lizenzierung: Unbefristete Lizenz ab $2,998 (Lite — 1 Entwickler, 1 Projekt). Professional: 1.499 $ (10 Entwickler). Enterprise: $2.999 (unbegrenzt). Veröffentlicht auf ironPdf.com.

QuestPDF - .NET 8-kompatibel, kein HTML

QuestPDF arbeitet mit .NET 8 ohne Plattformabhängigkeiten. Die fließende C#-API erstellt Dokumente programmatisch - kein HTML-Parser, keine CSS-Engine, keine Browser-Engine:

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 konvertiert kein HTML. Wenn Ihr Arbeitsablauf HTML-Vorlagen verwendet (Razor-Ansichten, Dashboard-Exporte, Archivierung von Webinhalten), benötigen Sie eine andere Bibliothek. Die Community-Lizenz gilt für Unternehmen mit einem Jahresumsatz von weniger als 1 Million US-Dollar; darüber hinaus ist eine kommerzielle Lizenzierung erforderlich.

iText— .NET 8 kompatibel, AGPL-lizenziert

iText (der Nachfolger von iText) unterstützt .NET 8. Das pdfHTML-Add-on bietet eine HTML-zu-PDF-Konvertierung mit einem benutzerdefinierten Parser — kein Browser-Engine, daher werden moderne CSS-Features (Flexbox, Grid) nicht korrekt wiedergegeben.

Lizenzierung: AGPL für Open-Source-Nutzung, kommerzielle Lizenzierung (Abonnement, Preise nicht veröffentlicht) für proprietäre Anwendungen. iTextwird 2024 auf eine kommerzielle Lizenzierung auf Abonnementbasis umgestellt.

Standard-Debian-Abbild (empfohlen)

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"]

Alpine Image (Kleinerer Fußabdruck)

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"]

Das Debian-Image erfordert keine zusätzlichen Pakete. Das Alpine-Image ist kleiner, erfordert aber eine explizite Installation der Chromium-Bibliothek. Für die meisten Einsätze ist das Standard-Debian-Image einfacher und zuverlässiger.

Von iTextzu 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")

Von wkhtmltopdf Wrappers zu 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

Die API-Oberfläche ist in beiden Fällen einfacher. Die Hauptkosten für die Migration bestehen darin, Ihre vorhandenen HTML-Vorlagen mit dem neuen Renderer zu testen, um zu überprüfen, ob die Ausgabe den Erwartungen entspricht.