Dosya yolu veya URL ile referans verilen görüntüleri içeren bir PDF, gizli bir bağımlılık taşır. Belgeyi oluşturan makineden ayrılması, stateless bulut fonksiyonunda çalıştırılması veya yıllarca arşivlenmesi anında, bu referanslar kırılabilir ve logo veya grafiğin olması gereken yerde boş kutular bırakabilir. Görüntüleri doğrudan HTML içine base64 veri URI'leri olarak eklemek bu bağımlılığı ortadan kaldırır ve IronPDF sonucu tamamen kendi kendine yeten bir PDF'ye dönüştürür.

İş Problemi

Bir faturalama hizmeti, dosya sistemi erişiminin sınırlı ve geçici olduğu Azure veya AWS Lambda'ya taşınır, dolayısıyla yerel olarak çalışan görüntü yolları artık çözümlenmez. Bir raporlama aracı, orijinal varlık sunucusu değiştikten çok sonra bile belgeleri doğru şekilde görüntülemesi gereken belgeleri e-posta ile gönderir. Bir yol süreç, diske hiç kaydedilmeyen çalıştırma zamanında üretilen görüntülerden belgeleri bir araya getirir. Her durumda, harici görüntü referansları bir sorumluluktur.

Görüntüleri Veri URI'leri Olarak Ekleme

Desen üç adımdan oluşur: görüntü baytlarını okuyun, bunları base64'e dönüştürün ve sonucu uygun MIME türüyle eşleşen <img> etiketi içine yerleştirin. Render edilen PDF, daha sonra görüntüyü dosya içinde tutar.

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

Aynı yaklaşım, doğrudan baytları geçici bir dosya yazmadan kodlayarak bellekte üretilen grafik veya barkod gibi çalıştırma zamanında üretilen görüntüler için de geçerlidir. Veri URI doğru türü belirttiği sürece, birden fazla format desteklenir: PNG, JPEG, GIF, SVG (image/svg+xml) ve WebP.

Planlanması Gereken Noktalar

• Base64 boyutu artırır: Kodlama, her bir görüntünün bayt boyutunu yaklaşık üçte bir oranında artırır, bu da hem HTML hem de PDF'ye yansır. Görüntü ağırlıklı belgeler için, kodlamadan önce sıkıştırın veya boyutlandırın ve ardından PDF sıkıştırması uygulayın.
• MIME türünü eşleştirin: Ön ek, JPEG için data:image/jpeg;base64, gibi formatla eşleşmelidir, aksi takdirde görüntü render edilmez.
• Dosya sistemi bağımlılığı yok: Görüntü belge içinde gezindiği için, render erişilebilir bir yol veya varlık sunucusuna bağımlı değildir, bu da onu bulut ve konteyner dağıtımlarında güvenilir kılar.
• Daha az getirme: İç içe görüntüler, render sırasında ekstra HTTP veya dosya sistemi çağrılarını önler, bu da bir belge birçok küçük görüntü içerdiğinde verimi arttırır.

Sonuç

Görüntüleri veri URI'leri olarak ekleyerek, ekipler bir dizüstü bilgisayarda veya sunucusuz bir işlevde çalışsın, tüm görüntüleri e-posta veya arşivleme sırasında sağlam bırakarak aynı şekilde render eden PDF'ler üretir. Tam format detayları ve örnekler DataURIs kılavuzu içine gömülüdür.