インエンジンモードでIronPDFを使う
ネイティブとエンジンの違い
IronPDFには、リモートで実行することを選択できるパフォーマンス集約的な関数があります。 IronPDFは実行するためにIronPDFEngineを必要としませんが、リモートサービスとしてIronPDFEngineを設定することは、古いオペレーティングシステムやモバイル環境でのプラットフォーム固有のChrome互換性の問題を回避するためのオプションです。
IronPDFの使い方
今日あなたのプロジェクトでIronPDFを無料トライアルで使用開始。
Engineの使用により、IronPDFでのコーディング方法が変わります
Engine構成を使用する場合、NuGetからIronPdf.Slimをインストールすることを推奨します。これは、Nativeパッケージに含まれる余分なデータはすべてEngineが管理するためです。
Install-Package IronPdf.Slim
IronPdf.Slimをインストールした後、IronPDFをIronPdfEngineインスタンスに指定して接続設定を行ってください。 アプリケーションのスタートアップ(または任意のIronPDFメソッドを呼び出す前)に以下のコードを追加します。
追加するC#コードの構成コード行
IronPdfEngineが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
IronPDFEngineはどのように機能するのか?
IronPDFEngineは、gRPCプロトコルを使用してPDFの作成、書き込み、編集、および読み取りを含むさまざまなIronPDF操作を管理するために設計されたコンテナ化されたサーバーです。 自己完結型のC# .NETアプリケーションとして構築されており、実行中に.NETランタイムを必要とせずに独立して動作します。 gRPC接続は弊社が代行するため、あなたはコーディングに集中できます!
IronPDFを独自のコンテナとして実行するためのクイックスタートチュートリアルには、このチュートリアルを参照してください。 この Docker コンテナは、ポート、ロギング、Chrome の制限などに関する 16 のランタイム設定パラメータをサポートしています。詳細については、パラメータリファレンスを参照してください。
IronPDFEngineをリモートサーバーとして使用する方法
- IronPDFEngineを活用するためにC#ライブラリをインストールする
- NuGetからIronPDF.slimパッケージをインストールする
- IronPDFConnectionConfigurationクラスを利用して接続設定を構成する
- IronPDFEngineを使用して、Chromeと同じレンダラーでHTMLをPDFにレンダリングする。
IronPDFEngineに関するその他の説明
IronPDF .NETはIronPDFEngineを必要としません。 IronPDFEngineは、IronPDFを使用するためのオプションの方法にすぎません。 デフォルトでは、IronPDF for .NETはIronPDFEngineを使用しません。
IronPDF .NETとリモートIronPDFEngine
IronPDF.slim NuGetパッケージは、IronPDF for .NETをリモートIronPDFEngineで使用するために必要な唯一のパッケージです。
IronPdf.slimを使用することができます。
IronPdfEngineが123.456.7.8:33350でリモート実行されているものと仮定します。
NuGetを使用してIronPDFをインストールします。
Install-Package IronPdf.Slim
IronPdf.slimをインストールした後、IronPdfEngineの場所をIronPdfに指定するだけです(そのアドレスがアクセス可能であり、ファイアウォールによってブロックされていないことを確認してください)。 IronPDFConnectionConfigurationクラスを使用して接続設定を構成します。 アプリケーションの初期段階(または任意の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"))
Simple as that! これにより、アプリケーションはリモートIronPDFEngineに接続されます!
IronPDFEngineの制限
- 現在、IronPDFEngineは水平スケーリング(複数インスタンスでの負荷分散)をサポートしていません。なぜなら、処理中のPDFファイルのバイナリをサーバーのメモリ内に保存し、PdfDocumentIdを使ってサーバーとクライアント間で通信を行うためです。 これはまた、帯域幅の使用を最小限に抑え、処理速度を向上させます。
- IronPDFEngine Dockerをリモートで実行する場合は、IronPDFEngineポートが到達可能であることを確認する必要があります。
- IronPDFEngine DockerはLinux x64 (Debian)上で公式のubuntu:22.04ベースのイメージを使用して実行すると、異なるOSの動作に起因して、IronPDFをローカルで実行する場合とは若干異なるPDF出力が生成される可能性があります。
- IronPdfEngine DockerはLinuxベースであるため、Linuxコンテナデーモンが必要です(Windowsを使用している場合は
Switch to Linux Containersを選択してください)。 - IronPDFEngineバイナリはクロスプラットフォームではないため、各プラットフォーム専用にビルドします。
- バージョン間の互換性サポートはありません。
よくある質問
リモートPDF生成のためにIronPDFEngineをどのようにセットアップできますか?
リモートPDF生成のためにIronPDFEngineをセットアップするには、NuGetからIronPdf.Slimパッケージをインストールし、IronPDFConnectionConfigurationクラスを使用して接続設定を構成します。このセットアップにより、アプリケーションをIronPDFEngineインスタンスにリモートで接続できます。
アプリケーションでIronPDFEngineを使用する主な利点は何ですか?
アプリケーションでIronPDFEngineを使用すると、PDFタスクをリモートで実行することができ、特に古いシステムやモバイルプラットフォームでのプラットフォーム固有の互換性の問題を回避できます。また、実行中に.NETランタイムを必要としません。
ネイティブのPDFライブラリの代わりにIronPDFEngineを利用する理由は何ですか?
パフォーマンス集約型のPDF機能をリモートで実行し、異なるオペレーティングシステムとの互換性の問題を軽減し、HTMLからPDFへの変換にChromeと同一のレンダラを利用することで性能を向上させるためにIronPDFEngineを選ぶかもしれません。
IronPDFEngineで水平方向のスケーリングはサポートされていますか?
いいえ、現在IronPDFEngineは水平方向のスケーリングをサポートしておらず、サーバーメモリ内でのPDFファイルバイナリの取り扱い方法のため、複数のインスタンス間で負荷分散することはできません。
IronPDFEngineは異なるオペレーティングシステムで動作できますか?
IronPDFEngineはDockerコンテナを使用してLinuxシステムで動作するように設計されています。ただし、バイナリはプラットフォーム固有であるため、使用するオペレーティングシステムに適したバージョンを使用する必要があります。
IronPDFEngineを使用しているときにPDFの出力が異なる場合、どうすればよいですか?
異なるオペレーティングシステムの動作によりPDFの出力がわずかに異なることがあります。差異を最小限に抑えるために、正しいDockerイメージを使用し、レンダリングに影響を与える可能性のあるOS特定の設定を確認してください。
アプリケーションがIronPDFEngineの正しいバージョンを使用していることをどうやって確認できますか?
互換性を確保するため、各バージョンのIronPDFには対応するバージョンのIronPDFEngineが必要です。クロスバージョンの問題を避けるために、両方のコンポーネントを同時に更新してください。
WindowsでIronPDFEngineを使用する際の制限は何ですか?
WindowsでIronPDFEngineを使用する場合、DockerのLinuxコンテナが必要であり、サーバーポートが到達可能であることを確認する必要があります。バイナリはプラットフォーム固有であり、Linuxコンテナへの切り替えが必要です。
リモートIronPDFEngineサーバーに接続するようにIronPDFを構成するにはどうすればよいですか?
リモートサーバー用にIronPDFを構成するには、Installation.ConnectToIronPDFHostをIronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServerメソッドと共に使用し、サーバーのIPとポートの詳細を指定します。
IronPDFEngineを使用する際にアプリケーションのサイズを最小化するためにはどのパッケージを使用すればよいですか?
アプリケーションサイズを削減するためにIronPDFをIronPDFEngineで実行するのに必要なコンポーネントのみを含むIronPdf.SlimパッケージをNuGetから使用するべきです。

