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

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

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

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

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

IronPDFを独自のコンテナとして実行するためのクイックスタートチュートリアルには、このチュートリアルを参照してください。

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 または IronPdf.Linux を使用している場合は、代わりに 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.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 ダウンロード 17,803,474 | バージョン: 2026.3 リリース
Still Scrolling Icon

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

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