Comprendre PeachPDF

PeachPDF est un outil relativement nouveau dans l'écosystème .NET, conçu pour les développeurs qui ont besoin de convertir du HTML en PDF. En tant que bibliothèque, PeachPDFpromet une implémentation .NET pure, se distinguant par le fait qu'elle ne dépend pas de processus externes, ce qui garantit qu'elle peut être intégrée de manière transparente sur toutes les plateformes où .NET est pris en charge. Cette caractéristique positionne PeachPDFcomme un choix attrayant pour les projets à la recherche d'une solution de bibliothèque gérée et légère.

Malgré son potentiel, PeachPDFest encore en cours de développement, ce qui met en évidence à la fois des possibilités intéressantes et des limites notables. PeachPDFreste attrayant en raison de son noyau .NET pur, qui promet un déploiement simple dans divers environnements. Toutefois, cela se traduit également par une adoption limitée, avec une base d'utilisateurs plus restreinte et un soutien communautaire.

Les limites de PeachPDF

PeachPDF est une bibliothèque PDF relativement nouvelle et peu connue qui n'a pas la maturité, les fonctionnalités et le support des solutions établies. Principales raisons de migrer :

1. Fonctionnalités limitées : PeachPDFne dispose pas de fonctionnalités avancées telles que les signatures numériques, la conformité PDF/Aet l'extraction de texte sophistiquée.

2. Petite communauté : Documentation, exemples et soutien communautaire limités. Avec une base d'utilisateurs réduite, le soutien de la communauté peut être rare, ce qui rend difficile l'obtention d'une assistance ou la recherche d'une documentation complète.

3. Avenir incertain : les nouvelles bibliothèques qui n'ont pas fait leurs preuves comportent un risque d'adoption.

4. Support HTML de base : Capacités de rendu CSS et JavaScriptlimitées.

5. Pas d'assistance aux entreprises : Pas d'assistance professionnelle ni d'options de SLA.

Comparaison PeachPDFvs IronPDF

IronPDF se distingue par des fonctionnalités plus larges, prenant en charge non seulement les conversions HTML vers PDF, mais aussi l'OCR, le filigrane et d'autres fonctions avancées. Sa structure d'assistance professionnelle est un avantage certain, offrant des résolutions rapides aux problèmes rencontrés par les développeurs.

Pour les équipes qui prévoient l'adoption de .NET 10 et C# 14 jusqu'en 2025 et 2026,IronPDFoffre des fonctionnalités complètes et une maintenance active qui garantissent une stabilité et une compatibilité à long terme avec les frameworks .NET modernes.

Prérequis

1. Environnement .NET : .NET Framework 4.6.2+ ou .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Accès NuGet : Capacité à installer des paquets NuGet
3. Licence IronPDF : Obtenez votre clé de licence sur ironpdf.com

Modifications du paquet NuGet

# Remove PeachPDF
dotnet remove package PeachPDF

# Install IronPDF
dotnet add package IronPdf

# Remove PeachPDF
dotnet remove package PeachPDF

# Install IronPDF
dotnet add package IronPdf

Configuration de la licence

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

Identifier l'utilisation de PeachPDF

# Audit PeachPDFusage in codebase
grep -r "using PeachPDF" --include="*.cs" .
grep -r "HtmlToPdfConverter\|Convert\|ConvertUrl" --include="*.cs" .

# Audit PeachPDFusage in codebase
grep -r "using PeachPDF" --include="*.cs" .
grep -r "HtmlToPdfConverter\|Convert\|ConvertUrl" --include="*.cs" .

Modifications de l'espace de nommage

// Before: PeachPDF
using PeachPDF;
using System.IO;

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

// Before: PeachPDF
using PeachPDF;
using System.IO;

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mappages de l'API de base

Exemple 1 : Conversion d'une chaîne HTML en fichier PDF

Avant (PeachPDF):

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.Convert(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.Convert(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

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

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

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Cet exemple illustre la différence fondamentale entre les deux bibliothèques. PeachPDFutilise HtmlToPdfConverter avec une méthode Convert() qui renvoie un byte[], nécessitant File.WriteAllBytes()pour l'enregistrement.IronPDFutilise ChromePdfRenderer avec RenderHtmlAsPdf() qui renvoie un objet PdfDocument avec une méthode intégrée SaveAs().

Les principaux avantages de l'approche d'IronPDF : l'objet PdfDocument peut être manipulé davantage (ajout de filigranes, fusion, paramètres de sécurité) avant l'enregistrement, alors que le tableau d'octets de PeachPDFest une sortie finale. L'approche d'IronPDF offre une syntaxe plus propre et une meilleure intégration avec les applications .NET modernes. Consultez la documentation HTML vers PDF pour des exemples complets.

Exemple 2 : Conversion d'une URL en PDF

Avant (PeachPDF):

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        var pdf = converter.ConvertUrl(url);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        var pdf = converter.ConvertUrl(url);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (IronPDF):

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

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

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

PeachPDF utilise ConvertUrl() tandis qu'IronPDF utilise RenderUrlAsPdf(). Le nommage des méthodes dansIronPDFest plus descriptif : il indique explicitement qu'une URL est rendue sous forme de PDF. Les deux bibliothèques gèrent la conversion d'URL en PDF de manière similaire, mais le moteur Chromium complet d'IronPDF offre un rendu supérieur des pages web modernes avec CSS et JavaScriptcomplexes. Pour en savoir plus, consultez nos tutoriels.

Exemple 3 : Ajout d'en-têtes et de pieds de page

Avant (PeachPDF):

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.Header = "<div style='text-align:center'>My Header</div>";
        converter.Footer = "<div style='text-align:center'>Page {page}</div>";
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = converter.Convert(html);
        File.WriteAllBytes("document.pdf", pdf);
    }
}

using PeachPDF;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.Header = "<div style='text-align:center'>My Header</div>";
        converter.Footer = "<div style='text-align:center'>Page {page}</div>";
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = converter.Convert(html);
        File.WriteAllBytes("document.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Après (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'>My Header</div>" };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>Page {page}</div>" };
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

// 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'>My Header</div>" };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = "<div style='text-align:center'>Page {page}</div>" };
        var html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Cet exemple illustre une différence architecturale essentielle. PeachPDFutilise des propriétés de chaînes simples (converter.Header et converter.Footer) pour les en-têtes et les pieds de page.IronPDFutilise des objets HtmlHeaderFooter affectés aux RenderingOptions.HtmlHeader et RenderingOptions.HtmlFooter.

L'approcheIronPDFoffre plus de flexibilité - les objets HtmlHeaderFooter peuvent inclure des propriétés supplémentaires comme MaxHeight pour contrôler la taille de l'en-tête/du pied de page. Notez que les deux bibliothèques utilisent {page} comme espace réservé au numéro de page.IronPDFprend également en charge {total-pages} pour le nombre total de pages.

Notez l'espace de noms supplémentaire requis pour IronPdf : utilisant IronPdf.Rendering; est nécessaire pour la classe HtmlHeaderFooter.

Changement de classe de convertisseur

PeachPDF utilise HtmlToPdfConverter ;IronPDFutilise ChromePdfRenderer :

// PeachPDF
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

// PeachPDF
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Changement de type de retour

PeachPDF retourne byte[] ;IronPDFrenvoie PdfDocument :

// PeachPDF: Returns byte array
byte[] pdf = converter.Convert(html);
File.WriteAllBytes("output.pdf", pdf);

// IronPDF: Returns PdfDocument object
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or get bytes: byte[] bytes = pdf.BinaryData;

// PeachPDF: Returns byte array
byte[] pdf = converter.Convert(html);
File.WriteAllBytes("output.pdf", pdf);

// IronPDF: Returns PdfDocument object
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or get bytes: byte[] bytes = pdf.BinaryData;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Modification de la propriété de l'en-tête/du pied de page

// PeachPDF: Simple string properties
converter.Header = "<div>Header</div>";
converter.Footer = "<div>Footer</div>";

// IronPDF: HtmlHeaderFooter objects
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter() 
{ 
    HtmlFragment = "<div>Header</div>" 
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() 
{ 
    HtmlFragment = "<div>Footer</div>" 
};

// PeachPDF: Simple string properties
converter.Header = "<div>Header</div>";
converter.Footer = "<div>Footer</div>";

// IronPDF: HtmlHeaderFooter objects
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter() 
{ 
    HtmlFragment = "<div>Header</div>" 
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter() 
{ 
    HtmlFragment = "<div>Footer</div>" 
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

Modification des noms de méthode

Fusion de fichiers PDF

var pdf1 = PdfDocument.FromFile("doc1.pdf");
var pdf2 = PdfDocument.FromFile("doc2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("doc1.pdf");
var pdf2 = PdfDocument.FromFile("doc2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

CONVERTER NOT RUNNING

Les filigranes avec HTML

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<div style='color: red; font-size: 48pt;'>DRAFT</div>");
pdf.SaveAs("watermarked.pdf");

var pdf = PdfDocument.FromFile("document.pdf");
pdf.ApplyWatermark("<div style='color: red; font-size: 48pt;'>DRAFT</div>");
pdf.SaveAs("watermarked.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Protection par mot de passe

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>");

pdf.SecuritySettings.OwnerPassword = "owner123";
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;

pdf.SaveAs("protected.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential</h1>");

pdf.SecuritySettings.OwnerPassword = "owner123";
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint;

pdf.SaveAs("protected.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Signatures numériques

using IronPdf.Signing;

var pdf = PdfDocument.FromFile("document.pdf");
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningReason = "Document Approval",
    SigningLocation = "New York"
};
pdf.Sign(signature);
pdf.SaveAs("signed.pdf");

using IronPdf.Signing;

var pdf = PdfDocument.FromFile("document.pdf");
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningReason = "Document Approval",
    SigningLocation = "New York"
};
pdf.Sign(signature);
pdf.SaveAs("signed.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Opérations asynchrones

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Async PDF</h1>");
pdf.SaveAs("async_output.pdf");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Async PDF</h1>");
pdf.SaveAs("async_output.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Enjeu 1 : Modèle d'API différent

Problème: PeachPDFutilise un modèle de convertisseur avec sortie de tableau d'octets ;IronPDFutilise un modèle de rendu avec sortie PdfDocument.

Solution:

// PeachPDFpattern
var converter = new HtmlToPdfConverter();
var pdf = converter.Convert(html);
File.WriteAllBytes(path, pdf);

//IronPDFpattern
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

// PeachPDFpattern
var converter = new HtmlToPdfConverter();
var pdf = converter.Convert(html);
File.WriteAllBytes(path, pdf);

//IronPDFpattern
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Enjeu 2 : Différence de méthode de sauvegarde

Problème: PeachPDFnécessite File.WriteAllBytes();IronPDFdispose d'un SaveAs()intégré.

Solution: Remplacez File.WriteAllBytes("path", pdf) par pdf.SaveAs("path").

Sujet 3 : Objets d'en-tête et de pied de page

Problème: PeachPDFutilise des propriétés de chaînes de caractères ;IronPDFutilise des propriétés d'objet.

Solution:Enveloppez les chaînes HTML dans les objets HtmlHeaderFooter avec la propriété HtmlFragment.

Pré-migration

• [Audit de l'utilisation de PeachPDFdans la base de code
• [Documenter les configurations personnalisées
• [Les traductions doivent rester professionnelles, tout en préservant l'exactitude technique et en expliquant les caractéristiques et les avantages de ces outils de développement
• [ ] Obtenir la clé de licenceIronPDFà partir de ironpdf.com
• [Testez d'abord avec la licence d'essai d'IronPDF

Modifications du paquet

• supprimer le package NuGet PeachPDF [ ]
• [Installer le package NuGet IronPdf : dotnet add package IronPdf

Modifications du code

• [Mise à jour des importations d'espaces de noms (utilisant PeachPDF; → utilisant IronPdf;)
• [Ajouter utilisant IronPdf.Rendering; pour la fonctionnalité d'en-tête/pied de page
• [Remplacer HtmlToPdfConverter par ChromePdfRenderer
• [Remplacer converter.Convert(html)par renderer.RenderHtmlAsPdf(html)
• [Remplacer converter.ConvertUrl(url)par renderer.RenderUrlAsPdf(url)
• [Remplacer File.WriteAllBytes(path, pdf)par pdf.SaveAs(path)
• [Remplacer converter.Header/Footer par des objets RenderingOptions.HtmlHeader/HtmlFooter
• [Ajouter l'initialisation de la licence au démarrage de l'application

Post-Migration

• [Test de la qualité du rendu HTML
• [Vérifier que la sortie PDF correspond aux attentes
• [Test du rendu de l'en-tête/du pied de page avec les numéros de page
• [Ajouter de nouvelles fonctionnalités (sécurité, filigrane, fusion) selon les besoins