1. IronPDF
2. Comment faire
3. Installation

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

Installation de laBibliothèque PDF C# prend moins de 5 minutes.

Le logiciel libre de développement est disponible via NuGet et en téléchargement direct, et avec ce tutoriel, nous allons vous permettre 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#

• Installation via NuGet
• Installer par téléchargement direct
• Accorder l'accès au bon chemin ou dossier
• Définir le chemin d'installation
• Bénéficier d'une assistance pour Docker, Linux et plus encore

Comment faire Tutoriel

1.1. Installer IronPDF via NuGet

Les étapes suivantes permettent d'installer leBibliothè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 deMac, Linux, L'azur, Docker et AWS documentés dans notreGuide 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 WindowsPaquet DLL 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 Parcourir et incluez toutes les DLL extraites du fichier zip.

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

   • Fenêtres
   • Linux
   • MacOS

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"

Si vous préférez ne pas appliquer la clé de licence à l'aide d'un code en ligne, veuillez consulter la page 'Guide des clés de licence IronPDFnous sommes à la recherche d'un traducteur 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, chaqueDomaine d'application nécessite sa propreChemin du dossier temporaire et les applications dans le mêmeAppPool 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

RendreHTML 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 baliseIronPdf.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. 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 parfois ê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 au 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");

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")

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 emballé avec 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 pouveztélécharger Microsoft Visual C# à partir de la page d'assistance officielle.

6. Compatibilité avec Linux

• IronPDF est compatible avec Linux. Nous soutenons officiellement :Ubuntu, Debian, CentOS, Fedora et Amazon Linux 2.
• Déploiement d'IronPdf sur des environnements Linux est bien documenté et constitue un choix populaire pour les déploiements en nuage tels qu'Azure.

7. Compatibilité Docker

• Déployer IronPdf sur des conteneurs Docker est bien documentée.
• Nous supportons officiellement Docker pour : Windows, Ubuntu, Debian, CentOS et Amazon Linux 2 et fournissonsfichiers Docker de travail pour le déploiement.

8. Compatibilité Azure

• Support officiel pour Azure WebApps, Azure WebJobs, Azure Functions, et Azure Docker instances et Azure VMs.
• Lire l'IronPDFGuide d'installation d'Azure et d'Azure Function.

9. Compatibilité Amazon AWS Lambda

• Atutoriel complet et support pour Amazon AWS Lambda est inclus.

10. compatibilité macOS

• Prise en charge officielle des déploiements macOS l'utilisation de Rider et de "Visual Studio for Mac" pour le développement de logiciels est prise en charge.
• Veuillez lire notreguide complet de macOS.