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

ネイティブとエンジンの違い

IronPDFには、リモートで実行することを選択できるパフォーマンス集約的な関数があります。 IronPDFは実行するためにIronPDFEngineを必要としませんが、リモートサービスとしてIronPDFEngineを設定することは、古いオペレーティングシステムやモバイル環境でのプラットフォーム固有のChrome互換性の問題を回避するためのオプションです。

IronPDFの使い方

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

最初のステップ：

無料で始める

---

Engineの使用により、IronPDFでのコーディング方法が変わります

Engine 構成を使用している場合、NuGet からの完全な IronPdf パッケージの代わりに IronPdf.Slim をインストールすることをお勧めします。これは、Engine がネイティブパッケージに含まれるすべての余分なバルクを管理するためです。

Install-Package IronPdf.Slim

IronPdf.Slim をインストールした後、IronPDF を IronPdfEngine インスタンスにポイントして接続設定を構成します。 アプリケーションのスタートアップ(または任意のIronPDFメソッドを呼び出す前)に以下のコードを追加します。

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-2.cs

// 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に関するその他の説明

IronPDF .NETはIronPdfEngineを実行するために必要ありません。 IronPdfEngineは単にIronPDFを使用するためのオプションの方法です。 デフォルトでは、IronPDF for .NETはIronPdfEngineを使用しません。

Install-Package IronPdf.Slim

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-4.cs

// 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")
)

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バイナリはクロスプラットフォームではないため、各プラットフォーム専用にビルドします。
• バージョン間の互換性サポートはありません。