インエンジンモードでIronPDFを使う
ネイティブとエンジンの違い
IronPDFには、リモートで実行することを選択できるパフォーマンス集約的な関数があります。 IronPDFは実行するためにIronPDFEngineを必要としませんが、リモートサービスとしてIronPDFEngineを設定することは、古いオペレーティングシステムやモバイル環境でのプラットフォーム固有のChrome互換性の問題を回避するためのオプションです。
IronPDFの使い方
Start using IronPDF in your project today with a free trial.
Engineの使用により、IronPDFでのコーディング方法が変わります
Engine 構成を使用している場合、NuGet からの完全な IronPdf パッケージの代わりに IronPdf.Slim をインストールすることをお勧めします。これは、Engine がネイティブパッケージに含まれるすべての余分なバルクを管理するためです。
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 applicationIronPDFEngineはどのように機能するのか？
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を使用しません。
リモートIronPdfEngine用のIronPDF .NET
リモートIronPdfEngineを使用するには、IronPDF for .NETに必要な唯一のパッケージはIronPdf.slim NuGetパッケージです。
IronPdf または IronPdf.Linux を使用している場合、アプリケーションのサイズを減らすために IronPdf.slim を代わりに使用することができます。
IronPdfEngine がリモートで 123.456.7.8:33350 で実行されていると仮定します。
IronPDFをNuGetでインストールします：
IronPdf.slim をインストールした後、IronPDF に IronPdfEngine の場所を指定するだけです（アドレスがアクセス可能で、ファイアウォールによってブロックされていないことを確認してください）。 IronPDFConnectionConfigurationクラスを使用して接続設定を構成します。 以下のコードをアプリケーションの初期段階に追加するか、またはIronPDFのメソッドを呼び出す直前に追加します。
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);Imports IronPdf
' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)Simple as that! これにより、アプリケーションはリモートIronPDFEngineに接続されます！
IronPDFEngineの制限
- 現在、IronPdfEngine自体は水平スケーリング（複数のエンジンインスタンス間の負荷分散）をサポートしていません。その理由は、エンジンが進行中のPDFバイナリをサーバーのメモリに保持し、PdfDocumentIdを使用してサーバーとクライアント間の調整を行うからです。 このデザインは帯域幅の使用を最小限に抑え、処理速度を向上させます。 この制限はIronPdfEngineサービスのみに適用されることに注意してください。IronPDFライブラリを使用しているアプリケーション（IronPdfEngineの有無にかかわらず）は、複数のアプリケーションインスタンスをデプロイすることで水平スケーリングを行うことができます。
- IronPDFEngine Dockerをリモートで実行する場合は、IronPDFEngineポートが到達可能であることを確認する必要があります。
- 公式のubuntu:22.04ベースのイメージを使用してLinux x64（Debian）で実行されているIronPdfEngine Dockerは、異なる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から使用するべきです。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。
