Guide de démarrage rapide d'IronPDF
Installez IronPDF et créez votre premier PDF en seulement cinq minutes. Grâce à son API simple, vous pouvez convertir des fichiers HTML, DOCX, des images et bien d'autres choses encore en PDF parfaits au pixel près.
1. Prérequis
- .NET Framework 4.6.2+ OU .NET Core 3.1+ OU .NET 5+
- Redistributable Visual C++ (pour Windows).
2. Installer IronPDF
L'installation standard d'IronPDF s'exécute localement. Si vous souhaitez déployer sur Docker/microservices, consultez le Guide du mode moteur à distance.
-
Installez IronPDF avec le Gestionnaire de Packages NuGet
PM > Install-Package IronPdf -
Copiez et exécutez cet extrait de code.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf"); -
Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit
Accédez à la bibliothèque NuGet d'IronPDF:
- Dans l'Explorateur de solutions, faites un clic droit sur Références
- Sélectionnez 'Gérer les paquets NuGet' > 'Parcourir' > Rechercher IronPDF
Install-Package IronPdf
- Télécharger le package DLL IronPDF
- Décompressez le fichier ZIP correspondant à votre système d'exploitation dans un emplacement situé dans votre répertoire Solution
- Dans l'explorateur de solutions de Visual Studio, cliquez avec le bouton droit de la souris sur "Dépendances
- ajouter une référence de projet" > Sélectionnez "Parcourir" pour inclure toutes les DLL extraites du fichier zip.
Guides spécifiques à la plateforme
3. Appliquer la clé de licence
Lorsque vous achetez des licences IronPDF ou choisissez de commencer avec un essai de 30 jours, une clé de licence sera envoyée à votre email. Copiez la clé et ajoutez-la au début de votre application.
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
4. Créez votre premier PDF
Ajoutez ceci en haut de votre fichier .cs.
using IronPdf;
using IronPdf;
Imports IronPdf
La façon la plus simple de créer un objet PDF utilise uniquement la largeur et la hauteur. Ce constructeur PdfDocument crée un PDF vierge, prêt à être personnalisé.
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
À l'aide de la méthode ChromePdfRenderer.RenderHtmlAsPdf, vous pouvez convertir n'importe quel code HTML (y compris HTML5) en PDF à l'aide du moteur Chromium intégré.
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
Imports IronPdf
IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
Convertissez des documents Word en PDF à l'aide de la classe DocxToPdfRenderer ; vous pouvez ainsi convertir des fichiers DOCX directement en PDF personnalisables pour une intégration transparente dans les applications .NET.
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf
Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
5. Exemples plus avancés
En plus de la création et de la conversion simples de PDF, IronPDF offre également des options de personnalisation PDF plus puissantes.
Créez des en-têtes ou des pieds de page en instanciant TextHeaderFooter, en ajoutant votre texte et en l'attachant au PDF.
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")
Masquez facilement du texte à l'aide de RedactTextOnAllPages pour supprimer une phrase dans l'ensemble du document.
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")
' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")
pdf.SaveAs("redacted.pdf")
Fusionnez deux fichiers PDF en C# à l'aide de la méthode Merge. Utilisez ReplaceTextOnAllPages sur tout PdfDocument, nouveau ou importé, pour remplacer l'ancien texte par le nouveau.
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
Imports IronPdf
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Private oldText As String = ".NET6"
Private newText As String = ".NET7"
' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)
pdf.SaveAs("replaceText.pdf")
Résolution rapide de problèmes
| Enjeu | Solution |
|---|---|
| Manque le Runtime Visual C# | Installer Visual C# Redistributable - versions x86 et x64 requises pour le moteur Chrome |
| Licence non reconnue | Vérifiez avec la propriété IronPdf.License.IsLicensed. Veillez à ce que la licence soit appliquée avant toute opération d'IronPDF |
| Premier rendu lent | Appeler IronPdf.Installation.Initialize() au démarrage pour pré-initialiser les moteurs de rendu |
| Dépendances Linux/Docker | Définissez Installation.LinuxAndDockerDependenciesAutoConfig = true pour l'installation automatique des dépendances |
Prochaines étapes
Questions Fréquemment Posées
Comment puis-je configurer IronPDFEngine pour la génération de PDF à distance ?
Pour configurer IronPDFEngine pour la génération de PDF à distance, installez le package IronPdf.Slim depuis NuGet et configurez les paramètres de connexion en utilisant la classe IronPDFConnectionConfiguration. Cette configuration vous permet de connecter votre application à l'instance IronPDFEngine à distance.
Quels sont les principaux avantages de l'utilisation d'IronPDFEngine avec mon application ?
L'utilisation d'IronPDFEngine avec votre application permet l'exécution à distance de tâches PDF, aidant à éviter les problèmes de compatibilité spécifiques à la plateforme, surtout sur d'anciens systèmes et plateformes mobiles. Elle élimine également le besoin du runtime .NET pendant l'exécution.
Pourquoi pourrais-je choisir d'utiliser IronPDFEngine au lieu de la bibliothèque PDF native ?
Vous pourriez choisir IronPDFEngine pour exécuter des fonctions PDF intensives en performance à distance, réduisant les problèmes de compatibilité avec différents systèmes d'exploitation et améliorant les performances en utilisant un moteur identique à Chrome pour la conversion HTML en PDF.
Le scaling horizontal est-il pris en charge par IronPDFEngine ?
Non, IronPDFEngine ne prend actuellement pas en charge le scaling horizontal, ce qui signifie qu'il ne peut pas être équilibré en charge sur plusieurs instances en raison de la façon dont les binaires de fichiers PDF sont gérés en mémoire serveur.
IronPDFEngine peut-il fonctionner sur différents systèmes d'exploitation ?
IronPDFEngine est conçu pour fonctionner sur des systèmes Linux en utilisant des conteneurs Docker. Cependant, les binaires sont spécifiques à chaque plateforme, vous devez donc vous assurer d'utiliser la version correcte pour votre système d'exploitation.
Que dois-je faire si mes sorties PDF sont différentes lorsque j'utilise IronPDFEngine ?
Les sorties PDF peuvent varier légèrement en raison des comportements différents du système d'exploitation. Pour minimiser les différences, assurez-vous d'utiliser l'image Docker correcte et vérifiez les configurations spécifiques à l'OS pouvant affecter le rendu.
Comment puis-je m'assurer que mon application utilise la bonne version d'IronPDFEngine ?
Pour assurer la compatibilité, chaque version de IronPDF nécessite une version correspondante d'IronPDFEngine. Assurez-vous de mettre à jour les deux composants simultanément pour éviter les problèmes de version croisée.
Quelles sont les limitations de l'utilisation d'IronPDFEngine sur Windows ?
Lors de l'utilisation d'IronPDFEngine sur Windows, vous avez besoin des conteneurs Linux pour Docker et devez vous assurer que le port serveur est accessible. Les binaires sont spécifiques à la plateforme, et passer aux conteneurs Linux est requis.
Comment puis-je configurer IronPDF pour se connecter à un serveur IronPDFEngine distant ?
Pour configurer IronPDF pour un serveur distant, utilisez Installation.ConnectToIronPDFHost avec la méthode IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer, en spécifiant l'IP et les détails du port du serveur.
Quel package devrais-je utiliser pour minimiser la taille de l'application lors de l'utilisation d'IronPDFEngine ?
Vous devriez utiliser le package IronPdf.Slim depuis NuGet, car il inclut seulement les composants nécessaires pour exécuter IronPDF avec IronPDFEngine, réduisant ainsi la taille de l'application.

