Altbilgi içeriğine atla
ÜRüN KARşıLAşTıRMALARı

iTextSharp: PDF'ye Görsel Ekleme

RenderHtmlFileAsPdf tek bir şey yapar: diskteki bir HTML dosyasını alır ve onu bir Chrome motoru aracılığıyla PDF olarak işler. Chrome'da doğru görüntülenen her şey, CSS3, JavaScript, görüntüler ve yazı tipleri için tam destekle belgeye doğru şekilde yansır. Önemli olan tek fark girdidir. Bu yöntem bir dosyayı okur, bu nedenle göreceli varlık yolları (logolar, stil dosyaları, yazı tipleri) dosyanın kendi konumuna göre çözülür, temel bir URL gerekmez. En iyi nerede uyduğuna karar verir.

Şablona dayalı belge oluşturma

Projenizde bir HTML şablonu (fatura, teklif, sertifika, sözleşme) tutun, doldurun, diske yazın ve işler hale getirin:

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html")
        .SaveAs("invoice-1042.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html")
        .SaveAs("invoice-1042.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html").SaveAs("invoice-1042.pdf")
$vbLabelText   $csharpLabel

Kaynak gerçek bir dosya olduğu için, ./logo.png ve styles.css de doğal olarak onun yanında çözülür.

Statik site ve yapı çıktısı oluşturma

Statik site oluşturucular, Markdown hatları ve dokümantasyon oluşturucuların hepsi HTML dosyaları üretir. Yayınlanmış bir sayfayı HTTP'den yeniden getirme ihtiyacı olmadan arşivlenebilir bir PDF'ye dönüştürmek için IronPDF'i çıktıya yönlendirin.

Tasarımcı tarafından oluşturulmuş düzenler

Bir tasarımcı size kendi içinde bir HTML ve CSS dosyası teslim eder; bunu olduğu gibi render edersiniz. Chrome dönüşümü yönetir, bu nedenle tasarımcının tarayıcı önizlemesi PDF ile eşleşir, bu da 'mockuplarda iyi görünüyordu' türündeki anlaşmazlıkları ortadan kaldırır.

Bir klasörün toplu dönüşümü

Yöntem dosya başına bir çağrıdır, bu nedenle bir dizin rapor veya dağıtım dönüştürmek kısa bir döngüdür:

var renderer = new ChromePdfRenderer();

foreach (string file in Directory.GetFiles("reports", "*.html"))
{
    string output = Path.ChangeExtension(file, ".pdf");
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output);
}
var renderer = new ChromePdfRenderer();

foreach (string file in Directory.GetFiles("reports", "*.html"))
{
    string output = Path.ChangeExtension(file, ".pdf");
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output);
}
Imports System.IO
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

For Each file As String In Directory.GetFiles("reports", "*.html")
    Dim output As String = Path.ChangeExtension(file, ".pdf")
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output)
Next
$vbLabelText   $csharpLabel

Çevrimdışı ve izole ortamda render etme

Bir URL yerine yerel dosya sisteminden okuduğu için, dışa bağlantıların olmadığı yerlerde çalışır: güvenli arka planlar, CI yürütücüler, yerel dağıtımlar. HTML ve varlıkları yalnızca makinede mevcut olmalıdır.

E-posta şablonu doğrulama

Bildirim veya e-posta şablonlarını HTML dosyaları olarak saklayan ekipler, bunları gözden geçirme, onay alma veya kayıt tutma için PDF'ye dönüştürebilir, bunları görüntülemek için bir web sunucusunu ayağa kaldırmadan.

Başparmak kuralı

IronPDF üç giriş noktası sunar ve yanlış olanını seçmek bozuk varlıkların en yaygın kaynağıdır:

  • RenderHtmlFileAsPdf, diskteki bir dosyayı okur; bağıl varlıklar, dosyanın konumundan çözülür.
  • RenderHtmlAsPdf, bellekte bir HTML dizesi alır; genellikle bir temel URL ayarlayarak varlıkların çözülmesini sağlarsınız.
  • RenderUrlAsPdf, HTTP üzerinden getirir ve kimlik doğrulamanın, çerezlerin ve oturum açmaların uygulandığı yerdir.

HTML'iniz zaten bir dosya olarak mevcut olduğunda, dosya yöntemine başvurun. Çıkışı RenderingOptions ile işleme başlamadan önce yapılandırın ve sayfayı önce Chrome'da doğrulayın; orada işlenirse, PDF'de de işlenir.

Sıkça Sorulan Sorular

RenderHtmlFileAsPdf, RenderHtmlAsPdf ve RenderUrlAsPdf arasındaki fark nedir?

RenderHtmlFileAsPdf, diskteki bir HTML dosyasını okur; göreli varlık yolları dosyanın kendi konumundan çözülür. RenderHtmlAsPdf, bellekteki bir HTML stringini alır ve genellikle varlıklar için bir ana URL gerektirir. RenderUrlAsPdf, HTTP üzerinden canlı bir URL'yi getirir ve kimlik doğrulama ile çerezlerin geçerli olduğu yer burasıdır.

RenderHtmlFileAsPdf kullanırken bir ana URL ayarlamam gerekir mi?

Hayır. Yöntem, diskteki gerçek bir dosyayı okuduğundan, ./logo.png ve styles.css gibi göreli yollar otomatik olarak HTML dosyasının dizininden çözülür. Ana URL yapılandırması gerekmez.

RenderHtmlFileAsPdf yöntemini çevrimdışı veya izole bir ortamda kullanabilir miyim?

Evet. Yöntem, HTTP üzerinden getirme yerine yerel dosya sisteminden okur, bu nedenle çıkış ağı erişimi olmayan ortamlarda, güvenli sunucu arka planlarında, CI çalıyıcılarında ve yerleşik dağıtımlarda çalışır.

IronPDF ile bir klasör dolusu HTML dosyasını toplu şekilde PDF'ye nasıl dönüştürebilirim?

Directory.GetFiles ile dosyaların üzerinden geçin ve dosya başına bir kez RenderHtmlFileAsPdf çağrısı yapın. Tarayıcı bağlamını paylaşmak için döngü boyunca tek bir ChromePdfRenderer örneğini tekrar kullanın.

PDF, Chrome'da gördüğüm gibi mi görünecek?

IronPDF, render işlemi için tam bir Chromium motoru kullanır; bu nedenle çıktı, aynı HTML dosyası için Chrome tarayıcı önizlemesi ile eşleşir. Sayfayı önce Chrome'da doğrulayın — burada doğru render ederse, PDF'de de doğru render edilecektir.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku

Iron Destek Ekibi

Haftada 5 gün, 24 saat çevrimiçiyiz.
Sohbet
E-posta
Beni Ara