IRONSOFTWAREHOME
IRONPDF KULLANARAK

.NET Core PDF Kütüphanesi

Curtis Chau
Curtis Chau
Updated: 28 Haziran 2026

IronPDF, C# dilinde görüntüleri PDF'ye dönüştürmek için ImageToPdf yöntemi aracılığıyla basit ve ücretsiz bir çözüm sunar; geliştiricilerin yalnızca birkaç satır kod ve özelleştirilebilir sayfa ayarları ile tek veya birden fazla görüntüyü dönüştürmesine olanak tanır.

Birçok kütüphane, C# geliştiricilerine resimleri PDF'lere dönüştürme olanağı sunar. İyi bir performansa sahip kullanıcı dostu ve ücretsiz bir kütüphane bulmak zor olabilir, çünkü bazıları ücretli, karmaşık veya işlevsellik açısından sınırlı olabilir. Bu kütüphaneler arasında, IronPDF ücretsiz, verimli ve uygulaması kolay bir C# kütüphanesi olarak öne çıkar. Kapsamlı dokümantasyon ve özel destek ile birlikte gelir.

IronPDF, .NET projelerinde PDF dosyalarını oluşturmak, okumak, düzenlemek ve kaydetmek için bir .NET kütüphanesidir. IronPDF, .NET 5, Core, Standard & Framework için CSS3 ve JS dahil olmak üzere tam HTML'den PDF'ye desteği ile HTML'den PDF'ye dönüştürme özelliğine sahiptir. Kütüphane, piksel mükemmel PDF oluşturulmasını çeşitli kaynaklardan garanti etmek için Chrome render motoru kullanır.

Resimleri PDF'ye nasıl dönüştüreceğinizi öğrenmek için örnek bir proje oluşturmayı inceleyelim. Bu öğretici, sizi kurulum süreci, temel görüntü dönüştürme ve birden fazla görüntü ve farklı formatlarla başa çıkma konusunda gelişmiş özellikler boyunca yönlendirecektir.

Visual Studio Projesi Nasıl Oluşturulur?

Yeni bir proje oluşturmak için Microsoft Visual Studio'yu açın. Visual Studio'nun en son sürümünü kullanmanız önerilir. Yeni proje oluşturma adımları sürümler arasında farklılık gösterebilir, ancak geri kalan her sürüm için aynı kalmalıdır.

  1. Yeni Proje Oluştur'a tıklayın.
  2. Proje Şablonunu Seçin, ardından bu gösterim için Konsol Uygulaması şablonunu seçin. Kendi gereksinimleriniz doğrultusunda ASP.NET Core veya Blazor uygulamaları dahil herhangi bir şablonu kullanabilirsiniz.
  3. İleri'ye tıklayın. Projeye bir ad verin (örneğin, "ImageToPDFConverter").
  4. İleri'ye tıklayın ve .NET Framework sürümünü seçin.
  5. Oluştur butonuna tıklayın.

Yeni proje aşağıda gösterildiği gibi oluşturulacaktır. Proje yapısı, image conversion kodumuzu yazacağımız bir Program.cs dosyasını içerecektir.

Visual Studio yeni konsol uygulama projesi oluşturma ekranı, şablon seçimi ve yapılandırma seçeneklerini gösteriyor Visual Studio'da yeni bir Console Uygulaması oluşturun

Hangi .NET Framework Sürümünü Seçmeliyim?

IronPDF, .NET Framework 4.6.2+, .NET Core 3.1+ ve .NET 5/6/7/8+ dahil olmak üzere geniş bir .NET sürümü yelpazesini destekler. Yeni projeler için, en iyi performans ve güvenlik güncellemeleri için en son LTS (Uzun Vadeli Destek) sürümü olan .NET kullanılması önerilir. Kütüphane ayrıca Windows, Linux ve macOS platformlarında sorunsuz bir şekilde çalışır.

Bu projede kullanmak için IronPDF NuGet Paketini yükleyin. IronPDF'in en iyi yanı, PDF belgeleri oluşturmanın sinir bozuculuğunu ortadan kaldırarak, tescilli API'lere dayanmıyor olmasıdır. HTML'den PDF'ye işleme, standart belge türlerinden piksel kusursuz PDF'ler oluşturan: HTML, JS, CSS, JPG, PNG, GIF ve SVG. Kısacası, geliştiricilerin zaten sahip olduğu becerileri kullanır.

IronPDF NuGet Paketi Nasıl Yüklenir?

NuGet Paketini yüklemek için Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu menüsüne gidin. Aşağıdaki pencere görünür:

Package Manager Console arayüzü, Visual Studio'da NuGet paket yönetimi için komut satırı arayüzünü gösteriyor Paket Yöneticisi Konsolu UI

Daha sonra, Paket Yöneticisi Konsolu'na aşağıdaki komutu yazın:

PM > Install-Package IronPdf

Enter'a basın. Kurulum işlemi, gerekli Chrome render motoru bileşenleri dahil olmak üzere IronPDF ve bağımlılıklarını indirecektir.

Package Manager Console, IronPDF paketinin başarılı kurulumunu, sürüm bilgilerini ve bağımlılıkları gösteriyor Paket Yöneticisi Konsolu'nda IronPDF paketini kurun

Alternatif Kurulum Yöntemleri Nelerdir?

IronPDF'i aşağıdaki yollarla da yükleyebilirsiniz: NuGet Package Manager UI: Projenize sağ tıklayın, "NuGet Paketlerini Yönet" seçeneğini seçin, "IronPDF"i arayın ve Yükle'ye tıklayın

  • Paket Referansı: .csproj dosyanıza <PackageReference Include="IronPdf" Version="*" /> ekleyin
  • Doğrudan İndirme: DLL'i IronPDF web sitesinden indirip manuel olarak referans alın
  • Komut Satırı: Terminalde dotnet add package IronPdf kullanın

Azure dağıtımları için ek yapılandırma gerekebilir. Benzer şekilde, Docker ortamları belirli kurulum adımları gerektirir.

Görüntü Dosyasını PDF Belgesine Nasıl Dönüştürürüm?

Sonraki adım, aşağıdaki görüntüyü PDF'ye dönüştürme işlemini gösterecek. IronPDF, ImageToPdf dönüştürücü fonksiyonelliği ile bu süreci basitleştirir.

Hangi Görüntü Formatları Destekleniyor?

IronPDF, PDF dönüştürme için geniş bir görüntü formatını destekler:

  • JPEG/JPG: Fotoğraflar için en yaygın format
  • PNG: Şeffaflığa sahip görüntüler için ideal
  • GIF: Hareketli GIF'leri içerir (ilk kare kullanılır)
  • BMP: Windows bitmap formatı
  • TIFF: Çok sayfalı TIFF'leri içerir
  • SVG: Ölçeklenebilir vektör grafikler
  • WebP: Modern web görüntü formatı

Örnek kuş görüntüsü, bir dalda durmakta olan renkli bir kuşu gösteriyor ve PDF dönüşümü için görüntü kalitesini sergiliyor Örnek Görüntü

Kütüphaneyi kullanmak için program.cs dosyasında IronPDF kütüphanesini referans olarak ekleyin. Dosyanın en üstüne aşağıdaki kod parçasını yazın:

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

Sonraki adım, ana fonksiyonun içine aşşağıdaki kodu yazmaktır. Bu, bir JPG dosyasını PDF dosyasına dönüştürecektir:

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
    
    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";
    
    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
    
    Console.WriteLine("PDF created successfully!");
}

ImageBehavior Çıkışı Nasıl Etkiler?

Yukarıdaki kod örneğinde, IronPDF tarafından sağlanan ImageToPdfConverter sınıfı, görüntü dönüşümü için kullanılır. ImageToPdf yöntemi, görüntülerden PDF belgeleri oluşturmak için kullanılabilir. Hem görüntü dosyalarını hem de bir System.Drawing nesnesini girdi olarak kabul eder.

Statik yöntem ImageToPdf, tek bir görüntü dosyasını, boyutlarıyla eşleşen bir PDF belgesine dönüştürür. İki argüman alır: Görsel Yolu ve Görsel Davranışı (görselin kağıda nasıl yerleşeceği). ImageBehavior enum, birkaç seçenek sunar:

  • CropPage: PDF sayfa boyutunu görüntü boyutlarına eşler
  • CenteredOnPage: Görüntüyü boyutlandırmadan sayfanın ortasına yerleştirir
  • FitToPage: Görüntüyü sayfa kenar boşluklarına sığacak şekilde ölçeklendirir
  • FitToPageAndMaintainAspectRatio: Görüntüyü en-boy oranını koruyarak ölçeklendirir

Imaging.ImageBehavior.CropPage, kağıt boyutunu görüntü boyutuna eşitleyecektir. Varsayılan sayfa boyutu A4'tür. Bunu aşağıdaki kod satırı ile ayarlayabilirsiniz:

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

Belirli gereksinimler için özel sayfa boyutları da belirleyebilirsiniz:

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

Hangi Kağıt Boyutu Seçenekleri Mevcut?

Birden çok sayfa boyutu seçeneği sağlanmıştır, ve bunları gereksinimlerinize göre ayarlayabilirsiniz. IronPDF tüm standart kağıt boyutlarını destekler:

  • A Serisi: A0, A1, A2, A3, A4 (varsayılan), A5, A6, A7, A8, A9, A10
  • B Serisi: B0'dan B10'a kadar
  • ABD Boyutları: Letter, Legal, Ledger, Tabloid, Executive
  • Diğer: Foolscap, Crown, Demy, Royal ve daha fazlası

Sayfa yönlendirmesi (Dikey veya Yatay) ve özel kenar boşluklarını da PDF'leriniz için yapılandırabilirsiniz.

Birden Çok Görüntüyü Bir PDF Dosyasına Nasıl Dönüştürürüm?

Aşağıdaki örnek, JPG görüntülerini yeni bir belgeye dönüştürecektir. Bu, fotoğraf albümleri, kataloglar oluşturmak veya taranmış belgeleri birleştirmek için özellikle kullanışlıdır:

public static void Main(string[] args)
{
    // Enumerate and filter JPG files from the specified directory
    var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
                                        .Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
    
    // Sort files alphabetically (optional)
    var sortedImageFiles = imageFiles.OrderBy(f => f);
    
    // Convert the images to a PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(sortedImageFiles);
    
    // Add page numbers to each page
    for (int i = 0; i < doc.PageCount; i++)
    {
        doc.AddTextFooter($"Page {i + 1} of {doc.PageCount}", 
                         FontFamily.Arial, 
                         fontSize: 10,
                         y: 25);
    }
    
    // Save the combined PDF
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
    
    Console.WriteLine($"Combined {doc.PageCount} images into a single PDF!");
}

Farklı Görüntü Formatlarını Nasıl Filtre Edebilirim?

Yukarıdaki kodda, System.IO.Directory.EnumerateFiles belirtilen klasördeki tüm dosyaları alır. Where cümlesi, o klasördeki tüm JPG görüntülerini filtreler ve onları imageFiles koleksiyonunda depolar. PNG veya başka bir görüntü formatınız varsa, bunu Where sorgusuna ekleyebilirsiniz:

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

Ayrıca bir uzantılar dizisi ile daha özlü bir yaklaşım da kullanabilirsiniz:

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

Resimler PDF'de Hangi Sırayla Görünecek?

Varsayılan olarak, resimler dosya sistemi tarafından döndürülen sırayla görünür, bu alfabetik olmayabilir. Sırayı kontrol etmek için dosyaları sıralayabilirsiniz:

  • Alphabetical: imageFiles.OrderBy(f => f)
  • Oluşturulma Tarihine Göre: imageFiles.OrderBy(f => new FileInfo(f).CreationTime)
  • Dosya Boyutuna Göre: imageFiles.OrderBy(f => new FileInfo(f).Length)
  • Özel Sıra: Özel bir karşılaştırma fonksiyonu kullanın

Sonraki satır, tüm resimleri alır ve bunları tek bir PDF belgesinde birleştirir. Her bir resim, PDF'de ayrı bir sayfa haline gelir.

Bir PDF Dosyasını Nasıl Yazdırırım?

Aşağıdaki kod parçası, IronPDF'nin yazdırma yeteneklerini kullanarak belgeyi yazdıracaktır:

// Print using default printer
doc.Print();

// Print silently (without print dialog)
doc.Print(showPreview: false);

// Print to a specific printer
var printerName = "Microsoft Print to PDF";
doc.Print(printerName);

Yazıcı Ayarlarını Belirleyebilir miyim?

Print yöntemi, PdfDocument sınıfı tarafından sağlanır ve belgeyi varsayılan yazıcı ile yazdırır. Ayrıca yazıcı adını ve diğer ayarları değiştirme seçeneği sunar. Gelişmiş yazdırma seçenekleri için:

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

Belgeleri yazdırma ile ilgili daha fazla ayrıntı için bu PDF yazdırma örneğini ziyaret edin. Kurumsal ortamlar için ağ yazdırma seçeneklerini da keşfedebilirsiniz.

Ana Çıkarımlar Nedir?

Bu eğitim, görüntüleri PDF dosyasına dönüştürmenin çok kolay bir yolunu kod örnekleriyle gösterdi, tek bir görüntüyü PDF'ye dönüştürme veya birden fazla görüntüyü tek bir PDF dosyasında birleştirme. Ayrıca, belgeleri tek bir kod satırı ile yazdırmanın nasıl yapıldığını da açıkladı.

Ele alınan ana noktalar:

  • IronPDF'yi NuGet Paket Yöneticisi aracılığıyla yüklemek
  • Tekil resimleri özel davranışla PDF'ye dönüştürmek
  • Birden fazla resmi topluca tek bir PDF'ye dönüştürme
  • Sayfa boyutu, yönlendirme ve kenar boşluklarını kontrol etme
  • PDF'lere meta veriler ve sayfa numaraları ekleme
  • Programlı olarak seçeneklerle PDF'yi yazdırma

Ayrıca, IronPDF'nin bazı önemli özellikleri şunlardır:

IronPDF Hakkında Daha Fazla Nereden Öğrenebilirim?

IronPDF tarafından sağlanan birçok kullanışlı özellik vardır. Bu kaynakları keşfedin:

Belirli kullanım durumları için:

IronPDF Ne Kadar?

IronPDF, Iron Software paketinin bir parçasıdır. Iron Suite, Excel işlemleri için IronXL, barkod oluşturma için IronBarcode, metin tanıma için IronOCR ve web veri çıkarma için IronWebScraper gibi ek yararlı ürünleri içerir. Tam Iron Suite satın alarak %250'ye kadar tasarruf edebilir, çünkü şu anda sadece iki ürün fiyatına tüm beş ürünü elde edebilirsiniz. Daha fazla bilgi için lisanslama detayları sayfasını ziyaret edin.

IronPDF şunları sunar:

  • Test için ücretsiz geliştirme lisansı
  • Professional lisanslar $999 ile başlıyor
  • Telif ücretsiz yeniden dağıtım seçenekleri
  • SaaS ve OEM lisansları mevcut
  • 30 gün para iade garantisi
  • Bir yıl boyunca ücretsiz destek ve güncellemeler

Ekibiniz için bir deneme lisansı ile IronPDF'yi 30 gün boyunca ücretsiz deneyin veya lisanslama seçeneklerini keşfedin.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

İlgili Makaleler

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez