1. IronPDF
  2. ハウツー
  3. インストール

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

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

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

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

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

チュートリアルの方法

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

次のいくつかのステップを使用してをインストールします IronPDF NuGetライブラリ Visual Studio 内から。

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

  2. 「IronPdf」を選択して検索

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

以下に特定のデプロイメントのためのIronPDF NuGetパッケージも利用可能です Mac, Linux (リナックス), Azure (アジュール), Docker (ドッカー) 私たちの文書化されたAWSに関して IronPDF高度なNuGetインストールガイド.

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

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

  1. Windowsをダウンロードして解凍してください IronPDFファイル ソリューションディレクトリ内の ~/Libs などの場所へ

  2. Visual Studio ソリューション エクスプローラーで、「Dependencies」を右クリックし、「プロジェクト参照を追加」を選択します。 「参照」を選択し、zipから抽出したすべてのdllを含めます。

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

ライセンスキーを適用

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

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

ライセンスキーをインラインコードで適用することを好まない場合は、「IronPDFライセンスキー「記事で代替方法を探る。」

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

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

例えば、各 AppDomain（アプリケーションドメイン） 独自のものを必要とします テンポラリフォルダパス 同じ内でのアプリケーション アプリケーションプール TempFolderPathを共有できません。

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

AppDomainは、特定のプロセス内で隔離のレイヤーを提供するだけです。 以下の内容を日本語に翻訳してください：

あなたが per-program と考えているすべてのものは、実際には per-AppDomain です。 以下の各アプリケーションは完全に独立して機能するために、同じアプリケーションプール内にそれぞれ独自の一時フォルダーが必要です。

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

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

  2. プロパティを選択

  3. セキュリティを選択

  4. クリック 編集…

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

インストールパスの設定

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

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

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

IronPdf.Installation.TempFolderPathの設定

適切な場所に展開するには、TempFolderPathプロパティを設定してください。 IronPDFのインストール ここに示すようにオブジェクト:

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")
VB   C#

4. 権限およびIIS

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

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

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

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

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

ここでは Microsoft Visual C++ をダウンロード.

6. Linux 互換性

7. Docker互換性

8. Azure互換性

  • Azure WebApps、Azure WebJobs、Azure Functions、Azure Dockerインスタンス、およびAzure VMを正式にサポートしています。
  • アイアンPDFを読む AzureとAzure Function設定ガイド.

9. Amazon AWS Lambda 互換性

10. macOS互換性