Migrieren von PDFPrinting.NET zu IronPDF in C#

PDFPrinting.NET kennenlernen

PDFPrinting.NET zeichnet sich als spezialisierte Lösung aus, die eine beispiellose Einfachheit und Effektivität beim stillen PDF-Druck bietet. PDFPrinting.NET ist eine kommerzielle Bibliothek, die in erster Linie im Windows-Ökosystem eingesetzt wird und speziell auf Entwickler zugeschnitten ist, die PDF-Druckfunktionen in ihre Anwendungen integrieren müssen. PDFPrinting.NET ist ein spezielles Werkzeug, das sich ausschließlich auf das geräuschlose und robuste Drucken von PDFs konzentriert und die oft komplexe Aufgabe des programmgesteuerten Druckens von Dokumenten ohne Benutzereingriff vereinfacht.

Einer der wichtigsten Vorteile von PDFPrinting.NET ist die Möglichkeit, Dokumente im Hintergrund zu drucken. Sie umgeht die üblichen Druckdialogfenster und ermöglicht so vollautomatische Arbeitsabläufe, was für Anwendungen, die eine minimale Benutzerinteraktion erfordern, von entscheidender Bedeutung ist.

Die Beschränkung auf den Druck

Eine deutliche Einschränkung von PDFPrinting.NET ist, dass es nur den Druckaspekt der PDF-Verarbeitung behandelt. Sie kann keine PDF-Dokumente erstellen, verändern oder manipulieren, was ihren Nutzen für Entwickler, die Lösungen für den gesamten Lebenszyklus von PDF-Dokumenten benötigen, einschränkt:

1. Nur Drucken: PDF-Dokumente können nicht erstellt, bearbeitet oder manipuliert werden.

2. Nur für Windows: An die Windows-Druckinfrastruktur gebunden – keine Unterstützung für Linux/macOS. Die Abhängigkeit von der Windows-Druckinfrastruktur schränkt die Anwendbarkeit auf reine Windows-Umgebungen ein und schränkt die plattformübergreifende Nutzbarkeit ein.

3. Keine PDF-Generierung: HTML, URLs oder Daten können nicht in PDF konvertiert werden.

4. Keine Dokumentenmanipulation: PDFs können nicht zusammengeführt, geteilt, mit Wasserzeichen versehen oder gesichert werden.

5. Keine Textextraktion: Kann keine Inhalte aus PDFs lesen oder extrahieren.

6. Keine Formularverarbeitung: PDF-Formulare können nicht ausgefüllt oder reduziert werden.

PDFPrinting.NET vs IronPDF Vergleich

IronPDF bietet eine umfassendere Lösung, die den gesamten Lebenszyklus der PDF-Verarbeitung abdeckt. Es erleichtert die Erstellung, Bearbeitung, Konvertierung und den Druck von PDF-Dokumenten und bietet Entwicklern über eine einheitliche API eine ganze Reihe von Funktionen. Im Gegensatz zu PDFPrinting.NET kann IronPDF auf verschiedenen Plattformen eingesetzt werden, was es zu einer vielseitigen Wahl für Anwendungen macht, die in unterschiedlichen Umgebungen arbeiten.

Für Teams, die die Einführung von .NET 10 und C# 14 bis 2025 und 2026 planen, bietet IronPDF eine vollständige PDF-Lösung, die in Windows-, Linux- und macOS-Umgebungen funktioniert.

Voraussetzungen

1. .NET -Umgebung: .NET Framework 4.6.2+ oder .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGet -Zugriff: Möglichkeit zur Installation von NuGet -Paketen
3. IronPDF -Lizenz: Ihren Lizenzschlüssel erhalten Sie unter IronPDF.

NuGet-Paketänderungen

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

Lizenz-Konfiguration

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

Die Verwendung von PDFPrinting.NET erkennen

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

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

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

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

Namensraumänderungen

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

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

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

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

' Before: PDFPrinting.NET
Imports PDFPrinting.NET
Imports PDFPrintingNET

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

Kernklassen-Zuordnungen

Drucken von Methodenzuordnungen

Neue Funktionen in PDFPrinting.NET nicht verfügbar

Beispiel 1: Konvertierung von HTML in PDF

Vor (PDFPrinting.NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        Dim html As String = "<html><body><h1>Hello World</h1></body></html>"
        converter.ConvertHtmlToPdf(html, "output.pdf")
        Console.WriteLine("PDF created successfully")
    End Sub
End Class

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        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()
    {
        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()
        Dim renderer = 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 verwendet HtmlToPdfConverter mit ConvertHtmlToPdf(html, outputPath), wodurch das Rendern und Speichern in einem einzigen Aufruf kombiniert wird.IronPDF verwendet ChromePdfRenderer mit RenderHtmlAsPdf(), was ein PdfDocument-Objekt zurückgibt, das Sie dann mit SaveAs() speichern. Diese Trennung bietet mehr Flexibilität - Sie können die PDF-Datei vor dem Speichern bearbeiten (Wasserzeichen hinzufügen, mit anderen Dokumenten zusammenführen, Sicherheit hinzufügen).

IronPDF bietet Funktionen wie die HTML-zu-PDF-Konvertierung, die es Entwicklern ermöglicht, Webinhalte als PDFs zu rendern und dabei moderne Webtechnologien für die Dokumentenerstellung zu nutzen. Durch die interne Nutzung von Browser-Engines bildet IronPDF das Styling und Rendering von Webdokumenten in PDF-Dateien exakt nach. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.

Beispiel 2: Konvertierung von URL in PDF

Vor (PDFPrinting.NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New WebPageToPdfConverter()
        Dim url As String = "https://www.example.com"
        converter.Convert(url, "webpage.pdf")
        Console.WriteLine("PDF from URL created successfully")
    End Sub
End Class

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        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()
    {
        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

Class Program
    Shared Sub Main()
        Dim renderer = 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 Class

PDFPrinting .NET verwendet WebPageToPdfConverter mit Convert(url, outputPath).IronPDF verwendet die gleiche Klasse ChromePdfRenderer mit der Methode RenderUrlAsPdf(). Beachten Sie, dass IronPDF eine einzige Renderer-Klasse sowohl für HTML-Strings als auch für URLs verwendet, was Ihren Code vereinfacht, wenn Sie beide Funktionen benötigen. Erfahren Sie mehr in unseren Tutorials.

Beispiel 3: Kopf- und Fußzeilen

Vor (PDFPrinting.NET):

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

Imports PDFPrinting.NET
Imports System

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        converter.HeaderText = "Company Report"
        converter.FooterText = "Page {page} of {total}"
        Dim html As String = "<html><body><h1>Document Content</h1></body></html>"
        converter.ConvertHtmlToPdf(html, "report.pdf")
        Console.WriteLine("PDF with headers/footers created")
    End Sub
End Class

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        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()
    {
        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

Class Program
    Shared Sub Main()
        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 Class

PDFPrinting .NET verwendet einfache String-Eigenschaften HeaderText und FooterText mit Platzhaltern {page} und {total}.IronPDF verwendet HtmlHeaderFooter Objekte mit einer HtmlFragment Eigenschaft, die vollständiges HTML akzeptiert und so umfangreiches Styling mit CSS ermöglicht. Beachten Sie die Änderung der Platzhaltersyntax: PDFPrinting .NET verwendet {total}, während IronPDF{total-pages} verwendet.

Änderung der Syntax für Platzhalter

Die Platzhalter für Kopf- und Fußzeilen unterscheiden sich je nach Bibliothek:

// PDFPrinting.NET placeholders
"Page {page} of {total}"

//IronPDFplaceholders
"Page {page} of {total-pages}"

// PDFPrinting.NET placeholders
"Page {page} of {total}"

//IronPDFplaceholders
"Page {page} of {total-pages}"

Load-Then-Print-Muster

PDFPrinting.NET gibt Dateipfade direkt weiter;IronPDF wird zuerst geladen:

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

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

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

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

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

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

Migration der Druckeinstellungen

PDFPrinting.NET verwendet Properties;IronPDF verwendet ein Einstellungsobjekt:

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

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

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

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

' PDFPrinting.NET: Properties on printer object
printer.Copies = 2
printer.Duplex = True

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

HTML-Kopfzeilen vs. Textkopfzeilen

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF: Vollständiges HTMLwith styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF: Vollständiges HTMLwith styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

' PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report"

' IronPDF: Vollständiges HTMLwith styling
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center'>Company Report</div>"
}

PDF-Zusammenführung

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

Wasserzeichen

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

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

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

Passwortschutz

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

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

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

Textextraktion

string text = pdf.ExtractAllText();

string text = pdf.ExtractAllText();

Dim text As String = pdf.ExtractAllText()

Generieren-Dann-Drucken-Workflow

Mit IronPDF können Sie PDFs in einem einzigen Arbeitsgang erzeugen und drucken:

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

Vor der Migration

• Erfassung aller Verwendungen von PDFPrinting .NET im Quellcode
• Alle aktuell verwendeten Druckernamen dokumentieren
• Notieren Sie alle Druckeinstellungen.
• Prüfen, ob plattformübergreifende Unterstützung erforderlich ist.
• Speicherung des IronPDF-Lizenzschlüssels (Umgebungsvariablen empfohlen)
• Zuerst mit der IronPDF Testlizenz testen

Paketänderungen

• Entfernen Sie das NuGet Paket PDFPrinting.NET
• Installieren Sie das NuGet Paket IronPdf: dotnet add package IronPdf

Code-Änderungen

• Namespace-Importe aktualisieren
• Ersetzen Sie HtmlToPdfConverter durch ChromePdfRenderer
• Ersetzen Sie WebPageToPdfConverter durch ChromePdfRenderer
• Ersetzen Sie ConvertHtmlToPdf(html, path) durch RenderHtmlAsPdf(html).SaveAs(path)
• Ersetzen Sie Convert(url, path) durch RenderUrlAsPdf(url).SaveAs(path)
• Aktualisierung der Kopf-/Fußzeile von FooterText zu HtmlFooter
• Aktualisierung der Platzhaltersyntax ({total} → {total-pages})
• Umwandlung von Druckaufrufen in das Muster Laden-dann-Drucken
• Druckeinstellungen auf das Objekt PrintSettings aktualisieren

Nach der Migration

• Testdruck auf allen Zielplattformen
• Überprüfung der Darstellung von Kopf- und Fußzeile
• Erwägen Sie die Hinzufügung der PDF-Generierung für dynamische Dokumente
• Fügen Sie bei Bedarf neue Funktionen hinzu (Zusammenführung, Wasserzeichen, Sicherheit).