如何将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。


教程

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 文档到您的解决方案目录中的 ~/Libs 位置
  2. 在 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。 每个位于同一应用程序池中的应用程序都需要拥有自己的临时文件夹,以便完全独立地运行。

如有必要,您可以按以下方式设置权限:

  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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
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 兼容性