インエンジンモードでIronPDFを使う

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でのコーディング方法が変わります

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
$vbLabelText   $csharpLabel

IronPDFEngineはどのように機能するのか?

IronPDFEngineは、gRPCプロトコルを使用してPDFの作成、書き込み、編集、および読み取りを含むさまざまなIronPDF操作を管理するために設計されたコンテナ化されたサーバーです。 自己完結型の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とリモート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"))
$vbLabelText   $csharpLabel

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.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 ダウンロード 18,560,885 | バージョン: 2026.4 リリース
Still Scrolling Icon

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

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