1. IronPDF
  2. Commencer
  3. Qu'est-ce que IronPdfEngine

Use IronPDF with in-Engine Mode

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Différence entre Native et Engine

IronPDF dispose de certaines fonctions intensives en performances que vous pouvez choisir d'exécuter à distance. Bien qu'IronPDF ne nécessite pas IronPdfEngine pour fonctionner, configurer IronPdfEngine en tant que service à distance est une méthode optionnelle pour éviter les problèmes de compatibilité spécifique à la plateforme Chrome sur les systèmes d'exploitation plus anciens et les environnements mobiles.

Commencer avec IronPDF

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

Première étape :
green arrow pointer

Comment l'utilisation de l'Engine change la façon dont vous codez avec IronPDF

Lors de l'utilisation de la configuration de l'Engine, nous recommandons d'installer IronPdf.Slim au lieu du package complet IronPdf depuis NuGet, car l'Engine gère toute la surcharge incluse dans le package Native.

Install-Package IronPdf.Slim

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

Ligne de code de configuration supplémentaire à ajouter à votre code C

En supposant qu'IronPdfEngine fonctionne à distance à 123.456.7.8:33350 :

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
' Establish a connection with the remote IronPdfEngine
' Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))

' Additional code for your application
$vbLabelText   $csharpLabel

Comment fonctionne IronPdfEngine ?

IronPdfEngine est un serveur conteneurisé conçu pour gérer diverses opérations IronPDF, y compris la création, l'écriture, la modification et la lecture de PDF, le tout en utilisant le protocole gRPC. Construite comme une application autonome C# .NET, IronPdfEngine fonctionne de manière indépendante, éliminant le besoin du runtime .NET lors de l'exécution. Nous gérons la connexion gRPC pour vous afin que vous puissiez vous concentrer sur le codage !

Pour un tutoriel de démarrage rapide concernant l'exécution d'IronPDF en tant que propre conteneur, veuillez vous référer à ce tutoriel.

class="hsg-featured-snippet">

Comment utiliser IronPdfEngine en tant que serveur distant

  1. Installez la bibliothèque C# pour utiliser IronPdfEngine
  2. Installez le package IronPdf.slim depuis NuGet
  3. Utilisez la classe IronPdfConnectionConfiguration pour configurer les paramètres de connexion
  4. Utilisez IronPdfEngine pour rendre HTML en PDF avec un moteur identique à Chrome

Autres clarifications pour IronPdfEngine

IronPdf .NET ne nécessite pas IronPdfEngine pour fonctionner. IronPdfEngine est juste une méthode optionnelle pour utiliser IronPdf. Par défaut, IronPdf pour .NET n'utilisera pas IronPdfEngine.

Veuillez noterChaque version d'IronPdf pour .NET nécessite une version spécifique d'IronPdfEngine. Le support interversion n'est pas disponible. Pour IronPdf pour .NET, la version requise d'IronPdfEngine correspondra toujours. Par exemple, IronPdf 2024.2.2 utilisera IronPdfEngine 2024.2.2

IronPdf .NET avec IronPdfEngine distant

Le package NuGet IronPdf.slim est le seul nécessaire pour utiliser IronPdf pour .NET avec IronPdfEngine distant.

Veuillez noterSi vous utilisez IronPdf ou IronPdf.Linux, vous pouvez utiliser IronPdf.slim à la place pour réduire la taille de votre application.

En supposant qu'IronPdfEngine fonctionne à distance à 123.456.7.8:33350.

Installez IronPdf en utilisant NuGet :

Install-Package IronPdf.Slim

Après avoir installé IronPdf.slim, vous devez simplement indiquer à IronPdf où se trouve IronPdfEngine (veuillez vous assurer que l'adresse est accessible, non bloquée par un pare-feu). Utilisez la classe IronPdfConnectionConfiguration pour configurer les paramètres de connexion. Ajoutez le code ci-dessous à l'étape initiale de votre application (ou juste avant d'appeler toute méthode IronPdf).

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
$vbLabelText   $csharpLabel

C'est aussi simple que ça ! Après cela, votre application sera connectée à l'IronPdfEngine distant !

Limitations d'IronPdfEngine

  • Actuellement, IronPdfEngine ne supporte pas encore le scaling horizontal (répartition de la charge avec plusieurs instances) car nous stockons les binaires des fichiers PDF en traitement dans la mémoire du serveur et utilisons PdfDocumentId pour communiquer entre le serveur et le client. Cela minimise également l'utilisation de la bande passante et augmente la vitesse de traitement.
  • Pour exécuter IronPdfEngine Docker à distance, vous devez vous assurer que le port IronPdfEngine est accessible.
  • IronPdfEngine Docker fonctionnant sur Linux x64 (Debian) en utilisant des images officielles basées sur ubuntu:22.04 peut produire une sortie PDF légèrement différente de ce que vous obtiendriez en exécutant IronPdf localement en raison d'un comportement OS différent.
  • Comme IronPdfEngine Docker est basé sur Linux, il nécessite un démon de conteneur Linux (sélectionnez Switch to Linux Containers si vous utilisez Windows).
  • Les binaires d'IronPdfEngine ne sont pas multiplateformes, nous les construisons donc spécifiquement pour chaque plateforme.
  • Le support interversion n'est pas disponible.

Questions Fréquemment Posées

Comment puis-je configurer IronPdfEngine pour la génération de PDF à distance ?

Pour configurer IronPdfEngine pour la génération de PDF à distance, installez le package IronPdf.Slim depuis NuGet et configurez les paramètres de connexion en utilisant la classe IronPdfConnectionConfiguration. Cette configuration vous permet de connecter votre application à l'instance IronPdfEngine à distance.

Quels sont les principaux avantages de l'utilisation d'IronPdfEngine avec mon application ?

L'utilisation d'IronPdfEngine avec votre application permet l'exécution à distance de tâches PDF, aidant à éviter les problèmes de compatibilité spécifiques à la plateforme, surtout sur d'anciens systèmes et plateformes mobiles. Elle élimine également le besoin du runtime .NET pendant l'exécution.

Pourquoi pourrais-je choisir d'utiliser IronPdfEngine au lieu de la bibliothèque PDF native ?

Vous pourriez choisir IronPdfEngine pour exécuter des fonctions PDF intensives en performance à distance, réduisant les problèmes de compatibilité avec différents systèmes d'exploitation et améliorant les performances en utilisant un moteur identique à Chrome pour la conversion HTML en PDF.

Le scaling horizontal est-il pris en charge par IronPdfEngine ?

Non, IronPdfEngine ne prend actuellement pas en charge le scaling horizontal, ce qui signifie qu'il ne peut pas être équilibré en charge sur plusieurs instances en raison de la façon dont les binaires de fichiers PDF sont gérés en mémoire serveur.

IronPdfEngine peut-il fonctionner sur différents systèmes d'exploitation ?

IronPdfEngine est conçu pour fonctionner sur des systèmes Linux en utilisant des conteneurs Docker. Cependant, les binaires sont spécifiques à chaque plateforme, vous devez donc vous assurer d'utiliser la version correcte pour votre système d'exploitation.

Que dois-je faire si mes sorties PDF sont différentes lorsque j'utilise IronPdfEngine ?

Les sorties PDF peuvent varier légèrement en raison des comportements différents du système d'exploitation. Pour minimiser les différences, assurez-vous d'utiliser l'image Docker correcte et vérifiez les configurations spécifiques à l'OS pouvant affecter le rendu.

Comment puis-je m'assurer que mon application utilise la bonne version d'IronPdfEngine ?

Pour assurer la compatibilité, chaque version de IronPDF nécessite une version correspondante d'IronPdfEngine. Assurez-vous de mettre à jour les deux composants simultanément pour éviter les problèmes de version croisée.

Quelles sont les limitations de l'utilisation d'IronPdfEngine sur Windows ?

Lors de l'utilisation d'IronPdfEngine sur Windows, vous avez besoin des conteneurs Linux pour Docker et devez vous assurer que le port serveur est accessible. Les binaires sont spécifiques à la plateforme, et passer aux conteneurs Linux est requis.

Comment puis-je configurer IronPDF pour se connecter à un serveur IronPdfEngine distant ?

Pour configurer IronPDF pour un serveur distant, utilisez Installation.ConnectToIronPdfHost avec la méthode IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, en spécifiant l'IP et les détails du port du serveur.

Quel package devrais-je utiliser pour minimiser la taille de l'application lors de l'utilisation d'IronPdfEngine ?

Vous devriez utiliser le package IronPdf.Slim depuis NuGet, car il inclut seulement les composants nécessaires pour exécuter IronPDF avec IronPdfEngine, réduisant ainsi la taille de l'application.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir