如何在ASP.NET Core C#應用程式中將Razor頁面轉換成PDF

Curtis Chau
Curtis Chau
已更新: 2026年9月17日

IronPDF 可以透過使用 RenderRazorToPdf 方法,將 Razor 頁面 (.cshtml 檔案) 在 ASP.NET Core 應用程式中轉換為 PDF 文件,簡化了從網頁內容生成 PDF 的過程,並完全支援 C# 和 HTML 呈現。

Razor 頁面是一個具有 .cshtml 副檔名的檔案,它結合了 C# 和 HTML 來生成網頁內容。 在 ASP.NET Core 中,Razor Pages 是組織 Web 應用程式程式碼的一種更簡單的方式,非常適合只讀或做簡單資料輸入的簡單頁面。

ASP.NET Core Web 應用程式是使用 ASP.NET Core 建立的 Web 應用程式,ASP.NET Core 是一個用於開發現代 Web 應用程式的跨平台框架。

IronPDF 簡化了在 ASP.NET Core Web 應用程式專案中從 Razor Pages 建立 PDF 檔案的流程。 這使得在 ASP.NET Core Web Apps 中直接生成 PDF。

快速開始:幾秒鐘內將Razor Pages轉換為PDF

在 ASP.NET Core 應用程式中將您的 Razor 頁面轉換成高品質的 PDF。 透過使用 RenderRazorToPdf 方法,您可以將 CSHTML 檔案轉換為 PDF 文件,優化您的工作流程並增強文件分發。 本指南將教您在幾分鐘內完成所需的簡單步驟。

  1. 1使用 IronPDF 安裝 NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2複製並運行這段程式碼。

    // Install-Package IronPdf.Extensions.Razor
    var pdf = new IronPdf.ChromePdfRenderer().RenderRazorToPdf("Views/Home/Index.cshtml");
  3. 3部署到您的生產環境進行測試

    立即在您的項目中開始使用 IronPDF,並使用 免費試用
    arrow pointer

介紹

Razor Pages 提供了在 ASP.NET Core 應用程式中建立動態網頁內容的強大直覺方式。 當與 IronPDF 的渲染功能結合時,開發人員可以直接從網頁內容建立專業的 PDF 文件。 此方法可移除複雜的 PDF 生成邏輯,並允許您使用現有的 HTML 和 CSS 技能。

IronPDF 與 Razor Pages 的整合對於產生報告、發票、證書以及任何其他需要動態資料呈現的文件特別有價值。 透過使用您已經熟悉的 Razor 語法,您可以保持網頁檢視與 PDF 輸出之間的一致性。

我需要哪些 NuGet 套件才能將 Razor 轉換為 PDF?

IronPdf.Extensions.Razor 套件 是主要 IronPdf 套件的擴展。 在 ASP.NET Core Web App 中渲染 Razor 頁面為 PDF 文件,需要使用 IronPdf.Extensions.Razor 和 IronPdf 套件。如需詳細安裝說明,請參閱我們的安裝概述指南。

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor
SHELL
C# NuGet PDF 庫

使用 NuGet 安裝

Install-Package IronPdf.Extensions.Razor

如何在 ASP.NET Core 中將 Razor 頁面轉換為 PDF?

您需要一個 ASP.NET Core Web App 專案來將 Razor Pages 轉換成 PDF 檔案。 過程涉及為您的資料建立一個模型,設置一個 Razor 頁面來顯示該資料,然後使用 IronPDF 的 RenderRazorToPdf 方法生成 PDF 輸出。

為什麼我需要 Model 類別來生成 PDF?

模型類別是 Razor 頁面中資料表示的骨幹。 這些工具提供結構化的方式將資料從控制器邏輯傳送到檢視,確保類型的安全性和可維護性。 在生成 PDF 時,這些模型變得更加重要,因為它們定義了將出現在您最終文件中的資料的確切結構。

  • 在專案中建立一個新資料夾,並將其命名為「Models」。
  • 將一個標準的 C# 類添加到資料夾中,並命名為 Person。 此類將用作個別數據的模型。 請使用以下程式碼片段:
namespace RazorPageSample.Models
{
    public class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

如何設置 Razor 頁面以進行 PDF 轉換?

在 "Pages" 資料夾中新增一個空白的 Razor 頁面,並命名為 persons.cshtml。

  • 使用下面提供的代碼示例修改新創建的 Persons.cshtml 檔案。

下面的程式碼會在瀏覽器中顯示資訊。 請注意 Razor 語法如何允許在 HTML 中直接集成 C# 代碼,這使得它非常適合生成可以轉換為 PDF 的動態內容:

@page
@using RazorPageSample.Models;
@model RazorPageSample.Pages.PersonsModel
@{
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in ViewData["personList"] as List<Person>)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<form method="post">
    <button type="submit">Print</button>
</form>
HTML

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能,例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000,同時提高生產力,釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官,OPYN

查看案例研究

將 Razor Pages 渲染為 PDF

接下來,下面的程式碼首先實例化ChromePdfRenderer類別。 將 這個 傳遞給 RenderRazorToPdf 方法就足以將這個 Razor 頁面轉換為 PDF 文件。

您可以完全使用 RenderingOptions中提供的功能。 這些功能包括將 頁碼 應用於生成的 PDF,設置 自定義邊距,以及添加自定義 文字以及 HTML 頭部和尾部。 您還可以為您的 PDF 配置 元數據,以確保正確的文件識別和可搜尋性。

  • 打開 Persons.cshtml 檔案下拉選單以查看 Persons.cshtml.cs 檔案。
  • 使用下面的代碼修改 Persons.cshtml.cs。
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<Person> Persons { get; set; }
        
        // Handle GET request to load initial data
        public void OnGet()
        {
            Persons = new List<Person>
            {
                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<Person>
            {
                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。 將「人物」導覽項目放在「首頁」之後。

確保 asp-page 屬性的值與我們的檔案名稱完全匹配,在此例中為 Persons。 這可確保在您的 ASP.NET Core 應用程式中進行正確的路由:

<header>
    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
        <div class="container">
            <a class="navbar-brand" asp-area="" asp-page="/Index">RazorPageSample</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                    aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
                <ul class="navbar-nav flex-grow-1">
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Index">Home</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Persons">Person</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Privacy">Privacy</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
</header>
HTML

當我運行 PDF 生成時會發生什麼?

這會告訴您如何執行專案並產生 PDF 文件。 當您按一下「人」導覽連結時,您會看到以表格格式顯示的資料。 點選「列印」按鈕會觸發 PDF 產生程序,將目前的 Razor Page 檢視轉換為可下載的 PDF 文件。

Visual Studio 顯示 C# 的 PersonsModel 類別,含使用 IronPDF 產生 PDF 的 OnGet 與 OnPostAsync 方法

生成的 PDF 會保留 Razor 頁面的所有樣式與格式,確保網頁檢視與 PDF 輸出的外觀一致。 這種方法對於產生報告、發票或任何需要應用程式資料庫或商業邏輯資料的文件特別有用。

在哪裡可以下載完整的 ASP.NET Core Web App 示例?

您可以下載本指南的完整程式碼壓縮文件,然後在 Visual Studio 中將其作為 ASP.NET Core Web 應用程式專案開啟。

常見問題

如何在ASP.NET Core中使用IronPDF將Razor頁面轉換為PDF?

您可以通過使用IronPDF的RenderRazorToPdf方法在ASP.NET Core中將Razor頁面轉換為PDF。這個方法允許您輕鬆地將CSHTML文件轉換為PDF文件,正如指南中提供的範例程式所示。

什麼是RenderRazorToPdf方法?

RenderRazorToPdf方法是IronPDF的一個功能,使開發者能夠將由HTML和C#代碼組成的Razor頁面轉換為高質量的PDF文件。它簡化了在ASP.NET Core應用程式中生成PDF的過程。

我是否需要特定的NuGet套件來使用IronPDF將Razor頁面轉換為PDF?

是的,您需要安裝IronPdf.Extensions.Razor和IronPdf這兩個NuGet套件,以在您的ASP.NET Core Web App中有效地將Razor頁面呈現為PDF文件。

為什麼在從Razor頁面生成PDF時需要一個模型類?

模型類是關鍵,因為它們定義了在您的PDF文件中顯示的數據結構。它們促進了數據綁定並確保您的Razor頁面能動態生成內容以加入PDF。

我可以自定義IronPDF生成的PDF的外觀嗎?

是的,通過使用IronPDF中的RenderingOptions,您可以自定義頁碼、邊距、文本以及HTML頁眉和頁尾等方面。這讓您可以保持一致性,並使PDF輸出符合您的品牌和設計偏好。

我如何在ASP.NET Core應用程式中設置PDF生成頁面的導航?

要設置導航,您可以編輯頁面資料夾中的_Layout.cshtml文件,整合到您的PDF生成頁面的鏈接。確保根據您專案中使用的頁面名稱正確定義路由。

IronPDF在PDF文件管理方面提供了哪些功能?

IronPDF提供了PDF壓縮、數位簽章整合、合併和拆分文件、旋轉、註釋、書籤和水印加蓋等功能,提供全面的PDF文件管理能力。

我可以在哪裡找到一個使用IronPDF進行PDF轉換的完整ASP.NET Core Web App示例?

您可以從指南中提供的鏈接下載一個完整的ASP.NET Core Web App示例,展示如何使用IronPDF將Razor頁面轉換為PDF,示例作為壓縮檔案提供。

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布