如何在 .NET 项目中安装 IronPDF 库
安装 C# PDF 库 只需不到 5 分钟。
这款免费的开发软件可通过 NuGet 或直接下载获得,本教程将帮助您在 Visual Studio 中运行。请按照以下说明开始在您的 .NET 项目中将 HTML 转换为 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
如果您不想使用内嵌代码应用许可证密钥,请访问"......"。IronPDF 许可证密钥'一文来探讨替代方法。
2.允许对文件或文件夹进行必要的访问
有时可能需要为电脑上的某些用户或角色添加权限。
例如,每个 应用程序域 需要有自己的 临时文件夹路径 和应用程序在同一 应用程序池 不能共享 TempFolderPath。
这意味着什么?
AppDomain 只是在某个进程中提供了一层隔离。你所认为的每个程序实际上都是每个 AppDomain。同一应用程序池中的每个应用程序都需要有自己的临时文件夹,才能完全独立运行。
如果需要上述任何故障排除选项,可以按以下方式设置权限:
右键点击文件或文件夹
选择属性
选择安全
单击编辑...
- 选择所需的权限。
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")
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++。
6.Linux 兼容性
- IronPDF 支持 Linux。我们正式支持 Ubuntu、Debian、CentOS、Fedora 和 Amazon Linux 2.
- 在 Linux 上部署 IronPDF 有据可查,是 Azure 等云部署的热门选择。
7.Docker 兼容性
- 在 Docker 上部署 IronPDF 有据可查。
- 我们正式支持以下版本的 DockerWindows、Ubuntu、Debian、CentOS 和 Amazon Linux 2,并提供 工作的 Docker 文件.
8.与 Azure 的兼容性
- 正式支持 Azure WebApps、Azure WebJobs、Azure Functions 以及 Azure Docker 实例和 Azure VM。
- 阅读 IronPDF Azure 和 Azure 函数设置指南.
9.亚马逊 AWS Lambda 兼容性
- A 亚马逊 AWS Lambda 教程和支持 包括在内。
10. MacOS 兼容性
- 为 macOS 部署和开发提供官方支持 支持使用 Rider 和 "Visual Studio for Mac
- 请阅读我们的 全面的 macOS 指南.