Comment démarrer avec la bibliothèque C# de PDF d'IronPDF

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 abordera 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 :

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

IronPDF propose deux modes pour le rendu des PDF -- Mode natif et Mode distant -- adaptés à différents environnements de développement :

Mode natif : Idéal pour les développeurs souhaitant exécuter tout localement, adapté aux déploiements modernes sur Windows, macOS et Linux. Il suffit d'installer le IronPDF intégrez dans votre projet .NET.
**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. Également idéal pour les systèmes d'exploitation natifs non pris en charge ou hérités tels que Windows Server 2012 et des distributions Linux moins populaires. Il suffit d'installer le IronPdf.Slim intégrer dans votre projet .NET et héberger le IronPdfEngine dans un conteneur.

Utilisez IronPDF avec Remote Engine

[{i :( Quelle est la différence entre Native et 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 modifie-t-elle ma façon 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 orientant 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"))

VB C#

)}]

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

Installation de laBibliothè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.

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

Méthode 1 : Installer IronPDF via NuGet

Les étapes suivantes permettent d'installer leBibliothèque IronPDF NuGet à partir de 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

Il existe également des Packages NuGet IronPDF disponibles pour des déploiements spécifiques afin deMac, Linux, L'azur, Docker et AWS documenté dans notreGuide d'installation avancée d'IronPDF sous NuGet.

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 :

Windows -Télécharger IronPdf.zip
Linux - Téléchargez IronPdf.Linux.zip
Mac -Télécharger IronPdf.MacOs.zip
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"

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, 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 :

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

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

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

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 pouveztélécharger Microsoft Visual C#.

6. Compatibilité avec Linux

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

7. Compatibilité Docker

Déploiement d'IronPDF sur Docker est bien documentée.
Nous supportons officiellement Docker pour : Windows, Ubuntu, Debian, CentOS et Amazon Linux 2 et fournissonsfichiers Docker de travail.

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.