ASP.NET MVC Görünümlerini PDF'ye Çevirme: IronPDF vs iTextSharp

iTextSharp Kurulumu

iTextSharp'ı ASP.NET Core MVC projenize eklemek için, Paket Yöneticisi Konsolu'nu kullanarak NuGet paketini yükleyin:

Install-Package iTextSharp

Install-Package iTextSharp

iTextSharp ile Temel Uygulama

Iste ASP.NET MVC projenizde, iTextSharp'ın XMLWorkerHelper sınıfını kullanarak bir MVC gorunumunu PDF'ye dönüştürmenin tam bir ornegi:

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Hayırw.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";

        // Create PDF document using iTextSharp
        using var stream = new MemoryStream();
        var document = new Document(PageSize.A4);
        PdfWriter writer = PdfWriter.GetInstance(document, stream);
        document.Open();

        using (var srHtml = new StringReader(invoiceHtml))
        {
            XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
        }

        document.Close();

        // Return the PDF file
        return new FileContentResult(stream.ToArray(), "application/pdf")
        {
            FileDownloadName = "invoice.pdf"
        };
    }
}

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Hayırw.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";

        // Create PDF document using iTextSharp
        using var stream = new MemoryStream();
        var document = new Document(PageSize.A4);
        PdfWriter writer = PdfWriter.GetInstance(document, stream);
        document.Open();

        using (var srHtml = new StringReader(invoiceHtml))
        {
            XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
        }

        document.Close();

        // Return the PDF file
        return new FileContentResult(stream.ToArray(), "application/pdf")
        {
            FileDownloadName = "invoice.pdf"
        };
    }
}

Imports iTextSharp.text
Imports iTextSharp.tool.xml
Imports iTextSharp.text.pdf
Imports System.IO

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GeneratePDF() As ActionResult
        ' Create a simple invoice HTML
        Dim invoiceHtml As String = "
            <h1>Invoice #1001</h1>
            <p>Date: " & DateTime.Now.ToString("MM/dd/yyyy") & "</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>"

        ' Create PDF document using iTextSharp
        Using stream As New MemoryStream()
            Dim document As New Document(PageSize.A4)
            Dim writer As PdfWriter = PdfWriter.GetInstance(document, stream)
            document.Open()

            Using srHtml As New StringReader(invoiceHtml)
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml)
            End Using

            document.Close()

            ' Return the PDF file
            Return New FileContentResult(stream.ToArray(), "application/pdf") With {
                .FileDownloadName = "invoice.pdf"
            }
        End Using
    End Function
End Class

Bu örnek, HTML içeriğinden temel bir PDF belge oluşturur. XMLWorkerHelper sınıfı HTML dizgisini isler ve nesne modelini kullanarak PDF belgesine ogeler ekler. PdfWriter asıl PDF oluşturma surecini yonetirken, Document sayfa yapısını yonetir.

Çıktı

iTextSharp'ın Temel Sınırlamaları Nelerdir?

XMLWorkerHelper sınıfı temel HTML etiketlerini ve satir ici CSS'yi destekler. Modern CSS3 özellikleri, flexbox düzenleri ve grid sistemleri işlenmez. JavaScript'e bağımlı içerik tamamen kaybolur. Degradyantlar, gölgeler ve dönüşümler gibi karmaşık stil öğeleri göz ardı edilir. Standart Bootstrap sınıfları bile uygulanmaz, özenle tasarlanmış görünümler sade ve profesyonel görünmeyen şekilde kalır.

Birçok geliştirici, MVC'deki görünümleri iTextSharp ile PDF'ye dönüştürmeye çalışırken bu sınırlamaları Stack Overflow'da bildirmiştir, bu da hayal kırıklığına yol açmıştır.

Belki de daha endişe verici olan iTextSharp'ın lisanslama modelidir. Kütüphane, ücretsiz sürümü kullanıyorsanız tüm uygulamanızı açık kaynak yapmanızı gerektiren AGPL lisansını kullanır. Ticari lisanslar yılda birkaç bin dolardan başlar, bu da birçok işletme için aşırı derecede pahalı hale gelir. Bu lisans sınırlaması, birçok geliştiriciyi ticari geliştirme ihtiyaçlarına daha iyi uyan alternatifler aramaya yöneltmiştir. Microsoft'un .NET dokümantasyonunda tartışıldığı gibi, uygun lisanslara sahip kütüphanelerin seçilmesi, ticari projeler açısından kritiktir.

IronPDF'i Nasıl Kurarız?

Projenize IronPDF'i NuGet Paket Yöneticisi Konsolu'ndan ekleyin:

Install-Package IronPdf

Install-Package IronPdf

IronPDF ile Modern Uygulama

Yukarıda oluşturulan aynı fatura artık modern CSS ve tam HTML5 render kullanarak IronPDF'in ChromePdfRenderer'ı ile oluşturulur:

using IronPdf;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Hayırw.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Hayırw.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

Imports IronPdf

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GenerateModernPDF() As ActionResult
        ' Create a styled invoice HTML with modern CSS
        Dim invoiceHtml As String = "
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " & DateTime.Now.ToString("MMMM dd, yyyy") & "</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>"

        ' Use Chromium engine for rendering
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(invoiceHtml)

        ' Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf")

        ' Return the PDF file with binary data
        Return New FileContentResult(pdf.BinaryData, "application/pdf")
    End Function
End Class

ChromePdfRenderer HTML'i tam olarak Chrome'un göstereceği gibi dönüştürur. Degradyant arka planlar, modern yazı tipleri ve sofistike stil öğeleri doğru şekilde oluşturulur. Render motoru, iTextSharp'ın işleyemediği kompleks CSS özelliklerini, flexbox, grid düzenleri ve CSS dönüşümlerini statik çerçeveler olarak işleyebilir. RenderHtmlAsPdf yöntemi MVC'de HTML'yi PDF'ye dönüştürmayi kolaylastiriyor.

Çıktı

Ücretsiz denemenizi başlatın ve Chrome destekli render motoru ile modern PDF oluşturmayı deneyimleyin.

Özellik Karsilastirmasi

Lisanslama Düşünceleri

Bu kütüphaneler arasındaki lisanslama farkı, ticari geliştirme üzerinde önemli bir etkiye sahiptir. iTextSharp'ın AGPL lisansı, birçok işletmenin kabul edemeyeceği yasal yükümlülükler oluşturur. Ücretsiz sürümü kullanmak, tescilli iş mantığınızı içeren tüm uygulamanızı açık kaynak yapmayı gerektirir. Bu kısıtlama, pahalı bir ticari lisans almadığınız sürece iTextSharp'ı çoğu ticari proje için uygun kılmaz.

IronPDF, tek bir geliştirici icin $799 ile basit ticari lisanslama sunar. Lisans, bir yıl güncellemeler ve destekle birlikte gelir ve uygulamanızı açık kaynak yapma zorunluluğu yoktur. Bu şeffaf fiyatlandırma modeli, tipik yazılım geliştirme bütçelerine uygun olarak profesyonel PDF oluşturmayı her boyutta işletme için MVC görünümlerini PDF'ye dönüştürmede erişilebilir kılar.

Çıktı Kalite Analizi

Çıkışları karşılaştırırken rendering kalitesi farkı hemen belli olur. iTextSharp, 2000'lerin başından kalma belgelere benzeyen temel PDF'ler üretir. Tablolar düzgün stilizasyondan yoksundur, yazı tipleri sistem standartlarına geri döner ve modern tasarım öğeleri tamamen kaybolur. Ortaya çıkan PDF'ler profesyonel görünmez ve uygulamanızın marka kimliğiyle eşleşmez.

IronPDF, web tasarımınıza birebir uygun pixel-perfect PDF'ler üretir. Degradyantlar doğru şekilde oluşturulur, özel yazı tipleri doğru görüntülenir ve karmaşık düzenler yapısını korur. Chromium motoru, PDF'lerinizin web görünümüyle aynı görünmesini sağlar ve tüm oluşturulan belgelerde marka kimliğini ve profesyonel görünümü korur.

Üstbilgiler ve Altbilgiler

Dinamik içerikle profesyonel başlık ve alt bilgi ekleyin:

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

Dim renderer = New ChromePdfRenderer With {
    .RenderingOptions = New ChromePdfRenderOptions With {
        .HtmlHeader = New HtmlHeaderFooter With {
            .MaxHeight = 25,
            .HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        .HtmlFooter = New HtmlHeaderFooter With {
            .MaxHeight = 20,
            .HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
}

Bu yapılandırma, her sayfaya tutarlı bir markalama ekler. {page} ve {total-pages} yer tutuculari otomatik olarak dogru degerlerle doldurulur, belgeleriniz boyunca dogru sayfa numaralandirmasini saglar. Daha fazla yapılandırma seçeneği için başlıklar ve alt bilgiler kılavuzuna bakın.

Güvenlik ve Şifreleme

IronPDF'un güvenlik özelliklerini kullanarak hassas belgeleri parolalar ve izinlerle koruyun:

var pdf = renderer.RenderHtmlAsPdf(html);

// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.TamPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

var pdf = renderer.RenderHtmlAsPdf(html);

// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.TamPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

Dim pdf = renderer.RenderHtmlAsPdf(html)

' Add password protection
pdf.SecuritySettings.UserPassword = "user123"
pdf.SecuritySettings.OwnerPassword = "owner456"

' Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.TamPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False

Bu güvenlik ayarları, MMA görünümlerini PDF'ye dönüştürdüğünüzde, PDF'lerinizle alıcıların nasıl etkileşimde bulunacağını kontrol eder ve yetkisiz erişimi engeller. Yazdırmayı, kopyalamayı ve düzenlemeyi kısıtlayabilir ve tam sahip kontrolünü koruyabilirsiniz. Daha fazla bilgiyi PDF güvenliği dokümantasyonunda öğrenin.

Çıktı

Form Alanı İşleme

IronPDF, hiçbir ek araca gerek kalmadan HTML formları etkileşimli PDF formlarına dönüştürür:

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";

var pdf = renderer.RenderHtmlAsPdf(formHtml);

Imports System

Dim formHtml As String = "
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>"

Dim pdf = renderer.RenderHtmlAsPdf(formHtml)

Sonuçta ortaya çıkan PDF, kullanıcıların PDF okuyucularında alanları doğrudan doldurmalarına izin veren form etkileşimini korur. Bu özellik, doküman iş akışınızı basitleştirerek ayrı form oluşturma araçlarına gerek kalmamasını sağlar. Daha fazla seçenek için formlar dokümantasyonunu keşfedin.

Çıktı

CSS Render Optimizasyonu

HTML dosyalarını PDF formatına dönüştürürken karmaşık CSS ile en iyi sonuçlar için medya sorgularını kullanın:

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

Bu ayar, ekran görüntüsünden ziyade PDF çıktısı için düzenleri optimize eden yazdırma özgü CSS kurallarını uygular. Bunu yazdırma için optimize edilmiş stil sayfalarıyla birleştirmek, sayfa kırılmaları, kenar boşlukları ve tipografi üzerinde hassas kontrol sağlar. CSS medya türü kılavuzu, ek render seçeneklerini açıklar.

JavaScript Çalıştırma Zamanlaması

Dinamik içeriği dönüştürürken, PDF'yi yakalamadan önce JavaScript çalışmasının tamamlanması için zaman tanıyın. Bu, tüm AJAX çağrılarının ve DOM manipülasyonlarının tamamlanmasını sağlar:

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

Bu yapılandırma, AJAX çağrılarının tamamlanmasını ve DOM manipülasyonlarının bitmesini sağlar, PDF oluşturulmadan önce MVC görünümünüzün tamamen render edilmiş durumunu yakalar. Özellikle grafik kütüphaneleri ve diğer asenkron içerik için gecikme değerini artırmanız gerekebilir.

Çıktı

Yazi Tipi Gomulemesi ve Doküman Bicimlendirme

Ozel yazi tiplerinin dogru bir sekilde gösterildiginden emin olmak icin, bunlari HTML dosyanizda base64-encoded veri URI'lari kullanarak direk olarak gomun:

@font-face {
    font-family: 'CustomFont';
    src: url(data:font/woff2;base64,[base64-encoded-font]) format('woff2');
}

Yazi tiplerini HTML'ye direk olarak gommek, tüm ortamlarda tutarli bir görüntüleme saglar, oluşturulan PDF dokümanlarinda yazi tipi eksikligi sorunlarini ortadan kaldirir. Bu yaklasim, ister RenderUrlAsPdf ile URL tabanli, ister RenderHtmlAsPdf ile dizge tabanli render kullanin, ayni derecede basarili calisir.

IronPDF render etme seçenekleri dokümantasyonu adresinde sayfa boyutu, yonlendirme ve kenar bosluk kontrolu dahil olmak üzere ek yapılandirma kaliplari bulabilirsiniz. GitHub'daki örnek projeleri inceleyin ve yaygin MVC entegrasyon kaliplarini gozden gecirin.