Używanie IronPDF z trybem wewnętrznym

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

Różnica między Native a Engine

IronPDF posiada pewne funkcje wymagające intensywnego przetwarzania, które można uruchomić zdalnie. Chociaż IronPDF nie wymaga uruchomienia IronPdfEngine, skonfigurowanie IronPdfEngine jako usługi zdalnej jest opcjonalnym sposobem uniknięcia problemów z kompatybilnością platformową z Chrome na starszych systemach operacyjnych i w środowiskach mobilnych.

Zacznij korzystać z IronPDF

Rozpocznij używanie IronPDF w swoim projekcie już dziś dzięki darmowej wersji próbnej.

Pierwszy krok:
green arrow pointer


Jak używanie Engine zmienia sposób kodowania z IronPDF

W przypadku korzystania z konfiguracji Engine zalecamy zainstalowanie IronPdf.Slim zamiast pełnego pakietu IronPdf z NuGet, ponieważ Engine zarządza wszystkimi dodatkowymi elementami zawartymi w pakiecie Native.

Install-Package IronPdf.Slim

Po zainstalowaniu IronPdf.Slim skonfiguruj ustawienia połączenia, wskazując IronPDF na swoją instancję IronPdfEngine. Dodaj poniższy kod na początku swojego programu (lub przed wywołaniem dowolnej metody IronPDF):

Dodatkowa linia kodu konfiguracyjnego do dodania do kodu C

Zakładając, że IronPdfEngine działa zdalnie na 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

Jak działa IronPdfEngine?

IronPdfEngine to konteneryzowany serwer stworzony do zarządzania różnorodnymi operacjami IronPDF, w tym tworzeniem, zapisywaniem, edytowaniem i odczytem plików PDF, wszystko przy użyciu protokołu gRPC. Zbudowany jako samodzielna aplikacja C# .NET, IronPdfEngine działa niezależnie, eliminując potrzebę środowiska wykonawczego .NET podczas wykonywania. My zajmujemy się połączeniem gRPC, abyś mógł skupić się na programowaniu!

Aby szybko rozpocząć korzystanie z samodzielnego kontenera IronPDF, zapoznaj się z tym samouczkiem. Kontener Docker wspiera 16 parametrów konfiguracji czasu wykonania dla portu, logowania, limitów Chrome i więcej — zobacz pełną dokumentację parametrów.

Inne wyjaśnienia dotyczące IronPdfEngine

IronPDF .NET nie wymaga IronPdfEngine do dzialania. IronPdfEngine to tylko opcjonalny sposob na uzycie IronPDF. Domyslnie, IronPDF dla .NET nie bedzie uzywal IronPdfEngine.

Zwróć uwagęKazda wersja IronPDF dla .NET wymaga okreslonej wersji IronPdfEngine. Wsparcie miedzywersyjne nie jest dostepne. Dla IronPDF dla .NET wymagana wersja IronPdfEngine bedzie zawsze zgodna. Na przyklad, IronPDF 2024.2.2 bedzie uzywal IronPdfEngine 2024.2.2

IronPDF .NET ze zdalnym IronPdfEngine

Pakiet NuGet IronPdf.slim jest jedynym pakietem potrzebnym do uzywania IronPDF dla .NET ze zdalnym IronPdfEngine.

Zwróć uwagęJeśli używasz IronPdf lub IronPdf.Linux, możesz zamiast tego użyć IronPdf.slim, aby zmniejszyć rozmiar aplikacji.

Zakładając, że IronPdfEngine działa zdalnie na 123.456.7.8:33350.

Zainstaluj IronPDF uzywajac NuGet:

Install-Package IronPdf.Slim

Po zainstalowaniu IronPdf.slim wystarczy po prostu wskazać IronPDF, gdzie znajduje się IronPdfEngine (proszę upewnić się, że adres jest dostępny i nie jest blokowany przez zaporę sieciową). Użyj klasy IronPdfConnectionConfiguration do skonfigurowania ustawień połączenia. Dodaj ponizszy kod do poczatkowego etapu aplikacji (lub tuz przed wywolaniem jakiejkolwiek metody IronPDF).

// 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

To takie proste! Po tym, Twoja aplikacja będzie połączona z zdalnym IronPdfEngine!


Ograniczenia IronPdfEngine

  • Obecnie sam IronPdfEngine nie obsługuje skalowania poziomego (równoważenia obciążenia między wieloma instancjami silnika), ponieważ silnik przechowuje pliki binarne PDF w trakcie przetwarzania w pamięci serwera i wykorzystuje PdfDocumentId do koordynacji między serwerem a klientem. Ten projekt minimalizuje wykorzystanie przepustowości i zwiększa szybkość przetwarzania. Należy pamiętać, że ograniczenie to dotyczy wyłącznie usługi IronPdfEngine; aplikacje korzystające z biblioteki IronPDF (z IronPdfEngine lub bez) nadal mogą skalować się horyzontalnie poprzez wdrażanie wielu instancji aplikacji.
  • Aby uruchomić IronPdfEngine Docker zdalnie, musisz upewnić się, że port IronPdfEngine jest dostępny.
  • Docker dzialajacy na Linux x64 (Debian) uzywajac oficjalnych obrazow opartych na Ubuntu:22.04 moze produkowac wyniki PDF, ktore nieco rozni sie od tego, co uzyskalbys uruchamiajac IronPDF lokalnie ze wzgledu na rozne zachowanie systemu operacyjnego.
  • Ponieważ IronPdfEngine Docker jest oparty na systemie Linux, wymaga demona Linux Containers (wybierz Switch to Linux Containers, jeśli korzystasz z systemu Windows).
  • Pliki binarne IronPdfEngine nie są międzyplatformowe, dlatego budujemy je specjalnie dla każdej platformy.
  • Obsługa różnych wersji nie jest dostępna.

Często Zadawane Pytania

Jak skonfigurować IronPdfEngine do zdalnego generowania plików PDF?

Aby skonfigurować IronPdfEngine do zdalnego generowania plików PDF, zainstaluj pakiet IronPdf.Slim z NuGet i skonfiguruj ustawienia połączenia za pomocą klasy IronPdfConnectionConfiguration. Ta konfiguracja pozwala na zdalne połączenie aplikacji z instancją IronPdfEngine.

Jakie są główne zalety korzystania z IronPdfEngine w mojej aplikacji?

Wykorzystanie IronPdfEngine w aplikacji pozwala na zdalne wykonywanie zadań związanych z plikami PDF, co pomaga uniknąć problemów z kompatybilnością na konkretnych platformach, zwłaszcza na starszych systemach i platformach mobilnych. Eliminuje to również potrzebę korzystania ze środowiska uruchomieniowego .NET podczas wykonywania zadań.

Dłączego warto wybrać IronPdfEngine zamiast natywnej biblioteki PDF?

Możesz wybrać IronPdfEngine do zdalnego uruchamiania funkcji PDF wymagających dużej wydajności, co zmniejsza problemy z kompatybilnością z różnymi systemami operacyjnymi i poprawia wydajność dzięki wykorzystaniu renderera identycznego z Chrome do konwersji HTML na PDF.

Czy IronPdfEngine obsługuje skalowanie horyzontalne?

Nie, IronPdfEngine obecnie nie obsługuje skalowania poziomego, co oznacza, że nie można rozłożyć obciążenia na wiele instancji ze względu na sposób obsługi plików PDF w pamięci serwera.

Czy IronPdfEngine może działać na różnych systemach operacyjnych?

IronPdfEngine jest przeznaczony do działania w systemach Linux przy użyciu kontenerów Docker. Pliki binarne są jednak specyficzne dla danej platformy, dlatego należy upewnić się, że używana jest wersja odpowiednia dla danego systemu operacyjnego.

Co mam zrobić, jeśli moje pliki PDF wyglądają inaczej po użyciu IronPdfEngine?

Wyniki w formacie PDF mogą się nieznacznie różnić ze względu na różne zachowania systemów operacyjnych. Aby zminimalizować różnice, upewnij się, że używasz właściwego obrazu Docker i sprawdź, czy nie ma żadnych ustawień specyficznych dla systemu operacyjnego, które mogłyby wpłynąć na renderowanie.

Jak upewnić się, że moja aplikacja korzysta z właściwej wersji IronPdfEngine?

Aby zapewnić kompatybilność, każda wersja IronPDF wymaga odpowiedniej wersji IronPdfEngine. Należy pamiętać o jednoczesnej aktualizacji obu komponentów, aby uniknąć problemów związanych z różnicami między wersjami.

Jakie są ograniczenia związane z używaniem IronPdfEngine w systemie Windows?

Podczas korzystania z IronPdfEngine w systemie Windows potrzebne są kontenery Linux dla Docker i należy upewnić się, że port serwera jest dostępny. Pliki binarne są specyficzne dla platformy i wymagane jest przejście na kontenery Linux.

Jak skonfigurować IronPDF, aby połączyć się ze zdalnym serwerem IronPdfEngine?

Aby skonfigurować IronPDF dla serwera zdalnego, należy użyć metody Installation.ConnectToIronPdfHost z IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, podając adres IP serwera i szczegóły dotyczące portu.

Jakiego pakietu powinienem użyć, aby zminimalizować rozmiar aplikacji podczas korzystania z IronPdfEngine?

Należy użyć pakietu IronPdf.Slim z NuGet, ponieważ zawiera on tylko komponenty niezbędne do uruchomienia IronPDF z IronPdfEngine, co zmniejsza rozmiar aplikacji.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.