在 C## ASP.NET 中将 ASPX 页转换为 PDF.

使用 IronPDF 的 AspxToPdf.RenderThisPageAsPdf() 方法在 C# 中将 ASPX 页面转换为 PDF，该方法可立即将任何 ASP.NET 网页表单转换为可下载的 PDF 文档，并保留样式、链接和表单。 无论是生成发票、报告还是文档，这种方法都能确保使用 基于 Chrome 的渲染技术进行像素级完美渲染。

本教程将指导您逐步完成 ASPX 到 PDF 的转换。 在 ASP.NET 网络应用程序中将 ASPX 页面保存为 PDF，并完全控制 页眉、页脚 和页面格式。

使用 .NET 代码自动将 ASPX 文件转换为 PDF，无需手动进行浏览器打印。 这种基于服务器的方法可转换 ASPX 内容，并使用 IronPDF 的渲染功能将其保存为 PDF。

应用设置，包括文件行为和名称、添加页眉和页脚、更改打印选项、添加分页符、结合异步和多线程等。 IronPdf 支持高级功能，如PDF/A 合规性和数字签名，以满足企业要求。

快速入门：几秒钟内将 ASPX 转换为 PDF

立即开始使用 IronPDF，轻松将 ASPX 文件转换为 PDF 文件。 这个快速示例演示了只需一行代码就能将 ASPX 页面直接呈现为 PDF 文档。 非常适合希望简化工作流程并增强 ASP.NET 应用程序的开发人员。

最小工作流程（5 个步骤）

1. 下载 ASPX to PDF C# 库。
2. 选择您的 ASPX 页面
3. 将 ASPX 文件转换为 PDF
4. 应用转换器设置并添加页眉、页脚
5. 在 PDF 文件中创建分页符

如何将 ASPX 文件转换为 PDF？ Microsoft Web Form Applications for ASP.NET 通常用于开发复杂的网站、网上银行、内联网和会计系统。 ASP.NET (ASPX) 网站的一个常见功能是生成动态 PDF 文件，如发票、票据或管理报告，供用户下载。 本教程展示了如何使用 IronPDF 将任何 ASP.NET 网页表单转化为 PDF（ASP.NET to PDF）。 通常以网页形式呈现的 HTML 将以 PDF 形式呈现，以供下载或在网络浏览器中查看。 所附源代码项目演示了在 ASP.NET 中使用 C# 将网页转换为 PDF。 在使用 IronPDF 及其 `AspxToPdf 类`（/object-reference/api/IronPdf.AspxToPdf.html）渲染网页时，我们实现了 HTML 到 PDF 的转换。 此过程将在生成的 PDF 中保留所有 [CSS样式](/how-to/html-to-pdf-responsive-css/)、JavaScript 功能，甚至 [网络字体](/how-to/webfonts-webicons/)。

如何安装 IronPDF 的 ASPX 文件转换器？ <！-- 说明：显示逐步过程的截图 --> 在 Visual Studio 中，右键单击您的项目解决方案资源管理器并选择"管理 NuGet 包..."。 从那里搜索 IronPDF 并安装最新版本。 单击 "确定 "对话框。 这适用于 Framework 4.6.2 及以上版本或 .NET Core 2 及以上版本的任何 C# .NET Framework 项目。 它也适用于 VB.NET 项目。 有关不同平台的详细安装说明，请查看我们的[安装概述指南](/get-started/installation-overview/)。 ```shell :ProductInstall ``` 从 NuGet 下载 IronPDF

何时应通过 DLL 而不是 NuGet 进行安装？ 或者，从 [下载 IronPDF Package](https://ironpdf.com/packages/IronPdf.zip) 下载 IronPDF DLL 并手动安装到项目或 GAC 中。 有关特定于 Windows 的安装，请参阅我们的 [Windows安装指南](/get-started/windows/)。 请记住，使用 IronPDF 时，务必将以下语句添加到任何`cs`类文件的顶部： ```csharp using IronPdf; ```

如何将 ASP.NET 网页转换为 PDF？ 从一个普通的 ASPX "Web表单 "开始，该表单渲染为HTML。 之后将 ASPX 页面转换为 PDF 文件格式。 在所附示例源代码中，我们渲染了一个名为"Invoice.aspx"的商业发票，这是一个简单的 HTML 商业发票，以 ASP.NET 页面的形式呈现。 对于涉及 [身份验证和 cookies](/how-to/cookies/) 的更复杂的情况，IronPDF 可提供全面的解决方案。 HTML 页面包含 CSS3 样式表，还可能包含图片和 JavaScript。 IronPdf 支持 [渲染前执行 JavaScript](/how-to/javascript-to-pdf/)，确保准确捕捉动态内容。 要将此 ASP.NET 网页渲染为 PDF 而不是 HTML，请打开 C#（或 VB.NET）代码并将此添加到 *Page_Load* 事件中： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-1.cs ``` 这就是全部所需条件； 现在HTML会渲染成PDF。 超链接、样式表、图片甚至 HTML 表单都要保留。 这类似于用户在浏览器中将 HTML 打印成 PDF 的输出结果。 IronPDF 基于 Chromium 网络浏览器技术构建，该技术也是 Google Chrome 浏览器的基础。 完整的 C# 代码如下所示： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-2.cs ```

如何将 ASPX 文件应用到 PDF 转换器设置？ <！--说明：显示代码执行输出或结果的截图 --> 使用 .NET Web Forms 从 ASPX 文件生成 PDF 时，有许多调整和完善的选择。 这些设置控制着从[纸张大小](/how-to/自定义纸张大小/)到[边距配置](/how-to/自定义边距/)的一切。 这些选项在[IronPDF API 参考文档](/object-reference/api/IronPdf.html)中有完整的在线说明。

如何控制 PDF 显示行为？ " `InBrowser` "文件行为尝试直接在用户的浏览器中显示PDF。 这是符合标准的现代浏览器的共同特点。 ```csharp IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser); ``` " `Attachment` "文件行为会导致 PDF 文件被下载。 ```csharp IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment); ```

如何自定义 PDF 文件名？ 通过添加附加参数设置 PDF 文档的文件名。 这将控制用户下载或保存文件时的文件名。 ```csharp IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf"); ```

我可以配置哪些 PDF 打印选项？ 通过添加 IronPdf.ChromePdfRenderer 类的实例来控制 PDF 输出。 [ChromePdfRenderer API 参考](/object-reference/api/IronPdf.ChromePdfRenderer.html) ```csharp :path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs ``` 可用的PDF渲染选项包括： - <代码>CreatePdfFormsFromHtml：将 ASPX 表单转换为可编辑的 PDF 表单。 请参见 [创建 PDF 表单](/how-to/create-forms/)。 - `CssMediaType`：`Screen` 或 `Print` CSS 样式。 请参见 [比较图片](/how-to/pixel-perfect-html-to-pdf/)。 - <代码>CustomCssUrl：在呈现之前将自定义 CSS 应用于 HTML。 本地文件路径或远程 URL。 - `EnableMathematicalLaTex`：启用/禁用 LaTeX 元素渲染。 - `EnableJavaScript`：在呈现之前执行 JavaScript。 非常适合 Ajax/Angular 应用程序。请参见 [WaitFor指南](/how-to/waitfor/)。 - <代码>JavaScript：在 HTML 加载后、渲染前执行的自定义 JavaScript。 - `JavascriptMessageListener`：浏览器 JavaScript 控制台消息的回调。 - `FirstPageNumber`：页眉/页脚的起始页码。 默认为 1。 - `TableOfContents`：在 id 为 "ironpdf-toc" 的元素上生成 TOC。 请参见 [TOC 指南](/how-to/table-of-contents/)。 - `TextHeader`：将页眉内容设置为文本。 支持邮件合并和自动链接 URL。 - `TextFooter`：将页脚内容设置为文本。 支持邮件合并和自动链接 URL。 - `HtmlHeader`：使用 HTML 设置页眉内容。 - `HtmlFooter`：使用 HTML 设置页脚内容。 - `MarginBottom`：以毫米为单位的底边距。 零为无国界。 - `MarginLeft`：以毫米为单位的左侧边距。 零为无国界。 - `MarginRight`：右边距，以毫米为单位。 零为无国界。 - `MarginTop`：顶部边距，以毫米为单位。 零为无国界。 - <代码>UseMarginsOnHeaderAndFooter：对页眉/页脚使用主文档页边距。 - <代码>PaperFit：虚拟纸张布局管理器。 包括 Chrome 浏览器行为、缩放、响应式 CSS3、按页面缩放和连续供稿等选项。 请参见 [视口指南](/how-to/viewport-zoom/)。 - `PaperOrientation`：PDF 方向 - 横向或纵向。 - `PageRotation`：从现有文档中旋转页面。 请参见 [定向示例](/examples/pdf-page-orientation/)。 - `PaperSize`：输出纸张大小使用 System.Drawing.Printing.PaperKind。 - `SetCustomPaperSizeinCentimeters`: 以厘米为单位设置纸张大小。 - `SetCustomPaperSizeInInches`: 以英寸为单位设置纸张大小。 - `SetCustomPaperSizeinMilimeters`: 以毫米为单位设置纸张大小。 - `SetCustomPaperSizeinPixelsOrPoints`: 以像素或点为单位设置纸张大小。 - <代码>ForcePaperSize：通过在生成后调整纸张大小来强制精确纸张大小。 - `PrintHtmlBackgrounds`：打印 HTML 图像背景。 - <代码>GrayScale：输出灰度 PDF。 请参见 [灰度转换](/how-to/color-grayscale/)。 - <代码>WaitFor：等待机制的配置： - `PageLoad`：默认呈现，无需等待。 - `RenderDelay`：任意等待时间。 - <代码>字体：等待加载字体。 - `JavaScript`：使用 JavaScript 函数触发呈现。 - `HTML 元素`：通过 ID、名称、标记或选择器等待特定元素。 - `NetworkIdle`：等待网络空闲（0、2 或自定义）。 - <代码>标题：PDF 文档标题元数据。 请参见 [元数据指南](/how-to/metadata/)。 - <代码>InputEncoding：字符编码。 默认为 UTF-8。 请参见 [UTF-8指南](/how-to/utf-8/)。 - <代码>RequestContext：用于呈现的请求上下文。 - `Timeout`：渲染超时时间（以秒为单位）。

如何为 ASPX PDF 添加页眉和页脚？ 使用 IronPDF，可以在 PDF 输出中添加页眉和页脚。 有关高级示例，请参阅我们的[完整的页眉和页脚指南](/how-to/add-headers-footers-advanced/)。 最简单的方法是使用 *TextHeaderFooter* 类，该类支持带有当前时间和页码等动态数据的基本布局。

如何实现页眉和页脚？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs ``` 或者，使用支持 CSS、图像和超链接的 HtmlHeaderFooter 类生成 HTML 页眉和页脚。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs ``` 如我们的示例所示，使用占位符将动态文本或 HTML 合并到页眉/页脚中： - `{page}`：当前页码。 - `{total-pages}`：总页数。 - <代码>{url}：渲染 PDF 的 Web URL。 - `{date}`：系统格式的今日日期。 - `{time}`：24 小时格式的时间。 - `{html-title}`：来自 ASPX head 标签的标题。 - `{pdf-title}`：文档文件名。

如何在 PDF 文件中添加分页符？ HTML 通常是长长的一页，而 PDF 则是模拟数字纸张，分成连贯的几页。 将此代码添加到 ASPX 页面后，生成的 PDF 将自动创建分页符。 有关高级分页控制，请参阅我们的[分页指南](/how-to/html-to-pdf-page-breaks/)。 ```html

 

```

如何使用异步和多线程提高性能？ IronPDF 适用于 .NET Framework 4.6.2 或 .NET Core 2 及以上版本。 在 Framework 4.6.2 或以上版本的项目中，[async 功能](/how-to/async/) 可提高处理多个文档时的性能。 将 async 与多线程 CPU 和 `Parallel.ForEach` 命令相结合，可显著改善批量 PDF 处理。 对于企业部署，请参阅我们的[性能优化指南](/troubleshooting/IronPdf-performance-assistance/)。

在哪里可以观看 ASPX 转 PDF 教程视频？

---

教程快速访问

在 GitHub 上探索此教程

此 C# ASPX-To-PDF 项目的代码以 C# 和 VB.NET 作为 ASP.NET 网站项目在 GitHub 上提供。请继续在 GitHub 上 fork 我们，以获得更多使用 IronPdf 的帮助。如果有人问 "如何将 ASPX 转换为 PDF？

C# ASPX 转 PDF 网站项目 用 C# 创建 PDF 的高级 ASP.NET Page to PDF 示例 用 VB.NET 创建 PDF 的 ASP.NET PDF 示例

下载 C# PDF 快速入门指南

为了让您在 .NET 应用程序中开发 PDF 更容易，我们将快速入门指南编译成 PDF 文档。这份 "Cheat-Sheet "提供了在 C# 和 VB.NET 中快速访问生成和编辑 PDF 的常用函数和示例，有助于节省在您的 .NET 项目中开始使用 IronPDF 的时间。

下载

查看 API 参考

探索 IronPDF 的 API 参考，概述 IronPDF 的所有功能、命名空间、类、方法字段和枚举的详细信息。

查看 IronPdf API 参考资料