IRONSOFTWAREHOME
VIDEOLAR

XML Kullanan C#'ta PDF'yi Nasıl Dönüştürürüz

Curtis Chau
Curtis Chau
Updated: 19 Temmuz 2026

PdfPig'den IronPDF'ye geçmek, okuma odaklı bir kütüphaneden (koordinata dayalı yazım için dar bir yazıcı yüzeyi ve temel birleştirme ile) PDF oluşturma, manipulasyon, metin çıkarma ve güvenlik özelliklerini işleyen kapsamlı bir PDF çözümüne yeteneklerinizi genişletir. Bu kılavuz, mevcut çıkarım iş akışlarınızı korurken, PdfPig'in sağlamadığı HTML dönüşümü, yüksek düzeyde belge manipulationu, filigran ekleme ve güvenlik yazımı eklemeyi planlı, adım adım bir geçiş yolu sağlar.

PdfPig'den IronPDF'ye Neden Geçiş Yapılmalı

PdfPig'i Anlamak

PdfPig (NuGet paketi PdfPig, namespace UglyToad.PdfPig) açık kaynaklı bir .NET PDF okuma ve çıkarım kütüphanesidir, başlangıçta Apache PDFBox Java projesinden esinlenilmiş ve kısmen taşınmıştır. Geliştiricilere, PDF'lerin yapısal içeriğine yüksek hassasiyetle erişim sağlar.PdfPigçıkarımda parlarken, kapsamı, tam yaşam döngüsü ticari kütüphanelerden daha dardır. Proje hala 1.0 öncesindedir (mevcut kararlı sürüm 0.1.14), ve README'sinde belirtiliyor ki "1.0.0 altındaki sürümler halka açık API'yi uyarı yapmadan değiştirebilir."

PdfPig, metin (harf ve kelime düzeyinde konumlarla), görüntüler, salt okunur form verileri, açıklamalar ve metadata çıkarmak için güvenilir araçlar sağlar. Ayrıca sınırlı bir yazar yüzeyi sunar — yeni belge yazımı için düşük seviyeli PdfDocumentBuilder ve mevcut PDF'lerin birleştirilmesi için PdfMerger (içinde UglyToad.PdfPig.Writer) kullanılır. Bu, esasen belge analizi, veri madenciliği ve temel birleştirme odaklı uygulamalar için uygun bir seçenek haline getirmektedir.

Okuma Odaklı Kısıtlama

PdfPig, okuma önceliklidir; yazıcı yüzeyi bilinçli olarak dar tutulmuştur. Uygulamanız çıkarımın ve ana birleştirmenin ötesine geçmek istediğinde,PdfPigyardımcı olamaz:

  1. Sınırlı PDF Oluşturma: Yeni belgeler, PdfDocumentBuilder ile manuel PdfPoint koordinat yerleştirmesi gerektirir — yüksek seviyeli düzenleme yoktur.

  2. **HTML-to-PDF Yok:**PdfPigbir PDF okuma/analiz kütüphanesidir, bir PDF oluşturma kütüphanesi değil. HTML'den PDF'ye dönüşümü için farklı bir kütüphane kullanmanız gerekecektir.

  3. Sınırlı Belge Manipülasyonu: PdfMerger birleştirme işlemlerini kapsar, ancak yüksek seviyeli bölme/döndürme/düzenleme API'si yoktur.

  4. Güvenlik Yazımı Yok: Şifreli PDF'leri (şifre ile) okuyabilir, ama şifre, şifreleme veya dijital imzalar ekleyemez.

  5. Filigranlar/Damgalar Yok: Mevcut belgelere görsel kaplamalar için yüksek düzey API yok.

  6. Form Doldurma Yok: Formlar salt okunur — değerler değiştirilemez veya eklenemez.

###PdfPigvs IronPDF Karşılaştırması

ÖzellikPdfPigIronPDF
LisansAçık Kaynak (Apache 2.0)Ticari
NuGet paketiPdfPig (v0.1.14, 1.0 öncesi)IronPdf
PDF Okuma/ÇıkarmaMükemmelMükemmel
PDF OluşturmaSınırlı (PdfDocumentBuilder aracılığıyla koordinat tabanlı)Kapsamlı
HTML'den PDF'yeDesteklenmiyorDesteklenen
Metin ÇıkarımıMükemmel (kelime sınırlama kutuları ile)Mükemmel (sadece metin)
PDF BirleştirmeDestekleniyor (PdfMerger)Destekleniyor (PdfDocument.Merge)
Böl/Döndür/DüzenleDesteklenmiyor (üst düzey)Desteklenen
FiligranlarDesteklenmiyorDesteklenen
Güvenlik/Şifreleme yazımıDesteklenmiyorDesteklenen
Destek ve BelgelerTopluluk DesteğiAdanmış Destek
Sayfa Endeksleme1 tabanlı0 tabanlı

IronPDF, PDF'leri oluşturma, okuma, düzenleme ve imzalama için eksiksiz bir özellik setini destekler. Bu çok yönlülük, PdfPig'in okuma yeteneklerinin ötesine geçerek, modern .NET üzerinde baştan sona PDF dosyalarını yönetmek için tam bir PDF yaşam döngüsü çözümü sağlar.


Başlamadan Önce

Ön Koşullar

  1. .NET Ortamı: .NET Framework 4.6.2+ veya .NET Core 3.1+ / .NET 5/6/7/8/9+
  2. NuGet Erişimi: NuGet paketlerini yükleyebilme
  3. IronPDF Lisansı: Lisans anahtarınızı ironpdf.com adresinden edinin

NuGet Paket Değişiklikleri

# Remove PdfPig
dotnet remove package PdfPig

# Install IronPDF
dotnet add package IronPdf
SHELL

Lisans Yapılandırması

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

###PdfPigKullanımını Belirleyin

# FindPdfPigusage
grep -r "UglyToad\.PdfPig\|PdfDocument\.Open\|GetPages\(\)" --include="*.cs" .

# Find page index references (may need 1→0 conversion)
grep -r "GetPage(\|NumberOfPages" --include="*.cs" .
SHELL

Tam API Referansı

Ad Alanı Değişiklikleri

// Before: PdfPig
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
using UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

Belge Yükleme Eşlemeleri

PdfPigIronPDF
PdfDocument.Open(path)PdfDocument.FromFile(path)
PdfDocument.Open(bytes)PdfDocument.FromBinaryData(bytes)
PdfDocument.Open(stream)PdfDocument.FromStream(stream)
using (var doc = ...)var pdf = ...

Sayfa Erişimi ve Özellikler Eşlemeleri

PdfPigIronPDF
document.NumberOfPagespdf.PageCount
document.GetPages()pdf.Pages
document.GetPage(1)pdf.Pages[0]

Metin Çıkarma Eşleşmeleri

PdfPigIronPDF
page.Textpdf.Pages[i].Text
page.GetWords()pdf.ExtractTextFromPage(i)
(manual loop)pdf.ExtractAllText()

Metadata Erişim Eşlemeleri

PdfPigIronPDF
document.Information.Titlepdf.MetaData.Title
document.Information.Authorpdf.MetaData.Author
document.Information.Subjectpdf.MetaData.Subject
document.Information.Creatorpdf.MetaData.Creator
document.Information.Producerpdf.MetaData.Producer

PdfPig'de Bulunmayan Yeni Özellikler

IronPDF ÖzelliğiAçıklama
renderer.RenderHtmlAsPdf(html)HTML'den PDF'ye dönüşüm
renderer.RenderUrlAsPdf(url)URL-to-PDF dönüşümü
pdf.ApplyWatermark(html)Filigran ekleme
pdf.SecuritySettings.UserPasswordParola koruması
pdf.Sign(certificate)Dijital imzalar

Not: PDF birleştirme her iki kütüphanede de mevcuttur (PdfMerger PdfPig'de, PdfDocument.Merge IronPDF'de).


Kod Göç Örnekleri

Örnek 1: PDF'ten Metin Çıkarma

Öncesi (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var text = new StringBuilder();
            foreach (var page in document.GetPages())
            {
                text.AppendLine(page.Text);
            }
            Console.WriteLine(text.ToString());
        }
    }
}

Sonrası (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();
        Console.WriteLine(text);
    }
}

HemPdfPighem de IronPDF mükemmel metin çıkarma yetenekleri sağlar. Ana fark, kod desenindedir. PdfPig, using beyanı ile PdfDocument.Open() gerektirir, GetPages() ile sayfalarda manuel yineleme yapar ve her page.Text özelliğinden metin toplamak için StringBuilder kullanır.

IronPDF, bunu tek bir çağrıya basitleştiriyor: PdfDocument.FromFile() belgeyi yükler, ve ExtractAllText() tüm metin içeriğini tek seferde döndürür. Herhangi bir using beyanı gerektirmez, manuel yineleme yok, StringBuilder gerekmez. Diğer seçenekler için metin çıkarma dökümantasyonuna buradan bakın.

Örnek 2: HTML'den PDF'e Dönüştürme

Öncesi (PdfPig):

PdfPig, HTML'den PDF'ye dönüşümünü desteklemez.PdfPigbir PDF okuma/parsing kütüphanesi, PDF oluşturma kütüphanesi değil. HTML'den PDF'ye dönüşümü için farklı bir kütüphane kullanmanız gerekecektir.

Sonrası (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
        pdf.SaveAs("output.pdf");
    }
}

Bu örnek, en önemli yetenek farkını vurgular.PdfPigaçıkça "HTML to PDF dönüşümünü desteklemediğini" ve "PDF okuma/parsing kütüphanesi, PDF oluşturma kütüphanesi değil." belirtir. HTML'den PDF oluşturmanız gerekiyorsa, tamamen farklı bir kütüphane kullanmanız gerekir.

IronPDF, doğal HTML'den PDF'e dönüştürmeyi ChromePdfRenderer aracılığıyla sunar. RenderHtmlAsPdf() metodu, HTML dizgilerini kabul eder ve bunları, HTML, CSS ve JavaScript'in doğru bir biçimde oluşturulması için dahili olarak bir Chromium motoru kullanarak PDF dökümanlarına dönüştürür. Sonuçta ortaya çıkan PdfDocument, SaveAs() ile kaydedilebilir veya kaydetmeden önce daha fazla manipüle edilebilir. Kapsamlı örnekler için HTML'den PDF'e dönüşüm belgelerine bakın.

Örnek 3: PDF Metadata Okuma

Öncesi (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var info = document.Information;
            Console.WriteLine($"Title: {info.Title}");
            Console.WriteLine($"Author: {info.Author}");
            Console.WriteLine($"Subject: {info.Subject}");
            Console.WriteLine($"Creator: {info.Creator}");
            Console.WriteLine($"Producer: {info.Producer}");
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}");
        }
    }
}

Sonrası (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        var info = pdf.MetaData;
        Console.WriteLine($"Title: {info.Title}");
        Console.WriteLine($"Author: {info.Author}");
        Console.WriteLine($"Subject: {info.Subject}");
        Console.WriteLine($"Creator: {info.Creator}");
        Console.WriteLine($"Producer: {info.Producer}");
        Console.WriteLine($"Number of Pages: {pdf.PageCount}");
    }
}

Her iki kütüphane de neredeyse aynı desenlerle metadata erişimi sağlar. PdfPig, meta veriye document.Information üzerinden ve sayfa sayısına document.NumberOfPages üzerinden erişir. IronPDF, meta veri için pdf.MetaData ve sayfa sayısı için pdf.PageCount kullanır.

Geçiş oldukça basittir: PdfDocument.Open()'yi PdfDocument.FromFile() ile, document.Information'yi pdf.MetaData ile ve document.NumberOfPages'yi pdf.PageCount ile değiştirin.IronPDF ihtiyaç duymadığı için using beyanı sarmalayıcısını kaldırın.


Kritik Taşıma Notları

Sayfa Dizinleme Değişikliği

PdfPig, 1 tabanlı indeksleme kullanır; IronPDF, 0 tabanlı kullanır:

// PdfPig:1 tabanlıindexing
var firstPage = document.GetPage(1);  // First page

// IronPDF:0 tabanlıindexing
var firstPage = pdf.Pages[0];  // First page

// Migration helper
int pdfPigIndex = 1;
int ironPdfIndex = pdfPigIndex - 1;
C#

Using İfadesine Gerek Yok

// PdfPig: Requires using for disposal
using (var document = PdfDocument.Open("input.pdf"))
{
    // ...
}

// IronPDF: No using required (but can use for cleanup)
var pdf = PdfDocument.FromFile("input.pdf");
// ...
// pdf.Dispose(); // Optional

Doküman Yükleme Değişikliği

// PdfPig: PdfDocument.Open()
using (var document = PdfDocument.Open("input.pdf"))

// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("input.pdf");

Metadata Özellik Adı Değişikliği

// PdfPig: document.Information
var info = document.Information;

// IronPDF: pdf.MetaData
var info = pdf.MetaData;

Sayfa Sayısı Özellik Değişikliği

// PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}");

// IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}");

Geçiş Sonrası Yeni Özellikler

IronPDF'e taşıdıktan sonra, PdfPig'in sağlayamadığı yetenekler elde edersiniz:

PDF Birleştirme

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Filigranlar

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

Şifre Koruma

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

Dijital İmzalar

var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningReason = "Document Approval"
};
pdf.Sign(signature);

Özellik Karşılaştırması Özeti

ÖzellikPdfPigIronPDF
Metin Çıkarma
Metadata Erişimi
Resim Çıkarma
PDF OluşturmaSınırlı (koordinata dayalı)
HTML'den PDF'ye
URL'yi PDF'ye çevir
PDF'leri birleştir✓ (PdfMerger)
PDF Ayırma
Filigranlar
Form Doldurma
Şifre Koruması
Dijital İmzalar
Kelime Konumu Verileri

Geçiş Kontrol Listesi

Öncesi-Geçiş

  • Kod tabanındaki tümPdfPigkullanımlarını dökün
  • Kelime seviyesinde konum verilerine ihtiyaç olup olmadığını belirleyin (hibrit yaklaşımı düşünün)
  • Tüm sayfa indeks referanslarını not alın (1 tabanlıdan 0 tabanlıya çevrilmesi gerekiyor) -IronPDF lisans anahtarı saklama planı yapın (ortam değişkenleri önerilir)
  • İlk önce IronPDF deneme lisansı ile test edin

Paket Değişiklikleri

  • PdfPig NuGet paketini kaldırın: dotnet remove package PdfPig
  • IronPdf NuGet paketini yükleyin: dotnet add package IronPdf

Kod Değişiklikleri

  • Namespace içe aktarımlarını güncelleyin (using UglyToad.PdfPig;using IronPdf;)
  • PdfDocument.Open()'yi PdfDocument.FromFile() ile değiştirin
  • document.Information'yi pdf.MetaData ile değiştirin
  • document.NumberOfPages'yi pdf.PageCount ile değiştirin
  • Sayfa dizinlerini 1 tabanlıdan 0 tabanlıya dönüştürün
  • using beyanlarını kaldırın (isteğe bağlı,IronPDF ihtiyaç duymaz)
  • Uygulama başlangıcında IronPDF lisans anahtarını ekleyin

Geçiş Sonrası

  • Metin çıkarma çıktısının beklentilere uyup uymadığını test edin
  • Tüm PDF oluşturma senaryolarını test edin
  • Yeni yetenekler ekleyin (birleştirme, filigranlar, güvenlik) gerektiğinde
  • Linux'a dağıtım yapıyorsanız Linux bağımlılıklarını yükleyin

Lütfen dikkate alın: Apache PDFBox ve PdfPig, kendi sahiplerinin kayıtlı ticari markalarıdır. Bu site, Apache Yazılım Vakfı veya UglyToad ile ilişkilendirilmemiştir, onaylanmamıştır ve sponsor olunmamıştır. Tüm ürün adları, logolar ve markalar kendi sahiplerine aittir. Karşılaştırmalar, yalnızca bilgilendirme amaçlıdır ve yazı sırasında halka açık bilgilerle alakalı olarak yansıtılmaktadır.
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