1. IronPDF
  2. 操作指南
  3. 安裝

如何將IronPDF庫安裝到.NET專案

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. 通過 NuGet 安裝 IronPDF

使用以下幾個步驟來安裝 IronPDF NuGet 庫 在 Visual Studio 中。

  1. 在方案總管中，右鍵點擊 References，選擇管理 NuGet 套件

  2. 選擇瀏覽並搜尋 "IronPdf"

  3. 選擇套件並安裝。
Install-Package IronPdf

還有 IronPDF NuGet 套件可用於特定部署 麦金塔, Linux, Azure, Docker 和 AWS 記錄在我們的 IronPDF 高級 NuGet 安裝指南.

1.2. 通過下載 DLL 安裝 IronPDF

第二種安裝 IronPDF 的方法是通過下載。請按照以下簡單快速的步驟操作：

  1. 下載並解壓縮 Windows IronPDF 文件 到您的解決方案目錄中的 ~/Libs 這樣的位置

  2. 在 Visual Studio 解決方案資源管理器中，右鍵點擊「Dependencies」並選擇「添加專案參考」。選擇瀏覽並包含從 zip 解壓縮的所有 dll。

以下是其他可用於特定平台的 IronPDF DLL 壓縮包： Windows

套用授權碼

在使用 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 授權金鑰探索替代方法的文章。

2. 授予檔案或資料夾必要的訪問權限

有時可能需要為您的電腦上的某些用戶或角色添加權限。

例如，每个 應用程式域 需要自己的 臨時資料夾路徑 和應用程式相同 應用程式集區 無法共享TempFolderPath。

這意味著什麼？

AppDomain 只是提供了一個在特定進程中的隔離層。您認為的每個程序實際上是每個AppDomain。每個在同一應用程序池中的應用程序需要自己單獨的臨時文件夾才能完全獨立運行。

如果上述任何故障排除選項需要，您可以以下列方式設置權限：

  1. 右鍵單擊文件或文件夾
  2. 選擇屬性
  3. 選擇安全性
  4. 單擊編輯…
  5. 選擇所需的權限。

3. 設定安裝路徑

要渲染 HTML 為 PDFIronPDF 必須嵌入 Chromium，它是一個安全的網頁瀏覽器。幸運的是，此過程完全自動化。

如果 IronPDF 的 HTML 到 PDF 轉換拋出「渲染失敗」異常，這是非常不可能的，你可能需要將本地瀏覽器二進制文件解壓縮到適當的位置。Temp 文件夾通常是理想的位置。

注意：Program Files 永遠不是適當的位置。

設定 IronPdf.Installation.TempFolderPath

您可以透過設置 TempFolderPath 屬性來將文件解壓到正確的位置 IronPdf.Installation 對象如圖所示：

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

更新路徑後，請記得清除開發和服務器上的所有臨時和緩存文件夾。重新部署一個乾淨版本的應用程式。

設置應用程式範圍內的臨時文件夾環境變量

IronPDF 在渲染和編輯 PDF 文檔時偶爾會在系統臨時文件夾中生成臨時文件。我們可以設置IronPdf.Installation.TempFolderPath來解決此問題，但環境臨時路徑目錄有時仍可能被第三方包使用。

為了解決這個問題，我們可以在 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 位平台上)因此，有必要安裝 Visual C++ 的32位元和64位元版本。

在這裡你可以 下載 Microsoft Visual C++.

6. Linux 相容性

7. Docker 相容性

8. Azure 相容性

9. Amazon AWS Lambda 兼容性

10. macOS 相容性