Was ist PDFSharp?

PDFSharp ist eine Low-Level-Bibliothek zur PDF-Erstellung, die es Entwicklern ermöglicht, PDF-Dokumente durch einen programmatischen, koordinatenbasierten Ansatz zu erzeugen.PDFSharpwird unter der MIT-Lizenz veröffentlicht und gewährt der Entwicklergemeinschaft Freiheit bei der Nutzung und Modifikation ohne Lizenzkosten.

PDFSharp fungiert in erster Linie als Werkzeug zum Zeichnen und Kompilieren von PDFs von Grund auf. Die Bibliothek verwendet eine API im Stil von GDI+, bei der Entwickler jedes Element anhand von X- und Y-Koordinaten positionieren. Bei diesem Ansatz müssen exakte Positionen für Text, Bilder, Linien und Rechtecke berechnet werden - ähnlich wie beim Zeichnen auf einer Leinwand.

Zu den wichtigsten Merkmalen vonPDFSharpgehören:

• Koordinatenbasiertes Zeichnen: Jedes Element erfordert eine explizite X,Y-Positionierung
• MIT-Lizenz: Frei zur Nutzung, Änderung und Verbreitung
• GDI+ Style API: Verwendet die Klassen XGraphics, XFont, XBrush, und XPen
• Manuelle Seitenverwaltung: Entwickler verwalten die Erstellung und den Überlauf von Seiten manuell
• Keine HTML-Unterstützung: Keine direkte Konvertierung von HTML/CSS in PDF möglich
• Leichtgewichtig: Keine externen Abhängigkeiten, vereinfacht die Bereitstellung

PDFSharp wird manchmal fälschlicherweise für einen HTML-zu-PDF-Konverter gehalten, was es nicht ist. Der Zweck ist ausschließlich auf die programmatische Erstellung von PDF-Dokumenten ausgerichtet. Es gibt zwar ein Add-on, HtmlRenderer.PdfSharp, das HTML-Rendering-Fähigkeiten bieten soll, aber es unterstützt nur CSS 2.1, ohne Unterstützung für moderne CSS-Funktionen wie Flexbox und Grid, und hat Einschränkungen wie z. B. die fehlerhafte Darstellung von Tabellen.

Was ist IronPDF?

IronPDF ist eine umfassende .NET-Bibliothek, die eine native HTML-zu-PDF-Konvertierung mit einer eingebetteten Chromium-Rendering-Engine bietet. Die Klasse ChromePdfRenderer konvertiert HTML-Inhalte mit voller Unterstützung für HTML5, CSS3 und JavaScript - einschließlich moderner Layoutfunktionen wie Flexbox und Grid.

Im Gegensatz zum koordinatenbasierten Ansatz vonPDFSharpermöglichtIronPDFEntwicklern die Nutzung von Webtechnologien für die Dokumentenerstellung. Anstatt X,Y-Positionen zu berechnen, schreiben Entwickler HTML und CSS, um die Struktur und das Styling von Dokumenten zu definieren. Die Chromium-Engine verarbeitet Textfluss, Seitenumbrüche und Elementpositionierung automatisch.

Architekturvergleich

Der grundlegende Unterschied zwischenPDFSharpundIronPDFliegt in ihrer Herangehensweise an die Dokumentenerstellung: manuelles koordinatenbasiertes Zeichnen gegenüber HTML-basiertem Rendering.

Entwickler mit Erfahrung in der Web-Entwicklung können mit dem HTML-basierten Ansatz vonIronPDFihre vorhandenen Kenntnisse auf die PDF-Erstellung übertragen. Für Entwickler, die eine feinkörnige Kontrolle über einzelne Pixel benötigen oder aus dem GDI+-Umfeld kommen, bietetPDFSharpvertraute Muster.

HTML zu PDF Konvertierung

Die Konvertierung von HTML-Inhalten in PDF zeigt den grundlegenden Leistungsunterschied zwischen diesen Bibliotheken auf.

PDFSharp HTML-to-PDF Ansatz:

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        //PDFSharpdoes not have built-in HTML to PDF conversion
        // You need to manually parse HTML and render content
        PdfDocument document = new PdfDocument();
        PdfPage page = document.AddPage();
        XGraphics gfx = XGraphics.FromPdfPage(page);
        XFont font = new XFont("Arial", 12);

        // Manual text rendering (no HTML support)
        gfx.DrawString("Hello from PDFSharp", font, XBrushes.Black,
            new XRect(0, 0, page.Width, page.Height),
            XStringFormats.TopLeft);

        document.Save("output.pdf");
    }
}

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        //PDFSharpdoes not have built-in HTML to PDF conversion
        // You need to manually parse HTML and render content
        PdfDocument document = new PdfDocument();
        PdfPage page = document.AddPage();
        XGraphics gfx = XGraphics.FromPdfPage(page);
        XFont font = new XFont("Arial", 12);

        // Manual text rendering (no HTML support)
        gfx.DrawString("Hello from PDFSharp", font, XBrushes.Black,
            new XRect(0, 0, page.Width, page.Height),
            XStringFormats.TopLeft);

        document.Save("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF HTML-zu-PDF-Ansatz:

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

class Program
{
    static void Main()
    {
        //IronPDFhas native HTML to PDF rendering
        var renderer = new ChromePdfRenderer();

        string html = "<h1>Hello from IronPDF</h1><p>Easy HTML to PDF conversion</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        //IronPDFhas native HTML to PDF rendering
        var renderer = new ChromePdfRenderer();

        string html = "<h1>Hello from IronPDF</h1><p>Easy HTML to PDF conversion</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDFSharp kann HTML nicht in PDF konvertieren. Die Bibliothek erfordert ein manuelles Rendering, bei dem die Entwickler HTML selbst parsen und jedes Element mithilfe von Koordinaten zeichnen müssen. Der ChromePdfRenderer vonIronPDFakzeptiert nativ HTML-Strings und rendert sie mit voller CSS-Unterstützung durch die eingebettete Chromium-Engine.

Dieser Kompetenzunterschied wirkt sich erheblich auf die Entwicklungszeit aus. Die Erstellung eines gestylten Dokuments inPDFSharperfordert die Berechnung von Positionen für jedes Element, während IronPDF-Entwickler Standard-HTML/CSS schreiben. Eine ausführliche Anleitung zur HTML-zu-PDF-Konvertierung finden Sie im HTML-zu-PDF-Tutorial.

Text in bestehende PDFs einfügen

Das Ändern vorhandener PDFs, um Text hinzuzufügen, zeigt verschiedene Ansätze zur Dokumentenmanipulation.

PDFSharp fügt Text zu PDF hinzu:

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        // Open existing PDF
        PdfDocument document = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify);
        PdfPage page = document.Pages[0];

        // Get graphics object
        XGraphics gfx = XGraphics.FromPdfPage(page);
        XFont font = new XFont("Arial", 20, XFontStyle.Bold);

        // Draw text at specific position
        gfx.DrawString("Watermark Text", font, XBrushes.Red,
            new XPoint(200, 400));

        document.Save("modified.pdf");
    }
}

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        // Open existing PDF
        PdfDocument document = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify);
        PdfPage page = document.Pages[0];

        // Get graphics object
        XGraphics gfx = XGraphics.FromPdfPage(page);
        XFont font = new XFont("Arial", 20, XFontStyle.Bold);

        // Draw text at specific position
        gfx.DrawString("Watermark Text", font, XBrushes.Red,
            new XPoint(200, 400));

        document.Save("modified.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF fügt Text zu PDF hinzu:

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

class Program
{
    static void Main()
    {
        // Open existing PDF
        var pdf = PdfDocument.FromFile("existing.pdf");

        // Add text stamp/watermark
        var textStamper = new TextStamper()
        {
            Text = "Watermark Text",
            FontSize = 20,
            Color = IronSoftware.Drawing.Color.Red,
            VerticalAlignment = VerticalAlignment.Middle,
            HorizontalAlignment = HorizontalAlignment.Center
        };

        pdf.ApplyStamp(textStamper);
        pdf.SaveAs("modified.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        // Open existing PDF
        var pdf = PdfDocument.FromFile("existing.pdf");

        // Add text stamp/watermark
        var textStamper = new TextStamper()
        {
            Text = "Watermark Text",
            FontSize = 20,
            Color = IronSoftware.Drawing.Color.Red,
            VerticalAlignment = VerticalAlignment.Middle,
            HorizontalAlignment = HorizontalAlignment.Center
        };

        pdf.ApplyStamp(textStamper);
        pdf.SaveAs("modified.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDFSharp verwendet PdfReader.Open(), um ein vorhandenes PDF zu laden, und erhält dann ein XGraphics-Objekt, um Text an bestimmten X,Y-Koordinaten mit DrawString() zu zeichnen. Der Entwickler muss die genaue Positionierung berechnen.

IronPDF verwendet PdfDocument.FromFile(), um das PDF zu laden, und erstellt dann ein TextStamper-Objekt mit Ausrichtungseigenschaften wie VerticalAlignment.Middle und HorizontalAlignment.Center. Die Methode ApplyStamp() übernimmt die Positionierung auf der Grundlage dieser Alignment-Einstellungen. Umfassende Optionen für Wasserzeichen finden Sie in der Wasserzeichen-Dokumentation.

Erstellen von PDFs mit Bildern

Das Hinzufügen von Bildern zu PDFs veranschaulicht die unterschiedlichen Paradigmen zwischen koordinatenbasierten und HTML-basierten Ansätzen.

PDFSharp erstellt PDF mit Bild:

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        // Create new PDF document
        PdfDocument document = new PdfDocument();
        PdfPage page = document.AddPage();
        XGraphics gfx = XGraphics.FromPdfPage(page);

        // Load and draw image
        XImage image = XImage.FromFile("image.jpg");

        // Calculate size to fit page
        double width = 200;
        double height = 200;

        gfx.DrawImage(image, 50, 50, width, height);

        // Add text
        XFont font = new XFont("Arial", 16);
        gfx.DrawString("Image in PDF", font, XBrushes.Black,
            new XPoint(50, 270));

        document.Save("output.pdf");
    }
}

// NuGet: Install-Package PdfSharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;

class Program
{
    static void Main()
    {
        // Create new PDF document
        PdfDocument document = new PdfDocument();
        PdfPage page = document.AddPage();
        XGraphics gfx = XGraphics.FromPdfPage(page);

        // Load and draw image
        XImage image = XImage.FromFile("image.jpg");

        // Calculate size to fit page
        double width = 200;
        double height = 200;

        gfx.DrawImage(image, 50, 50, width, height);

        // Add text
        XFont font = new XFont("Arial", 16);
        gfx.DrawString("Image in PDF", font, XBrushes.Black,
            new XPoint(50, 270));

        document.Save("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF erstellt PDF mit Bild:

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

class Program
{
    static void Main()
    {
        // Create PDF from HTML with image
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Image in PDF</h1>
            <img src='image.jpg' style='width:200px; height:200px;' />
            <p>Easy image embedding with HTML</p>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");

        // Alternative: Add image to existing PDF
        var existingPdf = new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Document</h1>");
        var imageStamper = new IronPdf.Editing.ImageStamper(new Uri("image.jpg"))
        {
            VerticalAlignment = IronPdf.Editing.VerticalAlignment.Top
        };
        existingPdf.ApplyStamp(imageStamper);
    }
}

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

class Program
{
    static void Main()
    {
        // Create PDF from HTML with image
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Image in PDF</h1>
            <img src='image.jpg' style='width:200px; height:200px;' />
            <p>Easy image embedding with HTML</p>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");

        // Alternative: Add image to existing PDF
        var existingPdf = new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Document</h1>");
        var imageStamper = new IronPdf.Editing.ImageStamper(new Uri("image.jpg"))
        {
            VerticalAlignment = IronPdf.Editing.VerticalAlignment.Top
        };
        existingPdf.ApplyStamp(imageStamper);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDFSharp erfordert das Laden des Bildes mit XImage.FromFile() und das anschließende Zeichnen an bestimmten Koordinaten mit gfx.DrawImage(image, x, y, width, height). Der Text muss anhand von berechneten Koordinaten relativ zum Bild positioniert werden.

IronPDF ermöglicht das Einbetten von Bildern mit Hilfe von Standard-HTML <img>-Tags mit CSS-Styling. Die Chromium-Engine steuert das Laden, die Größe und die Positionierung von Bildern über CSS-Eigenschaften. Alternativ kann ImageStamper Bilder in bestehende PDFs mit alignementbasierter Positionierung einfügen.

API-Mapping-Referenz

Für Teams, die eine Migration vonPDFSharpzuIronPDFerwägen, hilft das Verständnis der API-Zuordnungen, den Entwicklungsaufwand abzuschätzen.

Das Koordinatenberechnungsproblem

Der GDI+-Ansatz vonPDFSharpverursacht einen erheblichen Entwicklungsaufwand:

• Genaue X,Y-Positionen für jedes Element berechnen: Jeder Textblock, jedes Bild und jede Form muss manuell positioniert werden
• Inhaltshöhe bei Seitenüberlauf manuell verfolgen: Entwickler müssen erkennen, wenn der Inhalt die Seitengrenzen überschreitet
• Den Zeilenumbruch und die Textmessung selbst vornehmen: Bei langen Texten muss berechnet werden, wo der Zeilenumbruch erfolgen soll
• Tabellen zellenweise mit Randberechnungen zeichnen: Jede Tabellenzelle erfordert eine individuelle Positionierung und Randzeichnung
• Verwaltung mehrseitiger Dokumente mit manuellem Seitenumbruch: Die Erkennung und Handhabung von Seitengrenzen ist manuell

IronPDF räumt diese Bedenken aus, indem es die Chromium-Layout-Engine nutzt. Der Text fließt natürlich, die Größe von Tabellen wird automatisch angepasst, und Seitenumbrüche erfolgen an geeigneten Stellen - alles gesteuert durch Standard-CSS.

Zusammenfassung des Funktionsvergleichs

Anwendungen, die moderne CSS-Layouts, automatische Paginierung oder HTML-Vorlagen-basierte Generierung erfordern, profitieren erheblich von IronPDFs Ansatz.

Wenn Teams den Wechsel vonPDFSharpzuIronPDFerwägen

Mehrere Faktoren veranlassen Teams,IronPDFals Alternative zuPDFSharpzu bewerten:

Reduzierung der Entwicklungszeit:PDFSharperfordert die Berechnung von X,Y-Positionen für jedes Element. Teams, die viel Zeit für Koordinatenberechnungen und die Behandlung von Seitenumbrüchen aufwenden, finden die HTML/CSS-basierte Generierung oft wesentlich schneller.

Moderne CSS-Anforderungen:PDFSharpkann keine modernen CSS-Funktionen wie Flexbox, Grid oder CSS3-Selektoren darstellen. Anwendungen, die moderne Weblayouts erfordern, müssen die Chromium-Engine vonIronPDFverwenden.

Belange der Wartbarkeit: Koordinatenbasierter PDFSharp-Code ist schwer zu ändern - die Änderung eines Elements erfordert oft die Anpassung der Positionen nachfolgender Elemente. HTML/CSS-Vorlagen sind wesentlich einfacher zu aktualisieren.

Transfer von Webentwicklungskenntnissen: Teams mit HTML/CSS-Kenntnissen können ihre vorhandenen Kenntnisse auf die PDF-Erzeugung mitIronPDFanwenden, anstatt GDI+-ähnliche Zeichen-APIs zu lernen.

Komplexe Dokumentanforderungen: Dokumente mit Tabellen, gemischten Inhalten oder dynamischen Layouts werden mit koordinatenbasierter Positionierung immer schwieriger. HTML-Vorlagen gehen natürlicher mit Komplexität um.

Aktiver Wartungsbedarf:PDFSharperhält nur selten Updates. Teams, die regelmäßig Sicherheits-Patches und Funktions-Updates benötigen, profitieren von der aktiven Entwicklung von IronPDF.

Installationsvergleich

PDFSharp-Installation:

Install-Package PdfSharp

Install-Package PdfSharp

Leichtgewichtig und ohne externe Abhängigkeiten.

IronPDF-Installation:

Install-Package IronPdf

Install-Package IronPdf

IronPDF erfordert eine Lizenzschlüsselkonfiguration:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

Die Chromium-Engine vonIronPDFbietet umfassende Rendering-Funktionen, benötigt aber mehr Platz als der leichtgewichtige Ansatz von PDFSharp. Die Bibliothek unterstützt .NET Framework, .NET Core, .NET 5+ und Vorwärtskompatibilität zu .NET 10 und C# 14.

Die Entscheidung treffen

Die Wahl zwischenPDFSharpundIronPDFhängt von Ihren Projektanforderungen ab:

Konsultieren Sie PDFSharp, wenn: Ihr Projekt eine genaue Kontrolle über das Rendering von Dokumenten ohne zusätzliche Abhängigkeiten erfordert, Budgetbeschränkungen eine kommerzielle Lizenzierung verhindern, Sie mit koordinatenbasierter Positionierung vertraut sind und Ihre Dokumente kein HTML/CSS-Rendering erfordern.

Konsultieren Sie IronPDF, wenn: Sie eine moderne HTML-zu-PDF-Konvertierung mit CSS3-Unterstützung benötigen, Ihr Team über Webentwicklungskenntnisse verfügt, Sie automatischen Textfluss, Tabellen und Seitenumbrüche wünschen, die Entwicklungszeit verkürzt werden soll oder Sie aktive Wartung und Unterstützung benötigen.

Einstieg mit IronPDF

Testen SieIronPDFfür Ihre Anforderungen bei der PDF-Erstellung:

1. Installation über NuGet: Install-Package IronPdf
2. Überprüfen Sie die Dokumentation für die ersten Schritte
3. Erkunden Sie HTML to PDF tutorials für Konvertierungsmuster
4. Eine vollständige Dokumentation der Methoden finden Sie in der API-Referenz

Die IronPDF-Tutorials bieten umfassende Beispiele, die gängige Szenarien von der einfachen Konvertierung bis zur fortgeschrittenen PDF-Bearbeitung abdecken.

Abschluss

PDFSharp undIronPDFerfüllen unterschiedliche Anforderungen im Bereich der .NET-PDF-Generierung.PDFSharpeignet sich für Projekte, die eine feine Kontrolle über das Rendering von Dokumenten ohne zusätzliche Abhängigkeiten erfordern, bei denen Budgetbeschränkungen ein Faktor sind und koordinatenbasiertes Zeichnen akzeptabel ist. Für Projekte, die moderne Webstandards oder dynamische Inhalte über HTML erfordern, ist sie jedoch nicht geeignet.

IronPDF übertrifftPDFSharpin Situationen, die eine moderne HTML-zu-PDF-Konvertierung erfordern, dank seiner robusten Funktionen, die CSS3, HTML5 und die Bearbeitung von Dokumenten auf hohem Niveau unterstützen. Zwar ist eine kommerzielle Lizenz erforderlich, aber die erhöhte Produktivität und die modernen Funktionen rechtfertigen oft die Investition.

Bei der Wahl zwischen diesen beiden Bibliotheksangeboten kommt es darauf an, die Anforderungen Ihres Projekts zu verstehen - seien es Kostenbeschränkungen, die Notwendigkeit einer modernen Webunterstützung oder ein kompliziertes Dokumentendesign. Die koordinatenbasierte Natur vonPDFSharpverursacht einen Entwicklungsaufwand, den IronPDFs HTML-basierter Ansatz eliminiert, aber die MIT-Lizenz und der geringe Platzbedarf vonPDFSharpbleiben für geeignete Anwendungsfälle attraktiv.

Berücksichtigen Sie bei der Auswahl dieser Bibliotheken Ihre kompletten Anforderungen - HTML/CSS-Supportbedarf, Entwicklungszeit, Wartungserwägungen und Budget. Die architektonischen Unterschiede sind grundlegend und wirken sich auf jeden Aspekt des PDF-Erzeugungsworkflows aus.