Use IronPDF in the engine mode

This article was translated from English: Does it need improvement?
Translated
View the article in English

NativeとEngineの違い

IronPDFには、リモートで実行することを選択できる、処理負荷の高い機能がいくつかあります。 IronPDFはIronPdfEngineなしでも動作しますが、IronPdfEngineをリモートサービスとして設定することは、古いオペレーティングシステムやモバイル環境におけるChromeのプラットフォーム固有の互換性問題を回避するためのオプションの方法です。

IronPDF を始める

今日あなたのプロジェクトでIronPDFを無料トライアルで使用開始。

最初のステップ:
green arrow pointer


Engineの利用が、IronPDFを用いたコーディングの在り方をどう変えるか

Engine構成を使用する場合、NuGetからIronPdf.Slimをインストールすることを推奨します。これは、Nativeパッケージに含まれる余分なデータはすべてEngineによって管理されるためです。

Install-Package IronPdf.Slim

IronPdf.Slim をインストールした後、IronPDF を IronPdfEngine インスタンスに指定して接続設定を行ってください。 アプリケーションの起動時(またはIronPDFメソッドを呼び出す前)に、以下のコードを追加してください:

C#コードに追加する設定コードの1行

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.Co/nnectToIronPdfHost(
    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.Co/nnectToIronPdfHost(
    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
$vbLabelText   $csharpLabel

IronPdfEngineはどのように機能しますか?

IronPdfEngineは、PDFの作成、書き込み、編集、読み取りなど、さまざまなIronPDF操作をgRPCプロトコルを使用して管理するために設計されたコンテナ化サーバーです。 IronPdfEngineは、独立したC# .NETアプリケーションとして構築されており、実行時に.NETランタイムを必要とせずに動作します。 gRPC接続は当社が代行しますので、お客様はコーディングに集中していただけます!

IronPDFを独自のコンテナとして実行するためのクイックスタートチュートリアルについては、こちらのチュートリアルを参照してください。 この Docker コンテナは、ポート、ロギング、Chrome の制限などに関する 16 のランタイム設定パラメータをサポートしています。詳細についてはパラメータリファレンスを参照してください。

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

IronPdf.Slim NuGet パッケージは、Remote IronPdfEngine を使用して IronPDF for .NET を利用する際に必要な唯一のパッケージです。

IronPdf.slimを使用することもできます。

IronPdfEngineが123.456.7.8:33350でリモート実行されていると仮定します。

NuGet を使用して IronPDF をインストールします:

Install-Package IronPdf.Slim

IronPdf.slimをインストールした後、IronPDFにIronPdfEngineの場所を指定するだけで済みます(そのアドレスがアクセス可能であり、ファイアウォールによってブロックされていないことを確認してください)。 接続設定を行うには、IronPdfConnectionConfiguration クラスを使用してください。 以下のコードを、アプリケーションの初期段階(またはIronPDFメソッドを呼び出す直前)に追加してください。

// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
$vbLabelText   $csharpLabel

以上です! これで、アプリケーションがリモート IronPdfEngine に接続されます!


IronPdfEngine の制限事項

  • 現在、IronPdfEngine自体は水平スケーリング(複数のエンジンインスタンス間での負荷分散)をサポートしていません。これは、エンジンが処理中のPDFバイナリをサーバーのメモリに保持し、PdfDocumentIdを使用してサーバーとクライアント間の連携を行っているためです。 この設計により、帯域幅の使用量が最小限に抑えられ、処理速度が向上します。 なお、この制限はIronPdfEngineサービスにのみ適用されます。IronPDFライブラリを使用するアプリケーション(IronPdfEngineの有無にかかわらず)は、複数のアプリケーションインスタンスを展開することで、引き続き水平スケーリングが可能です。
  • IronPdfEngine Dockerをリモートで実行するには、IronPdfEngineのポートにアクセスできることを確認する必要があります。
  • Linux x64 (Debian) 上で、公式の ubuntu:22.04 ベースのイメージを使用して 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.ConnectToIronPDFHostIronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServerメソッドと共に使用し、サーバーのIPとポートの詳細を指定します。

IronPDFEngineを使用する際にアプリケーションのサイズを最小化するためにはどのパッケージを使用すればよいですか?

アプリケーションサイズを削減するためにIronPDFをIronPDFEngineで実行するのに必要なコンポーネントのみを含むIronPdf.SlimパッケージをNuGetから使用するべきです。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 19,014,616 | バージョン: 2026.5 just released
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。