.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に変換し始めましょう。


チュートリアルの方法

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

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

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

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

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

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


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

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

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

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

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

ライセンスキーを適用

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

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
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.Installationここに示すようにオブジェクト:

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

4. 権限およびIIS

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


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

IronPDFはMicrosoft Visual C++がターゲットWindowsマシンにインストールされている必要があります。必要であればMSIのようなアプリケーションインストーラを同梱することもできます。

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

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

ここでは公式サポートページからMicrosoft Visual C#++をダウンロードしてください。.


6. Linux 互換性

7. Docker互換性

8. Azure互換性

9. Amazon AWS Lambda 互換性

10. macOS互換性