IronPDF ile C# Kullanarak PDF'lere Görüntü Ekleme

RenderHtmlAsPdf Yöntemi Neden En İyi Sonucu Verir?

RenderHtmlAsPdf metodu, IronPDF'nin Chrome render motorunu kullanarak görseller içeren HTML içeriğini düzen ve stili koruyarak PDF formatına dönüştürür. Bu yöntem, duyarlı CSS yerleşimlerini destekler ve görüntülerin web tarayıcısında olduğu gibi görüntülenmesini sağlar. Karmaşık düzenler için piksel mükemmelliğinde HTML formatlama rehberimize bakın.

Hangi Resim Formatları Destekleniyor?

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

Doğrudan URL mi yoksa Base64 Kodlaması mı Kullanmalıyım?

Görüntüler çevrimiçi olarak barındırıldığında ve dosya boyutu bir endişe olduğunda doğrudan URL'leri kullanın. İnternet erişimi gerektirmeyen kendi kendine yeterli PDF'ler için Base64 kodlamasını seçin. Bulut hizmetlerinde saklanan görüntüler için, Azure Blob Storage'dan görüntü yerleştirme rehberimize bakın. Bu karar, oluşturduğunuz PDF'lerin dosya boyutunu ve 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")

Görüntüler İçin Base64 Kodlama Neden Kullanılır?

Base64 kodlama, harici kaynaklara bağımlı olmayan kendi kendine yeterli PDF'ler oluşturur ve görüntülerin internet bağlantısı olmadan veya orijinal görüntü dosyaları taşındığında veya silindiğinde her zaman görüntülenmesini sağlar. Bu teknik, Blazor Sunucu uygulamalarında PDF'ler oluştururken veya harici dosya erişiminin kısıtlı olabileceği Azure'a dağıtım yaparken yararlıdır. Kodlanmış görüntüler HTML dizesinin bir parçası haline gelir, bu da onları HTML dizesini PDF'ye dönüştürme için ideal hale getirir.

Performans Dikkat Edilmesi Gereken Hususlar Nelerdir?

Base64 kodlama dosya boyutunu yaklaşık %33 artırır, ancak dış bağımlılıkları ortadan kaldırır; bu nedenle arşivleme amaçları veya kısıtlı ağ ortamları için idealdir. Performansın kritik olduğu durumlarda, birden fazla görüntü dönüşümünü aynı anda işlemek için senkron olmayan PDF oluşturmayı düşünün. Büyük ölçekli işlemler için, verimi maksimuma çıkarmak için performans optimizasyon rehberimize bakın.

Büyük Görüntü Dosyalarını Nasıl İşlerim?

Büyük görüntüler için, Base64 kodlamadan önce sıkıştırarak PDF dosya boyutunu en aza indirin veya dosya boyutu kritikse dış URL'leri kullanın. IronPDF, dosya boyutlarını %75'e kadar azaltabilen PDF sıkıştırma özellikleri sunar. Birden fazla görüntüyle ç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? Eğitim sayfamıza buradan göz atın: Ek Özellikler