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

チャクニット・ビン

2023年1月25日

更新済み 2024年10月20日

共有:

Translated

View the article in English

C# PDF ライブラリのインストールは5分未満で完了します。

無償の開発用ソフトウェアは、NuGetや直接ダウンロードで入手できます。このチュートリアルでは、Visual Studioですぐに使えるようになる方法を紹介します。以下の手順に従って、.NETプロジェクトでHTMLをPDFに変換し始めましょう。

ステップバイステップのC# PDFライブラリインストール

NuGet経由でインストール
直接ダウンロードでインストール
正しいパスまたはフォルダーへのアクセスを許可する
インストールパスを設定する
Docker、Linux、その他のサポートを受ける

チュートリアルの方法

1.1. IronPDFをNuGet経由でインストール

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

ソリューションエクスプローラーで「参照」を右クリックし、「NuGet パッケージの管理」を選択します
「IronPdf」を選択して検索
パッケージを選択してインストールしてください。

Install-Package IronPdf

また、特定のデプロイメント用に、IronPDF上級NuGetインストールガイドに文書化されています。

DLLダウンロードによるIronPDFのインストール

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

Windows用のIronPDF DLLパッケージをダウンロードして解凍し、ソリューションディレクトリ内の~/Libsなどの場所に配置します。
Visual Studioのソリューションエクスプローラーで、「依存関係」を右クリックし、「プロジェクトリファレンスを追加」します。参照]を選択し、zipから抽出したすべてのDLLを含めます。

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

ライセンスキーを適用

アプリケーションの起動時に、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 Guide」をご覧ください。

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

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

たとえば、各AppPool内のアプリケーションはTempFolderPathを共有することはできません。

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

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

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

ファイルまたはフォルダーを右クリック
プロパティを選択
セキュリティを選択
クリック編集…
必要な権限を選択してください。

インストールパスの設定

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

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

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

IronPdf.Installation.TempFolderPathの設定

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

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

パスを更新した後は、開発環境とサーバー上のすべてのtempフォルダとcacheフォルダをクリアすることを忘れないでください。アプリケーションのクリーンバージョンを再デプロイします。

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

IronPDFは、PDFドキュメントをレンダリングおよび編集する際に、システムの一時フォルダに一時ファイルを生成することがあります。 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