使用 IronPDF 进行引擎模式

2018年八月28日
更新 2025年一月6日
分享:
This article was translated from English: Does it need improvement?
Translated
View the article in English

原生与引擎的区别

IronPDF具有一些性能密集型功能,您可以选择远程运行。 虽然IronPDF不需要IronPdfEngine来运行,但将IronPdfEngine设置为远程服务是一种可选的方法,可避免在较旧的操作系统和移动环境中遇到特定平台的Chrome兼容性问题。

开始使用IronPDF

立即在您的项目中开始使用IronPDF,并享受免费试用。

第一步:
green arrow pointer


使用 Engine 如何改变您与 IronPDF 编码的方式

在使用引擎配置时,我们建议安装IronPdf.Slim而不是从NuGet中安装完整的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 ...
$vbLabelText   $csharpLabel

IronPdfEngine 是如何运作的?

IronPdfEngine 是一个容器化服务器,旨在管理各种 IronPDF 操作,包括使用 gRPC 协议创建、编写、编辑和读取 PDF。 作为一个独立的C# .NET应用程序,IronPdfEngine可以独立操作,执行时无需.NET运行时环境。 我们为您处理 gRPC 连接,让您可以专注于编码!

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 与 Remote IronPdfEngine

IronPdf.slim nuget 包是使用带有远程 IronPdfEngine 的 IronPdf for .NET 所需的唯一软件包。

[{i:(如果您正在使用IronPdfIronPdf.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"))
$vbLabelText   $csharpLabel

就这么简单! 之后,您的应用程序将连接到远程IronPdfEngine!


IronPdfEngine 限制

  • 目前,IronPdfEngine 还不支持水平扩展。 (通过多实例进行负载均衡。)因为我们将正在处理的 PDF 文件二进制存储在服务器内存中,并使用 PdfDocumentId 在服务器和客户端之间进行通信。 这也减少了带宽使用并提高了处理速度。
  • 要远程运行IronPdfEngine Docker,您需要确保IronPdfEngine端口是可访问的。
  • 在 Linux x64(Debian)上运行的 IronPdfEngine Docker 使用基于官方 ubuntu:22.04 的镜像,由于不同操作系统的行为,PDF 输出可能与在本地机器上运行 IronPdf 略有不同。
  • 由于IronPdfEngine Docker基于Linux,因此需要Linux容器守护程序。 (如果您使用的是Windows,请选择Switch to Linux Containers
  • IronPdfEngine 的二进制文件不是跨平台的,所以我们针对每个平台特别构建。
  • 跨版本不受支持。