在引擎模式下使用 IronPDF
原生與引擎之間的差異
IronPDF 有一些性能密集的功能,您可以选择遠程執行。 雖然IronPDF不需要IronPdfEngine來運行,但將IronPdfEngine設置為遠程服務是一種可選的方法,可以避免在舊操作系統和移動環境上發生特定平台的Chrome兼容性問題。
開始使用 IronPDF
立即在您的專案中使用IronPDF,並享受免費試用。
使用 Engine 如何改變您使用 IronPDF 編碼的方式
在使用引擎配置時,我們建議從 NuGet 安裝 IronPdf.Slim
而不是完整的 IronPdf
套件,因為引擎會管理原生套件中包含的所有額外負擔。
PM> Install-Package IronPdf.Slim
安裝IronPdf.Slim
後,將 IronPDF 指向您的 IronPdfEngine 實例來配置連接設置。 在您的應用程式啟動時(或在呼叫任何 IronPDF 方法之前)添加以下程式碼:
要添加到 C# 代碼中的額外配置行
假設 IronPdfEngine 在遠端執行 123.456.7.8:33350
:
// ... 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 ...
IronPdfEngine 如何運作?
IronPdfEngine 是一個容器化伺服器,專為管理各種 IronPDF 操作而設計,包括使用 gRPC 協議創建、寫入、編輯和閱讀 PDF。 作為一個自成一體的C# .NET應用程序,IronPdfEngine獨立運作,執行時無需.NET運行時。 我們為您處理 gRPC 連接,讓您能專注於編程!
如何將 IronPdfEngine 作為遠程伺服器使用
- 安裝C#庫以使用IronPdfEngine
- 從NuGet安裝IronPdf.slim套件
- 使用IronPdfConnectionConfiguration類別來配置連接設置
- 使用IronPdfEngine以與Chrome相同的渲染器將HTML渲染為PDF
IronPdfEngine的其他說明
IronPDF .NET 不需要 IronPdfEngine 即可運行。 IronPdfEngine 只是使用 IronPdf 的一種選擇方式。 預設情況下,IronPdf for .NET 不會使用 IronPdfEngine。
每個版本的 IronPdf for .NET 需要特定版本的 IronPdfEngine。不支援跨版本。 對於 IronPdf for .NET,所需的 IronPdfEngine 版本將始終匹配。 例如,IronPdf 2024.2.2 將使用 IronPdfEngine 2024.2.2
IronPdf .NET 與遠端 IronPdfEngine
IronPdf.slim nuget 套件是使用 IronPdf for .NET 與遠端 IronPdfEngine 所需的唯一套件。
請注意
IronPdf
或IronPdf.Linux
,可以改用IronPdf.slim
來減小您的應用程式大小。假設 IronPdfEngine 遠端運行於 123.456.7.8:33350
。
使用 NuGet 安裝 IronPdf:
PM> Install-Package IronPdf
安裝 IronPdf.slim
後,您只需要告訴 IronPdf IronPdfEngine 的位置(請確保該地址可訪問,未被防火牆阻擋)。 使用 IronPdfConnectionConfiguration 類別來配置連接設置。 將以下程式碼添加到應用程式的初始階段(或在調用任何IronPdf方法之前)。
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"))
就是這麼簡單! 這樣之後,您的應用程式將連接到遠端 IronPdfEngine!
IronPdfEngine 限制
- 目前,IronPdfEngine 尚未支持水平擴展。 (使用多個實例進行負載平衡。)因為我們將處理的 PDF 文件二進位檔存儲在服務器記憶體中,並使用 PdfDocumentId 在服務器和客戶端之間進行通信。 這也減少了頻寬使用並提高了處理速度。
- 要遠程運行 IronPdfEngine Docker,您需要確保 IronPdfEngine 端口是可訪問的。
- 在使用基於官方 ubuntu:22.04 映像的 Linux x64(Debian)上運行的 IronPdfEngine Docker,PDF 輸出可能會與在本地機器上運行 IronPdf 稍有不同,這是由於不同作業系統的行為所致。
- 由於IronPdfEngine Docker是基於Linux的,因此需要Linux容器守護進程。 (如果您使用的是 Windows,請選擇
Switch to Linux Containers
) - IronPdfEngine 的二進制文件不是跨平台的,因此我們為每個平台特別構建。
- 跨版本不受支持。