1. IronPDF
  2. ドキュメント
  3. はじめに

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 .NETプロジェクトにパッケージします。

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

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

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

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

Engineを使用することでIronPDFでのコーディング方法はどのように変わりますか？

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

PM> Install-Package IronPdf.Slim

IronPdf.Slimをインストールした後、IronPDFをIronPdfEngineインスタンスに向けることで接続設定を構成します。 アプリケーションのスタートアップに次のコードを追加します。(または、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"))
VB   C#

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

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

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

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

Pdf In Csharp No Button related to .NETプロジェクトにIronPDFライブラリをインストールする方法（...

チュートリアルの方法

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

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

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

  2. 「参照」を選択し、IronPdfを検索してください。

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

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

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

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

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

  • 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"
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";

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

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

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を正式にサポートしています。
  • IronPDFを読むAzureとAzure Function設定ガイド.

9. Amazon AWS Lambda 互換性

10. macOS互換性