如何在 C## ASP.NET Core MVC 中将视图转换为 PDF。

使用 IronPDF 的 RenderRazorViewToPdf 方法将 ASP.NET Core MVC 视图转换为 PDF，只需在您的 MVC 应用程序中编写一行代码即可将 .cshtml 文件转换为高质量的 PDF 文档。

视图是 ASP.NET 框架中用于在 Web 应用程序中生成 HTML 标记的组件。 它是模型-视图-控制器（MVC）模式的一部分，常用于 ASP.NET MVC 和 ASP.NET Core MVC 应用程序。 视图负责通过动态呈现 HTML 内容向用户展示数据。 视图通常使用 Razor 语法，这是一种将基于服务器的代码嵌入网页的标记语法，使其成为创建数据驱动型 PDF 文档的强大工具。

as-heading:2（快速入门：在 ASP.NET Core 中将 CSHTML 转换为 PDF）

使用 IronPDF for .NET 将 ASP.NET Core MVC 视图转换为 PDF。 只需一行代码，即可将您的".cshtml "文件渲染为 PDF 文档。 将此功能直接集成到您的 MVC 应用程序中，以便从动态 HTML 视图无缝生成 PDF。 请按照本指南设置环境并开始转换。

ASP.NET Core Web App MVC（模型-视图-控制器）是微软提供的一个 Web 应用程序框架，用于使用 ASP.NET Core 构建 Web 应用程序。

• 模型：代表数据和业务逻辑，管理数据交互，与数据源通信。
• 视图：提供用户界面、显示数据、向用户呈现信息。
• 控制器：处理用户输入、响应请求、与模型通信、协调模型与视图的交互。

IronPDF 可在 ASP.NET Core MVC 项目中通过视图直接创建 PDF 文件。 这使得 PDF 生成在 ASP.NET Core MVC 中变得简单明了，支持包括 CSS 风格、JavaScript 执行和 自定义字体在内的现代功能。

IronPDF 扩展需要哪些软件包？ `IronPdf.Extensions.Mvc.Core` 包是主 `IronPdf` 包的扩展。 `IronPdf.Extensions.Mvc.Core` 和 `IronPdf` 包都需要用于在 ASP.NET Core MVC 中将视图呈现为 PDF 文档。 扩展包提供了与 ASP.NET Core 的依赖注入系统和 Razor 视图渲染管道集成的特定功能。 ```shell :InstallCmd 安装-打包 IronPdf.Extensions.Mvc.Core ```

为什么我需要 IronPDF 和扩展包？ IronPDF 的主软件包包含核心 PDF 渲染引擎和基本功能，而 Extensions.Mvc.Core 软件包则提供与 ASP.NET Core MVC 的视图渲染系统的专门集成。 这种分离可以实现更好的模块化，确保只包含项目类型所需的特定功能。 该扩展包包括 `IRazorViewRenderer` 接口以及在生成 PDF 之前将 Razor 视图转换为 HTML 所需的实现。

我应该使用哪个 NuGet 软件包版本？ 始终使用与 IronPDF 和 `IronPdf.Extensions.Mvc.Core` 匹配的版本，以确保兼容性。 有关最新稳定版本和版本兼容性信息，请查看 NuGet 软件包文档。 更新时，确保两个软件包一起更新，以保持适当的功能。

常见的安装问题有哪些？ 常见的安装问题包括核心软件包和扩展软件包之间的版本不匹配、依赖关系缺失或特定平台要求。 如果遇到问题，请确保您的项目使用的是受支持的 .NET 版本，并查看安装概述以了解故障排除步骤。

通过 NuGet 安装

安装-打包 IronPdf.Extensions.Mvc.Core

复制软件包管理器命令。

nuget.org/packages/IronPdf.Extensions.Mvc.Core/

如何将视图渲染为 PDF？ 您需要一个 ASP.NET Core Web App（模型-视图-控制器）项目来将视图转换为 PDF 文件。 该过程包括创建一个控制器动作，使用 IronPDF 的 `RenderRazorViewToPdf` 方法将您的 Razor 视图转换为 PDF 文档。 这种方法充分利用了 Razor 语法的全部功能，使您能够创建具有动态内容的复杂、数据驱动型 PDF。

我应该使用哪种项目类型？ 使用 ASP.NET Core Web App（模型-视图-控制器）模板，以获得与 IronPDF 视图渲染功能的最佳兼容性。 该项目类型为视图渲染提供了必要的基础设施，包括 Razor 视图引擎和适当的路由。 对于现有项目，应确保它们遵循 MVC 模式并安装了所需的视图渲染功能。

我可以使用最小化 API 吗？ 虽然 Minimal API 没有内置视图支持，但您仍然可以使用 IronPdf 的 HTML 到 PDF 转换功能。 对于基于视图的 PDF 生成，请使用传统的 MVC 方法或考虑将 Razor Pages 作为替代方法。

如何添加模型类？ - 导航到"Models"文件夹。 - 创建一个新的 C# 类文件，命名为 "Person"。该类将作为表示个人数据的模型。 使用以下代码片段： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/cshtml-to-pdf-mvc-core-model.cs ```

为什么我需要生成 PDF 的模型？ 模型提供结构化数据，可传递给视图进行渲染。 这种关注点的分离确保了 PDF 生成逻辑的简洁性和可维护性。 模型是控制器与视图之间的契约，可确保类型安全并在 Razor 视图中启用 IntelliSense 支持。

哪些数据类型最适合使用视图？ 简单的数据类型和集合最适合生成 PDF。 可以使用复杂的嵌套对象，但可能需要额外的视图逻辑。 为获得最佳性能，请在控制器中将复杂的数据结构扁平化，然后再将其传递给视图。 当您的领域模型过于复杂时，请考虑使用专为 PDF 输出设计的 ViewModels。 下面是一个适合生成 PDF 的复杂模型结构示例： ```csharp public class InvoiceViewModel { public string InvoiceNumber { get; set; } public DateTime InvoiceDate { get; set; } public decimal TotalAmount { get; set; } public ListLineItems { get; set; } public CustomerInfo Customer { get; set; } // Computed property for PDF display public string FormattedTotal => TotalAmount.ToString("C"); } public class InvoiceLineItem { public string Description { get; set; } public int Quantity { get; set; } public decimal UnitPrice { get; set; } public decimal LineTotal => Quantity * UnitPrice; } public class CustomerInfo { public string Name { get; set; } public string Email { get; set; } public string Address { get; set; } } ```

如何编辑控制器？ 导航至 "控制器 "文件夹并打开 "HomeController "文件。我们将仅更改 `HomeController` 并添加 `Persons` 操作。 请参考以下代码以获得指导： 下面的代码首先实例化了 `ChromePdfRenderer` 类，并将 `IRazorViewRenderer` 方法、`Views/Home/Persons.cshtml` 的路径以及包含所需数据的 List 传递给 `RenderRazorViewToPdf` 方法。 用户可以使用 `RenderingOptions` 访问一系列功能，如添加自定义文本、在生成的 PDF 中包含 HTML 页眉和页脚、定义自定义页边距以及应用页码。 有关更多高级渲染选项，请参阅渲染选项文档。

请注意可使用以下代码在浏览器中查看 PDF 文档：`File(pdf.BinaryData, "application/pdf")`. 但是，在浏览器中查看 PDF 后再下载会导致 PDF 文档损坏。

```csharp using IronPdf.Extensions.Mvc.Core; using Microsoft.AspNetCore.Mvc; using System.Diagnostics; using ViewToPdfMVCCoreSample.Models; namespace ViewToPdfMVCCoreSample.Controllers { public class HomeController : Controller { private readonly ILogger_logger; private readonly IRazorViewRenderer _viewRenderService; private readonly IHttpContextAccessor _httpContextAccessor; public HomeController(ILoggerlogger, IRazorViewRenderer viewRenderService, IHttpContextAccessor httpContextAccessor) { _logger = logger; _viewRenderService = viewRenderService; _httpContextAccessor = httpContextAccessor; } public IActionResult Index() { return View(); } public async TaskPersons() { // Example list of persons var 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" } }; // Check if the request method is POST if (_httpContextAccessor.HttpContext.Request.Method == HttpMethod.Post.Method) { // Create a new PDF renderer ChromePdfRenderer renderer = new ChromePdfRenderer(); // Configure rendering options for better output renderer.RenderingOptions.MarginTop = 40; renderer.RenderingOptions.MarginBottom = 40; renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait; renderer.RenderingOptions.Title = "Persons Report"; // Render View to PDF document PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Persons.cshtml", persons); Response.Headers.Add("Content-Disposition", "inline"); // Output PDF document return File(pdf.BinaryData, "application/pdf", "viewToPdfMVCCore.pdf"); } return View(persons); } public IActionResult Privacy() { return View(); } [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)] public IActionResult Error() { return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier }); } } } ``` 使用 `RenderRazorViewToPdf` 方法后，您将收到一个可进一步增强和修改的 `PdfDocument` 对象。 您可以将 PDF 转换为 PDF/A 或 PDF/UA 格式，在生成的 PDF 上添加数字签名，或根据需要合并和拆分 PDF 文档。 此外，该库允许您旋转页面，插入注释或书签，并在您的 PDF 文件上加盖独特的水印。

什么是 IRazorViewRenderer 服务？ `IRazorViewRenderer` 是由 `IronPdf.Extensions.Mvc.Core` 包提供的服务接口，用于处理 Razor 视图到 HTML 的转换。 它与 ASP.NET Core 的视图引擎集成，处理 .cshtml 文件及其相关模型，执行所有 Razor 语法并生成 IronPDF 转换为 PDF 的最终 HTML。

为什么要在渲染前检查 POST 方法？ 检查 POST 可确保只有在通过表单提交明确请求时才生成 PDF。 这样可以防止在页面加载时意外生成 PDF，并允许同一操作同时提供 HTML 视图（GET）和 PDF 下载（POST）。 该模式遵循 RESTful 原则，可提供更好的用户体验。

如何自定义 PDF 输出？ IronPDF 通过 `RenderingOptions` 属性提供广泛的自定义选项。 下面是一个具有更高级设置的示例： ```csharp // Advanced rendering configuration example var renderer = new ChromePdfRenderer(); // Page setup renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4; renderer.RenderingOptions.MarginLeft = 20; renderer.RenderingOptions.MarginRight = 20; // Headers and footers with merge fields renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter() { Height = 25, HtmlFragment = "

Page {page} of {total-pages}

" }; // JavaScript execution delay for dynamic content renderer.RenderingOptions.WaitFor = new WaitFor() { RenderDelay = 500, // Wait 500ms for JS execution NetworkIdle = NetworkIdleTypes.NetworkIdle0 // Wait for network requests }; // Apply watermark renderer.RenderingOptions.TextHeader = new TextHeaderFooter() { DrawDividerLine = true, CenterText = "CONFIDENTIAL", Font = new FontTypes() { FontSize = 16 } }; ```

哪些是常见的控制器错误？ 常见错误包括服务未正确注入时的空引用异常、指定视图位置时的路径问题以及模型绑定问题。 确保在 `Program.cs` 中注册了所有必需的服务，并在指定视图位置时使用项目根目录的相对路径。 为排除故障，请在开发模式下启用详细的错误信息。

如何添加视图？ - 右键单击新添加的 `Person` 操作并选择 "添加视图"。 ！[右键单击 Persons() 方法时，显示 "添加视图...... "选项的 Visual Studio 上下文菜单突出显示](/static-assets/pdf/how-to/cshtml-to-pdf-mvc-core/right-click-on-Persons.webp)。 - 为新的脚手架项选择"Razor View"。 ！[在 Visual Studio 中添加 Razor 视图对话框，显示带有布局选项的列表模板和人员模型类选择](/static-assets/pdf/how-to/cshtml-to-pdf-mvc-core/select-scaffold.webp)。 - 选择 "List "模板和 `Person` 模型类。 ！[在 Visual Studio 中添加 Razor 视图对话框，显示带有布局选项的列表模板和人员模型类选择](/static-assets/pdf/how-to/cshtml-to-pdf-mvc-core/add-view.webp)。 这将创建一个名为 `Persons` 的 .cshtml 文件。 - 导航至 "Views "文件夹 -> "Home "文件夹 -> `Persons.cshtml` 文件。 要添加一个调用 `Persons` 操作的按钮，请使用下面的代码： ```html @using (Html.BeginForm("Persons", "Home", FormMethod.Post)) { } ```

为什么使用 FormMethod.Post 生成 PDF？ 使用 `POST` 生成 PDF 时，应遵循网络最佳实践，明确说明操作，防止因刷新浏览器或书签 URL 而生成不必要的 PDF。 `GET`请求应是empotent的（不改变服务器状态），而`POST`请求则表示产生结果的操作--在本例中，生成 PDF 文档。

如何设置 PDF 打印按钮的样式？ 使用 CSS 类设计打印按钮的样式，并使用 JavaScript 对其进行增强，以获得更好的用户体验。 以下是增强版： ```html @using (Html.BeginForm("Persons", "Home", FormMethod.Post, new { @class = "pdf-form" })) { Download as PDF }```

哪些视图模板最适合 PDF？ `List` 和 `Details` 模板特别适合生成 PDF，因为它们提供了结构化布局。 专为 PDF 输出设计的定制模板通常能产生最佳效果。 考虑创建专门的 PDF 视图，优化印刷排版而非屏幕显示，去除导航元素，专注于内容展示。

如何在顶部导航栏中添加一个部分？ - 在同一 "Views "文件夹中，导航至 "Shared "文件夹 -> `_Layout.cshtml` 。 将 `Person` 导航项放在 `Home` 之后。 确保 `asp-action` 属性的值与我们的文件名完全匹配，本例中的文件名为 `Persons`。 ```html

```

为什么 asp-action 需要完全匹配？ `asp-action` 属性使用 ASP.NET Core 的标记助手，根据您的路由配置生成正确的 URL。 精确匹配可确保链接指向正确的控制器操作。 不匹配会导致 404 错误或路由到非预期的操作。 标签辅助系统区分大小写，必须与控制器中的方法名称完全匹配。

如果导航链接不匹配会怎样？ 当导航链接与控制器操作不匹配时，用户会遇到 404 错误或被引导到不正确的页面。 在开发过程中，ASP.NET Core 的开发人员异常页面会显示详细的路由错误。 在生产过程中，用户会看到通用的错误页面。 务必确保导航链接与控制器操作名称完全匹配，以防止破坏用户体验。

如何编辑 Program.cs 文件？ 将 `IHttpContextAccessor` 和 `IRazorViewRenderer` 接口注册到依赖注入 (DI) 容器。 请查看下面的代码，以供参考。 ```csharp using IronPdf.Extensions.Mvc.Core; using Microsoft.AspNetCore.Mvc.ViewFeatures; var builder = WebApplication.CreateBuilder(args); // Add services to the container. builder.Services.AddControllersWithViews(); builder.Services.AddSingleton(); builder.Services.AddSingleton(); // Register IRazorViewRenderer here builder.Services.AddSingleton(); // Optional: Configure IronPDF license if you have one IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"; var app = builder.Build(); // Configure the HTTP request pipeline. if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler("/Home/Error"); // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. app.UseHsts(); } app.UseHttpsRedirection(); app.UseStaticFiles(); app.UseRouting(); app.UseAuthorization(); app.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); app.Run(); ```

为什么要将服务注册为单例？ 单例服务只需创建一次，并在应用程序的整个生命周期中重复使用，因此对于像 `IRazorViewRenderer` 这样的无状态服务来说，单例服务是高效的。 这种模式可以减少内存开销并提高性能，因为视图呈现服务不需要维护请求的特定状态。 `IHttpContextAccessor` 必须是单例的，以便在不同的服务生命周期内均可访问。

ITempDataProvider 有何用途？ `ITempDataProvider` 可在请求之间进行临时数据存储，通常用于在重定向后显示消息。 在生成 PDF 时，要确保在将视图渲染为 PDF 时正确保持视图状态。 `CookieTempDataProvider` 将这些临时数据存储在加密的 Cookie 中，从而为状态管理提供了一种安全机制。

我可以使用范围服务来代替吗？ 虽然您可以在某些场景中使用作用域服务，但 `IRazorViewRenderer` 作为单例效果最佳，因为它不保存特定于请求的状态。 使用范围服务会为每个请求创建新的实例，增加内存使用量，却没有任何好处。 不过，如果您需要在视图中注入作用域服务，请确保正确的服务生命周期管理，以避免运行时出错。 #### 运行项目 这展示了如何运行项目并生成 PDF 文档。 运行应用程序时，使用顶部导航菜单导航到 `Persons` 页面，然后单击 `Print Person` 按钮生成并下载 PDF。

在哪里可以下载 ASP.NET Core MVC 项目？ 下载本指南的完整代码。它以压缩文件的形式提供，您可以在 Visual Studio 中将其作为 ASP.NET Core Web App（模型-视图-控制器）项目打开。 [下载 ASP.NET Core MVC 示例项目](/static-assets/pdf/how-to/cshtml-to-pdf-mvc-core/ViewToPdfMVCCoreSample.zip)

示例项目包括哪些内容？ 示例项目包括一个完整配置的 ASP.NET Core MVC 应用程序，其中集成了 IronPDF，演示了视图到 PDF 的转换。 它包含 `Person` 模型、带有 PDF 生成逻辑的 `HomeController` 、带有正确 Razor 语法的 `Persons` 视图以及 `Program.cs` 中所有必要的服务注册。 该项目还包括针对 PDF 输出进行优化的样式和布局配置示例。

我应该使用哪个 Visual Studio 版本？ 建议使用 Visual Studio 2022（17.0 或更高版本），以获得 .NET 6+ 项目的最佳体验。 带有 C# 扩展的 Visual Studio Code 也能很好地进行跨平台开发。 确保您已安装 ASP.NET 和网络开发工作负载。 该项目默认以 .NET 6.0 为目标，但也可以更新到更新的版本。

如何排除项目设置问题？ 常见的设置问题包括 NuGet 软件包丢失、.NET SDK 版本不正确或配置问题。 首先，使用 `dotnet restore` 或通过 Visual Studio 的软件包管理器还原 NuGet 软件包。 使用 `dotnet --version` 验证您的 .NET SDK 版本是否符合项目要求。 有关许可问题，请参见许可密钥文档。 如果出现渲染问题，请查看故障排除指南了解解决方案。 准备好看看您还能做些什么吗？ 查看我们的教程页面：[转换PDF文档](https://ironpdf.com/tutorials/convert-pdf/)