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

PrinceXML'i Anlamak

PrinceXML, CSS Sayfa Medya özelliklerine olan bağlılığı sayesinde HTML içeriğini baskı-mükemmel PDF belgelerine dönüştürmede üstün bir yetenek için tasarlanmış gelişmiş bir araçtır. Bu uzmanlaşma, PrinceXML'in, yayıncılık veya hukuki belgeler gibi detaylı baskı tasarımına ihtiyaç duyan endüstriler için değerli bir nitelik olan belgeleri tasarlanan baskı tasarımlarına yüksek sadakatle oluşturmasını sağlar.

Bununla birlikte,PrinceXMLbir .NET kütüphanesi değildir ve bütünleşik olmayan bir komut satırı aracı olarak çalışır, bu da saf .NET çözümlerini tercih eden ortamlar için entegrasyonu zorlayıcı hale getirebilir. Ayrı bir sunucu sürecine dayanması, ek sistem kaynak yönetimini ve proje dağıtımları için potansiyel olarak artan bir karmaşıklığı içerir.

Harici Proses Problemi

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

1. Proses Yönetimi Yükü: Harici süreçleri oluşturmalı, izlemeli ve sonlandırmalıdır.

2. Yerli .NET Entegrasyonu Yok: stdin/stdout veya geçici dosyalar yoluyla iletişim kur

3. Dağıtım Karmaşıklığı: Her sunucuda Prince yüklemesi gerektirir.

4. Sunucu Başına Lisanslama: Her dağıtım ayrı bir lisans gerektirir.

5. Hata İşleme Zorluğu: Hata tespiti için metin çıkışını ayrıştır.

6. Async/Await Yok: Engelleyici çağrılar veya karmaşık senkron-olmayan sarmalayıcılar gerektirir.

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

PrinceXMLve IronPDF Karşılaştırması

IronPDF, sadece HTML'den PDF'e dönüştürmenin ötesine geçen, gelişmiş PDF manipülasyon görevlerini içeren, düzenleme, birleştirme ve dijital imzalar gibi .NET yerli yeteneklerine sahip bir alternatif sunar. IronPDF'in API'si, minimal şablon koduyla dönüşümleri ve manipülasyonları gerçekleştirmesine izin vererek basitlik ve kullanım kolaylığı için tasarlanmıştır.

Modern .NET'i benimseyen ekipler için, IronPDF'in sorunsuz dağıtımı, dış bağımlılıklar veya sunucu süreçleri gerektirmez ve böylece .NET frameworke entegrasyonu kolaylaştırır.

Ö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

# 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ı Araştırması

# 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" .

Ad Alanı Değişiklikleri

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

// After: IronPDF
using IronPdf;

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

// After: IronPDF
using IronPdf;

Imports IronPdf
Imports System.Diagnostics
Imports System.IO

Komut Satırından Metoda Haritalama

CSS @page ve RenderingOptions Haritalama

Sayfa Boyutu Dönüşümleri

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

Önceki (PrinceXML):

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXML.Wrapper;
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 PrinceXML.Wrapper;
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 PrinceXML.Wrapper
Imports System

Class Program
    Shared 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 Class

Sonrası (IronPDF):

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        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()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        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()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        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 yapısal farkı gösterir. PrinceXML, yürütülebilir dosyanın tam yolu ("C:\\Program Files\\Prince\\engine\\bin\\prince.exe") ile bir Prince nesnesini çalıştırmayı ve ardından giriş ve çıkış yolları ile Convert() çalıştırmayı 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() çağırın. Yürütülebilir yollar, süreç yönetimi, yol bağımlılıkları yok. Kapsamlı örnekler için HTML'den PDF'e dönüşüm belgelerine bakın.

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

Önceki (PrinceXML):

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXML.Wrapper;
using System;

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

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXML.Wrapper;
using System;

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

Imports PrinceXML.Wrapper
Imports System

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

Sonrası (IronPDF):

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.Title = "Website Export";

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SecuritySettings.OwnerPassword = "owner-password";
        pdf.SecuritySettings.UserPassword = "user-password";
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.Title = "Website Export";

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SecuritySettings.OwnerPassword = "owner-password";
        pdf.SecuritySettings.UserPassword = "user-password";
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("URL converted to PDF");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.EnableJavaScript = True
        renderer.RenderingOptions.Title = "Website Export"

        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SecuritySettings.OwnerPassword = "owner-password"
        pdf.SecuritySettings.UserPassword = "user-password"
        pdf.SaveAs("webpage.pdf")
        Console.WriteLine("URL converted to PDF")
    End Sub
End Class

Bu örnek,PrinceXMLseçeneklerinin IronPDF özelliklerine nasıl eşlendiğini gösterir. PrinceXML, dönüşüm öncesinde Prince nesnesi üzerinde (JavaScript, Encrypt, PdfTitle) özellikler olarak yapılandırmayı sunar. IronPDF, önceden işleme ayarları için RenderingOptions özelliklerini kullanır ve işlemi sonlandırdıktan sonra şifrelemeyi SecuritySettings yoluyla PdfDocument üzerinde uygular.

Anahtar eşlemeleri:

• prince.JavaScript = true → renderer.RenderingOptions.EnableJavaScript = true
• prince.PdfTitle = "..." → renderer.RenderingOptions.Title = "..."
• prince.Encrypt = true → pdf.SecuritySettings.OwnerPassword = "..." / pdf.SecuritySettings.UserPassword = "..."

Daha fazla bilgiyi kılavuzlarımızda öğrenin.

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

Önceki (PrinceXML):

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXML.Wrapper;
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>";

        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        // ConvertString accepts a raw HTML/XML string directly
        prince.ConvertString(html, "styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

// NuGet: Install-Package PrinceXMLWrapper
using PrinceXML.Wrapper;
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>";

        Prince prince = new Prince("C:\\Program Files\\Prince\\engine\\bin\\prince.exe");
        // ConvertString accepts a raw HTML/XML string directly
        prince.ConvertString(html, "styled-output.pdf");
        Console.WriteLine("Styled PDF created");
    }
}

Imports PrinceXML.Wrapper
Imports System

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>"

        Dim prince As New Prince("C:\Program Files\Prince\engine\bin\prince.exe")
        ' ConvertString accepts a raw HTML/XML string directly
        prince.ConvertString(html, "styled-output.pdf")
        Console.WriteLine("Styled PDF created")
    End Sub
End Module

Sonrası (IronPDF):

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        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()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
        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()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
        Dim html As String = "<html><head><style>body { font-family: Arial; color: blue; }</style></head><body><h1>Hello World</h1></body></html>"

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

Her iki kütüphane de doğrudan bir HTML dizesini kabul eder:PrinceXMLConvertString() ve IronPDFRenderHtmlAsPdf() aracılığıyla. Temel mimari fark kalır — PrinceXML'nin ConvertString, girdiyi temel belirleme altında harici prince ikili dosyasına iletirken,IronPDF herhangi bir harici yürütülebilir dosya olmadan işlemi dahili olarak gerçekleştirir.

Ortak CSS Geçiş Sorunları

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

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

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

CSS marj kutuları (@top-center, @bottom-right) Prince'e özeldir. Bunun yerine HtmlFooter kullanın.

Sorun 3: string-set/content Çalışmıyor

string-set CSS özelliği Prince'e özeldir. <title> etiketinden {html-title} placeholder 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) Hatalı

CSS sayaçları yerine IronPDF'nin {total-pages} placeholder'ını 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")

Öncesi-Geçiş

• Tüm Prince komut satırı çağrılarını belirleyin
• Kullanılan CSS @page kurallarını belgeleyin
• Prince'e özgü CSS özelliklerini listele (prince-*, string-set)
• Herhangi bir PrinceJavaScriptfonksiyonunu not alın
• Kullanılan PDF özelliklerini belirleyin (şifreleme, metadata)
• ironpdf.com adresinden IronPDF lisans anahtarını edinin

Kod Değişiklikleri

• PrinceXMLWrapper NuGet paketini kaldırın
• IronPdf NuGet paketini yükleyin
• Ad alanı ithalatlarını güncelleyin
• Prince oluşturmasını ChromePdfRenderer ile değiştirin
• prince.Convert() öğesini RenderHtmlFileAsPdf() veya RenderHtmlAsPdf() ile değiştirin
• Ayarlayıcı yöntemleri RenderingOptions özelliklerine dönüştürün
• @page CSS'yi RenderingOptions öğesine taşıyın
• Marj kutularını HtmlFooter ile değiştirin
• CSS sayaçlarını {total-pages} placeholder'larına dönüştürün
• HTML dizgileri için geçici dosya işleme işlemlerini kaldırın
• Uygulama başlangıcında lisans başlatma ekle

Geçiş Sonrası

• HTML dosya dönüştürmesini test edin
• HTML dizesi dönüştürmesini test edin
• URL dönüştürmesini 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ık ve alt bilgileri test edin
• Sayfa numaralarını doğrulayın
• Şifreleme/güvenlik testini yapın
• Sunuculardan Prince kurulumunu kaldırın
• Dağıtım betiklerini güncelleyin

PrinceXML, ilgili sahibinin tescilli bir markasıdır. Bu site, YesLogic Pty tarafından onaylanmamış, desteklenmemiş veya sponsor olunmamıştır. Ltd. 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.)}]