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

Translated

View the article in English

安裝中C# PDF程式庫需要不到5分鐘。

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

逐步安裝C# PDF庫

透過NuGet安裝
直接下載安裝
授予對正確路徑或資料夾的存取權限
設定安裝路徑
提供對 Docker、Linux 和更多技術支持

如何操作教程

1.1 透過 NuGet 安裝 IronPDF

使用以下幾個步驟來安装IronPDF NuGet 庫從 Visual Studio 內部。

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

Install-Package IronPdf

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

1.2. 安裝 IronPDF 透過 DLL 下載

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

下載並解壓縮WindowsIronPDF 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"

VB C#

如果您不想使用內嵌代碼來應用許可證密鑰，請訪問 'IronPDF 授權金鑰指南「以探索替代方法。」

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

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

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

现在这是什么意思？

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

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

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

3. 設定安裝路徑

To renderHTML 為 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 來解決此問題，但環境 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#