1. IronPDF
  2. Comment faire
  3. Installation

Comment installer la bibliothèque IronPDF pour .NET dans un projet .NET

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

Installation de la Bibliothèque PDF C# 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.

Installation pas à pas de la bibliothèque PDF C#

Comment faire Tutoriel

1.1. Installer IronPDF via NuGet

Les étapes suivantes permettent d'installer le Bibliothèque IronPDF NuGet à partir de 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 afin de Mac, Linux, L'azur, Docker et AWS documenté dans notre Guide d'installation avancée d'IronPDF sous NuGet.

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

  1. Téléchargez et décompressez le fichier Windows Fichier IronPDF à un emplacement tel que ~/Libs dans votre répertoire Solution

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

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

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 = "IRONPDF-MYLICENSE-KEY-1EF01";
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Si vous préférez ne pas appliquer la clé de licence à l'aide d'un code en ligne, veuillez consulter la page 'Clés de licence IronPDFl'article de la Commission européenne vise à explorer d'autres méthodes.

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 Domaine d'application nécessite sa propre Chemin du dossier temporaire et les applications dans le même AppPool ne peut 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

Rendre HTML en PDFironPDF doit intégrer Chromium, qui est un navigateur web sûr. 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 au bon endroit en définissant la propriété TempFolderPath de la balise 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 environnementale TempPath au niveau de l'application lors du démarrage de l'application C#. Cela permet de s'assurer 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

4. Permissions et IIS

Si le serveur a été verrouillé, il se peut que vous deviez donner à l'utilisateur IIS l'autorisation d'accéder au serveur (IUSER) les droits de lecture et d'écriture sur le dossier du chemin d'installation, ainsi que sur le dossier Windows et le dossier 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 Framework .NET peut être exécuté en tant qu'application 32 bits (même sur les plates-formes 64 bits)il est donc nécessaire d'installer Visual C# dans les versions 32 et 64 bits.

Ici, vous pouvez télécharger Microsoft Visual C#.

6. Compatibilité avec Linux

7. Compatibilité Docker

8. Compatibilité Azure

9. Compatibilité Amazon AWS Lambda

10. compatibilité macOS