PrinceXML'den IronPDF'e C# ile Nasıl Geçilir

PrinceXML'i Anlamak

PrinceXML, HTML içeriğini baskı mükemmelliğinde PDF belgelerine dönüştürmede mükemmel olmak için tasarlanmış sofistike bir araçtır veCSS Sayfalı Medyaözellikleri için özel desteği vardır. Bu uzmanlaşma, PrinceXML'in, yayıncılık veya yasal belgeler gibi detaylı baskı stilizasyonu gerektiren endüstriler için değerli bir özellik olan, belgeleri tasarlanan baskı tasarımlarına yüksek sadakatle işlemesine olanak tanır.

Ancak,PrinceXMLbir .NET kütüphanesi değildir ve ayrı bir komut satırı aracı olarak çalışır, bu da saf .NET çözümlerini tercih eden ortamlar için entegrasyonu zorlaştırabilir. Ayrı bir sunucu işlemine dayanması, ek sistem kaynak yönetimi ve potansiyel olarak proje dağıtımları için karmaşıklığın artmasına neden olur.

Dış Süreç Sorunu

PrinceXML, .NET uygulamaları için önemli mimari zorluklar yaratan ayrı bir komut satırı yürütülebilir dosyası olarak çalışır:

1. İşlem Yönetim Yükü: Dış süreçlerin oluşturulması, izlenmesi ve sonlandırılması gerekir.

2. Yerel .NET Entegrasyonu Yok: stdin/stdout veya geçici dosyalarla iletişim kurar.

3. Dağıtım Karmaşıklığı: Her sunucuya Prince kurulumunu gerektirir.

4. Sunucu Başına Lisanslama: Her dağıtım için ayrı bir lisans ($495+) gereklidir.

5. Hata İşleme Zorluğu: Hata tespiti için metin çıktısını analiz eder.

6. Async/Await Yok: Engelleyen çağrılar veya karmaşık async sarıcılar gereklidir.

7. Yol Bağımlılıkları: Prince yürütülebilir dosyasını PATH üzerinde veya mutlak yolda bulmak zorundadır.

PrinceXML vsIronPDFKarşılaştırması

IronPDF, HTML'den PDF'ye dönüştürmenin ötesine geçerek düzenleme, birleştirme ve dijital imzalar gibi ileri düzey PDF manipülasyonu görevlerini içeren ve .NET yerel yetenekleriyle bir alternatif sunar. IronPDF'in API'si basitlik ve kullanım kolaylığı için tasarlanmıştır, geliştiricilerin dönüşümleri ve manipülasyonları minimal kalıp kod ile gerçekleştirmelerine olanak tanır.

2025 ve 2026 boyunca .NET 10 ve C# 14 benimsemeyi planlayan ekipler için IronPDF'in kesintisiz dağıtımı, entegrasyonu .NET çerçevesine kolaylaştırarak dış bağımlılıklar veya sunucu süreçleri gerektirmez.

Önkoş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ükleme yeteneği
3. IronPDF Lisansı: Lisans anahtarınızı ironpdf.com adresinden edinin

NuGet Paket Değişiklikleri

# Install IronPDF
dotnet add package IronPdf

# Remove Prince wrapper if using one
dotnet remove package PrinceXMLWrapper

# Install IronPDF
dotnet add package IronPdf

# Remove Prince wrapper if using one
dotnet remove package PrinceXMLWrapper

Lisans Yapılandırması

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

PrinceXMLKullanımını Araştırın

# Find Prince process calls
grep -r "prince" --include="*.cs" .
grep -r "Process.Start" --include="*.cs" . | grep -i prince
grep -r "@page" --include="*.css" .
grep -r "prince-" --include="*.css" .

# Find Prince process calls
grep -r "prince" --include="*.cs" .
grep -r "Process.Start" --include="*.cs" . | grep -i prince
grep -r "@page" --include="*.css" .
grep -r "prince-" --include="*.css" .

Namespace Değişiklikleri

// Before: PrinceXML
using PrinceXMLWrapper;
using System.Diagnostics;
using System.IO;

// After: IronPDF
using IronPdf;

// Before: PrinceXML
using PrinceXMLWrapper;
using System.Diagnostics;
using System.IO;

// After: IronPDF
using IronPdf;

' Before: PrinceXML
Imports PrinceXMLWrapper
Imports System.Diagnostics
Imports System.IO

' After: IronPDF
Imports IronPdf

Komut Satırı ile Yöntem Eşleştirme

CSS @page ve RenderingOptions Eşleştirme

Sayfa Boyutu Dönüşümleri

Örnek 1: HTML Dosyasını PDF'ye Dönüştürme

Önceki (PrinceXML):

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

class Program
{
    static void Main()
    {
        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.Convert("input.html", "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

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

class Program
{
    static void Main()
    {
        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.Convert("input.html", "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports PrinceXMLWrapper
Imports System

Module Program
    Sub Main()
        Dim prince As New Prince("C:\Program Files\Prince\engine\bin\prince.exe")
        prince.Convert("input.html", "output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Module

Sonra (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlFileAsPdf("input.html")
        pdf.SaveAs("output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

Bu örnek temel mimari farkı göstermektedir. PrinceXML, çalıştırılabilir dosya için tam yolu ("C:\\Program Files\\Prince\\engine\\bin\\prince.exe") sağlayarak bir Prince nesnesinin oluşturulmasını ve ardından giriş ve çıkış yolları ile Convert() çağrılmasını gerektirir.

IronPDF, yol bağımlılıklarını tamamen ortadan kaldırır: bir ChromePdfRenderer oluşturun, HTML dosya yolu ile RenderHtmlFileAsPdf() çağırın ve sonucu yazmak için SaveAs() kullanın. Yürütülebilir dosya yolları yok, işlem yönetimi yok, yol bağımlılıkları yok. Kapsamlı örnekler için HTML'den PDF'e döndürme belgesine bakın.

Örnek 2: URL'yi PDF'ye Dönüştürme Seçenekleriyle

Önceki (PrinceXML):

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

class Program
{
    static void Main()
    {
        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.SetJavaScript(true);
        prince.SetEncrypt(true);
        prince.SetPDFTitle("Website Export");
        prince.Convert("https://example.com", "webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

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

class Program
{
    static void Main()
    {
        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.SetJavaScript(true);
        prince.SetEncrypt(true);
        prince.SetPDFTitle("Website Export");
        prince.Convert("https://example.com", "webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

Imports PrinceXMLWrapper
Imports System

Class Program
    Shared Sub Main()
        Dim prince As New Prince("C:\Program Files\Prince\engine\bin\prince.exe")
        prince.SetJavaScript(True)
        prince.SetEncrypt(True)
        prince.SetPDFTitle("Website Export")
        prince.Convert("https://example.com", "webpage.pdf")
        Console.WriteLine("URL converted to PDF")
    End Sub
End Class

Sonra (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.PdfTitle = "Website Export";

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.Encrypt("password");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.PdfTitle = "Website Export";

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.Encrypt("password");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.EnableJavaScript = True
        renderer.RenderingOptions.PdfTitle = "Website Export"

        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.Encrypt("password")
        pdf.SaveAs("webpage.pdf")
        Console.WriteLine("URL converted to PDF")
    End Sub
End Class

Bu örnek,PrinceXMLseçeneklerininIronPDFözellikleriyle eşleşmesini gösterir.PrinceXMLdönüştürmeden önce (SetJavaScript(), SetEncrypt(), SetPDFTitle()) setter yöntemlerini kullanır. IronPDF, önceden oluşturma ayarları için RenderingOptions özelliklerini ve PdfDocument nesnesi üzerinde Encrypt() gibi sonrasında çalıştırılacak yöntemleri kullanır.

Anahtar eşlemeler:

• prince.SetJavaScript(true) → renderer.RenderingOptions.EnableJavaScript = true
• prince.SetPDFTitle("...") → renderer.RenderingOptions.PdfTitle = "..."
• prince.SetEncrypt(true) → pdf.Encrypt("password") (IronPDF bir parola gerektirir)

Detayli bilgi icin eğitimlerimize bakin.

Örnek 3: HTML Dizesini PDF'ye Dönüştürme

Önceki (PrinceXML):

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXMLWrapper;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>";
        File.WriteAllText("temp.html", html);

        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.Convert("temp.html", "styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXMLWrapper;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>";
        File.WriteAllText("temp.html", html);

        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        prince.Convert("temp.html", "styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

Imports PrinceXMLWrapper
Imports System
Imports System.IO

Module Program
    Sub Main()
        Dim html As String = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>"
        File.WriteAllText("temp.html", html)

        Dim prince As New Prince("C:\Program Files\Prince\engine\bin\prince.exe")
        prince.Convert("temp.html", "styled-output.pdf")
        Console.WriteLine("Styled PDF created")
    End Sub
End Module

Sonra (IronPDF):

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

class Program
{
    static void Main()
    {
        string html = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

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

class Program
{
    static void Main()
    {
        string html = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim html As String = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>"

        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("styled-output.pdf")
        Console.WriteLine("Styled PDF created")
    End Sub
End Class

Bu örnek önemli bir farkı vurgular:PrinceXMLdosya girdisi gerektirir, bu yüzden dönüştürmeden önce geçici bir dosya (File.WriteAllText("temp.html", html)) oluşturmalısınız. IronPDF'in RenderHtmlAsPdf() doğrudan HTML dizgilerini kabul eder—geçici dosyalar, temizlik kodu, disk G/Ç üstsel maliyeti yoktur.

Yaygın CSS Geçiş Sorunları

Sorun 1: CSS @page Çalışmıyor

IronPDF, @page desteği sınırlı olan Chromium kullanır. CSS kurallarını RenderingOptions'a dönüştürün.

Sorun 2: Sayfa Kenar Boşluğu Kutuları Eksik

CSS kenar boşluğu kutuları (@top-center, @bottom-right) Prince'e özeldir. Bunun yerine HtmlFooter kullanın.

Sorun 3: string-set/içerik Çalışmıyor

string-set CSS özelliği Prince'e özeldir. <title> etiketinden {html-title} yer tutucu kullanın:

<title>Chapter 1: Introduction</title>

<title>Chapter 1: Introduction</title>

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div>{html-title}</div>"
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div>{html-title}</div>"
};

Sorun 4: counter(pages) Yanlış

CSS sayaçları yerine IronPDF'in {total-pages} yer tutucusunu kullanın.

PDF Birleştirme

var pdf1 = PdfDocument.FromFile("chapter1.pdf");
var pdf2 = PdfDocument.FromFile("chapter2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("complete_book.pdf");

var pdf1 = PdfDocument.FromFile("chapter1.pdf");
var pdf2 = PdfDocument.FromFile("chapter2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("complete_book.pdf");

Dim pdf1 = PdfDocument.FromFile("chapter1.pdf")
Dim pdf2 = PdfDocument.FromFile("chapter2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("complete_book.pdf")

Filigranlar

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dijital İmzalar

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

Dim signature = New PdfSignature("certificate.pfx", "password")
pdf.Sign(signature)

Form Doldurma

var pdf = PdfDocument.FromFile("form.pdf");
pdf.Form.GetFieldByName("Name").Value = "John Doe";
pdf.SaveAs("filled_form.pdf");

var pdf = PdfDocument.FromFile("form.pdf");
pdf.Form.GetFieldByName("Name").Value = "John Doe";
pdf.SaveAs("filled_form.pdf");

Dim pdf = PdfDocument.FromFile("form.pdf")
pdf.Form.GetFieldByName("Name").Value = "John Doe"
pdf.SaveAs("filled_form.pdf")

Geçiş Öncesi

• Tüm Prince komut satırı çağrılarını belirleyin
• Kullanılan CSS @page kurallarını belgelendirin
• Prince'e özel CSS özelliklerini listele (prince-*, string-set)
• Herhangi bir PrinceJavaScriptişlevini not edin
• Kullanılan PDF özelliklerini belirleyin (şifreleme, meta veriler)
• ironpdf.com adresindenIronPDFlisans anahtarını alın

Kod Değişiklikleri

• PrinceXMLWrapper NuGet paketini kaldırın
• IronPdf NuGet paketini yükleyin
• Ad alanı eklerini güncelleyin
• Prince oluşturmalarını ChromePdfRenderer ile değiştirin
• prince.Convert()'yi RenderHtmlFileAsPdf() veya RenderHtmlAsPdf() ile değiştirin
• Setter yöntemlerini RenderingOptions özelliklerine dönüştürün
• @page CSS'i RenderingOptions'ya taşıyın
• Kenar kutularını HtmlFooter ile değiştirin
• CSS sayaçlarını {total-pages} yer tutucularına dönüştürün
• HTML dizeleri için geçici dosya işlemini kaldırın
• Uygulama başlatıldığında lisans başlatma ekleyin

Geçişten Sonra

• HTML dosya dönüşümünü test edin
• HTML dize dönüşümünü test edin
• URL dönüşümünü test edin
• Sayfa boyutlarının eşleştiğini doğrulayın
• Kenar boşluklarının eşleştiğini doğrulayın
• Başlıkları ve alt bilgileri test edin
• Sayfa numaralarını doğrulayın
• Şifreleme/güvenliği test edin
• Sunuculardan Prince kurulumunu kaldırın
• Dağıtım betiklerini güncelleyin