.NET 8 için Belge Üretim Kütüphanesi Seçimi

iText— .NET 8 ile Uyumsuz

iText (iText'in orijinal .NET portu) 2018'den beri güncellenmemiştir. Sadece .NET Framework'ü hedefler:

hata NU1202: Paket iTextSharp 5.5.13 net8.0 ile uyumlu değil

Geçiş yolu, farklı bir API'ye sahip olan ve ya AGPL uyumluluğu (tüm uygulamanızı açık kaynağa dönüştürün) ya da ticari lisanslama gerektiren iText'tir. Fiyatlandırma yayınlanmamış — üçüncü taraf verileri $15,000–$210,000/yıl öneriyor.

wkhtmltopdf Çevreleyicileri — .NET 8'de DLL Yükleme Hataları

Wkhtmltopdf etrafında C# çevreleyicileri (DinkToPdf, Rotativa, NReco.PdfGenerator) .NET 8'deki dağıtım modeliyle yalnızca platforma özgü hatalar ile başarısız oluyor:

DinkToPdf — yerel kütüphane bulunamadı:

System.DllNotFoundException: 'libwkhtmltox' DLL'i yüklenemedi

Rotativa.AspNetCore — .NET 8'in kapsayıcı öncelikli dağıtımıyla çelişen manuel ikili yol yapılandırması gerektiriyor:

// 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 — mimari uyumsuzluk:

System.BadImageFormatException: Dosya veya derlemeyi yükleyemedi

Bu hatalar daha derin bir sorunu yansıtıyor: wkhtmltopdf, Temmuz 2024'te arşivlendi yamalanmamış CVE'lerle. Yerel binary mimarisi .NET 8'in platform algılama iyileştirmelerinin öncesinde geldi. Hiçbir düzeltme yok — sadece farklı bir kütüphaneye geçiş var.

PDFSharp— Linux'ta System.Drawing.Common Başarısızlıkları

PDFSharp, Microsoft'un .NET 6'da Windows dışı platformlar için kullanımdan kaldırdığı System.Drawing.Common'a bağlıdır. .NET 8'de, Linux veya Docker'a dağıtıldığında çalışma zamanı hatalarına neden olur:

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, bu bağımlılığı kaldırmak için çalışmıştır, ancak 2026 başı itibariyle platformlar arası destek hala tamamlanmamıştır. Sadece Windows dağıtımları için PDFSharp, .NET 8 ile çalışır. Linux, Docker veya bulut dağıtımları için güvenilir değildir.

IronPDF— Tam .NET 8 Desteği, Çapraz Platform

IronPDF, gömülü Chromium render ile yerel olarak net8.0 hedefler. System.Drawing.Common bağımlılığı yok, yerel binary yönetimi yok, platforma özel yapılandırma yok.

Minimal API entegrasyonu (ana .NET 8 modeli):

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

Controller pattern kullanan ekipler için, aynı kod bir controller işleminde çalışır — RenderHtmlAsPdf, .BinaryData ile baytlara dönüştürebileceğiniz bir PdfDocument döndürür.

Lisanslama: Süresiz lisans, $2,998'dan başlar (Lite — 1 geliştirici, 1 proje). Professional: $1,499 (10 geliştirici). Enterprise: $2,999 (sınırsız). ironpdf.com adresinde yayınlanmıştır.

QuestPDF— .NET 8 Uyumlu, HTML Yok

QuestPDF, platform bağımlılıkları olmadan .NET 8 ile çalışır. Akıcı C# API'si belgeleri programatik olarak oluşturur — HTML ayrıştırıcı, CSS motoru, tarayıcı motoru yok:

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 HTML dönüştürmez. İş akışınız HTML şablonları kullanıyorsa (Razor görünümleri, pano dışa aktarımları, web içerik arşivi), farklı bir kütüphaneye ihtiyacınız var. Topluluk Lisansı, yıllık $1M brüt gelir altındaki işletmeleri kapsar; bu eşiği geçerseniz, ticari lisans gereklidir.

iText— .NET 8 Uyumlu, AGPL Lisanslı

iText (iText'in ardılı) .NET 8'i destekler. pdfHTML eklentisi, özel bir ayrıştırıcı ile HTML-to-PDF dönüşümü sağlar — bir tarayıcı motoru değildir, bu nedenle modern CSS özellikleri (Flexbox, Grid) doğru şekilde rendere edilmez.

Lisanslama: AGPL açık kaynak kullanımı için, ticarî uygulamalar için ticarî lisanslama (abonelik, fiyat açıklanmadı).iText2024'te abonelik bazlı ticarî lisansa geçiş yaptı.

Standart Debian Görüntüsü (Önerilen)

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 Görüntüsü (Daha Küçük Bir Kapasite)

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

Debian görüntüsü hiçbir ek paket gerektirmez. Alpine görüntüsü daha küçüktür ama açıkça Chromium kütüphane kurulumu gerektirir. Çoğu dağıtım için, standart Debian görüntüsü daha basit ve daha güvenilir.

iText'ten IronPDF'e

// 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")

wkhtmltopdf Çevreleyicilerinden IronPDF'e Geçiş

// 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

Her iki durumda da API yüzeyi daha basittir. Ana geçiş maliyeti, çıktının beklentilere uygun olduğunu doğrulamak için mevcut HTML şablonlarınızı yeni render motoruna karşı test etmenizdir.