IronPDFをin-Engineモードで使用する

2018年8月28日

更新済み 2025年1月6日

共有:

Translated

View the article in English

ネイティブとエンジンの違い

IronPDFには、リモートで実行することを選択できるパフォーマンス集約型の機能があります。 IronPDFはIronPdfEngineを実行するために必要ではありませんが、IronPdfEngineをリモートサービスとして設定することは、古いオペレーティングシステムやモバイル環境のプラットフォーム固有のChrome互換性問題を回避するためのオプションの方法です。

IronPDFを始めましょう

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:

Engineを使用することで、IronPDFを用いたコーディングがどのように変わるか

エンジンの構成を使用する際は、NuGetからの完全なIronPdfパッケージではなく、IronPdf.Slimをインストールすることをお勧めします。エンジンがネイティブパッケージに含まれるすべての余分な容量を管理するためです。

PM> Install-Package IronPdf.Slim

IronPdf.Slimをインストールした後、IronPdfEngineインスタンスを指すことでIronPDFの接続設定を構成します。アプリケーションの起動時（または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は、gRPCプロトコルを使用してPDFの作成、書き込み、編集、読み取りを行うために設計されたコンテナ化されたサーバーです。 C# .NETの自己完結型アプリケーションとして構築されたIronPdfEngineは、実行中に.NETランタイムを必要とせずに独立して動作します。私たちは、gRPC接続を処理するので、あなたはコーディングに専念できます！

IronPdfEngineをリモートサーバーとして使用する方法

C#ライブラリをインストールしてIronPdfEngineを利用する
NuGetからIronPDF.slimパッケージをインストールします
IronPdfConnectionConfigurationクラスを使用して接続設定を構成します。
IronPdfEngineを使用してHTMLをChromeレンダラーと同一の形式で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パッケージは、リモートIronPdfEngineでIronPdf for .NETを使用するために必要な唯一のパッケージです。

次の内容にご注意ください。

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"))

$vbLabelText $csharpLabel

それだけです！これで、アプリケーションはリモートIronPdfEngineに接続されます！

IronPdfEngineの制限

現在、IronPdfEngineはまだ水平スケーリングをサポートしていません。（複数のインスタンスによるロードバランシング。）PDFファイルのバイナリをサーバーメモリ内に格納し、サーバーとクライアント間の通信にはPdfDocumentIdを使用するためです。これにより、帯域幅の使用を最小限に抑え、処理速度を向上させます。
IronPdfEngine Dockerをリモートで実行するには、IronPdfEngineポートがアクセス可能であることを確認する必要があります。
Linux x64 (Debian) で公式の ubuntu:22.04 ベースのイメージを使用して実行されている IronPdfEngine Docker では、異なる OS の動作により、ローカルマシンで IronPdf を実行した場合と比較して PDF 出力が若干異なることがあります。
IronPdfEngine DockerはLinuxベースなので、Linux Containersデーモンが必要です。 (Windows を使用している場合は、Switch to Linux Containers を選択します)
IronPdfEngine のバイナリはクロスプラットフォームではないため、それぞれのプラットフォームに特化して構築しています。
クロスバージョンはサポートされていません。