Comment commencer avec la bibliothèque PDF C# IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF est notre bibliothèque logicielle complète et polyvalente qui vous offre un contrôle granulaire total sur la génération, la modification et l'exportation de fichiers PDF dans votre projet ou flux de travail. Ainsi que chaque aspect et détail dans sa sortie.

Avec cet outil puissant, bénéficiant d'un support dans une variété de langages tels que C#, F#, VB.NET, Java, et plus encore. C'est la meilleure solution pour vos problèmes de PDF. Cet article explique la méthode d'installation de C# IronPDF.

Le logiciel gratuit pour le développement est disponible via NuGet et téléchargement direct. Suivez les instructions ci-dessous pour commencer à convertir HTML en PDF dans votre projet .NET.

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer

Comment installer IronPDF : Choisir le bon mode : Natif vs Distant

IronPDF propose deux modes pour le rendu des PDF -- Mode Natif et Mode À Distance -- adaptés pour différents environnements de développement :

Mode Natif : Idéal pour les développeurs souhaitant tout exécuter localement, adapté aux déploiements modernes sur Windows, macOS et Linux. Installez simplement le package suivant :

  • IronPdf

    Mode à distance (IronPdfEngine) : Idéal pour les environnements cloud et conteneurisés comme Azure, AWS et Docker, où les dépendances peuvent être gérées de manière centralisée. Aussi idéal pour les systèmes d'exploitation nativement non pris en charge ou obsolètes tels que Windows Server 2012 et les distributions Linux moins populaires. Il suffit d'installer le package suivant dans votre projet et de se connecter au conteneur IronPdfEngine :

  • IronPdf.Slim

Utilisez IronPDF avec Remote Engine

A noter
Quelle est la différence entre Native & Engine ?

IronPDF dispose de certaines fonctions nécessitant une performance intensive que vous pouvez choisir d'exécuter à distance. Bien qu'IronPDF ne nécessite pas IronPdfEngine pour fonctionner, configurer IronPdfEngine en tant que service distant est une option permettant d'éviter les problèmes de compatibilité spécifiques à la plateforme avec Chrome sur les systèmes d'exploitation plus anciens et les environnements mobiles.

Comment l'utilisation d'Engine change-t-elle ma manière de coder avec IronPDF ?

Lors de l'utilisation de la configuration Engine, nous recommandons d'installer IronPdf.Slim au lieu du package complet IronPdf depuis NuGet, car l'Engine gère tout le volume supplémentaire inclus dans le package Native.

PM> Install-Package IronPdf.Slim

Après avoir installé IronPdf.Slim, configurez les paramètres de connexion en pointant IronPDF vers votre instance IronPdfEngine. Ajoutez le code suivant au démarrage de votre application (ou avant d'appeler toute méthode IronPDF) :

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
$vbLabelText   $csharpLabel

Comment installer la bibliothèque IronPDF dans un projet .NET (Natif)

L'installation de la bibliothèque PDF C# est simple et prend moins de 5 minutes.

Le logiciel de développement gratuit est disponible via NuGet et en téléchargement direct, et ce tutoriel vous permettra d'être opérationnel dans Visual Studio. Suivez les instructions ci-dessous pour commencer à convertir HTML en PDF dans votre projet .NET.


Comment faire Tutoriel

Méthode 1 : Installer IronPDF via NuGet

Utilisez les étapes suivantes pour installer la bibliothèque NuGet IronPDF depuis Visual Studio.

  1. Dans l'explorateur de solutions, cliquez avec le bouton droit de la souris sur References, Manage NuGet Packages

  2. Sélectionnez Parcourir et recherchez IronPdf

  3. Sélectionnez le paquet et installez-le.
Install-Package IronPdf

Il existe également des packages NuGet IronPDF disponibles pour des déploiements spécifiques sur Mac, Linux, Azure, Docker et AWS, documentés dans notre guide avancé d'installation NuGet IronPDF.


Méthode 2 : Installer IronPDF par téléchargement de DLL

La deuxième façon d'installer IronPDF est de le télécharger. Suivez ces étapes simples et rapides :

Voici d'autres paquets zip de DLL IronPDF disponibles pour des plates-formes spécifiques :

Système d'exploitation
  • Téléchargez et décompressez le fichier ZIP approprié pour votre système d'exploitation à un emplacement tel que ~/Libs dans votre répertoire Solution.
  • Dans l'explorateur de solutions de Visual Studio, faites un clic droit sur "Dépendances" et "Ajouter une référence de projet". Sélectionnez Browse et incluez tous les fichiers dll extraits du zip.

Appliquer la clé de licence

Incluez ce code au démarrage de votre application, avant d'utiliser IronPDF. Cette approche est universellement efficace et facile à mettre en œuvre.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

Si vous préférez ne pas appliquer la clé de licence en utilisant du code en ligne, veuillez visiter l'article 'IronPDF License Keys' pour explorer des méthodes alternatives.


2. Accorder l'accès nécessaire à un fichier ou à un dossier

Il peut parfois être nécessaire d'ajouter des autorisations à certains utilisateurs ou rôles sur votre PC.

Par exemple, chaque AppDomain nécessite son propre TempFolderPath et les applications dans le même AppPool ne peuvent pas partager un TempFolderPath.

Qu'est-ce que cela signifie ?

Un AppDomain fournit simplement une couche d'isolation au sein d'un certain processus. Tout ce que vous considérez comme un programme est en réalité un domaine d'application. Chacune de ces applications dans le même pool d'applications nécessite son propre dossier temporaire afin de fonctionner de manière totalement indépendante.

Si cela s'avère nécessaire pour l'une des options de dépannage susmentionnées, vous pouvez définir les autorisations de la manière suivante :

  1. Cliquer avec le bouton droit de la souris sur un fichier ou un dossier

  2. Sélectionner les propriétés

  3. Sélectionner la sécurité

  4. Cliquez sur Modifier...

  5. Sélectionnez les autorisations souhaitées.


3. Définir le chemin d'installation

Pour convertir HTML en PDF, IronPDF doit intégrer Chromium, qui est un navigateur web sécurisé. Heureusement, ce processus est entièrement automatisé.

Si HTML to PDF d'IronPDF génère une exception de type "failed rendering", ce qui est très peu probable, vous devrez peut-être décompresser les binaires natifs du navigateur à un emplacement approprié. Le dossier Temp est normalement idéal.

Remarque : Program Files n'est jamais un emplacement approprié.

Réglage de IronPDF.Installation.TempFolderPath

Vous pouvez décompresser à l'emplacement approprié en définissant la propriété TempFolderPath de l'objet IronPdf.Installation comme indiqué ici :

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

Après avoir mis à jour un chemin d'accès, n'oubliez pas d'effacer tous les dossiers temporaires et les dossiers de cache sur vos serveurs de développement et vos serveurs. Redéployez une version PROPRE de votre application.

Définition de la variable d'environnement Temp Folder au niveau de l'application

IronPDF peut occasionnellement générer des fichiers temporaires lors du rendu et de l'édition de documents PDF dans un dossier temporaire du système. Nous pouvons définir IronPdf.Installation.TempFolderPath pour contourner ce problème, mais le répertoire TempPath de l'environnement peut encore être utilisé par des paquets tiers.

Pour résoudre ce problème, nous pouvons définir la variable d'environnement TempPath à l'échelle de l'application lors du démarrage de l'application C#. Cela garantit que tous les fichiers temporaires créés par votre application sont stockés dans un emplacement contrôlable.

using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf

' Set Application scope Temp Files Path.
' This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
Private MyTempPath = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code here..E.G.
Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
$vbLabelText   $csharpLabel

4. Permissions et IIS

Dans le cas où le serveur a été verrouillé, il peut être nécessaire de donner à l'utilisateur IIS (IUSER) des autorisations de lecture et d'écriture pour votre dossier de chemin d'installation, ainsi que pour vos dossiers Windows et Temp.


5. Compatibilité Microsoft Visual C# et Windows

IronPDF nécessite l'installation de Microsoft Visual C# sur la machine Windows cible. Il peut être intégré à un programme d'installation d'application tel qu'un MSI si nécessaire.

Microsoft Visual C# est un composant Windows et est normalement présent sur les versions modernes de Windows, à moins qu'elles n'aient été délibérément dépouillées.

Le .NET Framework peut fonctionner en tant que 32 bits (même sur des plateformes 64 bits), il est donc nécessaire d'installer Visual C++ en versions 32 et 64 bits.

Vous pouvez télécharger Microsoft Visual C++ ici.


6. Compatibilité avec Linux

7. Compatibilité Docker

8. Compatibilité Azure

9. Compatibilité Amazon AWS Lambda

10. compatibilité macOS