1. IronPDF
  2. Commencer
  3. Guide de démarrage rapide

IronPDF Quickstart Guide

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Installez IronPDF et créez votre premier PDF en seulement cinq minutes. Avec son API simple, vous pouvez convertir HTML, DOCX, images, et plus encore en PDFs parfaitement fidèles.

1. Prérequis

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.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
data-active-tab="1">
class="options-installation__tabs">
data-tab="1"> Gestionnaire de paquets NuGet
data-tab="2"> Télécharger DLL
data-tab="1">
data-tab="2">
id="nuget-package-manager-start">

Accédez à la bibliothèque NuGet IronPDF:

  1. Dans l'Explorateur de solutions, faites un clic droit sur Références
  2. Sélectionnez 'Gérer les paquets NuGet' > 'Parcourir' > Recherchez IronPdf
Install-Package IronPdf
id="nuget-package-manager-end">
id="dll-download-start">
  • Téléchargez le paquet DLL IronPDF
  • Décompressez le fichier ZIP pour votre système d'exploitation à un emplacement dans le répertoire de votre Solution
  • Dans l'Explorateur de Solutions Visual Studio, faites un clic droit sur 'Dépendances'
  • 'Ajouter une référence de projet' > Sélectionnez 'Parcourir' pour inclure toutes les DLLs extraites du zip.

class="related-link">EN RELATION: Plus d'informations sur les paramètres de configuration

id="dll-download-end">

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"
$vbLabelText   $csharpLabel

class="related-link">Voir la licence IronPDF

4. Créez votre premier PDF

class="related-link">IronPDF vous aide à créer des PDFs ou à convertir HTML, DOCX, RTF, Markdown et images en PDFs avec une fidélité totale. Explorez plus de types de conversions de PDF

Ajoutez ceci en haut de votre fichier .cs.

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel
data-active-tab="1">
class="options-installation__tabs">
data-tab="1"> Créer un PDF vierge
data-tab="2"> Convertir une chaîne HTML en PDF
data-tab="3"> Convertir DOCX en PDF
data-tab="1">
data-tab="2">
data-tab="3">
id="create-a-blank-pdf-start">

La manière 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 pour la personnalisation. 

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
id="create-a-blank-pdf-end">
id="convert-html-string-to-pdf-start">

En utilisant la méthode ChromePdfRenderer.RenderHtmlAsPdf, vous pouvez transformer n'importe quel HTML (y compris HTML5) en PDF en utilisant le 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

class="related-link">ARTICLE ASSOCIÉ : Comment convertir une chaîne HTML en PDF en C#

id="convert-html-string-to-pdf-end">
id="convert-docx-to-pdf-start">

Convertissez des documents Word en PDF avec la classe DocxToPdfRenderer, vous pouvez rendre les fichiers DOCX directement en PDFs 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")
$vbLabelText   $csharpLabel

class="related-link">ARTICLE ASSOCIÉ : Comment convertir Microsoft Word en PDF en C#

id="convert-docx-to-pdf-end">

5. Plus d'exemples 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.

data-active-tab="1">
class="options-installation__tabs">
data-tab="1"> Ajouter des en-têtes et pieds de page
data-tab="2"> Rendre un PDF
data-tab="3"> Fusionner des PDF
data-tab="1">
data-tab="2">
data-tab="3">
id="add-headers-and-footers-start">

Créez des en-têtes ou pieds de page texte 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

class="related-link">ARTICLE ASSOCIÉ : Comment ajouter des en-têtes et pieds de page

id="add-headers-and-footers-end">
id="redact-text-start">

Rendez le texte facilement en utilisant RedactTextOnAllPages pour supprimer une phrase à travers tout le 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")
$vbLabelText   $csharpLabel

class="related-link">ARTICLE ASSOCIÉ : Comment rendre une URL en PDF

id="redact-text-end">
id="merge-pdfs-start">

Fusionnez deux fichiers PDF en C# avec la méthode Merge. Utilisez ReplaceTextOnAllPages sur n'importe quel PdfDocument, nouveau ou importé, pour échanger un ancien texte avec un 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")
$vbLabelText   $csharpLabel

class="related-link">ARTICLE ASSOCIÉ : Comment fusionner ou diviser des PDFs

id="merge-pdfs-end">

Résolution rapide de problèmes

class="résolution-rapide-de-problèmes">
Problème Solution
Manque Runtime Visual C++ Installez le Redistributable Visual C++ - les versions x86 et x64 sont nécessaires pour le moteur Chrome
Licence non reconnue Vérifiez avec la propriété IronPdf.License.IsLicensed. Assurez-vous que la licence est appliquée avant toute opération IronPDF
Premier rendu lent Appelez IronPdf.Installation.Initialize() au démarrage pour pré-initialiser les moteurs de rendu
Dépendances Linux/Docker Réglez Installation.LinuxAndDockerDependenciesAutoConfig = true pour une installation automatique des dépendances

Étapes suivantes

class="next-step__card-info">
class="next-step__card-icon">
class="next-step__card-text">Modifier des PDFs

class="next-step__card-cta">Voir les fonctionnalités

class="next-step__card-info">
class="next-step__card-icon">
class="next-step__card-text">Organiser des PDFs

class="next-step__card-cta">Voir les fonctionnalités

class="next-step__card-info">
class="next-step__card-icon">
class="next-step__card-text">Signer et sécuriser des PDFs

class="next-step__card-cta">Voir les fonctionnalités

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.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

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

Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,133,208 | Version : 2025.11 vient de sortir