Wie man PDF-Dateien in .NET Core mit IronPDF erstellt

PDFPrinting.NET kennenlernen

PDFPrinting.NET (Terminalworks; NuGet PdfPrintingNet) ist eine spezialisierte Bibliothek, die sich auf das stille Drucken von PDF-Dateien in Windows-Umgebungen konzentriert. Als dediziertes Werkzeug, das sich auf das stille Drucken bestehender PDFs fokussiert, vereinfacht es die Aufgabe, Dokumente programmgesteuert ohne Benutzerintervention an einen Drucker zu senden. Der neuere Einstiegspunkt ist die PdfPrint Klasse; älterer Code kann immer noch auf die alte TerminalWorks.PDFPrinting.PDFPrinter verweisen.

Eine Kernstärke ist das stille Drucken — das Umgehen der üblichen Druckdialogfenster, sodass vollautomatische Workflows unbeaufsichtigt ablaufen können.

Die Druckzentrierte Begrenzung

PDFPrinting.NET konzentriert sich auf einen engen Satz von Operationen und erstellt keine neuen PDF-Inhalte. Der Umfang ist Drucken, Betrachten, grundlegendes Bearbeiten und Rasterisieren bestehender Dokumente:

1. Druckzentriert: Erstellt keine neuen PDF-Inhalte — druckt, zeigt an, bearbeitet und rasterisiert nur bestehende PDFs.

2. Nur Windows-Druck: Gebunden an die Windows-Druckinfrastruktur, was die plattformübergreifende Nutzbarkeit einschränkt.

3. Keine HTML/URL-zu-PDF-API: Es gibt keine HtmlToPdfConverter und keine WebPageToPdfConverter Klasse — diese Funktionen existieren nicht in der API-Oberfläche.

4. Eingeschränkte Bearbeitung: Grundlegendes Zusammenführen/Teilen/Extrahieren ist über PdfPrintDocument verfügbar; es gibt kein Wasserzeichen oder moderne Inhaltserstellung.

5. Keine umfassende Textextraktions-Oberfläche.

6. Keine Formularbefüllung oder -flattening.

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 auf modernem .NET 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 (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

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

Namensraumänderungen

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

Kernklassen-Zuordnungen

Drucken von Methodenzuordnungen

Neue Funktionen in PDFPrinting.NET nicht verfügbar

Beispiel 1: Konvertierung von HTML in PDF

Vorher (PDFPrinting.NET): PDFPrinting.NET hat keine HTML-zu-PDF-API — es gibt keine HtmlToPdfConverter Klasse. Der nächstliegende Workflow besteht darin, das PDF mit einer anderen Bibliothek zu erstellen und dann die Datei zu drucken oder weiterzugeben:

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

Nach (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

Da PDFPrinting.NET PDFs überhaupt nicht erstellt, ist die Migration kein eins-zu-eins-Klassentausch — es ist die Einführung einer neuen Fähigkeit. IronPDF's ChromePdfRenderer.RenderHtmlAsPdf() gibt ein PdfDocument zurück, das Sie bearbeiten können (Wasserzeichen, Zusammenführen, Sicherheit), bevor Sie mit SaveAs() speichern. Durch die Nutzung einer Chromium-basierten Engine repliziert IronPDF moderne CSS- und JavaScript-Darstellung mit hoher Wiedergabetreue. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.

Beispiel 2: Konvertierung von URL in PDF

Vorher (PDFPrinting.NET): Es gibt keine WebPageToPdfConverter Klasse — PDFPrinting.NET lädt keine Webseiten herunter oder rendert sie. Eine separate Bibliothek muss zuerst die URL als PDF erfassen; PDFPrinting.NET kann dann die resultierende Datei drucken:

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

Nach (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 verwendet eine einzelne ChromePdfRenderer Klasse für sowohl HTML-Strings als auch URLs, wobei RenderUrlAsPdf() das Web-Capture mit einem Aufruf erledigt. Erfahren Sie mehr in unseren Tutorials.

Beispiel 3: Kopf- und Fußzeilen

Vorher (PDFPrinting.NET): PDFPrinting.NET kann keine Kopf- oder Fußzeilen erstellen — es generiert keine PDFs aus HTML oder einer anderen Quelle und bietet keine Kopf-/Fußzeilen-Kompositions-API. Wenn Ihr PDF diese bereits enthält, kann die Bibliothek es drucken:

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

Nach (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 verwendet HtmlHeaderFooter Objekte mit einer HtmlFragment Eigenschaft, die vollständiges HTML akzeptiert und dadurch reichhaltiges Styling mit CSS ermöglicht. Platzhalter wie {page} und {total-pages} werden zur Renderzeit ersetzt.

Kopf-/Fußzeilen-Platzhalter sind eine IronPDF-Only-Funktion

PDFPrinting.NET hat überhaupt keine Kopf- oder Fußzeilen-Erstellungs-API, daher gibt es keine Platzhaltersyntax, von der migriert werden könnte.IronPDF unterstützt {page} und {total-pages} Platzhalter innerhalb von HtmlHeaderFooter.HtmlFragment:

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

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

Load-Then-Print-Muster

PDFPrinting.NET übergibt Dateipfade direkt an Print();IronPDF lädt zuerst das Dokument:

// 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()

Migration der Druckeinstellungen

PDFPrinting.NET verwendet Eigenschaften auf PdfPrint;IronPDF verwendet ein Einstellungsobjekt:

// 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-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 PdfPrintingNet NuGet-Paket
• Installieren Sie das IronPdf NuGet-Paket: dotnet add package IronPdf

Code-Änderungen

• Aktualisieren Sie die Namespace-Importe (PdfPrintingNet / alt TerminalWorks.PDFPrinting → IronPdf)
• Konvertieren Sie pdfPrint.Print(path)Aufrufe in das PdfDocument.FromFile(path).Print() Muster
• Verschieben Sie pro-Druck-Eigenschaften (Copies, Duplex, Collate, PrinterName) auf ein PrintSettings Objekt
• Nehmen Sie neue Fähigkeiten an: verwenden Sie ChromePdfRenderer.RenderHtmlAsPdf / RenderUrlAsPdf für HTML- und URL-Eingaben (kein Äquivalent existierte in PDFPrinting.NET)
• Konfigurieren Sie Kopf- und Fußzeilen über RenderingOptions.HtmlHeader und HtmlFooter (neue Fähigkeit)
• Setzen Sie IronPdf.License.LicenseKey beim Start der Anwendung

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