Convert ASPX Pages to PDF in C# ASP.NET

使用 IronPDF 的 AspxToPdf.RenderThisPageAsPdf() 方法在 C# 中將 ASPX 頁面轉換成 PDF，此方法可立即將任何 ASP.NET 網頁表單轉換成可下載的 PDF 文件，並保留樣式、連結和表單。 無論是生成發票、報告或文件，這種方法都能確保使用 基於 Chrome 的渲染技術進行像素完美的渲染。

本教學引導您逐步完成 ASPX 到 PDF 的轉換。 在 ASP.NET Web 應用程式中將 ASPX 頁面儲存為 PDF，並可完全控制 頁眉、頁腳 和頁面格式。

使用 .NET 程式碼將 ASPX 檔案自動轉換為 PDF - 無須手動瀏覽器列印。 這種基於伺服器的方法可轉換 ASPX 內容，並使用 IronPDF 的渲染功能將其儲存為 PDF。

套用包括檔案行為與名稱、新增頁首與頁尾、變更列印選項、新增分頁符號、結合同步與多執行緒等設定。 IronPdf 支援進階功能，例如 PDF/A compliance 和 企業需求的數位簽名。

快速入門：幾秒鐘內將 ASPX 轉換為 PDF

立即開始使用 IronPDF，輕鬆將 ASPX 檔案轉換為 PDF 檔案。 這個快速範例示範只需一行程式碼，就能將 ASPX 頁面直接呈現為 PDF 文件。 非常適合希望簡化工作流程並增強 ASP.NET 應用程式的開發人員。

最小工作流程（5 個步驟）

1. 下載 ASPX 轉 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/custom-paper-size/)到 [ 邊界配置](/how-to/custom-margins/)的一切。 這些選項在[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 Styles。 請參閱 [比較圖片](/how-to/pixel-perfect-html-to-pdf/)。 - `CustomCssUrl`：在呈現之前將自訂 CSS 套用至 HTML。 本地檔案路徑或遠端 URL。 - `EnableMathematicalLaTex`：啟用/停用 LaTeX 元素渲染。 - `EnableJavaScript`：在呈現前執行 JavaScript。 適用於 Ajax/Angular 應用程式。請參閱 [WaitFor 指南](/how-to/waitfor/)。 - `JavaScript`：自訂 JavaScript，在 HTML 載入後但渲染前執行。 - `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、按頁面縮放和連續饋送的選項。 請參閱 [viewport 指南](/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 文件標題元資料。 請參閱 [metadata指南](/how-to/metadata/)。 - `InputEncoding`：字元編碼。 預設為 UTF-8。 請參閱 [UTF-8 指南](/how-to/utf-8/)。 - `RequestContext`：用於 render 的請求上下文。 - `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 ``` 或者，使用 HtmlHeaderFooter 類別產生 HTML 標題和頁尾，該類別支援 CSS、影像和超連結。 ```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

 

```

如何使用 async 和多執行緒提高效能？ 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 to PDF 教學影片？

---

教程快速存取

在GitHub上探索本教程

這個 C# ASPX 轉 PDF 專案的程式碼以 ASP.NET 網站專案的形式發佈在 GitHub 上，提供 C# 和 VB.NET 兩種版本。歡迎在 GitHub 上 fork 我們，取得更多使用 IronPDF 的協助。如果您正在詢問"如何將 ASPX 轉換為 PDF？"，請隨意分享此項目。

C# ASPX 轉 PDF 網站項目 使用 C# 建立 PDF 的高級 ASP.NET 頁面轉 PDF 範例 使用 VB.NET 建立 PDF 的 ASP.NET PDF 範例

下載 C# PDF 快速入門指南

為了讓您更輕鬆地在 .NET 應用程式中開發 PDF，我們編寫了一份快速入門指南，以 PDF 文件的形式呈現。這份"速查表"提供了在 C# 和 VB.NET 中產生和編輯 PDF 的常用函數和範例，可協助您快速上手 IronPDF，節省在 .NET 專案中使用它的時間。

下載

檢視 API 參考資料

探索 IronPDF 的 API 參考資料，概述 IronPDF 所有功能、命名空間、類別、方法欄位和枚數的細節。

查看 IronPDF API 參考