ASP.NET Core'da HTML'i PDF'ye Cevirin: C# - IronPDF Kılavuzu

Oluşturulan PDF Nasıl Görünür?

ChromePdfRenderer sınıfı tüm karmaşık render işlemlerini ele alır ve HTML yapınızın, CSS stillerinizin ve hatta JavaScript'in doğru bir şekilde nihai PDF çıkışında render edilmesini sağlar. Dönüş değeri, BinaryData özelliğini bir dosya indirme olarak doğrudan tarayıcıya yönlendirebileceğiniz bir PdfDocument nesnesidir.

Dinamik HTML Dizelerini Nasıl Dönüştürürsünüz?

Veritabanı destekli raporlar gibi dinamik içerikle çalışırken, HTML dizgilerini doğrudan dönüştürmek için RenderHtmlAsPdf kullanın. Bu yöntem, geçerli herhangi bir HTML işaretlemesini kabul eder ve tam olarak render edilmiş bir PDF döndürür:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = BuildDynamicHtml() ' your method to generate HTML
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("dynamic-report.pdf")

Bu yaklaşım, gerçek zamanlı veri, form gönderimleri veya dinamik olarak oluşturulan herhangi bir içerikle doldurulmuş HTML şablonlarından PDF belgeleri oluşturmak için iyi çalışır. Render motoru, özel yazı tipleri, renkler ve tablo formatlaması dahil olmak üzere tüm CSS stilini korur. HTML'ınızın göreli yollar kullanarak harici stil sayfalarına veya görüntülere referans verdiği zaman, renderer'ın bu kaynakları doğru şekilde çözmesini sağlamak için ikinci argüman olarak bir baseUrl geçin.

Diskten Statik HTML Dosyalarını Nasıl Dönüştürürsünüz?

Fiziksel dosyalar olarak depolanan HTML şablonları için, onları önce belleğe yüklemeden dönüştürmek için RenderHtmlFileAsPdf kullanın. Bu, büyük şablonlar için etkilidir ve dize birleştirmeyi önler:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html")
pdf.SaveAs("report.pdf")

Bu yöntem, dosyada referans verilen CSS stiller, görüntüler ve diğer dış kaynaklar için göreli yolları otomatik olarak çözer. Tasarım ekibinizin uygulamanın C# kod tabanının dışında ayrı HTML şablonları koruduğu durumlarda iyi çalışır. Yöntem, CSS baskı medya sorgularını ve özel yazı tiplerini destekler, böylece baskı ortamları için inşa edilen şablonlar ekstra yapılandırma gerekmeden doğru bir şekilde render edilir.

Web Sayfası URL'sini PDF'ye Nasıl Dönüştürürsünüz?

Canlı bir web sayfasını yakalamak veya URL erişimli bir sayfayı PDF olarak render etmek için RenderUrlAsPdf kullanın. Bu yöntem Chrome motorunu başlatır, URL'ye gider, sayfanın tam olarak yüklenmesini bekler ve ardından render edilmiş çıktıyı yakalar:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
Dim pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")
pdf.SaveAs("webpage.pdf")

WaitFor.RenderDelay seçeneği, sayfa yüklemesinden sonra renderın duraklamasını söyler. Bu, JavaScript ile ilk HTML yanıt geldikten sonra DOM oluşturan tek sayfa uygulamaları için değerlidir. EnableJavaScript = true ayarlamak, tam Chrome JavaScript motorunu etkinleştirir, böylece grafikler, veri gridleri ve diğer JavaScript ile render edilen bileşenler tarayıcıda olduğu gibi PDF'de görünür.

Form Arayüzü Nasıl Görünür?

Üretilen PDF'de Form Verileri Nasıl Görünür?

Daha karmaşık belge senaryoları için, önceden doldurulmuş alanlarla PDF formları entegre edin veya mevcut PDF şablonlarını düzenleyin. Kütüphane ayrıca, üretilen her belgeye kriptografik olarak doğrulanabilir imzalar ekleyerek dijital imzaları yasal belgeler ve sözleşmeler için destekler.

Kullanıcı verilerini HTML dizelerine yerleştirirken dikkate alınması gereken önemli bir şey temizlemektir. Kullanıcı tarafından sağlanan dizeleri HTML'ye eklemeden önce kaçınılmaz sorunları önlemek için her zaman kaçış karakterlerine çevirin. Her alanda basit bir System.Web.HttpUtility.HtmlEncode(model.CustomerName) çağrısı, şablonu rendera iletmeden önce güvende tutar.

Başlıklar, Altbilgiler ve Filigranlar Nasıl Yapılandırılır?

Profesyonel PDF belgeleri genellikle her sayfada başlıklar ve altbilgiler ve taslak veya gizli belgeler için filigranlar gerektirir. IronPDF hem RenderingOptions nesnesinin özelliği hem de elde edilen PdfDocument üzerinde ApplyWatermark yöntemi aracılığıyla her ikisini de ele alır:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 20,
    .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>", 30, VerticalAlignment.Middle, HorizontalAlignment.Center)
pdf.SaveAs("report-with-watermark.pdf")

Footer HTML'inde yer alan {page} ve {total-pages} yer tutucuları render zamanında otomatik olarak değiştirilir, böylece doğru sayfa numaralarını herhangi bir son işlem olmadan alırsınız. Sayfa numaraları, arka plan resimleri veya ön plan bindirmeleri ve özel metin veya resim damgaları da ekleyebilirsiniz.

PDF Düzen Kontrolü için CSS Baskı Medyası Nasıl Kullanılır?

PDF çıktınızın beklentilerinize uygun olduğundan emin olmak için CSS @media print kurallarını ve PdfCssMediaType.Print ayarını kullanın. IronPDF, sayfa sonu kontrolü ve özel kağıt boyutları için tam destek sağlar:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
renderer.RenderingOptions.ViewPortWidth = 1024
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

Dim html As String = "
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

Baskı CSS kullanmak, gereksiz web öğelerini, örneğin gezinme menüleri veya etkileşimli düğmeler gibi, gizlerken PDF belgelerinizin profesyonel formatını korur. CssMediaType = PdfCssMediaType.Print ayarlamak, ekran stilleri yerine @media print kurallarınızı uygulamak için rendera söyler, bu da genellikle arka plan dekorasyonlarını kaldırır ve tipografi ayarlarını baskı çıkışı için ayarlar. Her sayfa için özel kenar boşluklarını ayarlayabilir ve geniş format veya döndürülmüş raporlar için sayfa yönlendirme ve döndürmeyi kontrol edebilirsiniz.

W3C CSS Paged Media specification, @page, page-break-before, ve widows gibi özelliklerin sayfalı çıktıda nasıl davranması gerektiğini tanımlar. IronPDF'in Chrome motoru bu spesifikasyonu yakından takip ederek, CSS standardına yazılan tarzları herhangi bir manuel ayarlama yapmadan doğru bir şekilde PDF'ye dönüştürür.