Comment installer la bibliothèque IronPDF pour .NET dans un projet .NET
L'installation de la bibliothè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#
Comment faire Tutoriel
1.1. Installer IronPDF via NuGet
Utilisez les étapes suivantes pour installer la bibliothèque NuGet IronPDF depuis Visual Studio.
Dans l'explorateur de solutions, cliquez avec le bouton droit de la souris sur References, Manage NuGet Packages
Sélectionnez Parcourir et recherchez
"IronPdf"- Sélectionnez le paquet et installez-le.
Install-Package IronPdf
Des packages NuGet IronPDF sont également disponibles pour des déploiements spécifiques sur guide d'installation avancée NuGet IronPDF.
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 :
Téléchargez et décompressez le package DLL IronPDF pour Windows dans un emplacement tel que ~/Libs dans votre répertoire de 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 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 :
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 en utilisant du code en ligne, veuillez visiter le 'Guide des clés de licence IronPDF' 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 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 :
Cliquer avec le bouton droit de la souris sur un fichier ou un dossier
Sélectionner les propriétés
Sélectionner la sécurité
Cliquez sur Modifier..
- 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. 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 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")4. Permissions et IIS
Dans le cas où le serveur a été verrouillé, vous devrez peut-être donner à l'utilisateur IIS (IUSER) des autorisations de lecture et d'écriture sur votre dossier du chemin d'installation, ainsi que sur votre dossier 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 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 .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.
Ici, vous pouvez télécharger Microsoft Visual C++ depuis la page d'assistance officielle.
6. Compatibilité avec Linux
- IronPDF est compatible avec Linux. Nous prenons officiellement en charge : Ubuntu, Debian, CentOS, Fedora & Amazon Linux 2.
- Le déploiement de IronPDF sur des environnements Linux est bien documenté et est un choix populaire pour les déploiements cloud tels qu'Azure.
7. Compatibilité Docker
- Le déploiement d'IronPDF sur des conteneurs Docker est bien documenté.
- Nous prenons officiellement en charge Docker pour : Windows, Ubuntu, Debian, CentOS et Amazon Linux 2 et fournissons des fichiers Docker fonctionnels pour le déploiement.
8. Compatibilité Azure
- Support officiel pour Azure WebApps, Azure WebJobs, Azure Functions, et Azure Docker instances et Azure VMs.
- Lisez le Guide de configuration Azure et Azure Function de IronPDF.
9. Compatibilité Amazon AWS Lambda
- Un didacticiel complet et support pour Amazon AWS Lambda est inclus.
10. compatibilité macOS
- Support officiel pour les déploiements macOS et le développement utilisant Rider et "Visual Studio pour Mac" sont pris en charge.
- Veuillez lire notre guide complet pour macOS.
