.NET'te PDF Dosyalari Nasıl Birlestirilir

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

ChromePdfRenderer sınıfı, tüm karmaşık render işlemleri ile ilgilidir ve HTML yapınızın, CSS stillerinizin ve hatta JavaScript'in doğru bir şekilde renderlanmasını sağlar. Dönüş değeri, @ @-- CODE-592--@@ nesnesidir ve bu nesnenin BinaryData özelliği, bir dosya indirimi olarak doğrudan tarayıcıya aktarılabilir.

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

Veritabanı kökenli raporlar gibi dinamik içeriklerle çalışırken, HTML dizgilerini doğrudan dönüştürmek için RenderHtmlAsPdf kullanın. Bu yöntem, geçerli olan herhangi bir HTML işaretlemesini kabul eder ve tam olarak renderlanmış 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ı verilerle doldurulmuş HTML şablonlarından, form gönderimlerinden veya herhangi bir dinamik olarak üretilmiş içerikten PDF belgeleri üretmek için iyi çalışır. Render motoru, özel yazı tipleri, renkler ve tablo düzeni dahil olmak üzere tüm CSS stilini korur. HTML'niz harici stil dosyalarını veya görüntüleri görece yollar kullanarak başvuruyorsa, bu varlıkların doğru çözülmesi için baseUrl'i ikinci argüman olarak iletin.

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

Fiziksel dosyalar olarak depolanan HTML şablonları için, bunları önce belleğe yüklemeden dönüştürmek için RenderHtmlFileAsPdf kullanın. Bu, büyük şablonlar için verimlidir 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, dosyadaki CSS stil sayfalarına, resimlere ve diğer dış kaynaklara yönelik göreceli yolları otomatik olarak çözer. Tasarım ekibiniz, uygulamanın C# kod tabanı dışında bulunan ayrı HTML şablon dosyalarını bakım ederken iyi çalışır. Bu yöntem CSS baskı medya sorgularını ve özel yazı tiplerini destekler, böylece baskı ortamları için oluşturulmuş şablonlar ek yapılandırma gerektirmeden aslına sadık bir şekilde renderlanır.

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

Canlı bir web sayfasını yakalamak veya bir URL erişilebilir sayfasını PDF olarak render etmek için RenderUrlAsPdf kullanın. Bu yöntem, Chrome motorunu başlatarak URL'ye gider, sayfanın tamamen yüklenmesini bekler ve ardından renderlanan çı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, yükleme sonrası yakalamadan önce render işlemcisinin durmasını bildirir. Bu, istemci tarafı JavaScript tarafından HTML yanıtı geldikten sonra DOM'u oluşturan tek sayfa uygulamaları için değerlidir. EnableJavaScript = true ayarlanması, tam Chrome JavaScript motorunu etkinleştirir, bu nedenle PDF'de grafikler, veri tabloları ve diğer JavaScript ile oluşturulmuş bileşenler tarayıcıda oldukları gibi görünür.

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

Form Verileri Oluşturulan PDF'de Nasıl Görünür?

Daha gelişmiş belge senaryoları için, PDF formları entegre edebilir veya önceden doldurulmuş alanlarla mevcut PDF şablonlarını düzenleyebilirsiniz. Kütüphane ayrıca, oluşturulan herhangi bir belgeye kriptografik olarak doğrulanabilir imzalar eklemenize olanak tanıyan yasal belgeler ve sözleşmeler için dijital imzaları destekler.

Kullanıcı verilerini HTML dizgilerine gömerken önemli bir husus, temizlemedir. Herhangi bir enjeksiyon sorununu önlemek için kullanıcı tarafından sağlanan dizgileri HTML'ye eklemeden önce her zaman kaçırın. Her alan üzerinde basit bir System.Web.HttpUtility.HtmlEncode(model.CustomerName) çağrısı, şablonu render işlemcisine 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ık ve altbilgiler gerektirir, ayrıca taslak ve gizli belgeler için filigranlar gerektirir. IronPDF, hem RenderingOptions nesnesi üzerindeki özellikler hem de ortaya çıkan PdfDocument üzerindeki @@--CODE-602---@@ 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")

Altbilgi HTML'sindeki {page} ve {total-pages} yer tutucular, render anında otomatik olarak değiştirilir, böylece herhangi bir sonrası işleme gerek kalmadan doğru sayfa numaralarını alırsınız. Sayfa numaraları, arka plan görüntüleri veya ön plan kaplamaları ve özel metin veya resim damgaları da ekleyebilirsiniz.

PDF Düzeni Kontrolü için CSS Baskı Medyasını Nasıl Kullanırsınız?

PDF çıktınızın beklentilerle uyuşmasını sağlamak için CSS @media print kurallarını ve PdfCssMediaType.Print ayarını kullanın. IronPDF, sayfa kırılma kontrolü ve özel kağıt boyutları tam destek vermektedir:

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'i kullanmak, gereksiz web öğelerinin (navigasyon menüleri veya etkileşimli düğmeler gibi) gizlenirken PDF belgelerinizin profesyonel biçimlendirmeyi korumasını sağlar. CssMediaType = PdfCssMediaType.Print ayarı, render işlemcisinden ekran tarzları yerine @media print kurallarınızı uygulamasını ister, bu genellikle arka plan dekorasyonlarını kaldırır ve yazı tiplerini baskı çıktısı için ayarlar. Sayfa başına özel kenar boşlukları yapılandırabilir ve sayfa yönlendirme ve döndürme işlevlerini kontrol edebilirsiniz, geniş format veya döndürülmüş raporlar için.

W3C CSS Paged Media spesifikasyonu, @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 eder, böylece CSS standardına göre yazılmış stiller, manuel ayarlar gerektirmeden PDF'ye doğru bir şekilde çevrilir.