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

如何在 .NET 项目中安装 IronPDF 库

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 包可用于特定部署，以 Mac, Linux, Azure, Docker 我们的 IronPDF 高级 NuGet 安装指南.

1.2.通过 DLL 下载安装 IronPDF

安装 IronPDF 的第二种方法是下载。请按照以下简单快捷的步骤操作：

1.下载并解压 Windows IronPDF 文件 到解决方案目录下的 ~/Libs 等位置

2.在 Visual Studio 解决方案资源管理器中，右键单击 "依赖项"，然后单击 "添加项目引用"。选择 "浏览 "并包含从压缩包中提取的所有 dll。

以下是适用于特定平台的其他 IronPDF DLL 压缩包：

申请许可证密钥

在使用 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 作为 PDF因此，IronPDF 必须嵌入 Chromium，这是一种安全的网络浏览器。幸运的是，这一过程是完全自动化的。

如果 IronPDF 的 HTML to PDF 出现 "渲染失败 "异常（这种可能性很小），您可能需要将本地浏览器二进制文件解压缩到一个适当的位置。Temp 文件夹通常是理想的位置。

注意：程序文件从来不是合适的位置。

设置 IronPdf.Installation.TempFolderPath

通过设置 IronPdf.Installation.TempFolderPath 属性，您可以解压到正确的位置。 IronPdf.Installation 对象，如图所示：

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

更新路径后，请务必记住清除开发和服务器上的所有临时文件夹和缓存文件夹。重新部署干净版本的应用程序。

在应用程序范围设置 Temp 文件夹环境变量

在渲染和编辑 PDF 文档时，IronPDF 有时会在系统临时文件夹中生成临时文件。我们可以设置 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++ 是一种视窗组件，通常存在于现代视窗版本中，除非被刻意删减。

.NET Framework 可作为 32 位 (即使在 64 位平台上)因此，有必要安装 32 位和 64 位版本的 Visual C++。

您可以 下载 Microsoft Visual C++.

6.Linux 兼容性

7.Docker 兼容性

8.与 Azure 的兼容性

9.亚马逊 AWS Lambda 兼容性

10. MacOS 兼容性