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 库

Pdf In Csharp No Button related to 如何将IronPDF库安装到.NET项目中

教程

1.1. 通过 NuGet 安装 IronPDF

请按照以下几个步骤进行安装IronPDF NuGet 库从Visual Studio中。

  1. 在解决方案资源管理器中，右击“引用”，管理NuGet包。

  2. 选择浏览并搜索“IronPdf”

  3. 选择软件包并安装。
Install-Package IronPdf

还有一些 IronPDF NuGet 包可用于特定部署，以Mac, Linux, Azure, Docker在我们的IronPDF 高级 NuGet 安装指南.

1.2 通过DLL下载安装IronPDF

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

  1. 下载并解压WindowsIronPDF DLL 包到您的解决方案目录中的 ~/Libs 位置

  2. 在 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"
VB   C#

如果您不想使用内嵌代码应用许可证密钥，请访问"......"。IronPDF 许可证密钥指南'探索其他方法。

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

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

例如，每个应用程序域需要有自己的临时文件夹路径和应用程序在同一应用程序池无法共享 TempFolderPath。

现在这是什么意思？

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

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

  1. 右键单击文件或文件夹

  2. 选择属性

  3. 选择安全性

  4. 点击编辑...

  5. 选择所需的权限。

3. 设置安装路径

To renderHTML 作为 PDFIronPDF必须嵌入Chromium，这是一种安全的网页浏览器。 幸运的是，这个过程是完全自动化的。

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

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

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

4. 权限和 IIS

在服务器被锁定的情况下，您可能需要给予IIS用户权限。(IUSER)您必须拥有安装路径文件夹以及 Windows 和 Temp 文件夹的读写权限。

5. 微软Visual C++和Windows兼容性

IronPdf 需要在目标 Windows 机器上安装 Microsoft Visual C++。如有必要，可将其打包到 MSI 等应用程序安装程序中。

Microsoft Visual C# 是 Windows 组件，通常存在于现代版本的 Windows 中，除非它们被刻意删减。

.NET Framework 可以运行为32位(即使在 64 位平台上)因此，需要在32位和64位版本中安装Visual C++。

在这里您可以从官方支持页面下载 Microsoft Visual C#.

6. Linux 兼容性

7. Docker 兼容性

8. Azure 兼容性

9. 亚马逊 AWS Lambda 兼容性

A亚马逊 AWS Lambda 的全面教程和支持包括在内。

10. macOS 兼容性