IronPDF ile C#'te PDF'lere Resim Ekleme

RenderHtmlAsPdf Yöntemi Neden En İyi Sonuç Verir?

RenderHtmlAsPdf yöntemi, IronPDF'nin Chrome görüntüleme motorunu kullanarak, düzeni ve stili koruyarak resimler dahil HTML içeriğini PDF formatına dönüştürür. Bu yöntem, duyarlı CSS düzenlerini destekler ve resimlerin bir web tarayıcısında göründükleri gibi render edilmesini sağlar. Karmaşık düzenler için, piksel mükemmeliyetinde HTML formatlama kılavuzumuza bakın.

Hangi Görüntü Formatları Destekleniyor?

IronPDF, HTML dönüştürme yoluyla gömüldüğünde PNG, JPG, SVG, GIF ve BMP dahil olmak üzere tüm önemli resim formatlarını destekler. Kütüphane, ölçeklenebilir vektör illüstrasyonları için SVG grafiklerini etkili bir şekilde işler. Farklı biçimlerle çalışırken, HTML'nizin src özniteliğinde veya Base64 veri URI'sinde görüntü türünü doğru şekilde belirttiğinden emin olun.

Doğrudan URL yerine Base64 Kodlamasını Ne Zaman Kullanmamalıyım?

Doğrudan URL'leri, dosya boyutunun önemli olduğu ve resimlerin çevrimiçi olarak barındırılması durumunda kullanın. İnternet erişimi gerektirmeyen kendi içlerinde bütünleşik PDF'ler için Base64 kodlamasını tercih edin. Bulut hizmetlerinde saklanan görüntüler için, Azure Blob Storage'dan resim gömme üzerine kılavuzumuza bakın. Bu karar, oluşturulmuş PDF'lerinizin hem dosya boyutunu hem de taşınabilirliğini etkiler.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export PDF
pdf.SaveAs("embedImage.pdf")

Resimler için Neden Base64 Kodlaması Kullanıyorum?

Base64 kodlaması, internet bağlantısı olmadan veya orijinal resim dosyaları taşındığında veya silindiğinde her zaman resimlerin görüntülenmesini sağlar ve dış kaynaklara dayanmayan kendi içinde bütünleşik PDF'ler oluşturur. Bu teknik, Blazor Server uygulamalarında PDF oluştururken veya dosya erişiminin sınırlı olabileceği Azure'a deploy yapılırken yararlıdır. Kodlanmış resimler HTML dizisinin bir parçası haline gelir ve bu da onları HTML dizi to PDF dönüşümleri için ideal kılar.

Performans Hususları Nelerdir?

Base64 kodlaması dosya boyutunu yaklaşık %33 artırır ancak dış bağımlılıkları ortadan kaldırarak arşivleme amaçları için veya kısıtlı ağ ortamlarında idealdir. Performansın kritik olduğu durumlarda, aynı anda birden fazla resim dönüşümünü gerçekleştirmek için async PDF oluşturma kullanmayı düşünün. Büyük çaptaki işlemler için, çıktıyı en üst düzeye çıkarmak adına performans optimizasyon kılavuzumuza göz atın.

Büyük Resim Dosyalarına Nasıl Mücadele Edilir?

Büyük resimler için, PDF dosya boyutunu en aza indirmek için onları Base64 kodlamadan önce sıkıştırın veya dosya boyutuyla ilgili kritik durumlarda dış URL'ler kullanın. IronPDF, dosya boyutlarını %75'e kadar azaltabilen PDF sıkıştırma özellikleri sunar. Birden fazla resimle çalışırken, render ayarlarınızı en iyi kalite ve dosya boyutu dengesi için optimize edin.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

' Embed in HTML
Private html As String = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>"

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("embedImageBase64.pdf")

Başka neler yapabileceğinizi görmek için hazır mısınız? Öğretici sayfamızdan daha fazla özelliği burada kontrol edin: Ek Özellikler