IronPDF C# PDFライブラリで始める方法

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

IronPDFは、プロジェクトやワークフロー内でPDFファイルを生成、編集、エクスポートするための詳細な制御を提供する包括的で多機能なソフトウェアライブラリです。 その出力におけるあらゆる側面と詳細も同様に。

この強力なツールには、C#、F#、VB.NET、Javaなど、さまざまな言語のサポートがあります。 それはあなたのPDF問題に対する最良の解決策です。 この記事では、C# IronPDF インストール メソッドについて説明します。

開発用の無料ソフトウェアは、NuGetおよび直接ダウンロードで利用可能です。 以下の手順に従って、.NETプロジェクトでHTMLをPDFに変換し始めましょう。

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:
green arrow pointer

IronPDFのインストール方法:ネイティブ vs リモート、適切なモードの選択

IronPDFは、異なる開発環境に適した2つのPDFレンダリングモード、ネイティブモードリモートモードを提供しています。

ネイティブモード: すべてをローカルで実行したい開発者に最適で、現代のWindows、macOS、およびLinuxのデプロイメントに適しています。 次のパッケージをインストールするだけです。

  • IronPdf

    リモートモード (IronPdfEngine): 依存関係を中央管理できるAzure、AWS、Dockerのようなクラウドおよびコンテナ化環境に最適です。 また、Windows Server 2012やあまり人気のないLinuxディストリビューションなど、ネイティブでサポートされていないまたはレガシーのOSにも最適です。 プロジェクトに次のパッケージをインストールし、IronPdfEngine コンテナに接続してください。

  • IronPdf.Slim

リモートエンジンでIronPDFを使用する

次の内容にご注意ください。
ネイティブとエンジンの違いは何ですか?

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

エンジンを使用すると、IronPDF のコーディング方法がどのように変わりますか?

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

PM> Install-Package IronPdf.Slim

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

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
$vbLabelText   $csharpLabel

.NETプロジェクトにIronPDFライブラリをインストールする方法(ネイティブ)

C# PDFライブラリのインストールは簡単で、5分以内に完了します。

開発用の無料ソフトウェアは、NuGetおよび直接ダウンロードを通じて利用可能であり、このチュートリアルを使用して、Visual Studioでの設定と稼働をサポートします。 以下の手順に従って、.NETプロジェクトでHTMLをPDFに変換し始めましょう。


チュートリアルの方法

方法 1: IronPDFをNuGet経由でインストールする

次の手順を使用して、Visual Studio 内で IronPDF NuGet ライブラリ をインストールします。

  1. ソリューション エクスプローラーで「参照」を右クリックし、「NuGet パッケージの管理」を選択します

  2. 「参照」ボタンを選択し、IronPdfを検索します。

  3. パッケージを選択してインストールしてください。
Install-Package IronPdf

また、特定のデプロイメント向けに、MacLinuxAzureDocker、およびAWS用のIronPDF NuGetパッケージが用意されています。詳細はIronPDFの高度なNuGetインストールガイドに記載されています。


方法 2: DLLをダウンロードしてIronPDFをインストールする

IronPDFをインストールする2つ目の方法は、ダウンロードすることです。 以下の簡単な手順に従ってください:

以下は、特定のプラットフォーム向けに提供されている他のIronPDF DLL zipパッケージです:

Operating System ZIP Package
Windows IronPdf.zip
Linux IronPdf.Linux.zip
Mac IronPdf.MacOs.zip
  • お使いのオペレーティングシステムに適したZIPファイルをダウンロードして解凍し、ソリューションディレクトリ内の~/Libsなどの場所に保存してください。
  • Visual Studio ソリューション エクスプローラーで、「Dependencies」を右クリックし、「プロジェクト参照を追加」を選択します。 「参照」を選択し、zipから抽出したすべてのdllを含めます。

ライセンスキーを適用

アプリケーションの起動時に、IronPDFを使用する前に次のコードを含めてください。 このアプローチは普遍的に効果的で、実装が簡単です。

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

ライセンスキーをインラインコードで適用したくない場合は、代替方法を探るために'IronPDF License Keys'の記事をご覧ください。


ファイルまたはフォルダへの必要なアクセス権を付与する

場合によっては、特定のユーザーや役割に対してPC上の権限を追加する必要があるかもしれません。

たとえば、各AppDomainはそれぞれ独自のTempFolderPathを必要とし、同じAppPool内のアプリケーションはTempFolderPathを共有することはできません。

さて、これはどういう意味でしょうか?

AppDomainは、特定のプロセス内で隔離のレイヤーを提供するだけです。 あなたがプログラムごとだと思っているすべてのものは、実際にはAppDomainごとです。 以下の各アプリケーションは完全に独立して機能するために、同じアプリケーションプール内にそれぞれ独自の一時フォルダーが必要です。

以下のいずれかのトラブルシューティングオプションが必要な場合、次の方法で権限を設定できます:

  1. ファイルまたはフォルダーを右クリック

  2. プロパティを選択

  3. セキュリティを選択

  4. 編集をクリック...

  5. 必要な権限を選択してください。


インストールパスの設定

HTMLをPDFとしてレンダリングするには、IronPDFが安全なウェブブラウザであるChromiumを埋め込む必要があります。 幸運にも、このプロセスは完全に自動化されています。

IronPDFのHTML to PDFが「レンダリング失敗」例外をスローする場合(これは非常に稀です)、ネイティブブラウザーのバイナリを適切な場所に展開する必要があるかもしれません。 一時フォルダーは通常理想的です。

注意:Program Filesは適切な場所ではありません。

IronPdf.Installation.TempFolderPathの設定

こちらに示すように、IronPdf.Installation オブジェクトの TempFolderPath プロパティを設定することで、適切な場所に解凍できます。

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

パスを更新した後は、必ず開発環境およびサーバー上のすべてのテンポラリフォルダとキャッシュフォルダをクリアしてください。 アプリケーションのクリーンバージョンを再デプロイします。

アプリケーションスコープでの一時フォルダ環境変数の設定

IronPDFは、PDFドキュメントをレンダリングおよび編集する際に、システムの一時フォルダに一時ファイルを生成することがあります。 IronPDFの問題を回避するために、IronPdf.Installation.TempFolderPathを設定することもできますが、サードパーティパッケージによって環境TempPathディレクトリが使用される場合があります。

この問題を解決するために、C#アプリケーションの起動時にTempPath環境変数をアプリケーション全体で設定することができます。これにより、アプリケーションによって作成されるすべての一時ファイルが制御可能な場所に保存されることが保証されます。

using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf

' Set Application scope Temp Files Path.
' This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
Private MyTempPath = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code here..E.G.
Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
$vbLabelText   $csharpLabel

4. 権限およびIIS

サーバーがロックダウンされた場合、インストールパスフォルダー、およびWindowsとTempフォルダーに対して、IISユーザー(IUSER)に読み取りおよび書き込み権限を与える必要があるかもしれません。


5. Microsoft Visual C++ および Windows との互換性

IronPDFは、ターゲットのWindowsマシンにMicrosoft Visual C++がインストールされている必要があります。必要に応じて、MSIなどのアプリケーションインストーラーと一緒にパッケージ化することができます。

Microsoft Visual C++ は Windows のコンポーネントであり、意図的に削除されていない限り、通常は最新のバージョンの Windows に存在します。

.NET Frameworkは32ビットとして実行可能です(64ビットプラットフォームでも)、そのためにはVisual C++の32ビット版と64ビット版の両方をインストールする必要があります。

ここでMicrosoft Visual C++をダウンロードできます。


6. Linux 互換性

7. Docker互換性

8. Azure互換性

  • Azure WebApps、Azure WebJobs、Azure Functions、Azure Dockerインスタンス、およびAzure VMを正式にサポートしています。
  • IronPDF Azure & Azure Function 設定ガイドをお読みください。

9. Amazon AWS Lambda 互換性

10. macOS互換性