Verwenden Sie IronPDF mit dem In-Engine-Modus
Unterschied zwischen Native und Engine
IronPDF hat einige leistungsintensive Funktionen, die Sie remote ausführen können. Auch wenn IronPDF nicht IronPDFEngine zum Ausführen benötigt, ist das Einrichten von IronPDFEngine als Remotedienst eine optionale Möglichkeit, plattformspezifische Chrome-Kompatibilitätsprobleme auf älteren Betriebssystemen und mobilen Umgebungen zu vermeiden.
Erste Schritte mit IronPDF
Nutzen Sie IronPDF heute kostenlos in Ihrem Projekt.
Wie die Verwendung der Engine die Programmierung mit IronPDF verändert
Bei Verwendung der Engine-Konfiguration empfehlen wir, IronPdf.Slim anstelle des vollständigen IronPdf-Pakets aus NuGet zu installieren, da die Engine den gesamten zusätzlichen Umfang des Native-Pakets verwaltet.
Install-Package IronPdf.Slim
Konfigurieren Sie nach der Installation von IronPdf.Slim 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):
Zusätzlicher Konfigurationscode für Ihren C#-Code
Angenommen, IronPdfEngine läuft remote unter 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
Wie funktioniert IronPDFEngine?
IronPDFEngine ist ein containerisierter Server, der darauf ausgelegt ist, 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 funktioniert unabhängig, wodurch zur Ausführung keine .NET-Laufzeitumgebung benötigt wird. Wir übernehmen die gRPC-Verbindung, damit Sie sich auf das Programmieren konzentrieren können!
Für ein Schnellstart-Tutorial zum Ausführen von IronPDF als eigenständiger Container, siehe bitte dieses Tutorial. Der Docker-Container unterstützt 16 Laufzeitkonfigurationsparameter für Port, Protokollierung, Chrome-Limits und mehr – siehe die vollständige Parameterreferenz .
Verwendung von IronPDFEngine als Remote Server
- Installieren Sie die C#-Bibliothek, um IronPDFEngine zu nutzen
- Installieren Sie das IronPDF.slim-Paket von NuGet
- Verwenden Sie die IronPDFConnectionConfiguration-Klasse, um die Verbindungseinstellungen zu konfigurieren
- Verwenden Sie die IronPDFEngine zum Rendern von HTML in PDF mit einem identischen Renderer wie Chrome
Weitere Klarstellungen zu IronPDFEngine
IronPDF .NET erfordert nicht IronPdfEngine zum Ausführen. IronPdfEngine ist nur eine optionale Möglichkeit, IronPDF zu nutzen. Standardmäßig wird IronPDF for .NET IronPdfEngine nicht nutzen.
IronPDF .NET mit remote IronPdfEngine
Das IronPdf.slim NuGet-Paket ist das einzige Paket, das benötigt wird, um IronPDF for .NET mit remote IronPdfEngine zu nutzen.
IronPdf oder IronPdf.Linux verwenden, können Sie stattdessen IronPdf.slim nutzen, um die Größe Ihrer Anwendung zu reduzieren.Angenommen, IronPdfEngine läuft remote unter 123.456.7.8:33350.
Installieren Sie IronPDF mit NuGet:
Install-Package IronPdf.Slim
Nach der Installation von IronPdf.slim müssen Sie IronPDF lediglich mitteilen, wo sich IronPdfEngine befindet (bitte stellen Sie sicher, dass diese Adresse erreichbar ist und nicht durch eine Firewall blockiert wird). Verwenden Sie die IronPDFConnectionConfiguration-Klasse, um die Verbindungseinstellungen zu konfigurieren. Fügen Sie den nachstehenden Code zum Anfang Ihrer Anwendung hinzu (oder kurz bevor Sie eine IronPDF-Methode aufrufen).
// 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"))
So einfach ist das! Danach wird Ihre Anwendung mit dem Remote IronPDFEngine verbunden sein!
Einschränkungen von IronPDFEngine
- Derzeit unterstützt IronPdfEngine selbst keine horizontale Skalierung (Lastenausgleich über mehrere Engine-Instanzen), da die Engine laufende PDF-Binärdateien im Serverspeicher hält und PdfDocumentId zur Koordination zwischen Server und Client verwendet. Dieses Design minimiert die Bandbreitennutzung und erhöht die Verarbeitungsgeschwindigkeit. Beachten Sie, dass diese Einschränkung nur für den IronPdfEngine-Dienst gilt; Anwendungen, die die IronPDF-Bibliothek nutzen (mit oder ohne IronPdfEngine), können weiterhin horizontal skaliert werden, indem mehrere Anwendungsinstanzen bereitgestellt werden.
- Um IronPDFEngine Docker remote auszuführen, müssen Sie sicherstellen, dass der IronPDFEngine-Port erreichbar ist.
- Im Docker mit IronPdfEngine, das auf Linux x64 (Debian) mit offiziellen ubuntu:22.04-basierten Versionen läuft, kann die PDF-Ausgabe leicht von der Ausführung von IronPDF lokal abweichen, aufgrund unterschiedlicher Betriebssystemverhalten.
- Da IronPdfEngine Docker auf Linux basiert, benötigt es den Linux Containers-Daemon (wählen Sie
Switch to Linux Containers, wenn Sie Windows verwenden). - IronPDFEngine-Binärdateien sind nicht plattformübergreifend, daher bauen wir sie speziell für jede Plattform.
- Unterstützung für Kreuzversionen ist nicht verfügbar.
Häufig gestellte Fragen
Wie kann ich IronPDFEngine für die entfernte PDF-Erstellung einrichten?
Um IronPDFEngine für die entfernte PDF-Erstellung einzurichten, installieren Sie das IronPdf.Slim-Paket von NuGet und konfigurieren Sie die Verbindungseinstellungen mit der IronPDFConnectionConfiguration-Klasse. Diese Einrichtung ermöglicht es Ihnen, Ihre Anwendung mit der IronPDFEngine-Instanz remote zu verbinden.
Was sind die Hauptvorteile der Verwendung von IronPDFEngine mit meiner Anwendung?
Die Verwendung von IronPDFEngine mit Ihrer Anwendung ermöglicht die Remote-Ausführung von PDF-Aufgaben, was hilft, plattformspezifische Kompatibilitätsprobleme zu vermeiden, insbesondere auf älteren Systemen und mobilen Plattformen. Es eliminiert auch die Notwendigkeit der .NET-Laufzeit während der Ausführung.
Warum könnte ich mich entscheiden, IronPDFEngine anstelle der nativen PDF-Bibliothek zu verwenden?
Sie könnten sich für IronPDFEngine entscheiden, um leistungsintensive PDF-Funktionen remote auszuführen, die Kompatibilitätsprobleme mit verschiedenen Betriebssystemen zu reduzieren und die Leistung zu verbessern, indem ein Chrome-identischer Renderer für die Umwandlung von HTML in PDF genutzt wird.
Wird horizontale Skalierung in IronPDFEngine unterstützt?
Nein, IronPDFEngine unterstützt derzeit keine horizontale Skalierung, was bedeutet, dass es nicht über mehrere Instanzen hinweg geladen werden kann, da PDF-Datei-Binärdaten im Serverspeicher gehandhabt werden.
Kann IronPDFEngine unter verschiedenen Betriebssystemen ausgeführt werden?
IronPDFEngine ist darauf ausgelegt, auf Linux-Systemen mithilfe von Docker-Containern zu laufen. Die Binärdateien sind jedoch plattformabhängig, daher müssen Sie sicherstellen, dass Sie die richtige Version für Ihr Betriebssystem verwenden.
Was sollte ich tun, wenn meine PDF-Ausgaben unterschiedlich sind, wenn ich IronPDFEngine verwende?
PDF-Ausgaben können aufgrund unterschiedlicher Betriebssystemverhalten leicht variieren. Um Unterschiede zu minimieren, stellen Sie sicher, dass Sie das richtige Docker-Image verwenden und überprüfen Sie eventuell bestehende, betriebssystemspezifische Einstellungen, die das Rendering beeinflussen könnten.
Wie stelle ich sicher, dass meine Anwendung die richtige Version von IronPDFEngine verwendet?
Um Kompatibilität sicherzustellen, erfordert jede Version von IronPDF eine passende Version von IronPDFEngine. Stellen Sie sicher, dass Sie beide Komponenten gleichzeitig aktualisieren, um Probleme zwischen den Versionen zu vermeiden.
Welche Einschränkungen gibt es bei der Verwendung von IronPDFEngine auf Windows?
Bei der Verwendung von IronPDFEngine auf Windows benötigen Sie Linux-Container für Docker und müssen sicherstellen, dass der Serverport erreichbar ist. Die Binärdateien sind plattformspezifisch und der Wechsel zu Linux-Containern ist erforderlich.
Wie konfiguriere ich IronPDF für die Verbindung zu einem entfernten IronPDFEngine-Server?
Um IronPDF für einen entfernten Server zu konfigurieren, verwenden Sie Installation.ConnectToIronPDFHost mit der Methode IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer und spezifizieren Sie die IP- und Port-Details des Servers.
Welches Paket sollte ich verwenden, um die Anwendungsgröße bei Verwendung von IronPDFEngine zu minimieren?
Sie sollten das IronPdf.Slim-Paket von NuGet verwenden, da es nur die notwendigen Komponenten für den Betrieb von IronPDF mit IronPDFEngine enthält und so die Anwendungsgröße reduziert.

