IronPDF: W3C ile Uyumlu, C#'ta Erişilebilir HTML'den PDF'ye

JPEG'ten PDF'e Dönüştürme için IronPDF Nasıl Kurulur?

Herhangi bir dönüştürme kodu yazmadan önce IronPDF'yi .NET projenize ekleyin. Kütüphane, NuGet üzerinden dağıtılır ve saniyeler içinde kurulur.

Visual Studio'da Paket Yöneticisi Konsolunu açın ve şu komutu çalıştırın:

Install-Package IronPdf

Veya .NET CLI kullanın:

dotnet add package IronPdf

IronPDF, .NET 8, .NET 9 ve .NET 10'un yanı sıra .NET Framework 4.6.2 ve sonrasını hedefler. Ek bir çalışma zamanı bağımlılığı gerekmez -- paket, Windows, Linux, macOS, Docker ve Azure'da görüntüden PDF'e dönüştürme için gereken her şeyi içerir.

Yüklendikten sonra dosyanızın üstüne tek bir using IronPdf; ifadesi ekleyin ve dönüştürmeye hazır olun.

IronPDF NuGet paketi, render motorunu içerir, bu yüzden üretim sunucuları için ayrı bir yükleyici yoktur. Bulut dağıtımları için, doğru temel görüntüyü yapılandırmak için Docker kurulum kılavuzunu inceleyin.

Tek Bir JPEG Görüntüsünü C#'de PDF'e Nasıl Dönüştürürsünüz?

JPEG'den PDF'ye dönüşüm için en basit yol, ImageToPdfConverter.ImageToPdf() statik yöntemini kullanmaktır. Görüntü dosya yolunu iletin, bir PdfDocument nesnesi alın ve ihtiyacınız olan yerde kaydedin.

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

Imports IronPdf

' Convert a single JPG image to PDF
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Save the converted PDF file
pdf.SaveAs("converted-photo.pdf")

ImageToPdf yöntemi, JPEG dosyanızın dosya yolunu kabul eder ve PdfDocument nesnesini döndürür, bu nesneyi kaydedebilir, akış yapabilir veya diğer IronPDF işlemlerine iletebilirsiniz. Dönüştürme hafızada gerçekleşir, bu da PDF'yi doğrudan sunması gereken web uygulamaları için ideal hale getirir.

IronPDF web sitesini solda ve sağda elde edilen PDF dönüşümünü gösteren ekran görüntüsü, HTML'den PDF'ye dönüşüm özelliğini C# kod örnekleriyle gösteriyor.

Üretilen PDF, orijinal görüntü kalitesini korur ve herhangi bir PDF okuyucu tarafından açılabilecek bir formata paketler. Sayfa boyutlandırması otomatik olarak yapılır -- PDF sayfa boyutları varsayılan olarak görüntü boyutlarıyla eşleşir, beyaz kenarlıklar istemiyorsanız temiz bir çıktı verir. Özel kenarlıklar ihtiyacınız varsa, özel kenarlıklar API'sini kullanın.

Zaten HTML'den PDF'e dönüştürme ile tanışık olan geliştiriciler için görüntü dönüştürme API'si aynı deseni izler: girişi sağlayın, gerekiyorsa seçenekleri yapılandırın ve çıktıyı kaydedin.

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

Imports IronPdf

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Get the PDF as a byte array for streaming
Dim pdfBytes As Byte() = pdf.BinaryData

' In an ASP.NET Core controller:
' Return File(pdfBytes, "application/pdf", "converted.pdf")

Birden Fazla JPEG Dosyasını Tek Bir PDF Belgesine Nasıl Dönüştürürsünüz?

Toplu dönüştürme -- birkaç JPEG görüntüsünü alıp onları tek bir PDF'de birleştirme -- aynı derecede basittir. Dosya yollarının sıralanabilir bir listesini ImageToPdfConverter.ImageToPdf()'ye iletin ve kütüphane, her görüntüyü çıktıda kendi sayfasına yerleştirir.

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

// Convert multiple JPEG images to a single PDF file
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

// Convert multiple JPEG images to a single PDF file
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

Imports IronPdf
Imports System.IO
Imports System.Linq

' Gather all JPG files from a folder
Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) _
             OrElse f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase))

' Convert multiple JPEG images to a single PDF file
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Save the combined PDF
pdf.SaveAs("photo-collection.pdf")

Görüntüler PDF'de dizi içinde göründükleri sırayla gösterilir. Sayfa sırasını kontrol etmek için, dosya yollarını dönüştürücüye iletmeden önce sıralayın -- örneğin, dosya adı, oluşturma tarihi veya iş akışınıza uyan herhangi bir özel sıralamaya göre.

Bir sırada gösterilen, 1-7 numaralı, çeşitli metin yerleşimleri ve PDF dönüşümü için örnek dosyalar gibi görünen resimler içeren yedi belge sayfası.

Gömülü görüntülerle, çok sayfalı bir Wikipedia makalesini gösteren PDF belge görüntüleyicisi, dönüştürülmüş çıktının 1-9 sayfalarını %25 yakınlaştırmada gösteriyor

using IronPdf;
using System.Collections.Generic;
using System.IO;
using System.Linq;

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

using IronPdf;
using System.Collections.Generic;
using System.IO;
using System.Linq;

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

Imports IronPdf
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase))

Dim pdfDocuments As New List(Of PdfDocument)()

For Each imagePath In imagePaths
    Dim individualPdf = ImageToPdfConverter.ImageToPdf( _
        imagePath, _
        ImageBehavior.FitToPageAndMaintainAspectRatio _
    )
    pdfDocuments.Add(individualPdf)
Next

' Merge all individual PDFs into one document
Dim combinedPdf As PdfDocument = PdfDocument.Merge(pdfDocuments)
combinedPdf.SaveAs("custom-photo-collection.pdf")

Bu PDF Dönüştürücü Hangi Görüntü Biçimlarını Destekler?

IronPDF'nin görüntüden PDF'ye dönüştürücüsü, JPEG'in ötesinde geniş bir format yelpazesini işleyebilir. Aynı ImageToPdfConverter sınıfı, PNG, BMP, GIF, TIFF, SVG ve WebP dosyalarını aynı yöntem çağrıları kullanarak işler -- farklı görüntü türleri için ayrı kod yollarına ihtiyacınız yoktur.

Özellikle TIFF dosyaları için, IronPDF, TIFF'teki her kareyi çıktıda ayrı bir sayfa haline getiren çok çerçeveli TIFF'ten PDF'e dönüştürme destekler. Bu, TIFF arşivleri olarak gelen taranmış çok sayfalı belgeler için özellikle kullanışlıdır.

Statik raster görüntülerin ötesinde, IronPDF tam çözünürlükte SVG vektör grafiklerini de işler, böylece kaliteli kayıp olmadan teknik diyagramlar ve simgeleri dönüştürmek için güvenilir bir araçtır. Görüntüleri işleyen aynı motor HTML'den PDF'e de dönüştürme yapar, böylece hem görüntü hem de HTML formatlı metin içeren belgeler karma içerik boru hatları iyi bir şekilde desteklenir.

çevrimiçi PDF dönüştürücüler veya tarayıcı tabanlılar aksine, IronPDF tamamen .NET işleminiz içinde çalışır. Dosyalar hiçbir zaman sunucunuzu terk etmez, bu da gizli belgeleri, tıbbi görüntüleri veya mali kayıtları işleyen uygulamalar için önemlidir.

Dönüştürülen PDF'deki Görüntü Yerleştirmelerini Nasıl Kontrol Edersiniz?

Varsayılan olarak, IronPDF PDF sayfasını görüntü boyutlarına uyacak şekilde ayarlar. Farklı bir davranışa ihtiyacınız varsa - görüntüleri standart kağıt boyutuna sığdırma, beyaz kenarlıklarla ortalama veya sayfayı dolduracak şekilde kırpma - ImageBehavior enumunu ImageToPdfRenderOptions ile birleştirin.

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

Imports IronPdf

Dim renderingOptions As New ImageToPdfRenderOptions With {
    .ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    .PaperSize = PdfPaperSize.A4,
    .MarginTop = 25,
    .MarginBottom = 25,
    .MarginLeft = 25,
    .MarginRight = 25
}

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions)
pdf.SaveAs("formatted-output.pdf")

Mevcut ImageBehavior değerleri en yaygın yerleşim gereksinimlerini karşılar:

• FitToPageAndMaintainAspectRatio -- oranları koruyarak sayfayı dolduracak şekilde görüntüyü ölçeklendirir
• CenteredOnPage -- görüntüyü orijinal boyutunda, yatay ve dikey olarak ortalar
• TopLeftCornerOfPage -- görüntüyü ölçeklendirmeden sol üst köşeye sabitler
• CropPage -- sayfa boyutunu görüntü boyutlarına tam olarak uyacak şekilde kırpar

Dönüştürmeden sonra, ek dönüştürmeler uygulayabilirsiniz. HTML işaretlemesi kullanarak bir filigran ekleyin, belge kimliği için başlıklar ve altbilgiler ekleyin veya istenilen yönlendirmeye uyacak şekilde sayfaları döndürün.

Daha fazla son işlem seçenekleri şunları içerir:

• Filigran veya onay işaretleri için Metin veya resim damgalama
• Arka plan şablonları uygulama başlıklı efektler için
• E-posta veya yükleme için dosya boyutunu küçültmek için çıktı PDF'sini sıkıştırma
• Görsel işaretleme için şekiller ve açıklamalar çizme

JPEG'ten PDF'e Dönüştürme için En Yaygın Kullanım Durumları Nelerdir?

Programatik JPEG'ten PDF'e dönüştürme, birçok belge iş akışı için bir yapı taşıdır. En sık senaryoları anlamak, uygulamanız için doğru mimariyi tasarlamanıza yardımcı olur.

Belge arşivleme ve uyumluluk -- Kağıt kayıtları tarayan kuruluşlar, masaüstü tarayıcılarından ve belge tarayıcılarından JPEG dosyaları üretir. Bunları PDF'e dönüştürmek, PDF/A formatında indeksleme, uzun süreli depolama ve standart belge yönetim platformları aracılığıyla erişim sağlar. PDF/A, özellikle arşivleme için tasarlanmış bir ISO standardıdır ve IronPDF uyumlu dosyalar üretmeyi destekler.

Rapor ve pano oluşturma -- Grafikler, ekran görüntüleri veya veri görselleştirmeleri üreten uygulamalar, genellikle çıktılarını JPEG olarak yakalar. ImageToPdfConverter kullanarak PDF raporlarına bunları dahil etmek, ilgililerin grafik yazılımı yüklemesine gerek kalmadan gözden geçirebileceği tutarlı, yazdırılabilir belgeler üretir.

Fotoğraf portföyleri ve galeriler -- Yaratıcı profesyoneller ve gayrimenkul platformları, baskı için gayrimenkul sayfaları, portföy kitapları ve katalog PDF'leri üretmek için toplu JPEG'ten PDF'e dönüştürme işlemi kullanır. Yer imleri ile tek bir gezilebilir PDF'ye onlarca fotoğrafı birleştirmek, görüntü dosyaları klasöründen daha iyi bir sunum oluşturur.

Otomatik yükleme iş akışları -- Kullanıcılardan JPEG yüklemeleri kabul eden web uygulamaları -- profil fotoğrafları, destekleyici belgeler, kimlik taramaları -- tüm yüklemeleri tutarlı alt işleme için PDF'e dönüştürerek normalleştirebilir. Bu, depolama, arama ve işlemeyi basitleştirir çünkü uygulama birden fazla format yerine tek bir formatla ilgilenir.

PDF Association'un endüstri araştırmasına göre, PDF, kurumsal ortamlarda en yaygın kullanılan belge formatı olmaya devam etmektedir, bu da bir iş akışında görselleri PDF'e erken dönüştürmenin uyumluluk ve uzun vadeli erişilebilirlik açısından yatırım getirisini sağladığı anlamına gelir.

Mozilla Geliştirici Ağı, PDF MIME tipini application/pdf olarak belgeler ve bu, tüm büyük tarayıcılar tarafından eklentisiz olarak yerel desteklenir -- PDF, tarayıcıda görüntülenmesi gereken belgeler için en güvenli format seçimi yapar.

Bu senaryoların herhangi birinde güvenliği arttırmak için, IronPDF PDF redaksiyonu, hassas içeriği kalıcı olarak kaldırma, PDF temizliği ile gizli meta verileri temizleme ve belge kimlik doğrulama için dijital imzalar destekler.

Dönüştürülen PDF'lere Başlıklar, Altbilgiler ve Meta Veriler Nasıl Eklenir?

Dönüştürülmüş bir JPEG'ten PDF'e genellikle sadece başlangıç noktasıdır. Üretim uygulamaları genellikle son dosyayı teslim etmeden önce belge meta verileri, sayfa numaraları ve organizasyonel markalama eklemelidir.

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

Imports IronPdf
Imports IronPdf.Editing

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Add a text footer with page numbers
Dim footer As New TextHeaderFooter With {
    .CenterText = "Page {page} of {total-pages}",
    .DrawDividerLine = True,
    .FontSize = 10
}
pdf.AddTextFooters(footer)

' Set document metadata
pdf.MetaData.Title = "Converted Photo Document"
pdf.MetaData.Author = "Document Processing System"
pdf.MetaData.CreationDate = System.DateTime.Now

' Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
)

pdf.SaveAs("final-document.pdf")

Toplu dönüştürmeler için, aynı altbilgi ve meta verileri kaydetmeden önce çok görüntülü PDF'nin her sayfasına uygulayabilirsiniz. eşzamanlı işleme API'si, çok görüntülü PDF'nin her sayfasına aynı altbilgi ve meta verileri kaydetmeden önce yüksek verimli ortamlarda birçok görüntüyü eş zamanlı olarak işler.

Dağıtımınız bulut tabanlıysa, Azure dağıtım kılavuzunu ve AWS kurulum belgelerini ortamınıza özgü yapılandırma için gözden geçirin. özel günlük API'si, operasyonel izleme için Serilog, NLog ve Microsoft.Uzantılar.Logging ile entegre olur.

IronPDF sorun giderme kılavuzu, üretimde ortaya çıkan en yaygın sorunları kapsar, font yüklemeleri, Linux'taki izin hataları ve .NET sürümleri arasındaki render farkları dahil.

Sonraki Adımlarınız Neler?

IronPDF'nin ImageToPdfConverter sınıfı size C#'da JPEG dosyalarından profesyonel PDF belgelerine giden basit bir yol sunar. API, aynı method çağrısı ile tek görüntüler ve toplu koleksiyonları işler, ek kod gerektirmeden yedi görüntü formatını destekler ve IronPDF'nin PDF manipülasyon özelliklerinin tam yelpazesiyle entegre olur.

NuGet aracılığıyla paketi yükleyerek başlayın:

Install-Package IronPdf

Ardından, bu eğiticiden örnek kodu kullanım durumunuza uyarlayın. Tek görüntü dönüştürme üç satır kod ile çalışır. Toplu işleme için bir LINQ sorgusu ve bir method çağrısı gereklidir. Yerleşim özelleştirmesi ImageToPdfRenderOptions sınıfı ve ImageBehavior enumunu kullanır.

IronPDF ücretsiz deneme, değerlendirme için tüm özelliklere tam erişim sağlar. Üretim için hazır olduğunuzda, ticari uygulamalar için lisanslama seçeneklerini, büyüyen ekipler için lisans yükseltme yollarını gözden geçirin. IronPDF PDF dönüştürücü özellik sayfası, eğer sadece JPEG girişi ile sınırlı kalmak istemiyorsanız, desteklenen her dönüştürme türünü listeler.

İlgili resimden belge iş akışları için, PDF'lere resim ekleme kılavuzu, mevcut PDF sayfalarına resim gömme işlemlerini kapsar ve HTML'den PDF'e dönüştürme eğitimi, tek bir belgede metin ve resim içeren PDF'ler üretmeyi açıklar.