1. IronPDF
  2. 文档
  3. 入门

如何开始使用 IronPDF C# PDF 库

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 是我们全面且多功能的软件库，可为您提供对项目或工作流程中生成、编辑和导出 PDF 文件的完全细致控制。 以及输出中的每个方面和细节。

这个强大的工具支持多种语言，例如 C#、F#、VB.NET、Java 等。 这是解决您PDF问题的最佳方案。 本文将介绍C# IronPDF安装方法。

可通过NuGet和直接下载获取开发用免费软件。 按照以下说明开始在您的 .NET 项目中将 HTML 转换为 PDF。

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：
green arrow pointer

如何安装IronPDF：选择正确的模式：本地 vs 远程

IronPDF 提供了两种用于渲染 PDF 的模式——Native Mode 和 Remote Mode——以适应不同的开发环境：

  • 本地模式：最适合希望在本地运行所有内容的开发人员，适用于现代 Windows、macOS 和 Linux 部署。 只需安装 IronPdf 将其打包到您的.NET项目中。

  • 远程模式(IronPdfEngine)理想适用于云和容器化环境，如 Azure、AWS 和 Docker，可以集中管理依赖项。 也非常适用于不受原生支持或遗留的操作系统，例如 Windows Server 2012 和较不受欢迎的 Linux 发行版。 只需安装 IronPdf.Slim 打包到您的.NET项目并托管 IronPdfEngine 在容器中。

使用IronPDF与远程引擎结合

请注意
Native 与 Engine 之间有什么区别？

IronPDF具有一些性能密集型功能，您可以选择远程运行。 虽然IronPDF不需要IronPdfEngine来运行，但将IronPdfEngine设置为远程服务是一种可选的方法，可避免在较旧的操作系统和移动环境中遇到特定平台的Chrome兼容性问题。

使用 Engine 会如何改变我使用 IronPDF 编码的方式？

在使用 Engine 配置时，我们建议安装 IronPdf.Slim 而不是从 NuGet 安装完整的 IronPdf 包，因为 Engine 负责管理 Native 包中的所有额外部分。

PM> Install-Package IronPdf.Slim

安装 IronPdf.Slim 后，通过将 IronPDF 指向您的 IronPdfEngine 实例来配置连接设置。 在应用程序启动时添加以下代码 (或在调用任何IronPDF方法之前):

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
VB   C#

如何将IronPDF库安装到.NET项目（本机）中

安装C# PDF 库简单且只需不到5分钟。

通过 NuGet 和直接下载提供的免费开发软件，本教程将帮助您在 Visual Studio 中快速启动和运行。 按照以下说明开始在您的 .NET 项目中将 HTML 转换为 PDF。

逐步安装 C# PDF 库

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

教程

方法 1：通过 NuGet 安装 IronPDF

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

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

  2. 选择浏览并搜索IronPdf

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

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

方法二：通过 DLL 下载安装 IronPDF

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

以下是针对特定平台的其他 IronPDF DLL 压缩包：

  • Windows -下载IronPdf.zip
  • Linux -下载 IronPdf.Linux.zip
  • Mac - 下载 IronPdf.MacOs.zip
  • 下载并解压缩适合您操作系统的ZIP文件到您的解决方案目录中的~/Libs等位置。
  • 在 Visual Studio 解决方案资源管理器中，右键单击“依赖项”并选择“添加项目引用”。 选择“浏览”并包含从zip中提取的所有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 兼容性