如何將 IronPDF 庫安裝到 .NET 項目中

查克尼思·賓

2023年1月25日

已更新 2024年10月20日

Translated

View the article in English

安裝 C# PDF library 不超過5分鐘。

可用於開發的免費軟體可通過 NuGet 和直接下載獲得，透過本教程，我們將在 Visual Studio 中幫助您開始使用。請按照以下說明在您的 .NET 項目中開始將 HTML 轉換為 PDF。

逐步安裝C# PDF庫

透過 NuGet 安裝
透過直接下載安裝
授予正確路徑或資料夾的訪問權限
設定安裝路徑
獲得對 Docker、Linux 等的支持

如何操作教程

1.1 透過 NuGet 安裝 IronPDF

請按照以下步驟從 Visual Studio 中安裝IronPDF NuGet 庫。

在解決方案總管中，右鍵點擊參考，管理 NuGet 包裹。
選擇瀏覽並搜尋"IronPdf"
選擇套件並安裝。

Install-Package IronPdf

還有適用於特定部署的 IronPDF NuGet 套件可供使用，IronPDF 進階 NuGet 安裝指南中有詳細記載。

1.2. 安裝 IronPDF 透過 DLL 下載

IronPDF 的第二種安裝方式是通過下載進行。請遵循以下快速且簡易的步驟：

下載並解壓縮 Windows IronPDF DLL 套件到您的解決方案目錄中的 ~/Libs 等位置
在 Visual Studio 的解決方案總管中，右鍵點擊“相依性”，然後選擇“加入專案參考”。選擇瀏覽並包含從zip提取的所有DLL。
以下是適用於特定平台的其他 IronPDF DLL 壓縮包：

套用授權碼

在您的應用程式啟動時，使用 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 授權金鑰指南' 以探索替代方法。

2. 授予對文件或文件夾的必要訪問權限

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

例如，每個AppPool中的應用程式不能共用一個TempFolderPath。

现在这是什么意思？

AppDomain 僅僅在某個進程中提供一個隔離層。您認為是每個程序的事實上是每個AppDomain的。每個相同應用程式池中的應用程式都需要其自己的臨時文件夾，以便完全獨立運作。

如果需要使用上述的任何疑難排解選項，您可以按以下方式設定權限：

右鍵點擊一個文件或文件夾
選擇屬性
選擇安全性
點擊編輯...
選擇所需的權限。

3. 設定安裝路徑

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

如果 IronPDF 的 HTML 轉 PDF 拋出“渲染失敗”的例外，這種情況非常罕見，您可能需要將原生瀏覽器二進制文件解壓到適當的位置。 Temp 資料夾通常是理想的選擇。

注意：永遠不要將程式檔案放置在 Program Files 資料夾中。

設定 IronPdf.Installation.TempFolderPath

您可以透過設置 IronPdf.Installation 物件的 TempFolderPath 屬性，來解壓縮到正確的位置，如下所示：

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

在更新路徑後，請務必記得清除開發環境和伺服器上的所有臨時檔案和快取資料夾。重新部署您的應用程式的乾淨版本。

在應用程式範圍設定臨時資料夾環境變數

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