Verwenden Sie IronPDF im In-Engine-Modus
Unterschied zwischen Native & Engine
IronPDF hat einige leistungsintensive Funktionen, die Sie möglicherweise remote ausführen möchten. Obwohl IronPDF nicht den IronPdfEngine benötigt, um zu laufen, ist das Einrichten von IronPdfEngine als Remote-Dienst eine optionale Möglichkeit, um plattformspezifische Chrome-Kompatibilitätsprobleme auf älteren Betriebssystemen und mobilen Umgebungen zu vermeiden.
Erste Schritte mit IronPDF
Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.
Wie die Verwendung von Engine die Art und Weise ändert, wie Sie mit IronPDF programmieren
Bei der Verwendung der Engine-Konfiguration empfehlen wir, IronPdf.Slim
anstelle des vollständigen IronPdf
-Pakets von NuGet zu installieren, da die Engine den gesamten zusätzlichen Umfang des Native-Pakets verwaltet.
PM> Install-Package IronPdf.Slim
Nach der Installation von IronPdf.Slim
konfigurieren Sie die Verbindungseinstellungen, indem Sie IronPDF auf Ihre IronPdfEngine-Instanz verweisen. Fügen Sie den folgenden Code beim Start Ihrer Anwendung hinzu (oder bevor eine IronPDF-Methode aufgerufen wird):
Zusätzliche Konfigurationszeile, die Ihrem C#-Code hinzugefügt werden muss.
Angenommen, dass IronPdfEngine remote unter 123.456.7.8:33350
läuft:
// ... 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 ...
' ... your code ...
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
' ... your code ...
Wie funktioniert der IronPdfEngine?
Der IronPdfEngine ist ein containerisierter Server, der entwickelt wurde, um verschiedene IronPDF-Operationen zu verwalten, einschließlich Erstellen, Schreiben, Bearbeiten und Lesen von PDFs, alles unter Verwendung des gRPC-Protokolls. IronPdfEngine wurde als eigenständige C# .NET-Anwendung entwickelt und arbeitet unabhängig, so dass die .NET-Laufzeitumgebung während der Ausführung nicht benötigt wird. Wir kümmern uns um die gRPC-Verbindung für Sie, damit Sie sich auf das Programmieren konzentrieren können.!
Verwendung von IronPdfEngine als Remote-Server
- Installieren Sie die C#-Bibliothek zur Nutzung von IronPdfEngine
- Installieren Sie das IronPDF.slim-Paket von NuGet
- Verwenden Sie die Klasse IronPdfConnectionConfiguration, um die Verbindungseinstellungen zu konfigurieren
- Verwenden Sie die IronPdfEngine zum Rendern von HTML in PDF mit einem identischen Renderer wie in Chrome
Weitere Klarstellungen für IronPdfEngine
IronPDF for .NET erfordert IronPdfEngine nicht zur Ausführung. IronPdfEngine ist nur eine optionale Möglichkeit, IronPdf zu nutzen. Standardmäßig verwendet IronPDF for .NET nicht IronPdfEngine.
Bitte beachten Sie
IronPDF for .NET mit entfernter IronPdfEngine
Das Nuget-Paket IronPDF.slim ist das einzige Paket, das für die Verwendung von IronPDF for .NET mit der Remote IronPdfEngine benötigt wird.
Bitte beachten Sie
IronPdf
oder IronPdf.Linux
benutzen, können Sie stattdessen IronPdf.slim
verwenden, um die Größe Ihrer Anwendung zu reduzieren.Unter der Annahme, dass IronPdfEngine per Fernzugriff unter der Adresse "123.456.7.8:33350" läuft.
Installieren Sie IronPDF mit NuGet:
PM> Install-Package IronPdf
Nach der Installation von IronPdf.slim
müssen Sie IronPdf nur noch mitteilen, wo sich IronPdfEngine befindet(vergewissern Sie sich, dass die Adresse zugänglich ist und nicht durch eine Firewall blockiert wird). Verwenden Sie die Klasse IronPdfConnectionConfiguration, um die Verbindungseinstellungen zu konfigurieren. Fügen Sie den folgenden Code in die Anfangsphase Ihrer Bewerbung ein(oder kurz vor dem Aufruf einer IronPDF-Methode).
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
So einfach ist das! Danach wird Ihre Anwendung mit der Remote IronPdfEngine verbunden!
IronPdfEngine Einschränkung
- Derzeit unterstützt IronPdfEngine noch keine horizontale Skalierung. (lastausgleich mit mehreren Instanzen.) Denn wir speichern die verarbeitenden PDF-Binärdateien im Speicher des Servers und verwenden PdfDocumentId für die Kommunikation zwischen Server und Client. Dies minimiert auch die Bandbreitennutzung und erhöht die Verarbeitungsgeschwindigkeit.
- Um IronPdfEngine Docker aus der Ferne auszuführen, müssen Sie sicherstellen, dass der IronPdfEngine-Port erreichbar ist
- IronPdfEngine Docker läuft auf Linux x64(Debian) wenn Sie die offiziellen ubuntu:22.04-basierten Images verwenden, kann die PDF-Ausgabe aufgrund des unterschiedlichen Verhaltens des Betriebssystems etwas anders aussehen als bei der Ausführung von IronPDF auf Ihrem lokalen Rechner.
- Da IronPdfEngine Docker auf Linux basiert, benötigt es einen Linux-Container-Daemon. (wählen Sie "Zu Linux Containern wechseln", wenn Sie Windows verwenden)
- IronPdfEngine-Binärdateien sind nicht plattformübergreifend, so dass wir sie für jede Plattform spezifisch erstellen.
- Versionsübergreifende Versionen werden nicht unterstützt.