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
Nachdem Sie IronPdf.Slim
installiert haben, 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 Sie eine IronPDF-Methode aufrufen):
Extra 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 übernehmen 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 .NET erfordert nicht IronPdfEngine zum Ausführen. IronPdfEngine ist nur eine optionale Möglichkeit, IronPdf zu nutzen. Standardmäßig verwendet IronPDF for .NET nicht IronPdfEngine.
Jede Version von IronPdf für .NET erfordert eine spezifische Version des IronPdfEngine. Versionen übergreifende Kompatibilität wird nicht unterstützt. Für IronPDF for .NET wird die erforderliche Version von IronPdfEngine immer angepasst. Zum Beispiel wird IronPdf 2024.2.2 IronPdfEngine 2024.2.2 verwenden
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
verwenden, können Sie stattdessen IronPdf.slim
nutzen, um die Größe Ihrer Anwendung zu reduzieren.Angenommen, dass IronPdfEngine remote unter 123.456.7.8:33350
ausgeführt wird.
Installieren Sie IronPDF mit NuGet:
PM> Install-Package IronPdf
Nach der Installation von IronPdf.slim
müssen Sie IronPdf nur mitteilen, wo sich IronPdfEngine befindet (bitte stellen Sie sicher, dass die Adresse zugänglich ist und nicht durch die Firewall blockiert wird). Verwenden Sie die IronPdfConnectionConfiguration-Klasse, um die Verbindungseinstellungen zu konfigurieren. Fügen Sie den unten stehenden Code zu der Anfangsphase Ihrer Anwendung hinzu (oder unmittelbar bevor Sie eine IronPdf-Methode aufrufen).
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 dem Remote IronPdfEngine verbunden sein!
IronPdfEngine Einschränkung
- Derzeit unterstützt IronPdfEngine noch keine horizontale Skalierung. (Lastverteilung mit mehreren Instanzen.) Weil wir die binären Daten der zu verarbeitenden PDF-Datei im Serverspeicher speichern und zur Kommunikation zwischen Server und Client die PdfDocumentId verwenden. 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) mit offiziellen ubuntu:22.04-basierten Images, der PDF-Ausgabe kann etwas anders sein als bei der Ausführung von IronPdf auf Ihrem lokalen Rechner aufgrund des unterschiedlichen Verhaltens des Betriebssystems.
- Da IronPdfEngine Docker auf Linux basiert, benötigt es einen Linux-Container-Daemon. (wählen Sie
Switch to Linux Containers
, 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.