如何在 ASP.NET Core C## 应用程序中将 Razor 页面转换为 PDF.

简介

<！--说明：说明代码概念的图表或截图 -->

Razor Pages 为在 ASP.NET Core 应用程序中构建动态网页内容提供了一种强大而直观的方法。 当与 IronPDF 的渲染功能相结合时，开发人员可以直接从他们的网页内容创建专业的 PDF 文档。 这种方法去除了复杂的 PDF 生成逻辑，让您可以使用现有的 HTML 和 CSS 技能。

IronPdf 和 Razor Pages 之间的集成对于生成报告、发票、证书和任何其他需要动态数据展示的文档尤为重要。 通过使用您已经熟悉的 Razor 语法，您可以保持网页视图和 PDF 输出之间的一致性。

将 Razor 转换为 PDF 需要哪些 NuGet 软件包？ **`IronPdf.Extensions.Razor`包**是主**`IronPdf`**包的扩展。 在 ASP.NET Core Web App 中将 Razor Pages 呈现为 PDF 文档需要 `IronPdf.Extensions.Razor` 和 `IronPdf` 包。有关详细的安装说明，请访问我们的[安装概述](https://ironpdf.com/get-started/installation-overview/)指南。 ```shell # Command to install IronPdf.Extensions.Razor package using NuGet Package Manager 安装-打包 IronPdf.Extensions.Razor ```

通过 NuGet 安装

安装-打包 IronPdf.Extensions.Razor

复制软件包管理器命令。

nuget.org/packages/IronPdf.Extensions.Razor/

如何在 ASP.NET Core 中将 Razor 页面转换为 PDF？ 您需要一个 ASP.NET Core Web App 项目来将 Razor Pages 转换为 PDF 文件。 翻译过程包括为数据创建模型，设置 Razor 页面以显示数据，然后使用 IronPDF 的 `RenderRazorToPdf` 方法生成 PDF 输出。

为什么我需要一个用于生成 PDF 的模型类？ 模型类是 Razor 页面中数据表示的支柱。 它们提供了一种结构化的方式，将数据从控制器逻辑传递到视图，确保了类型安全性和可维护性。 在生成 PDF 时，这些模型变得更加重要，因为它们定义了将出现在最终文档中的数据的确切结构。 - 在项目中创建一个新文件夹并命名为"Models"。 - 向文件夹中添加一个标准C#类并命名为"Person"。此类将用作个体数据的模型。 使用以下代码片段： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/cshtml-to-pdf-razor-model.cs ```

如何为 PDF 转换设置 Razor 页面？ 向"Pages"文件夹中添加一个空的Razor Page，并命名为"persons.cshtml"。 - 使用下面提供的代码示例修改新创建的 "Persons.cshtml "文件。 下面的代码会在浏览器中显示信息。 请注意 Razor 语法如何将 C# 代码无缝集成到 HTML 中，使其非常适合生成可转换为 PDF 的动态内容： ```html @page @using RazorPageSample.Models; @model RazorPageSample.Pages.PersonsModel @{ } @foreach (var person in ViewData["personList"] as List) { }

Name	Title	Description
@person.Name	@person.Title	@person.Description

Print

``` ## 将Razor Pages渲染为PDF --> <！--说明：显示代码执行输出或结果的截图 --> 接下来，代码首先实例化**ChromePdfRenderer**类。 将**this**传递给`RenderRazorToPdf`方法即可将此Razor Page转换为PDF文档。 您可以完全访问 **RenderingOptions**中提供的功能。 这些功能包括在生成的 PDF 中应用 [ 页码](https://ironpdf.com/how-to/page-numbers/)、设置 [ 自定义页边距](https://ironpdf.com/how-to/custom-margins/)、添加自定义 [ 文本以及 HTML 页眉和页脚](https://ironpdf.com/how-to/headers-and-footers/)。 您还可以为 PDF 配置 [metadata](https://ironpdf.com/how-to/metadata/) 以确保文档的正确标识和可搜索性。 - 打开"Persons.cshtml"文件的下拉菜单以查看"Persons.cshtml.cs"文件。 - 使用下面的代码修改"Persons.cshtml.cs"。 ```csharp using IronPdf.Razor; using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.Mvc.RazorPages; using RazorPageSample.Models; namespace RazorPageSample.Pages { public class PersonsModel : PageModel { [BindProperty(SupportsGet = true)] public List Persons { get; set; } // Handle GET request to load initial data public void OnGet() { Persons = new List { new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" }, new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" }, new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" } }; ViewData["personList"] = Persons; } // Handle POST request to convert Razor page to PDF public IActionResult OnPost() { Persons = new List { new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" }, new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" }, new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" } }; ViewData["personList"] = Persons; ChromePdfRenderer renderer = new ChromePdfRenderer(); // Render Razor Page to PDF document PdfDocument pdf = renderer.RenderRazorToPdf(this); // Return the generated PDF file with appropriate content headers Response.Headers.Add("Content-Disposition", "inline"); return File(pdf.BinaryData, "application/pdf", "razorPageToPdf.pdf"); // Optionally view the output PDF in browser (uncomment below line if needed) // return File(pdf.BinaryData, "application/pdf"); } } } ``` `RenderRazorToPdf`方法返回一个**`PdfDocument`**对象，该对象可以进行额外的处理和编辑。 您可以将 PDF 导出为 `PDFA` 或 `PDFUA` 格式，对渲染的 PDF 文档应用数字签名，或合并和拆分 PDF 文档。 该方法还允许您旋转页面、添加注释或书签，以及在 PDF 上加盖自定义水印。 为了加强文档管理，您还可以压缩 PDF 文件，在不影响质量的前提下减小文件大小。 这在处理大型报告或带宽问题时尤其有用。 此外，IronPDF 提供的广泛编辑功能已在我们全面的 PDF 编辑教程中进行了记录。

如何为 PDF 生成页面添加导航？ 导航对于 ASP.NET Core 应用程序的用户体验至关重要。 通过将 PDF 生成页面集成到主导航中，用户可以轻松访问该功能，而无需手动键入 URL。 - 导航至Pages文件夹 -> Shared文件夹 -> _Layout.cshtml。 将"Person"导航项放在"Home"之后。 确保 `asp-page` 属性的值与我们的文件名完全匹配，在本例中文件名为 "Persons"。 这可确保在您的 ASP.NET Core 应用程序中正确路由： ```html

```

运行 PDF 生成时会发生什么？ 这将向您展示如何运行项目并生成 PDF 文档。 点击 "人员 "导航链接后，您将看到以表格格式显示的数据。 点击 "打印 "按钮会触发 PDF 生成过程，将当前的 Razor 页面视图转换为可下载的 PDF 文档。 生成的 PDF 将保留 Razor 页面的所有样式和格式，确保网页视图和 PDF 输出的外观保持一致。 这种方法尤其适用于生成报告、发票或任何需要从应用程序数据库或业务逻辑中获取数据的文档。

在哪里可以下载完整的 ASP.NET Core Web 应用程序示例？ 您可以下载本指南的完整代码作为压缩文件，并在Visual Studio中打开为ASP.NET Core Web App项目。 [下载RazorPageSample.zip ASP.NET Core Web App项目](/static-assets/pdf/how-to/cshtml-to-pdf-razor/RazorPageSample.zip)