Use IronPDF with in-Engine Mode

This article was translated from English: Does it need improvement?
Translated
View the article in English

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.

Erster Schritt:
green arrow pointer


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 von NuGet zu installieren, da die Engine den gesamten zusätzlichen Umfang im nativen Paket verwaltet.

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 Sie eine IronPDF-Methode aufrufen):

Zusätzliche Zeile des Konfigurationscodes, die Ihrem C#-Code hinzugefügt werden soll

Angenommen, IronPdfEngine läuft remote auf 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

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 kümmern uns um die gRPC-Verbindung für Sie, damit Sie sich auf die Programmierung konzentrieren können!

Für ein Schnellstart-Tutorial zum Ausführen von IronPDF als eigenständiger Container, siehe bitte dieses Tutorial.

class="hsg-featured-snippet">

Wie man IronPdfEngine als Remote-Server verwendet

  1. Installieren Sie die C#-Bibliothek, um IronPdfEngine zu nutzen
  2. Installieren Sie das IronPdf.slim-Paket von NuGet
  3. Verwenden Sie die IronPdfConnectionConfiguration-Klasse, um die Verbindungseinstellungen zu konfigurieren
  4. Verwenden Sie IronPdfEngine, um HTML in PDF mit einem identischen Renderer wie Chrome zu rendern

Weitere Klarstellungen zu IronPdfEngine

IronPdf .NET benötigt nicht IronPdfEngine, um zu laufen. IronPdfEngine ist nur eine optionale Methode, um IronPdf zu verwenden. Standardmäßig wird IronPdf für .NET nicht IronPdfEngine nutzen.

Hinweis:Jede Version von IronPdf für .NET benötigt eine spezielle Version von IronPdfEngine. Unterstützung für Kreuzversionen ist nicht verfügbar. Für IronPdf für .NET wird die benötigte Version von IronPdfEngine immer übereinstimmen. Zum Beispiel wird IronPdf 2024.2.2 IronPdfEngine 2024.2.2 verwenden

IronPdf .NET mit Remote IronPdfEngine

Das IronPdf.slim NuGet-Paket ist das einzige benötigte Paket, um IronPdf für .NET mit Remote IronPdfEngine zu verwenden.

Hinweis:Wenn Sie IronPdf oder IronPdf.Linux verwenden, können Sie IronPdf.slim verwenden, um die Größe Ihrer Anwendung zu reduzieren.

Angenommen, IronPdfEngine läuft remote auf 123.456.7.8:33350.

Installieren Sie IronPdf mit NuGet:

Install-Package IronPdf.Slim

Nach der Installation von IronPdf.slim müssen Sie nur IronPdf mitteilen, wo IronPdfEngine ist (bitte stellen Sie sicher, dass die Adresse zugänglich ist und nicht durch eine Firewall blockiert wird). Verwenden Sie die IronPdfConnectionConfiguration-Klasse, um die Verbindungseinstellungen zu konfigurieren. Fügen Sie den untenstehenden Code in der Anfangsphase Ihrer Anwendung hinzu (oder direkt 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"))
$vbLabelText   $csharpLabel

So einfach ist das! Danach wird Ihre Anwendung mit dem Remote IronPdfEngine verbunden sein!


Einschränkungen von IronPdfEngine

  • Derzeit unterstützt IronPdfEngine noch kein horizontales Skalieren (Lastverteilung mit mehreren Instanzen), da wir die verarbeitenden PDF-Dateibinärdateien im Serverspeicher speichern und PdfDocumentId für die Kommunikation zwischen Server und Client verwenden. Dies minimiert auch die Bandbreitennutzung und erhöht die Verarbeitungsgeschwindigkeit.
  • Um IronPdfEngine Docker remote auszuführen, müssen Sie sicherstellen, dass der IronPdfEngine-Port erreichbar ist.
  • Das IronPdfEngine Docker, das auf Linux x64 (Debian) mit offiziellen ubuntu:22.04-basierten Images läuft, kann PDF-Ausgaben erzeugen, die sich leicht von denen unterscheiden, die Sie bei der lokalen Ausführung von IronPdf erhalten würden, aufgrund unterschiedlicher Betriebssystemverhaltensweisen.
  • Da IronPdfEngine Docker auf Linux basiert, erfordert es den Linux Containers Daemon (wählen Sie Zu Linux-Containern wechseln, 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.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht