Ücretsiz PDF Kütüphaneleri için .NET: Gizli Maliyetler ve C#'ta Daha İyi Alternatifler

"Ücretsiz" Eger .NET PDF Kutuphanelerinde Gerçekten Ne Anlama Geliyor?

"PDF" icin NuGet aramasi yapin ve .NET dağıtimlari icin farkli kisitlamalari olan bes lisanslama modelinde kutuphaneler bulacaksiniz:

MIT/Apache (gercekten musamaha gösteren): PdfSharp. Ticari uygulamalarda, Docker kapsayicilarinda, Azure Functions, AWS Lambda'da kullanin — hicbir sinirlama yok, hicbir gelir esigi yok, hicbir kaynak kodu aciklamasi yok. Isin yakin: HTML'yi PDF'e dönüştüremez.

AGPL (copyleft tuzagi):iText Core(eski iTextSharp). Herhangi bir agda erisilebilir uygulamada dağıtin — web uygulamalari, REST API'leri, mikrohizmetler — ve tüm kaynak kodunuzu AGPL altinda yayimlamaniz gerekecek. SaaS şirketleri icin muafiyet yok.

Gelir-kapali:QuestPDFTopluluk Lisansi. Yillik $1M brut gelir altinda ücretsiz. Bu esigi gecerseniz ticari bir lisans gerekir. Gecis asamali değil — bir ucurum.

Terk edilmis:wkhtmltopdfve tüm .NET cevreleri. Dokunulmamis CVE'ler 9.8 Kritik ile arsivlenmis. Sifir guvenlik bakimi. Herhangi bir uyumluluk denetiminde bir sorumluluk.

Isletim olarak pahali:PuppeteerSharpve Playwright for .NET. Lisans kisitlamasi yok, tam modern CSS destegi var — ancak uretimde harici tarayici sureclerle, Chromium indirmeleriyle ve bellek omru ile ilgileniyorsunuz.

Her kategori, .NET dağıtimlari icin farkli riskler oluşturur. Bu makalenin geri kalani, bu riskleri kod, sayilar ve NuGet ekosistem verileri ile aciklamaktadir.

Neden iText'in Fiyatlandirilmasi Asil Hikaye?

Cogu iText hakkinda makale, AGPL uygulama acisina odaklanir. Baska yerlerde ele alinmistir. .NET takimlarinin PDF kutuphanelerini degerlendirirken daha alakali olan soru, ticari bir lisansa ihtiyaç duydugunuzda neler oldugu.

PdfSharp'in .NET Dağıtimlari Icin Sinirlamalari Nelerdir?

PdfSharp ücretsiz kutuphaneler arasinda bir istisna: MIT lisansi, 34+ milyon NuGet indirilmesi, ticari kullanim icin gercekten musamaha gösteren. Gelir eşikleri yok. Kaynak kodu aciklamasi yok.

Sinirlama mimari derinliktedir.PdfSharpPDF koordinat seviyesinde calismaktadir. HTML parcayicisi, CSS motoru, DOM görüntülemesi yok.

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

Imports PdfSharp.Pdf
Imports PdfSharp.Drawing

Dim document As New PdfDocument()
Dim page As PdfPage = document.AddPage()
Dim gfx As XGraphics = XGraphics.FromPdfPage(page)

' Every element needs manual coordinates
Dim titleFont As New XFont("Arial", 18, XFontStyleEx.Bold)
Dim bodyFont As New XFont("Arial", 10)

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72)
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100)

' Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140)
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155)
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155)
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155)
gfx.DrawLine(XPens.Black, 72, 170, 540, 170)

' Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185)
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185)
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185)

document.Save("invoice.pdf")

Bu, stil, duyarlı yerleşim, CSS olmadan tek satirlik bir fatura icin 20 satirdir. Simdi dinamik veriler, grafikler ve kurumsal marka ile 15 sayfalik bir uyumluluk raporu oluşturmayi dusunun.

QuestPDFNe Zaman Ücretsiz Olmaktan Cikar?

QuestPDF, PdfSharp'tan farkli bir tasarim yaklasimi aldi: koordinat matematigi yerine bir yerlesim tanimi gibi okunan akici bir API. API tasarımı gerçekten iyi.

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(Sub(container)
    container.Page(Sub(page)
        page.Size(PageSizes.A4)
        page.Margin(2, Unit.Centimetre)

        page.Content().Column(Sub(column)
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold()
            column.Item().Table(Sub(table)
                table.ColumnsDefinition(Sub(columns)
                    columns.RelativeColumn(3)
                    columns.RelativeColumn(1)
                    columns.RelativeColumn(1)
                End Sub)

                table.Cell().Text("Item").Bold()
                table.Cell().Text("Qty").Bold()
                table.Cell().Text("Price").Bold()

                table.Cell().Text("Annual License")
                table.Cell().Text("1")
                table.Cell().Text("$749.00")
            End Sub)
        End Sub)
    End Sub)
End Sub).GeneratePdf("invoice.pdf")

PdfSharp'ın koordinat sisteminden daha ifadelidir. Ancak ayni temel sinirlamayi paylasir: HTML'yi görüntüleme yok.

wkhtmltopdf'yi .NET'de Herhangi Bir Dağıtimda Neden Kullanmayacaksiniz?

Bu makaleyi, bir neden icin CVE-2022-35583 ile actim. SSRF zafiyeti teorik değil — kanit konsepti istismarlar kamusal olarak mevcut ve aktif bir sekilde kullaniliyor.

PuppeteerSharp'ın Gerçek Operasyonel Maliyeti Nedir?

Bu bölüm, çoğu "ücretsiz PDF kitaplığı" makalesinde yanlış anlaşılmaktadır.PuppeteerSharpve .NET için Playwright teknik olarak mükemmeldir — gerçek Chromium üzerinden HTML'yi işler, her CSS özelliğini ve JavaScript API'sini destekler. Lisanslama kısıtlamaları yok. Gelir eşikleri yok.

Maliyet operasyoneldir. İşte üretimPuppeteerSharpPDF üretiminin aslında nasıl göründüğü:

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

Imports PuppeteerSharp
Imports System.Threading

Public Class PuppeteerPdfService
    Implements IDisposable

    Private _browser As IBrowser
    Private ReadOnly _semaphore As SemaphoreSlim
    Private _pdfCount As Long = 0

    Public Sub New()
        ' Limit concurrent pages to prevent memory exhaustion
        _semaphore = New SemaphoreSlim(3, 3)
    End Sub

    Public Async Function InitializeAsync() As Task
        ' Step 1: Download Chromium binary (~280MB)
        Dim fetcher = New BrowserFetcher()
        Await fetcher.DownloadAsync()

        ' Step 2: Launch with production-hardened flags
        _browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {
            .Headless = True,
            .Args = {
                "--no-sandbox",              ' Required in Docker
                "--disable-setuid-sandbox",  ' Required in Docker
                "--disable-dev-shm-usage",   ' Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            .Timeout = 30000
        })
    End Function

    Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte())
        Await _semaphore.WaitAsync()
        Dim page As IPage = Nothing

        Try
            Interlocked.Increment(_pdfCount)
            page = Await _browser.NewPageAsync()

            Await page.SetContentAsync(html, New NavigationOptions With {
                .WaitUntil = {WaitUntilNavigation.Networkidle0},
                .Timeout = 20000
            })

            Dim pdfBytes = Await page.PdfAsync(New PdfOptions With {
                .Format = PaperFormat.A4,
                .PrintBackground = True,
                .MarginOptions = New MarginOptions With {
                    .Top = "20mm", .Bottom = "20mm",
                    .Left = "15mm", .Right = "15mm"
                }
            })

            Return pdfBytes
        Finally
            If page IsNot Nothing Then
                Try
                    Await page.CloseAsync()
                Catch
                    ' Disposal can hang — GitHub issue #1489
                End Try
            End If
            _semaphore.Release()
        End Try
    End Function

    ' Restart browser periodically to reclaim leaked memory
    Public Async Function RecycleBrowserAsync() As Task
        Dim oldBrowser = _browser
        Await InitializeAsync()
        Try
            oldBrowser?.Dispose()
        Catch
        End Try
    End Function

    Public Sub Dispose() Implements IDisposable.Dispose
        _browser?.Dispose()
        _semaphore?.Dispose()
    End Sub
End Class

Bir PDF oluşturulmadan önce 80'den fazla satır vardır. Ve hala hata kurtarma, sağlık kontrolleri, metrikler ve üretim sistemlerinin ihtiyaç duyduğu bellek geri dönüşüm zamanlayıcısı eksiktir.

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20

Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

.NET Ekosistem Sağlığı: NuGet Paketi Karşılaştırması

Bir kütüphane seçmeden önce NuGet ekosistem sağlığını kontrol edin. Bağımlılık zincirleri, sürüm sıklığı ve sorun çözme süresi, özellik listelerinden daha fazlasını anlatır:

DinkToPdf gibi terkedilmiş paketlerdeki yüksek indirme sayıları, mevcut sağlığı değil, miras olarak benimsenmeyi yansıtır.300+yanıtlanmayan açık problem, gerçek hikayeyi anlatıyor.

.NET 8 uygulamaları net8.0 TFM'i hedefliyorsa: PdfSharp, QuestPDF,iText CoreveIronPDFbunu doğrudan destekler.wkhtmltopdfsarmalayıcıları desteklemez — DllNotFoundException ve NU1202 hedef çerçeve uyum hataları beklenebilir.

Karar Matrisi

Yalnızca yapılandırılmış verilerden programatik PDF oluşturma ihtiyaçınız varsa:PdfSharp(MIT, kısıtlama yok) veyaQuestPDF(daha iyi API, gelir eşiklerine dikkat edin).

Eğer modern CSS ile HTML'den PDF'ye ihtiyaçınız var ve tarayıcı altyapısını yönetmek istemiyorsanız: IronPDF. Dahili Chromium, işleme motoru yaşam döngüsünü ele alır. Yayınlanmış fiyatlandırma, iText'in abonelik modelinin bir kısmında.

HTML'den PDF'ye ihtiyaçınız varsa ve tarayıcı süreçlerini yönetmekte rahatsanıza:PuppeteerSharpsize tam kontrol sağlar. Operasyonel yük için bütçeler oluşturun.

Şu andawkhtmltopdfveya herhangi bir sarmalayıcı kullanıyorsanız: Geçiş yapın. Sadece güvenlik açığı bile çabayı haklı kılıyor — ve her ay gecikirsiniz, CVE listesi yamalanmadan kalır.