JPEG'yi PDF'ye Dönüştürun .NET | IronPDF C# Eğitmeni

JPEG'den PDF'ye Dönüştürme için IronPDF Nasıl Yüklenir?

Dönüşüm kodu yazmadan önce, IronPDF'yi .NET projenize ekleyin. Kütüphane NuGet aracılığıyla dağıtılır ve saniyeler içinde yüklenir.

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

Install-Package IronPdf

Install-Package IronPdf

Ya da .NET CLI kullanın:

dotnet add package IronPdf

dotnet add package IronPdf

IronPDF, .NET 8, .NET 9 ve .NET 10'un yanı sıra .NET Framework 4.6.2 ve üzerini hedefler. Ekstra çalışma zamanı bağımlılıkları gerekmez -- paket, Windows, Linux, macOS, Docker ve Azure üzerinde görüntüden PDF'ye dönüşüm için gerekli olan her şeyi içerir.

Kurulumdan sonra, dosyanızın en üstüne tek bir using IronPdf; ifadesi ekleyin ve dönüştürmeye başlamak için hazırsınız.

IronPDF NuGet paketi işleme motorunu içerir, dolayısıyla ü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 üzere Docker kurulum kılavuzunu gözden geçirin.

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

JPEG'ten PDF'e dönüştürmenin en basit yolu ImageToPdfConverter.ImageToPdf() statik metodu kullanmaktır. Görüntü dosya yolunu iletin, bir PdfDocument nesnesi alın ve ihtiyaçınız olan yere 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 metodu, JPEG dosyanızın dosya yolunu alır ve kaydedebileceğiniz, aktarabileceğiniz veya diğer IronPDF işlemlerine iletebileceğiniz bir PdfDocument nesnesi döndürür. Dönüşüm bellekte gerçekleşir, bu da diske dokunmadan doğrudan PDF'yi sunması gereken web uygulamaları için idealdir.

Çıktı PDF, orijinal görüntü kalitesini korurken, herhangi bir PDF okuyucusunun açabileceği bir formata paketler. Sayfa boyutları otomatik olarak ayarlanır -- PDF sayfası boyutları varsayılan olarak görüntü boyutlarına uyar, beyaz kenar boşlukları istemediğiniz sürece temiz bir çıktı sunar. Belirli kenar boşluklarına ihtiyaçınız varsa, özel kenar boşlukları API'sini kullanın.

HTML'den PDF'ye dönüşüm konusunda zaten deneyimi olan geliştiriciler için, görüntü dönüştürme API'si aynı deseni takip eder: girdi 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üşüm -- birden fazla JPEG görüntüsünü alıp tek bir PDF'de birleştirmek -- aynı derecede basit. Dosya yollarının bir listesini ImageToPdfConverter.ImageToPdf()'ye iletin ve kütüphane, her bir 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, enumerable'da göründükleri sırada görünür. Sayfa sıralarını kontrol etmek için, converter'a iletmeden önce dosya yollarını sıralayın -- örneğin dosya adı, oluşturma tarihi veya iş akışınıza uyan herhangi bir özel sıralama ile.

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ü Formatları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ıyla işler -- farklı görüntü türleri için ayrı kod yollarına ihtiyaçınız yoktur.

TIFF dosyaları özelinde, IronPDF, çoklu çerçeveli TIFF'ten PDF'e dönüşümü destekler, TIFF'teki her çerçeve, çıktı PDF'sinde ayrı bir sayfa olur. Bu, TIFF arşivleri olarak gelen taranmış çok sayfalı belgeler için özellikle faydalıdır.

Statik raster görüntülerin ötesinde, IronPDF, SVG vektör grafiklerini tam çözünürlükte işler, böylece teknik diyagramların ve ikonların kalite kaybı olmadan dönüştürülmesi için güvenilir bir araç olur. Görüntüleri işleyen aynı motor, ayrıca HTML'den PDF'e dönüştürür, bu nedenle karışık içerik boru hatları -- hem görüntü hem HTML formatlı metin içeren belgeler -- iyi desteklenir.

Tarayıcı tabanlı veya çevrimiçi PDF dönüştürücülerinden farklı olarak, IronPDF tamamen .NET süreciniz içinde çalışır. Dosyalar asla sunucunuzdan ayrılmaz, bu da gizli belgeler, tıbbi görüntüler veya finansal kayıtlarla ilgilenen uygulamalar için önemlidir.

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

Varsayılan olarak, IronPDF PDF sayfasını resim boyutlarıyla eşleştirir. Farklı davranışlar gerektiriyorsanız -- görüntüleri standart bir kağıt boyutuna sığdırmak, onları beyaz kenarlıklarla ortalamak veya sayfayı dolduracak şekilde kırpmak -- ImageBehavior enumunu ve ImageToPdfRenderOptions'i kullanın.

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 gerekliliklerini karşılar:

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

Dönüşümden sonra, ek dönüşümler uygulayabilirsiniz. HTML markajı ile bir filigran ekleyin, üstbilgi ve altbilgi ekleyerek belge kimliğini belirleyin ya da sayfaları istediğiniz yönlendirmeye uyacak şekilde döndürün.

Daha fazla sonrası işleme seçenekleri şunları içerir:

• Markalama veya onay işaretleri için Metin veya görüntü damgalama
• Antet etkileri için arka plan şablonları uygulama
• E-posta veya yükleme için dosya boyutunu küçültmek çıkış PDF'lerini sıkıştırmak
• Görsel markaj için şekil ve açıklamalar çizmek

JPEG'den PDF'e Dönüştürmenin En Yaygın Kullanım Senaryoları Nelerdir?

Programatik JPEG'den PDF'e dönüştürme, birçok belge iş akışı için bir yapı taşıdır. En sık karşılaşılan 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, düz yataklı ve belge tarayıcılardan 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ı üzerinden erişim sağlar. PDF/A, özellikle arşivleme için tasarlanmış bir ISO standardıdır ve IronPDF, uyumlu dosyalar oluşturmayı destekler.

Rapor ve gösterge paneli oluşturma -- Grafikler, ekran görüntüleri veya veri görselleştirmeleri üreten uygulamalar genellikle çıktıyı JPEG olarak yakalar. Bunları ImageToPdfConverter kullanarak PDF raporlarına gömmek, paydaşların grafik yazılımı yüklemeden inceleyebileceği tutarlı, yazdırılabilir belgeler oluşturur.

Fotoğraf portföyleri ve galerileri -- Yaratıcı profesyoneller ve emlak platformları, basılabilir mülk sayfaları, portföy kitapları ve katalog PDF'leri oluşturmak için toplu JPEG'den PDF'e dönüştürme kullanır. Bir görüntü dosyası klasöründen daha iyi bir sunum oluşturmak için bir navigasyona yerleştirilebilir PDF'e yer imleri eklenir.

Otomatik yükleme işlemleri -- Kullanıcılardan JPEG yüklemelerini kabul eden web uygulamaları -- profil fotoğrafları, destekleyici belgeler, kimlik taramaları -- tüm yüklemeleri tutarlı aşağı akış işlemleri için PDF'e normalleştirir. Bu, uygulamanın birçok format yerine tek bir formatla ilgilenmesi nedeniyle depolamayı, aramayı ve oluşturmayı basitleştirir.

PDF Birliği'nin sektör araştırmasına göre, PDF, kurumsal ortamlarda en yaygın kullanılan belge formatı olmaya devam ediyor, bu yüzden bir iş akışında baştan görüntüleri PDF'e dönüştürmek, uygunluk ve uzun vadeli erişilebilirlikte kazanç sağlar.

Mozilla Developer Network, PDF MIME türünü application/pdf olarak belgeler, ki bu tüm büyük tarayıcılar tarafından plugin olmadan desteklenir -- bu da PDF'i tarayıcıda görüntülenmesi gereken belgeler için en güvenli format seçimi yapar.

Bu senaryoların herhangi birinde artırılmış güvenlik için, IronPDF, hassas içeriği kalıcı olarak kaldırmak PDF karalama, gizli metaveriyi temizlemek PDF temizleme ve belge kimlik doğrulaması için dijital imzaları destekler.

Dönüştürülmüş PDF'lere Üstbilgi, Altbilgi ve Metaveri Nasıl Eklenir?

Dönüştürülmüş JPEG'den PDF'e genellikle sadece başlangıç noktasıdır. Üretim uygulamaları genellikle son dosyayı teslim etmeden önce belge metaverisi, sayfa numaraları ve kurumsal markalama eklemeyi gerektirir.

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üşümler için, çoklu görüntü PDF'indeki her sayfaya aynı altbilgi ve metaveriyi kaydetmeden önce uygulayabilirsiniz. Async işleme API'si, yüksek verimli ortamların birçok görüntüyü aynı anda işleyebilmesi için engelleyici olmayan iş parçacıkları sağlar.

Eğer dağıtımınız bulut tabanlı ise, ortamınıza özgü yapılandırma için Azure dağıtım kılavuzu ve AWS kurulum belgesi inceleyin. Özel günlük tutma API'si, operasyonel izleme için Serilog, NLog ve Microsoft.Uzantılar.Logging ile entegre edilir.

IronPDF sorun giderme kılavuzu, üretimde ortaya çıkan en yaygın sorunları kapsar, bunlar arasında yazı tipi yükleme, Linux'ta izin hataları ve .NET sürümleri arasında oluşturma farklılıkları bulunur.

Sıradaki Adımlarınız Neler?

IronPDF'in ImageToPdfConverter sınıfı, JPEG dosyalarından profesyonel PDF belgelerine doğrudan bir yol sunar. API, aynı yöntem çağrısı ile tekli görüntüleri ve toplu koleksiyonları ele alır, yedi görüntü formatını ek kod olmadan destekler ve IronPDF'nin tam PDF manipülasyon özellikleriyle entegre olur.

NuGet ile paketi yükleyerek başlayın:

Install-Package IronPdf

Install-Package IronPdf

Daha sonra bu öğreticinin kod örneklerini kullanım durumunuza uyarlayın. Tekli görüntü dönüştürme, üç satır kodla çalışır. Toplu işleme, bir LINQ sorgusu ve bir yöntem çağrısı gerektirir. Düzen özelleştirmesi, ImageToPdfRenderOptions sınıfı ve ImageBehavior enumu ile gerçekleştirilir.

IronPDF ücretsiz denemesi, değerlendirme için tüm özelliklere tam erişim sağlar. Üretim için hazır olduğunuzda, büyüyen ekipler için lisanslama yükseltme yolları dahil olmak üzere ticari uygulamalar için lisanslama seçeneklerini gözden geçirin. IronPDF PDF dönüştürücü özellikler sayfası, daha fazla giriş türünü ele almanız gerekiyorsa her desteklenen dönüşüm türünü listeler.

İlgili görüntüden belge iş akışları için, PDF'lere görüntü ekleme kılavuzu, mevcut PDF sayfalarına görüntü yerleştirmeyi kapsar ve HTML'den PDF'e eğitim, tek bir belgede metin ve görüntüleri birleştiren HTML şablonlarından PDF'lerin nasıl üretileceğini açıklar.