Utilisez IronPDF en mode intégré

août 28, 2018
Mise à jour janvier 6, 2025
Partager:
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 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.

Commencez avec IronPDF

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

Première étape :
green arrow pointer


Comment l'utilisation de Engine change votre 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 pointant IronPDF vers votre instance 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 que IronPdfEngine fonctionne à distance à 123.456.7.8:33350 :

// ... your code ...

Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));

// ... your code ...
// ... your code ...

Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));

// ... your code ...

Comment fonctionne IronPdfEngine ?

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

Autres clarifications pour IronPdfEngine

IronPdf .NET ne nécessite pas IronPdfEngine pour fonctionner. IronPdfEngine n'est qu'un moyen optionnel d'utiliser IronPdf. Par défaut, IronPDF for .NET n'utilise pas IronPdfEngine.

{i:(Chaque version d'IronPdf for .NET nécessite une version spécifique d'IronPdfEngine. Les versions croisées ne sont pas prises en charge. Pour IronPDF for .NET, la version requise d'IronPdfEngine correspondra toujours. Par exemple, IronPdf 2024.2.2 utilisera IronPdfEngine 2024.2.2

IronPDF for .NET avec IronPdfEngine à distance

Le paquet nuget IronPdf.slim est le seul paquet nécessaire à l'utilisation d'IronPDF for .NET avec le Remote IronPdfEngine.

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

En supposant que IronPdfEngine fonctionne à distance à l'adresse 123.456.7.8:33350.

Installez IronPDF à l'aide de NuGet :

PM> Install-Package IronPdf

Après avoir installé IronPdf.slim, vous devez simplement indiquer à IronPdf où se trouve IronPdfEngine (veuillez vous assurer que l'adresse est accessible et 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 n'importe quelle méthode IronPdf).

Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));

Aussi simple que cela ! Après cela, votre application sera connectée à Remote IronPdfEngine !


Limitation de IronPdfEngine

  • Actuellement, IronPdfEngine ne prend pas encore en charge la mise à l'échelle horizontale. (répartition de charge avec plusieurs instances.) Parce que nous stockons les binaires du fichier PDF en cours de traitement dans la mémoire du serveur et utilisons PdfDocumentId pour la communication entre le serveur et le client. Cela permet également de minimiser l'utilisation de la bande passante et d'augmenter 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, la sortie PDF peut être légèrement différente de celle d'IronPdf exécuté sur votre machine locale en raison du comportement différent du système d'exploitation.
  • Comme IronPdfEngine Docker est basé sur Linux, il a besoin d'un démon Linux Containers. (sélectionnez Switch to Linux Containers si vous utilisez Windows)
  • Les binaires d'IronPdfEngine ne sont pas inter-plateformes, nous les construisons donc pour chaque plateforme de manière spécifique.
  • Les versions croisées ne sont pas prises en charge.