PDFPrinting.NET'den IronPDF'e C# ile Nasıl Geçilir

PDFPrinting.NET'i Anlamak

PDFPrinting.NET (Terminalworks; NuGet PdfPrintingNet) Windows ortamlarında sessiz PDF yazdırmaya odaklanmış özel bir kütüphanedir. Mevcut PDF'lerin sessiz bir şekilde basılmasına odaklanan özel bir araç olarak, belgelerin programlı bir şekilde kullanıcı müdahalesi olmadan bir yazıcıya gönderilmesi görevini basitleştirir. Daha yeni giriş noktası PdfPrint sınıfıdır; eski kod hala eski TerminalWorks.PDFPrinting.PDFPrinter referans alabilir.

Önemli bir avantajı sessiz baskıdır — böylece tamamen otomatik iş akışları müdahale edilmeden çalışabilir.

Baskı Merkezli Sınırlama

PDFPrinting.NET, dar bir işlemler kümesine odaklanır ve yeni PDF içeriği oluşturmaz. Kapsamı, mevcut belgeleri yazdırmak, görüntülemek, temel düzenlemek ve rasterize etmektir:

1. Baskı merkezli: Yeni bir PDF içeriği oluşturmaz — sadece önceden var olan PDF'leri yazdırır, görüntüler, düzenler ve rasterize eder.

2. Sadece Windows baskısı: Windows baskı altyapısına bağlıdır, bu da çapraz platform kullanılabilirliğini sınırlar.

3. HTML/URL-to-PDF API'si yok: HtmlToPdfConverter ve WebPageToPdfConverter sınıfı yok — API yüzeyinde bu özellikler mevcut değildir.

4. Sınırlı manipülasyon: Temel birleştirme/ayırma/çıkarma işlemleri PdfPrintDocument ile yapılabilir; su damgaları veya modern içerik oluşturma yoktur.

5. Kapsamlı metin çıkarma yüzeyi yok.

6. Form doldurma veya düzleştirme yok.

PDFPrinting.NET vs IronPDF Karşılaştırması

IronPDF, PDF işleme yaşam döngüsünü tamamıyla ele alarak daha kapsamlı bir çözüm sunar. PDF belgelerini oluşturma, düzenleme, dönüştürme ve yazdırma işlevlerini kolaylaştırır, geliştiricilere birleşik bir API üzerinden eksiksiz özellik seti sunar. PDFPrinting.NET'ten farklı olarak,IronPDF çeşitli platformlarda dağıtılabilir ve bu da farklı ortamlarda çalışan uygulamalar için çeşitli bir seçenek yapar.

Modern .NET kullanan ekipler için, IronPDF, Windows, Linux ve macOS ortamlarında çalışan eksiksiz bir PDF çözümü sunar.

Ö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 PDFPrinting.NET (the actual NuGet ID is PdfPrintingNet)
dotnet remove package PdfPrintingNet

# Install IronPDF
dotnet add package IronPdf

# Remove PDFPrinting.NET (the actual NuGet ID is PdfPrintingNet)
dotnet remove package PdfPrintingNet

# Install IronPDF
dotnet add package IronPdf

Lisans Yapılandırması

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

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

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

PDFPrinting.NET Kullanımını Belirleme

# Find PDFPrinting.NET usage (newer + legacy namespaces)
grep -rE "PdfPrintingNet|TerminalWorks\.PDFPrinting|PdfPrint\b|PdfPrintDocument|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

# Find PDFPrinting.NET usage (newer + legacy namespaces)
grep -rE "PdfPrintingNet|TerminalWorks\.PDFPrinting|PdfPrint\b|PdfPrintDocument|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

Ad Alanı Değişiklikleri

// Before: PDFPrinting.NET
// Newer API:
using PdfPrintingNet;
// Older code may use:
using TerminalWorks.PDFPrinting;

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

// Before: PDFPrinting.NET
// Newer API:
using PdfPrintingNet;
// Older code may use:
using TerminalWorks.PDFPrinting;

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

' Before: PDFPrinting.NET
' Newer API:
Imports PdfPrintingNet
' Older code may use:
Imports TerminalWorks.PDFPrinting

' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering
Imports IronPdf.Printing

Çekirdek Sınıf Eşlemeleri

Yazdırma Yöntemi Eşlemeleri

PDFPrinting.NET'te Mevcut Olmayan Yeni Özellikler

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

Önce (PDFPrinting.NET): PDFPrinting.NET'in HTML-to-PDF API'si yok — HtmlToPdfConverter sınıfı yok. En yakın iş akışı başka bir kütüphane ile PDF oluşturmak, ardından dosyayı yazdırmak veya elden teslim etmektir:

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

class Program
{
    static void Main()
    {
        // Step 1: Produce the PDF with another library (PDFPrinting.NET cannot).
        // Step 2: Print the existing PDF file.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        var status = pdfPrint.Print("output.pdf");
        Console.WriteLine($"Printed: {status}");
    }
}

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

class Program
{
    static void Main()
    {
        // Step 1: Produce the PDF with another library (PDFPrinting.NET cannot).
        // Step 2: Print the existing PDF file.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        var status = pdfPrint.Print("output.pdf");
        Console.WriteLine($"Printed: {status}");
    }
}

Imports PdfPrintingNet
Imports System

Class Program
    Shared Sub Main()
        ' Step 1: Produce the PDF with another library (PDFPrinting.NET cannot).
        ' Step 2: Print the existing PDF file.
        Dim pdfPrint = New PdfPrint("license-owner", "license-key")
        Dim status = pdfPrint.Print("output.pdf")
        Console.WriteLine($"Printed: {status}")
    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();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(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();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(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 As New ChromePdfRenderer()
        Dim html As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

PDFPrinting.NET hiçbir şekilde PDF oluşturamadığı için, geçiş birebir sınıf değişimi değil — yeni bir yetenek benimsemektir. IronPDF'ün ChromePdfRenderer.RenderHtmlAsPdf(), kaydetmeden önce (filigranlar, birleştirme, güvenlik) manipüle edebileceğiniz bir PdfDocument döndürür SaveAs() ile. Chromium tabanlı bir motor kullanarak,IronPDF modern CSS ve JavaScript işleme reprodüksiyonu sağlar. Kapsamlı örnekler için HTML'den PDF'e dönüşüm belgelerine bakın.

Örnek 2: URL'den PDF'ye Dönüştürme

Önce (PDFPrinting.NET): WebPageToPdfConverter sınıfı yok — PDFPrinting.NET web sayfalarını indirmez veya işleme yapmaz. Ayrı bir kütüphane önce URL'yi PDF olarak yakalamalı; PDFPrinting.NET ardından oluşan dosyayı yazdırabilir:

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

class Program
{
    static void Main()
    {
        // Step 1: Capture the URL with another library (PDFPrinting.NET cannot).
        // Step 2: Print the resulting PDF.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        var status = pdfPrint.Print("webpage.pdf");
        Console.WriteLine($"Printed: {status}");
    }
}

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

class Program
{
    static void Main()
    {
        // Step 1: Capture the URL with another library (PDFPrinting.NET cannot).
        // Step 2: Print the resulting PDF.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        var status = pdfPrint.Print("webpage.pdf");
        Console.WriteLine($"Printed: {status}");
    }
}

Imports PdfPrintingNet
Imports System

Class Program
    Shared Sub Main()
        ' Step 1: Capture the URL with another library (PDFPrinting.NET cannot).
        ' Step 2: Print the resulting PDF.
        Dim pdfPrint As New PdfPrint("license-owner", "license-key")
        Dim status = pdfPrint.Print("webpage.pdf")
        Console.WriteLine($"Printed: {status}")
    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();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL 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();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

Imports IronPdf
Imports System

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

        Dim renderer As New ChromePdfRenderer()
        Dim url As String = "https://www.example.com"
        Dim pdf = renderer.RenderUrlAsPdf(url)
        pdf.SaveAs("webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Module

IronPDF, HTML dizelerini ve URL'leri aynı anda işleyen tek bir ChromePdfRenderer sınıfı kullanır, web yakalamayı tek bir çağrıda RenderUrlAsPdf() ile gerçekleştirir. Daha fazla bilgiyi kılavuzlarımızda öğrenin.

Örnek 3: Üstbilgiler ve Altbilgiler

Önce (PDFPrinting.NET): PDFPrinting.NET başlık veya alt bilgi oluşturamaz — HTML'den veya başka bir kaynaktan PDF üretmez ve hiçbir başlık/alt bilgi oluşturma API'si sunmaz. PDF'niz zaten bunları içeriyorsa, kütüphane basabilir:

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

class Program
{
    static void Main()
    {
        // Headers/footers must already be baked into the PDF.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        pdfPrint.Print("report.pdf");
        Console.WriteLine("PDF with pre-existing headers/footers printed");
    }
}

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

class Program
{
    static void Main()
    {
        // Headers/footers must already be baked into the PDF.
        var pdfPrint = new PdfPrint("license-owner", "license-key");
        pdfPrint.Print("report.pdf");
        Console.WriteLine("PDF with pre-existing headers/footers printed");
    }
}

Imports PdfPrintingNet
Imports System

Module Program
    Sub Main()
        ' Headers/footers must already be baked into the PDF.
        Dim pdfPrint As New PdfPrint("license-owner", "license-key")
        pdfPrint.Print("report.pdf")
        Console.WriteLine("PDF with pre-existing headers/footers printed")
    End Sub
End Module

Sonrası (IronPDF):

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

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

class Program
{
    static void Main()
    {
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

Imports IronPdf
Imports IronPdf.Rendering
Imports System

Module Program
    Sub Main()
        IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        }
        renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
            .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        }
        Dim html As String = "<html><body><h1>Document Content</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("report.pdf")
        Console.WriteLine("PDF with headers/footers created")
    End Sub
End Module

IronPDF, tam HTML kabul eden bir HtmlFragment özelliği olan HtmlHeaderFooter nesneleri kullanır, böylece CSS ile zengin stillendirme sağlar. Render zamanı {page} ve {total-pages} gibi yer tutucuların yerine geçer.

Başlık/Alt Bilgi Yer Tutucuları Sadece IronPDF Özelliğidir

PDFPrinting.NET'in başlık veya alt bilgi oluşturma API'si yoktur, dolayısıyla geçiş için hiçbir yer tutucu söz dizimi yoktur. IronPDF, HtmlHeaderFooter.HtmlFragment içinde {page} ve {total-pages} yer tutucularını destekler:

//IronPDF placeholders
"Page {page} of {total-pages}"

//IronPDF placeholders
"Page {page} of {total-pages}"

Yükle-Sonra-Yazdır Deseni

PDFPrinting.NET doğrudan dosya yollarını Print() 'a iletir; IronPDF, belgeyi önce yükler:

// PDFPrinting.NET: Direct path to Print()
pdfPrint.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

// PDFPrinting.NET: Direct path to Print()
pdfPrint.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

' PDFPrinting.NET: Direct path to Print()
pdfPrint.Print("document.pdf")

' IronPDF: Load first, then operate
Dim pdf = PdfDocument.FromFile("document.pdf")
pdf.Print()

Yazdırma Ayarları Geçişi

PDFPrinting.NET, PdfPrint üzerinde özellikler kullanır;IronPDF bir ayarlar nesnesi kullanır:

// PDFPrinting.NET: Properties on PdfPrint
pdfPrint.Copies = 2;
pdfPrint.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

// PDFPrinting.NET: Properties on PdfPrint
pdfPrint.Copies = 2;
pdfPrint.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

' PDFPrinting.NET: Properties on PdfPrint
pdfPrint.Copies = 2
pdfPrint.Duplex = True

' IronPDF: Settings object
Dim settings As New PrintSettings With {
    .NumberOfCopies = 2,
    .DuplexMode = System.Drawing.Printing.Duplex.Vertical
}
pdf.Print(settings)

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

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

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

Filigranlar

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

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

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

Şifre Koruma

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

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

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

Metin Çıkarma

string text = pdf.ExtractAllText();

string text = pdf.ExtractAllText();

Dim text As String = pdf.ExtractAllText()

Oluştur-Sonra-Yazdır İş Akışı

IronPDF ile tek bir iş akışında PDF oluşturup yazdırabilirsiniz:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>")
pdf.Print("Invoice Printer")

Windows

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet")

Linux

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

macOS

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet")

Öncesi-Geçiş

• Kod tabanındaki tüm PDFPrinting.NET kullanımlarını dökün
• Hâlihazırda kullanılan tüm yazıcı adlarını belgeler
• Tüm yazdırma ayarı yapılandırmalarını not edin
• Çapraz-platform desteğine ihtiyacınız olup olmadığını belirleyin -IronPDF lisans anahtarı saklama planı yapın (ortam değişkenleri önerilir)
• İlk önce IronPDF deneme lisansı ile test edin

Paket Değişiklikleri

• PdfPrintingNet NuGet paketini kaldırın
• IronPdf NuGet paketini kurun: dotnet add package IronPdf

Kod Değişiklikleri

• Ad alanı içe aktarımlarını güncelleyin (PdfPrintingNet / eski TerminalWorks.PDFPrinting → IronPdf)
• pdfPrint.Print(path)çağrılarını PdfDocument.FromFile(path).Print() biçimine dönüştürün
• Yazdırma başına olan özellikleri (Copies, Duplex, Collate, PrinterName) bir PrintSettings nesnesine taşıyın
• Yeni yetenekleri benimseyin: HTML ve URL girdileri için ChromePdfRenderer.RenderHtmlAsPdf / RenderUrlAsPdf kullanın (PDFPrinting.NET'te denk bir özellik yoktu)
• Başlıkları/alt bilgileri RenderingOptions.HtmlHeader ve HtmlFooter kullanarak yapılandırın (yeni yetenek)
• Uygulama başlatılırken IronPdf.License.LicenseKey ayarlayın

Geçiş Sonrası

• Tüm hedef platformlarda yazdırmayı test edin
• Başlık/altbilgi render'ını doğrulayın.
• Dinamik belgeler için PDF oluşturma eklemeyi düşünün
• Yeni yetenekler ekleyin (birleştirme, filigranlar, güvenlik) gerektiğinde