如何将IronPDF库安装到.NET项目中

查克尼特·宾

2023年一月25日

更新 2024年十月20日

Translated

View the article in English

安装C# PDF库只需不到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

我们的Docker和AWS提供的IronPDF NuGet包。

1.2 通过DLL下载安装IronPDF

可以通过下载来安装IronPDF，这是第二种方法。遵循以下简单快捷的步骤：

下载并解压Windows IronPDF DLL包到您的解决方案目录中的~/Libs等位置
在 Visual Studio 解决方案资源管理器中，右键单击 "依赖项"，然后单击 "添加项目引用"。选择浏览并包含从压缩包中提取的所有 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 License Keys Guide”以探索其他方法。

2. 授予文件或文件夹必要的访问权限

有时可能需要在您的电脑上为某些用户或角色添加权限。

例如，每个AppPool中的应用程序不能共享TempFolderPath。

现在这是什么意思？

AppDomain 只是在特定进程内提供一个隔离层。您认为的每个程序实际上是每个AppDomain。每个位于同一应用程序池中的应用程序都需要拥有自己的临时文件夹，以便完全独立地运行。

如有必要，您可以按以下方式设置权限：

右键单击文件或文件夹
选择属性
选择安全性
点击编辑...
选择所需的权限。

3. 设置安装路径

要将HTML 渲染为 PDF，IronPDF 必须嵌入 Chromium，这是一种安全的网络浏览器。幸运的是，这个过程是完全自动化的。

如果IronPDF的HTML转PDF遇到“渲染失败”的异常，这种情况虽然很罕见，但您可能需要将本地浏览器的二进制文件解压到适当的位置。临时文件夹通常是理想的选择。

注意：程序文件永远不是一个合适的位置。

设置 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