---

概述

完成本教程后，您将能够：

• 从不同的来源（如URL、HTML、MVC视图）转换为PDF
• 使用用于不同输出 PDF 设置的高级选项进行交互
• 将您的项目部署到 Linux 和 Windows 上
• 使用 PDF 文档操作功能
• 添加页眉和页脚、合并文件、添加印章

• 使用Docker

  这种广泛的.NET Core HTML转PDF功能将有助于满足各种项目需求。

  ---

  步骤 1

1. 免费安装 IronPDF 库

IronPDF可以安装并用于所有.NET项目类型，如Windows应用程序、ASP.NET MVC和.NET Core应用程序。

要将 IronPDF 库添加到我们的项目中有两种方式，一种是通过 Visual Studio 编辑器使用 NuGet 进行安装，另一种是使用包管理控制台通过命令行进行安装。

使用 NuGet 安装

要使用 NuGet 将 IronPDF 库添加到我们的项目中，我们可以使用可视化界面(NuGet 软件包管理器)或使用软件包管理器控制台的命令：

1.1.1 使用 NuGet 软件包管理器

1- 右键点击项目名称 -> 选择管理 NuGet 包2- 从浏览器选项卡 -> 搜索 IronPdf -> 安装3- 单击确定4- 完成！

1.1.2 使用 NuGet 软件包控制台管理器

1- 从工具 -> NuGet 软件包管理器 -> 软件包管理器控制台2- 运行命令 -> 安装软件包 IronPdf

---

教程

## 2.将网站转换为 PDF 样本ConvertUrlToPdf 控制台应用程序

按照以下步骤创建新的 Asp.NET MVC 项目

1- 打开 Visual Studio2- 选择创建新项目3- 选择控制台应用程序（.NET Core）4- 将样本命名为 "ConvertUrlToPdf"，然后点击创建5- 现在我们创建了一个控制台应用程序6- 添加 IronPdf => 点击安装

7- 添加前几行，将维基百科网站主页渲染为 PDF 格式

```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-1.cs ```

8- 运行并检查创建的文件 wiki.pdf

---

## 3.将 .NET Core HTML 转换为 PDF

样本ConvertHTMLToPdf 控制台应用程序

要将 HTML 转换为 PDF，我们有两种方法：
1- 将 HTML 写入字符串，然后进行渲染
2- 将 HTML 写入文件并将其路径传递给 IronPDF 以进行渲染

渲染 HTML 字符串的示例代码将如下所示。

```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-2.cs ```

生成的 PDF 将是这样的

---

## 4. 将MVC视图转换为PDF **示例：TicketsApps .NET Core MVC 应用程序** 让我们实施一个现实生活中的例子。 我选择了一个在线购票网站。打开网站，导航至“预订票务”页面，填写所需信息，然后将您的票据下载为PDF文件。 我们将遵循以下步骤： - [创建项目](#anchor-create-project) - [创建客户对象模型](#anchor-add-client-model) - [创建客户服务（添加、查看）](#anchor-add-client-services) - [设计订票页面](#anchor-design-ticket-booking-page) - [验证并保存预订信息](#anchor-validate-and-save-the-booking-information) - [下载 PDF 文件](#anchor-download-pdf-ticket) ### 创建项目 1. 选择 "ASP.NET Core Web应用程序(模型-视图-控制器)"项目。 2. 将项目命名为 "TicketsApps"。 3. 让我们使用启用了 Linux Docker 的 .NET 8。 在Dockerfile中，将“USER app”更改为“USER root”。 这将确保库获得足够的权限。 4. 现在可以了。 ### 添加客户端模型 1. 右键单击“Models”文件夹并添加类。 2. 将模型命名为 "ClientModel"，然后点击添加。 3. 将属性'name'、'phone'和'email'添加到ClientModel类中。 通过在每一个上添加“Required”属性，使它们全部成为必填项，如下所示： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-3.cs ``` ### 添加客户服务 1. 创建一个文件夹并将其命名为“services”。 2. 添加一个名为“ClientServices”的类。 3. 添加一个类型为“ClientModel”的静态对象，用作存储库。 4. 添加两个功能：一个用于将客户保存到仓库中，另一个用于检索已保存的客户。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-4.cs ``` ### 设计订票页面 1. 在解决方案资源管理器中，右键单击“Controllers”文件夹并添加一个控制器。 2. 将其命名为 "BookTicketController"。 3. 右击索引功能(我们称之为行动)并选择 "添加视图"。 4. 添加名为 "索引 "的视图。 5. 更新 HTML 如下 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-5.cs ``` 6. 添加一个导航链接，以便我们的网站访客能够导航到我们的新预定页面。 可以通过更新现有路径中的布局来完成此操作。(视图 -> 共享 -> \_Layout.cshtml). 添加以下代码： ```html

Book Ticket

``` 7. 结果应该是这样的 8. 导航至“预订票务”页面。 您应该会发现它看起来是这样的： ### 验证并保存预订信息 1. 添加另一个带有属性的索引操作[HttpPost]通知MVC引擎此操作用于提交数据。 验证发送的模型，如果有效，代码将重定向访问者到TicketView页面。 如果无效，访客将在屏幕上收到错误验证消息。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-7.cs ``` 错误信息示例 2. 在 "模型 "文件中创建一个票据模型，并添加如下代码 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-9.cs ``` 3. 将TicketView添加到我们的票证显示。 此视图将托管一个Ticket局部视图，该视图负责显示票据，并将用于稍后打印票据。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-8.cs ``` 4. 右键单击 TicketView 函数，选择“添加视图”，并将其命名为“TicketView”。 添加以下代码： ```html @model TicketsApps.Models.TicketModel @{ ViewData["Title"] = "TicketView"; } @Html.Partial("_TicketPdf", Model) @using (Html.BeginForm()) { @Html.HiddenFor(c => c.Email) @Html.HiddenFor(c => c.Name) @Html.HiddenFor(c => c.Phone) @Html.HiddenFor(c => c.TicketDate) @Html.HiddenFor(c => c.TicketNumber)} ``` 5. 右键单击 BookTicket 文件，添加另一个视图并命名为"\_TicketPdf"。添加以下代码 ```html @model TicketsApps.Models.TicketModel @{ Layout = null; }``` 6. 添加以下内容："[ticket.css](/img/tutorials/dot-net-core/ticket.css)"wwwroot/css"文件中的文件。 7. 将 IronPDF 添加到项目中并同意许可协议。 8. 添加将处理下载按钮的 TicketView post 方法。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-10.cs ``` 9. 在“Controller”文件中创建一个控制器，并将其命名为“ControllerExtensions”。 此控制器将部分视图渲染为字符串。 如下使用扩展代码： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-11.cs ``` 10. 运行申请并填写机票信息，然后点击 "保存"。 11. 查看生成的票据 ### 下载 PDF 文件 要将票证下载为PDF格式，请点击“下载PDF”。 您将收到一份包含门票的PDF文件。 您可以下载本指南的完整代码。它是一个压缩文件，您可以在Visual Studio中打开。 [点击此处下载项目。](/img/tutorials/dot-net-core/TicketsApps.zip)

---

## 5. .NET PDF 渲染选项图表 我们有一些高级选项可以定义PDF呈现选项，例如调整页边距， 纸张方向、纸张尺寸等。 下表展示了多种不同的选项。

---

## 6. .NET PDF 页眉页脚选项图表

---

## 7. 应用PDF打印（渲染）选项 让我们尝试配置我们的PDF渲染选项。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-12.cs ```

---

## 8.Docker .NET Core 应用程序 ### 8.1. 什么是Docker？ Docker 是一套平台即服务产品，它使用操作系统级虚拟化技术来交付称为容器的软件包。 容器相互隔离，并打包它们自己的软件、库和配置文件； 他们可以通过明确的渠道相互沟通。 You can learn more about[Docker 和 ASP.NET Core 应用程序](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/docker/building-net-docker-images)这里。 我们将直接跳到使用Docker的部分，但如果您想了解更多信息，这里有一个很好的介绍[这里是 .NET 和 Docker。](https://docs.microsoft.com/en-us/dotnet/core/docker/introduction)以及更多关于如何[为 .NET core 应用程序构建容器](https://docs.microsoft.com/en-us/dotnet/core/docker/build-container). 让我们一起开始使用Docker吧。 ### 8.2. 安装 Docker 访问这里的Docker网站[安装 Docker。](https://www.docker.com/) 点击开始。 点击下载 Mac 和 Windows 版。 免费注册，然后登录。 下载 Windows 版 Docker 开始安装 Docker 它需要重新启动。 重新启动计算机后，登录到 Docker。 现在您可以通过打开Windows命令行或PowerShell脚本运行Docker“hello world”，然后输入： Docker运行hello-world 这是一份最重要的命令行列表，可以帮助您： - Docker 镜像 => 列出此机器上的所有可用镜像 - Docker ps => 列出所有运行中的容器 - Docker ps –a => 列出所有容器 ### 8.3.运行到 Linux 容器中

---

## 9.处理现有 PDF 文档 ### 9.1. 打开现有PDF 您可以从URL和HTML创建PDF(文本或文件), 您也可以处理现有的PDF文档。 以下是一个示例，用于打开普通PDF或带密码的加密PDF。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-13.cs ``` ### 9.2. 合并多个PDF文件 您可以按以下方式将多个PDF合并为一个PDF： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-14.cs ``` 在当前 PDF 的末尾添加另一个 PDF，如下所示： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-15.cs ``` 从给定的索引开始，将 PDF 插入另一个 PDF： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-16.cs ``` ### 9.3 添加页眉或页脚 您可以在现有的PDF中添加页眉和页脚，或者在从HTML或URL渲染PDF时添加。 可以使用两个类在PDF中添加页眉或页脚： - TextHeaderFooter：在页眉或页脚添加简单文本。 - HtmlHeaderFooter：添加包含丰富HTML内容和图片的页眉或页脚。 现在让我们看两个例子，展示如何使用这两个类为现有的pdf添加页眉/页脚或在渲染时添加页眉/页脚。 **9.3.1 向现有pdf添加页眉** 下面是一个示例，加载一个现有的PDF，然后使用`AddTextHeaders`和`AddHtmlFooters`方法添加页眉和页脚。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-17.cs ``` **9.3.2 为新PDF添加页眉和页脚** 以下是使用渲染选项从HTML文件创建PDF并为其添加页眉和页脚的示例。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-18.cs ```

---

## 10. 添加PDF密码和安全性 您可以为您的PDF文件设置密码并编辑文件安全设置，如防止复制和打印。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-19.cs ```

---

## 11. 数字签名 PDFs 您也可以按如下方式对PDF文件进行数字签名： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-20.cs ``` 高级示例可实现更多控制： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-21.cs ``` ## 12.从 PDF 中提取文本和图像 提取文本和图像 使用 IronPdf，您可以从 PDF 中提取文本和图像，具体方法如下： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-22.cs ``` ### 12.1. 将PDF光栅化为图像 您也可以按以下方式将PDF页面转换为图像： ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-23.cs ```

---

## 13. 添加PDF水印 The following is an example of how to watermark PDF pages. ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-24.cs ``` 水印有一套受限的选项和功能。 为了更好的控制，您可以使用 **HTMLStamper** 类。 ```cs :path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-25.cs ```

---

教程快速访问