Migrer de PDFsharp à IronPDF transforme votre flux de travail de génération de PDF, passant du dessin manuel basé sur les coordonnées à la modélisation HTML/CSS moderne. Ce guide fournit un chemin de migration étape par étape qui remplace le positionnement de style GDI+ par des technologies web, réduisant le temps de développement et rendant la génération de PDF maintenable à travers des compétences standard HTML/CSS.
PDFsharp est une bibliothèque de création de PDF de bas niveau qui permet aux développeurs de générer des documents PDF de manière programmatique. Publié sous licence MIT et maintenu par le PDFsharp-Team (initialement empira Software GmbH), PDFsharp 6.x cible .NET 8/9/10 et .NET Standard 2.0 et fonctionne de manière multiplateforme sur Windows, Linux et macOS via la version Core. PDFsharp fonctionne principalement comme un outil pour dessiner et compiler des PDFs à partir de zéro en utilisant une API de style GDI+, ce qui peut être à la fois bénéfique et restrictif selon la nature du projet.
PDFsharp est parfois à tort supposé être un convertisseur HTML en PDF, ce qu'il n'est pas. L'objectif est uniquement la création programmatique de documents PDF. Bien qu'il existe un addon communautaire, HtmlRenderer.PdfSharp (par ArthurHub), destiné à fournir des capacités de rendu HTML, il couvre uniquement HTML 4.01 / CSS niveau 2 - pas de fonctionnalités CSS modernes comme flexbox, grille, ou JavaScript.
L'approche en GDI+ de PDFsharp signifie que vous devez :
L'architecture de PDFsharp nécessite une compréhension approfondie du positionnement en utilisant des coordonnées, posant souvent des défis dans la création de mises en page complexes.
| Fonction | PDFsharp | IronPDF |
|---|---|---|
| Licence | MIT (gratuit) | Commercial |
| Support HTML vers PDF | Non | Oui (prise en charge de HTML5/CSS3) |
| Support CSS moderne | Non (HTML 4.01/CSS 2 via add-on HtmlRenderer) | Oui (CSS3 complet) |
| Création de documents | Dessin à base de coordonnées | Modèles HTML/CSS |
| Système de mise en page | Positionnement manuel X,Y | CSS Flow/Flexbox/Grid |
| Sauts de page | Calcul manuel | Automatique + contrôle CSS |
| Tables | Dessiner des cellules individuellement | HTML <table> |
| Styling | Polices/couleurs basées sur le code | Feuilles de style CSS |
| Document API | Bas niveau (nécessite des coordonnées) | Haut niveau (API simplifiée) |
| Mises à jour | Actif (ligne 6.x) | Régulièrement |
IronPDF brille dans les scénarios où les documents HTML doivent être convertis en PDF avec une fidélité totale. Cette bibliothèque .NET prend en charge HTML5 et CSS3, ce qui garantit le respect des normes web modernes. Grâce à ses capacités natives de conversion de HTML en PDF, les développeurs peuvent tirer parti du contenu web existant ou des modèles conçus avec des outils web contemporains.
Pour les équipes sur .NET moderne, IronPDF fournit une approche qui élimine les calculs de coordonnées tout en tirant parti des compétences en développement web.
# Remove PDFsharp (official PDFsharp-Team package IDs; case-sensitive on case-sensitive feeds)
dotnet remove package PDFsharp
# dotnet remove package PDFsharp-WPF # if you used the WPF build
# dotnet remove package PDFsharp-GDI # if you used the GDI build
# dotnet remove package PDFsharp-MigraDoc # if you used MigraDoc on top
# dotnet remove package PdfSharpCore # community .NET Standard port
# Add IronPDF
dotnet add package IronPdf// 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"# Find all PDFsharp usages in your codebase
grep -r "PdfSharp\|XGraphics\|XFont\|XBrush\|XPen" --include="*.cs" .// Before: PDFsharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using PdfSharp.Pdf.IO;
// After: IronPDF
using IronPdf;
using IronPdf.Editing;Imports IronPdf
Imports IronPdf.Editing| API PDFsharp | API IronPDF |
|---|---|
new PdfDocument() | ChromePdfRenderer.RenderHtmlAsPdf() |
document.AddPage() | Automatique |
XGraphics.FromPdfPage() | Pas nécessaire |
XGraphics.DrawString() | HTML <p>, <h1>, etc. |
XGraphics.DrawImage() | HTML <img> tag |
XFont | CSS font-family, font-size |
XBrush, XPen | Couleurs/bordures CSS |
document.Save() | pdf.SaveAs() |
PdfReader.Open() | PdfDocument.FromFile() |
Avant (PDFsharp) :
// NuGet: Install-Package PDFsharp (official PDFsharp-Team package, MIT)
// PDFsharp does NOT support HTML-to-PDF natively. The community add-on
// HtmlRenderer.PdfSharp covers HTML 4.01 / CSS level 2 only (no flexbox, grid, JS).
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;
class Program
{
static void Main()
{
// PDFsharp does not have built-in HTML vers 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);
// Manuel 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");
}
}Après (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
// IronPDF has native HTML vers PDF rendering
var renderer = new ChromePdfRenderer();
string html = "<h1>Hello from IronPDF</h1><p>Easy HTML vers PDF conversion</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
}Cet exemple met en évidence la différence la plus importante entre les deux bibliothèques. PDFsharp ne propose pas de conversion HTML en PDF intégrée — vous devez créer manuellement un PdfDocument, ajouter un PdfPage, obtenir un objet XGraphics, créer un XFont, et utiliser DrawString() avec des coordonnées XRect.
IronPDF offre un rendu HTML en PDF natif via ChromePdfRenderer. La méthode RenderHtmlAsPdf() accepte des chaînes HTML et les convertit en utilisant un moteur Chromium en interne. IronPDF convertit facilement les fichiers HTML en PDF, en préservant tous les styles définis en HTML5 et CSS3, éliminant ainsi le besoin de calculs de coordonnées. Consultez la documentation HTML vers PDF pour des exemples complets.
Avant (PDFsharp) :
// NuGet: Install-Package PDFsharp (official PDFsharp-Team package, MIT)
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);
// Note: in PDFsharp 6.x, XFontStyle was renamed to XFontStyleEx
XFont font = new XFont("Arial", 20, XFontStyleEx.Bold);
// Draw text at specific position
gfx.DrawString("Watermark Text", font, XBrushes.Red,
new XPoint(200, 400));
document.Save("modified.pdf");
}
}Après (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Open existing PDF
var pdf = PdfDocument.FromFile("existing.pdf");
// Add text stamp/watermark
var textStamper = new TextStamper()
{
Text = "Watermark Text",
FontSize = 20,
FontFamily = "Arial",
IsBold = true,
FontColor = IronSoftware.Drawing.Color.Red,
VerticalAlignment = VerticalAlignment.Middle,
HorizontalAlignment = HorizontalAlignment.Center
};
pdf.ApplyStamp(textStamper);
pdf.SaveAs("modified.pdf");
}
}PDFsharp nécessite l'ouverture du PDF avec PdfReader.Open() en spécifiant PdfDocumentOpenMode.Modify, accédant à une page, créer un objet XGraphics, créer un XFont avec style, et utiliser DrawString() avec un XPoint spécifiant des coordonnées X,Y exactes (200, 400).
IronPDF simplifie cela avec PdfDocument.FromFile(), un objet TextStamper avec des propriétés déclaratives (Text, FontSize, FontFamily, IsBold, FontColor, VerticalAlignment, HorizontalAlignment), et ApplyStamp(). Aucun calcul de coordonnées n'est nécessaire : il suffit de spécifier l'alignement et IronPDF se charge du positionnement. Notez que le namespace IronPdf.Editing est requis pour la fonction de tamponnage.
Avant (PDFsharp) :
// NuGet: Install-Package PDFsharp (official PDFsharp-Team package, MIT)
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");
}
}Après (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// 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);
}
}PDFsharp nécessite de créer un nouveau PdfDocument, ajouter un PdfPage, obtenir XGraphics, charger un XImage à partir du fichier, calculer la largeur et la hauteur, utiliser DrawImage() avec des coordonnées exactes (50, 50, 200, 200), puis ajouter séparément du texte avec DrawString().
IronPDF utilise le HTML standard avec une balise <img> et du style CSS (style='width:200px; height:200px;'). Aucun calcul de coordonnées n'est nécessaire - la mise en page est gérée par CSS. IronPDF propose également ImageStamper pour ajouter des images aux PDFs existants avec des propriétés d'alignement déclaratives. Pour en savoir plus, consultez nos tutoriels.
Le changement le plus important est le passage du dessin basé sur les coordonnées à HTML/CSS :
// PDFsharp: manual positioning
gfx.DrawString("Invoice", titleFont, XBrushes.Black, new XPoint(50, 50));
gfx.DrawString("Customer: John", bodyFont, XBrushes.Black, new XPoint(50, 80));
// IronPDF: let CSS handle layout
var html = @"
<div style='padding: 50px;'>
<h1>Invoice</h1>
<p>Customer: John</p>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html);Imports PdfSharp.Drawing
Imports IronPdf
' PDFsharp: manual positioning
gfx.DrawString("Invoice", titleFont, XBrushes.Black, New XPoint(50, 50))
gfx.DrawString("Customer: John", bodyFont, XBrushes.Black, New XPoint(50, 80))
' IronPDF: let CSS handle layout
Dim html As String = "
<div style='padding: 50px;'>
<h1>Invoice</h1>
<p>Customer: John</p>
</div>"
Dim pdf = renderer.RenderHtmlAsPdf(html)// PDFsharp: XFont objects (PDFsharp 6.x renamed XFontStyle to XFontStyleEx)
var titleFont = new XFont("Arial", 24, XFontStyleEx.Bold);
var bodyFont = new XFont("Times New Roman", 12);
// IronPDF: CSS font properties
var html = @"
<style>
h1 { font-family: Arial, sans-serif; font-size: 24px; font-weight: bold; }
p { font-family: 'Times New Roman', serif; font-size: 12px; }
</style>";' PDFsharp: XFont objects (PDFsharp 6.x renamed XFontStyle to XFontStyleEx)
Dim titleFont As New XFont("Arial", 24, XFontStyleEx.Bold)
Dim bodyFont As New XFont("Times New Roman", 12)
' IronPDF: CSS font properties
Dim html As String = "
<style>
h1 { font-family: Arial, sans-serif; font-size: 24px; font-weight: bold; }
p { font-family: 'Times New Roman', serif; font-size: 12px; }
</style>"// PDFsharp: PdfReader.Open()
PdfDocument document = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify);
// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("existing.pdf");Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Imports IronPdf
' PDFsharp: PdfReader.Open()
Dim document As PdfDocument = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify)
' IronPDF: PdfDocument.FromFile()
Dim pdf As PdfDocument = PdfDocument.FromFile("existing.pdf")// PDFsharp: document.Save()
document.Save("output.pdf");
// IronPDF: pdf.SaveAs()
pdf.SaveAs("output.pdf");' PDFsharp: document.Save()
document.Save("output.pdf")
' IronPDF: pdf.SaveAs()
pdf.SaveAs("output.pdf")// PDFsharp: document.Pages[0]
PdfPage page = document.Pages[0];
// IronPDF: Automatique page handling or pdf.Pages[0]
// Pages are created automatically from HTML contentAprès avoir migré vers IronPDF, vous acquérez des capacités que PDFsharp ne peut pas fournir :
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Modern Web Content</h1>");Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Modern Web Content</h1>")var pdf = renderer.RenderUrlAsPdf("https://example.com");Dim pdf = renderer.RenderUrlAsPdf("https://example.com")var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")| Fonction | PDFsharp | IronPDF |
|---|---|---|
| Dessin à base de coordonnées | ✓ | ✗(utiliser HTML) |
| HTML vers PDF | ✗ | ✓ |
| Prise en charge CSS3 | ✗ | ✓ |
| Mise en page Flexbox/grille | ✗ | ✓ |
| Estampillage de texte | Manuel XGraphics | TextStamper |
| Estampillage d'images | Manuel XImage | ImageStamper |
| Fusionner des PDF | Manuel | ✓ |
| URL vers PDF | ✗ | ✓ |
| Rendu Web moderne | ✗ | Moteur Chromium |
| Sauts de page automatiques | ✗ | ✓ |
PDFsharp (package officiel de l'équipe PDFsharp)PDFsharp-WPF, PDFsharp-GDI, ou PDFsharp-MigraDoc si utilisésPdfSharpCore si vous utilisiez le port communauté .NET StandardIronPdf: dotnet add package IronPdfusing PdfSharp.Pdf; → using IronPdf;)using IronPdf.Editing; pour la fonction de tamponnageXFont par des propriétés de police CSSXPen par des couleurs/bordures CSSXGraphics.DrawString() par des éléments de texte HTMLXGraphics.DrawImage() par des balises HTML <img>PdfReader.Open() par PdfDocument.FromFile()document.Save() par pdf.SaveAs()
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
