Jak przejść z PDFFilePrint na IronPDF w języku C#

Zrozumienie PDFFilePrint

PDFFilePrint to praktyczne narzędzie zaprojektowane specjalnie do drukowania plików PDF z aplikacji napisanych w języku C#. Chociaż dobrze sprawdza się w przypadku docelowych zadań drukowania plików PDF, jego funkcjonalność ogranicza się do jednego aspektu obsługi dokumentów. Głównym atutem PDFFilePrint jest jego prostota — skupienie się wyłącznie na zapewnieniu możliwości drukowania plików PDF. Jednak to wąskie ukierunkowanie stwarza znaczne ograniczenia dla kompleksowych systemów zarządzania dokumentami.

Istotne ograniczenia PDFFilePrint

1. Skupienie wyłącznie na drukowaniu: Funkcjonalność PDFFilePrint ogranicza się do drukowania. Brakuje w nim funkcji tworzenia lub modyfikowania plików PDF, co ogranicza jego zastosowanie w bardziej kompleksowych systemach zarządzania dokumentami.

2. Zależność od wiersza poleceń: Często opierając się na operacjach wiersza poleceń z wywołaniami Process.Start(), PDFFilePrint może nie spełniać wymagań dotyczących płynnej integracji z aplikacjami, które wymagają bardziej rozbudowanych interfejsów API.

3. Tylko dla systemu Windows: Ponieważ opiera się w dużym stopniu na systemach drukowania Windows, może nie być najlepszym wyborem dla środowisk korzystających z innych systemów operacyjnych.

4. Brak integracji z .NET: brak natywnego API, brak pakietu NuGet oraz brak obsługi IntelliSense w niektórych scenariuszach użytkowania.

5. Zarządzanie procesami zewnętrznymi: Musi obsługiwać cykl życia procesów, kody wyjścia oraz analizę błędów ze stdout/stderr.

6. Ograniczona obsługa błędów: Wykrywanie błędów wymaga analizowania standardowego strumienia wyjściowego i strumienia błędów, a nie natywnych wyjątków.

7. Złożoność wdrożenia: W scenariuszach użytkowania z wiersza poleceń należy dołączyć plik PDFFilePrint.exe do aplikacji.

8. Brak generowania plików PDF: Nie można tworzyć plików PDF — w trybie wiersza poleceń można jedynie drukować istniejące pliki.

Porównanie PDFFilePrint i IronPDF

Dla zespołów planujących wdrożenie .NET 10 i C# 14 w latach 2025 i 2026,IronPDFzapewnia kompleksową platformę z obsługą wielu platform i aktywnym rozwojem, rozwiązując ograniczenia architektury PDFFilePrint.

Wymagania wstępne

1. Środowisko .NET: .NET Framework 4.6.2+ lub .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Dostęp do NuGet: Możliwość instalowania pakietów NuGet
3. Licencja IronPDF: Uzyskaj klucz licencyjny na stronie ironpdf.com

Zmiany w pakiecie NuGet

# Remove PDFFilePrint package (if installed via NuGet)
dotnet remove package PDFFilePrint

# If using command-line PDFFilePrint.exe, remove from deployment
# Delete bundled PDFFilePrint.exe from your project

# Install IronPDF
dotnet add package IronPdf

# Remove PDFFilePrint package (if installed via NuGet)
dotnet remove package PDFFilePrint

# If using command-line PDFFilePrint.exe, remove from deployment
# Delete bundled PDFFilePrint.exe from your project

# Install IronPDF
dotnet add package IronPdf

Konfiguracja licencji

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

Zidentyfikuj użycie PDFFilePrint

# Find PDFFilePrint references
grep -r "PDFFilePrint\|PDFFile\|CreateFromHtml\|CreateFromUrl" --include="*.cs" .

# Find command-line execution patterns
grep -r "ProcessStartInfo.*pdf\|Process.Start.*print" --include="*.cs" .

# Find batch scripts
find . -name "*.bat" -o -name "*.cmd" | xargs grep -l "PDFFilePrint"

# Find PDFFilePrint references
grep -r "PDFFilePrint\|PDFFile\|CreateFromHtml\|CreateFromUrl" --include="*.cs" .

# Find command-line execution patterns
grep -r "ProcessStartInfo.*pdf\|Process.Start.*print" --include="*.cs" .

# Find batch scripts
find . -name "*.bat" -o -name "*.cmd" | xargs grep -l "PDFFilePrint"

Zmiany w przestrzeni nazw

// PDFFilePrint
using PDFFilePrint;
using System.Diagnostics; // For command-line usage

// IronPDF
using IronPdf;
using IronPdf.Printing;

// PDFFilePrint
using PDFFilePrint;
using System.Diagnostics; // For command-line usage

// IronPDF
using IronPdf;
using IronPdf.Printing;

Imports PDFFilePrint
Imports System.Diagnostics ' For command-line usage

' IronPDF
Imports IronPdf
Imports IronPdf.Printing

Mapowania klas podstawowych

Mapowania metod generowania plików PDF

Mapowania ładowania i drukowania plików PDF

Mapowanie ustawień drukowania (z wiersza poleceń do API)

Nowe funkcje niedostępne w PDFFilePrint

Przykład 1: Konwersja HTML do PDF

Przed (PDFFilePrint):

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        pdf.CreateFromHtml(htmlContent);
        pdf.SaveToFile("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        pdf.CreateFromHtml(htmlContent);
        pdf.SaveToFile("output.pdf");
    }
}

Imports System
Imports PDFFilePrint

Module Program
    Sub Main()
        Dim pdf As New PDFFile()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
        pdf.CreateFromHtml(htmlContent)
        pdf.SaveToFile("output.pdf")
    End Sub
End Module

Po (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Podstawową różnicą jest tutaj wzorzec API. PDFFilePrint wykorzystuje pojedynczą klasę PDFFile z metodami CreateFromHtml() i SaveToFile().IronPDFoddziela renderowanie od obiektu dokumentu — ChromePdfRenderer obsługuje konwersję HTML do PDF i zwraca obiekt PdfDocument, który następnie zapisujesz za pomocą SaveAs().

To rozdzielenie zapewnia znaczące korzyści: przed konwersją można skonfigurować opcje renderowania w rendererze, a zwrócony plik PdfDocument można modyfikować (dodawać znaki wodne, łączyć z innymi plikami PDF, dodawać zabezpieczenia) przed zapisaniem. Dodatkowe opcje renderowania można znaleźć w dokumentacji dotyczącej konwersji HTML do PDF.

Przykład 2: Konwersja adresów URL do formatu PDF

Przed (PDFFilePrint):

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        pdf.CreateFromUrl("https://www.example.com");
        pdf.SaveToFile("webpage.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        pdf.CreateFromUrl("https://www.example.com");
        pdf.SaveToFile("webpage.pdf");
    }
}

Imports System
Imports PDFFilePrint

Class Program
    Shared Sub Main()
        Dim pdf As New PDFFile()
        pdf.CreateFromUrl("https://www.example.com")
        pdf.SaveToFile("webpage.pdf")
    End Sub
End Class

Po (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

PDFFilePrint używa CreateFromUrl() w tej samej klasie PDFFile.IronPDFwykorzystuje dedykowaną metodę RenderUrlAsPdf() w ChromePdfRenderer, która wykorzystuje nowoczesny silnik Chromium do dokładnego renderowania złożonych elementów CSS3, JavaScript oraz nowoczesnych funkcji internetowych. Jakość renderowania jest przewidywalna i odpowiada temu, co widać w przeglądarce Chrome. Dowiedz się więcej o konwersji adresów URL do formatu PDF.

Przykład 3: Drukowanie plików PDF

Przed (PDFFilePrint):

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        pdf.LoadFromFile("document.pdf");
        pdf.Print("Default Printer");
        Console.WriteLine("PDF sent to printer");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = new PDFFile();
        pdf.LoadFromFile("document.pdf");
        pdf.Print("Default Printer");
        Console.WriteLine("PDF sent to printer");
    }
}

Imports System
Imports PDFFilePrint

Module Program
    Sub Main()
        Dim pdf As New PDFFile()
        pdf.LoadFromFile("document.pdf")
        pdf.Print("Default Printer")
        Console.WriteLine("PDF sent to printer")
    End Sub
End Module

Po (IronPDF):

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("document.pdf");
        pdf.Print();
        Console.WriteLine("PDF sent to printer");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("document.pdf");
        pdf.Print();
        Console.WriteLine("PDF sent to printer");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim pdf = PdfDocument.FromFile("document.pdf")
        pdf.Print()
        Console.WriteLine("PDF sent to printer")
    End Sub
End Class

Ten przykład pokazuje fundamentalną różnicę architektoniczną w ładowaniu i drukowaniu plików PDF. PDFFilePrint używa new PDFFile(), po którym następuje LoadFromFile(), a następnie Print(printerName).IronPDFużywa statycznej metody fabrycznej PdfDocument.FromFile() do bezpośredniego ładowania, a następnie Print(), która korzysta z domyślnej drukarki (można też podać nazwę drukarki).

Najważniejsze zmiany związane z migracją:

• new PDFFile() + LoadFromFile(path) → PdfDocument.FromFile(path)
• Print("Default Printer") → Print() (domyślna drukarka jest ustawiona automatycznie)

W przypadku zaawansowanych ustawień drukowaniaIronPDFudostępnia klasę PrintSettings. Aby zapoznać się z opcjami zaawansowanymi, zobacz dokumentację dotyczącą drukowania.

Konwersja flagi trybu cichego

Zwróć uwagę na odwróconą logikę cichego drukowania:

// PDFFilePrint: -silent flag enables silent mode
// IronPDF: ShowPrintDialog = false (false = silent)
var settings = new PrintSettings { ShowPrintDialog = false };

// PDFFilePrint: -silent flag enables silent mode
// IronPDF: ShowPrintDialog = false (false = silent)
var settings = new PrintSettings { ShowPrintDialog = false };

' PDFFilePrint: -silent flag enables silent mode
' IronPDF: ShowPrintDialog = false (false = silent)
Dim settings As New PrintSettings With {.ShowPrintDialog = False}

Twórz i drukuj w jednym kroku

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice #12345</h1><p>Thank you for your order.</p>");
pdf.Print("Office Printer");

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice #12345</h1><p>Thank you for your order.</p>");
pdf.Print("Office Printer");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Invoice #12345</h1><p>Thank you for your order.</p>")
pdf.Print("Office Printer")

Łączenie plików PDF

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

Znaki wodne

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>CONFIDENTIAL</h1>");
pdf.SaveAs("watermarked.pdf");

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>CONFIDENTIAL</h1>");
pdf.SaveAs("watermarked.pdf");

Dim pdf = PdfDocument.FromFile("document.pdf")
pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>CONFIDENTIAL</h1>")
pdf.SaveAs("watermarked.pdf")

Ochrona hasłem

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SaveAs("secured.pdf");

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SaveAs("secured.pdf");

Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SecuritySettings.UserPassword = "userpassword"
pdf.SecuritySettings.OwnerPassword = "ownerpassword"
pdf.SaveAs("secured.pdf")

Wyodrębnianie tekstu

var pdf = PdfDocument.FromFile("document.pdf");
string text = pdf.ExtractAllText();

var pdf = PdfDocument.FromFile("document.pdf");
string text = pdf.ExtractAllText();

Dim pdf = PdfDocument.FromFile("document.pdf")
Dim text As String = pdf.ExtractAllText()

Zmiana wzorca klasy

PDFFilePrint wykorzystuje jedną klasę PDFFile do wszystkiego;IronPDFrozdziela obszary odpowiedzialności:

// PDFFilePrint: Single class
var pdf = new PDFFile();
pdf.CreateFromHtml(html);
pdf.SaveToFile(path);

// IronPDF: Renderer for creation, Document for manipulation
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

// PDFFilePrint: Single class
var pdf = new PDFFile();
pdf.CreateFromHtml(html);
pdf.SaveToFile(path);

// IronPDF: Renderer for creation, Document for manipulation
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

' PDFFilePrint: Single class
Dim pdf1 = New PDFFile()
pdf1.CreateFromHtml(html)
pdf1.SaveToFile(path)

' IronPDF: Renderer for creation, Document for manipulation
Dim renderer = New ChromePdfRenderer()
Dim pdf2 = renderer.RenderHtmlAsPdf(html)
pdf2.SaveAs(path)

Zmiany w nazewnictwie metod

// PDFFilePrint → IronPDF
CreateFromHtml() → RenderHtmlAsPdf()
CreateFromUrl() → RenderUrlAsPdf()
LoadFromFile() → PdfDocument.FromFile()
SaveToFile() → SaveAs()
Print(printerName) → Print(printerName) or Print()

// PDFFilePrint → IronPDF
CreateFromHtml() → RenderHtmlAsPdf()
CreateFromUrl() → RenderUrlAsPdf()
LoadFromFile() → PdfDocument.FromFile()
SaveToFile() → SaveAs()
Print(printerName) → Print(printerName) or Print()

' PDFFilePrint → IronPDF
' CreateFromHtml() → RenderHtmlAsPdf()
' CreateFromUrl() → RenderUrlAsPdf()
' LoadFromFile() → PdfDocument.FromFile()
' SaveToFile() → SaveAs()
' Print(printerName) → Print(printerName) or Print()

Kod wyjścia do obsługi wyjątków

W przypadku korzystania z polecenia PDFFilePrint w wierszu poleceń:

// PDFFilePrint: Check process exit code
if (process.ExitCode != 0) {
    var error = process.StandardError.ReadToEnd();
    throw new Exception($"Print failed: {error}");
}

// IronPDF: Use try-catch
try {
    pdf.Print();
}
catch (Exception ex) {
    // Handle error with full exception details
}

// PDFFilePrint: Check process exit code
if (process.ExitCode != 0) {
    var error = process.StandardError.ReadToEnd();
    throw new Exception($"Print failed: {error}");
}

// IronPDF: Use try-catch
try {
    pdf.Print();
}
catch (Exception ex) {
    // Handle error with full exception details
}

' PDFFilePrint: Check process exit code
If process.ExitCode <> 0 Then
    Dim error = process.StandardError.ReadToEnd()
    Throw New Exception($"Print failed: {error}")
End If

' IronPDF: Use try-catch
Try
    pdf.Print()
Catch ex As Exception
    ' Handle error with full exception details
End Try

Usuń zależności zewnętrzne

W przypadku korzystania z programu PDFFilePrint z wiersza poleceń należy usunąć dołączony plik wykonywalny:

// Before: Required external executable
private readonly string _pdfFilePrintPath = @"C:\tools\PDFFilePrint.exe";

// After: No external dependencies
//IronPDFis fully self-contained via NuGet

// Before: Required external executable
private readonly string _pdfFilePrintPath = @"C:\tools\PDFFilePrint.exe";

// After: No external dependencies
//IronPDFis fully self-contained via NuGet

' Before: Required external executable
Private ReadOnly _pdfFilePrintPath As String = "C:\tools\PDFFilePrint.exe"

' After: No external dependencies
'IronPDF is fully self-contained via NuGet

Przed migracją

• Znajdź wszystkie odniesienia do PDFFilePrint w kodzie źródłowym
• Opisz aktualnie stosowane metody (CreateFromHtml, CreateFromUrl, PRINT itp.)
• Zidentyfikuj nazwy drukarek używane w różnych środowiskach
• Wymień wszystkie argumenty wiersza poleceń, jeśli używasz wzorca Process.Start
• Zidentyfikuj możliwości wprowadzenia nowych funkcji (łączenie, znaki wodne, bezpieczeństwo)
• Uzyskaj klucz licencyjny IronPDF

Zmiany w pakiecie

• Usuń pakiet NuGet PDFFilePrint
• Usuń dołączony plik PDFFilePrint.exe z wdrożenia (jeśli dotyczy)
• Zainstaluj pakiet NuGet IronPdf: dotnet add package IronPdf
• Zaktualizuj importy przestrzeni nazw

Zmiany w kodzie

• Dodaj konfigurację klucza licencyjnego podczas uruchamiania
• Zastąp new PDFFile() + CreateFromHtml() przez ChromePdfRenderer.RenderHtmlAsPdf()
• Zastąp new PDFFile() + CreateFromUrl() przez ChromePdfRenderer.RenderUrlAsPdf()
• Zastąp LoadFromFile() przez PdfDocument.FromFile()
• Zastąp SaveToFile() przez SaveAs()
• W razie potrzeby zaktualizuj wywołania Print()
• Zastąp sprawdzanie kodów wyjścia obsługą wyjątków (jeśli ma to zastosowanie)

Po migracji

• Usuń plik PDFFilePrint.exe z kontroli wersji
• Zaktualizuj skrypty kompilacji, aby usunąć kopiowanie PDFFilePrint
• Wykonaj wydruk testowy na wszystkich docelowych drukarkach
• W razie potrzeby przeprowadź testy na różnych platformach
• W razie potrzeby dodaj nowe funkcje (znaki wodne, zabezpieczenia)
• Aktualizacja dokumentacji