1. IronPDF
  2. 操作指南
  3. Razor 轉 PDF (Blazor Server)
如何使用 C# 在 Blazor Server 中將 Razor 轉換為 PDF

在 Blazor Server 中使用 C# 將 Razor 轉換為 PDF；

柯蒂斯·週
柯蒂斯·週
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

在 Blazor Server 中使用 IronPDF 的 RenderRazorComponentToPdf 方法將 Razor 元件轉換為 PDF。 以最少的程式碼將 C# UI 元件轉換成 PDF，並可完全自訂頁眉、頁腳及頁面格式。

快速入門：幾分鐘內將 Razor 元件轉換為 PDF

使用 IronPDF 在 Blazor Server 應用程式中將 Razor 元件轉換為 PDF。 RenderRazorComponentToPdf 方法只需幾行代碼就能將您的 Razor 元件轉換成 PDF。 遵循本指南，將 Razor 轉換為 PDF 整合到您的專案中，只需最少的設定與彈性的客製化選項。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

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

    // 安裝 IronPdf.Extensions.Blazor 包
var pdf = new IronPdf.ChromePdfRenderer()
    .RenderRazorComponentToPdf<MyComponent>(new Dictionary<string,object> { {"persons",personsList} })
    .SaveAs("component-to-pdf.pdf");

  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF，免費試用！
    arrow pointer

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

  1. 下載用於在 Blazor Server 中將 Razor 轉換為 PDF 的 C# 庫
  2. 為數據添加模型類別
  3. 建立一個新的 Razor 元件並使用RenderRazorComponentToPdf方法
  4. 在左側菜單中添加一個部分以訪問新創建的 Razor 元件
  5. 下載示例項目以快速開始

Razor to PDF 轉換需要哪些 NuGet 套件？ <！--說明：說明程式碼概念的圖表或截圖 --> **IronPdf.Extensions.Blazor 套件**擴充了主 **IronPdf** 套件。 要在 Blazor Server App 中將 Razor 元件渲染為 PDF 文件，必須使用這兩個套件。此擴充提供 Blazor Server 應用程式的整合點，讓您不需大量重構，即可將現有的 Razor 元件轉換成 PDF。 安裝 IronPdf.Extensions.Blazor 會自動將核心 IronPDF 函式庫列入依賴項目。 擴充套件增加了一些方法，例如 `RenderRazorComponentToPdf` 可以理解 Blazor 的元件模型，並正確地渲染具有綁定資料的元件。 為獲得最佳效能與最新功能，請使用這兩個套件的最新版本。 請檢查 [changelog](https://ironpdf.com/product-updates/changelog/) 以取得更新與改進。 ```shell :InstallCmd 安裝 IronPdf.Extensions.Blazor 包 ```
C# NuGet PDF 庫

使用 NuGet 安裝

安裝 IronPdf.Extensions.Blazor 包
(按鈕)
nuget.org/packages/IronPdf.Extensions.Blazor/

如何在 Blazor 伺服器中將 Razor 元件渲染為 PDF？ --> <！--說明：顯示程式碼執行輸出或結果的截圖 --> 要將 Razor 元件轉換為 PDF，需要一個 Blazor 伺服器應用程式專案。 Blazor Server 應用程式在伺服器上執行，並透過 SignalR 連線渲染 UI 更新，因此適用於需要伺服器端處理的 PDF 製作。 此架構可確保在伺服器上進行 PDF 呈現，不論用戶端的瀏覽器或裝置為何，都能提供一致的結果。 在開始之前，請確保您已安裝 .NET SDK 和 Visual Studio 2019 或更新版本，並具備 ASP.NET 和網頁開發工作負載。 透過 Visual Studio 的專案範本或使用 .NET CLI 以 `dotnet new blazorserver` 建立新的 Blazor Server App。 如需詳細安裝說明和特定平台需求，請參閱 [ 安裝概述](https://ironpdf.com/get-started/installation-overview/)。

我應該使用何種模型類別結構？ 新增一個名為 **PersonInfo** 的標準 C# 類別。 此類別作為儲存個人資訊的模型。 插入以下程式碼： ```csharp :path=/static-assets/pdf/content-code-examples/how-to/razor-to-pdf-blazor-server-model.cs ``` 此模型代表傳送到您的 Razor 元件並在 PDF 中渲染的資料結構。 IronPdf 適用於任何 C# 物件模型，從簡單的 POCO 到複雜的實體框架模型。 為 PDF 生成設計模型時，請考慮資料在最終文件中的顯示方式，並據此結構屬性。

我該如何實作 PDF 生成的 Razor 元件？ 使用`RenderRazorComponentToPdf`方法將 Razor 元件轉換為 PDF。 透過實體化 **`ChromePdfRenderer`** 類別存取此方法。 該方法會返回一個 **`PdfDocument`** 物件，以供匯出或進一步修改。 返回的 PdfDocument 支援其他修改，包括轉換為 [PDF/A](https://ironpdf.com/how-to/pdfa/) 或 [PDF/UA](https://ironpdf.com/how-to/pdfua/) 格式。 您可以[合併或分割](https://ironpdf.com/how-to/merge-or-split-pdfs/)文件、旋轉頁面，以及新增[註釋](https://ironpdf.com/how-to/annotations/)或[書籤](https://ironpdf.com/how-to/bookmarks/)。 根據需要套用 [ 自訂水印](https://ironpdf.com/how-to/custom-watermark/)。 新增一個 Razor 元件，命名為 **`Person.razor`**。 請輸入以下代碼： ```razor @page "/Person" @using BlazorSample.Data; @using IronPdf; @using IronPdf.Extensions.Blazor;

Person

@code { // A parameter to receive a list of persons from the parent component. [Parameter] public IEnumerable persons { get; set; } // Dictionary to hold parameters that will be passed to the PDF renderer. public Dictionary Parameters { get; set; } = new Dictionary(); protected override async Task OnInitializedAsync() { // Initialize the persons list with some sample data. persons = new List { new PersonInfo { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" }, new PersonInfo { Name = "Bob", Title = "Mr.", Description = "Software Engineer" }, new PersonInfo { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" } }; } private async void PrintToPdf() { ChromePdfRenderer renderer = new ChromePdfRenderer(); // Apply text footer to the PDF pages. renderer.RenderingOptions.TextFooter = new TextHeaderFooter() { LeftText = "{date} - {time}", DrawDividerLine = true, RightText = "Page {page} of {total-pages}", Font = IronSoftware.Drawing.FontTypes.Arial, FontSize = 11 }; Parameters.Add("persons", persons); // Render Razor component to PDF and save it. PdfDocument pdf = renderer.RenderRazorComponentToPdf(Parameters); File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData); } } @foreach (var person in persons) { }
Name Title Description
@person.Name @person.Title @person.Description
``` 此方法可存取所有 **`RenderingOptions`**功能。 加入[文字和 HTML 標頭與頁尾](https://ironpdf.com/how-to/headers-and-footers/)，包括[頁數](https://ironpdf.com/how-to/page-numbers/)，並調整頁面尺寸和版面。 `RenderingOptions` 支援 [自訂邊距](https://ironpdf.com/how-to/custom-margins/)、適用於反應式設計的視口設定，以及動態內容的 JavaScript 執行延遲。 對於複雜的佈局或 CSS 架構（如 Bootstrap），請探索 [ 回應式 CSS 渲染功能](https://ironpdf.com/how-to/html-to-pdf-responsive-css/)，以確保 PDF 在不同的頁面大小上都能正確顯示。

如何在我的 Razor 元件中加入導航？ - 導覽至"共用資料夾"並開啟 `NavMenu.razor` 。 新增將開啟我們的 Razor 元件 `Person` 的部分。 我們的 `Person` 元件將是第二個選項。 ```razor
``` 此導覽設定與 Blazor 的路由系統整合，讓使用者可從應用程式的主導覽選單存取 PDF 產生功能。 `NavLink` 元件可確保活動路由的正確突出顯示。

PDF 生成流程是怎樣的？ 執行專案並產生 PDF 文件。 按一下"列印為 PDF"按鈕。 IronPdf 會處理您的 Razor 元件，將其轉換為 HTML，並使用其基於 Chrome 的渲染引擎將其渲染為 PDF。這保持了與現代網路瀏覽器相同的視覺保真度。 Visual Studio debugging Blazor app with PDF generation code using ChromePdfRenderer and Razor components 生成的 PDF 會儲存在您專案的輸出目錄中。 自訂儲存位置、實現直接瀏覽器下載，或將 PDF 儲存於 Azure Blob Storage 等雲端儲存中。 對於生產應用程式，針對 PDF 生成可能失敗或超出預期持續時間的情況，實施錯誤處理和使用者回饋。

哪裡可以下載完整的工作範例？ 以壓縮檔形式下載本指南的完整程式碼。在 Visual Studio 中以 Blazor Server App 專案的形式開啟。 範例包含所有的依賴、配置和範例程式碼，可立即開始在 Blazor 應用程式中進行 Razor 至 PDF 的轉換。 [下載 Blazor 範例項目，用於 Razor 到 PDF 的轉換](/static-assets/pdf/how-to/razor-to-pdf-blazor-server/BlazorSample.zip) 準備好看看您還能做些什麼嗎？ 請造訪我們的教學頁面：[轉換 PDF 文件](https://ironpdf.com/tutorials/convert-pdf/) 如需瞭解更多進階方案，請參閱我們的 [Blazor 教學](https://ironpdf.com/how-to/blazor-tutorial/)，其中涵蓋在 Blazor 應用程式中使用 IronPDF 的其他整合模式和最佳實務。

常見問題解答

在Blazor Server中，將Razor元件轉換成PDF的最快方法是什麼？

最快的方法是使用 IronPDF 的 RenderRazorComponentToPdf 方法。只需一行代碼，您就可以將任何 Razor 元件轉換為 PDF： var pdf = new IronPdf.ChromePdfRenderer().RenderRazorComponentToPdf(new Dictionary { {"persons",personsList} }).SaveAs("component-to-pdf.pdf")；

在 Blazor Server 中將 Razor 轉換為 PDF 需要哪些 NuGet 套件？

您需要 IronPdf.Extensions.Blazor 套件，它會自動包含核心 IronPDF 函式庫作為相依性。使用下列方式安裝安裝套件 IronPdf.Extensions.Blazor

當轉換Razor元件為PDF時，我可以加入自訂的頁首與頁尾嗎？

是的，當使用 RenderRazorComponentToPdf 方法轉換您的 Razor 元件時，IronPDF 提供完整的自訂選項，包括頁眉、頁腳和頁面格式。

為什麼推薦使用 Blazor Server 從 Razor 元件產生 PDF？

Blazor Server 應用程式在伺服器上執行，並透過 SignalR 連線渲染 UI 更新，使其成為 PDF 生成的理想選擇。這種架構可確保 IronPDF 的渲染發生在伺服器端，不論客戶端的瀏覽器或裝置為何，都能提供一致的結果。

我需要重構現有的Razor元件來轉換成PDF嗎？

不，IronPdf.Extensions.Blazor 套件可讓您將現有的 Razor 元件轉換為 PDF，而無需大量的重構。該擴充套件提供了解 Blazor 元件模型的整合點。

當轉換成PDF時，我該如何傳遞資料給我的Razor元件？

您可以在 RenderRazorComponentToPdf 方法中使用 Dictionary 參數傳輸資料。例如： new Dictionary { {"persons", personsList}} 其中 "persons" 是參數名稱，而 personsList 是您的資料。

柯蒂斯·週
柯蒂斯·週
  現在就和工程團隊聊天吧
技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位，專長於前端開發，精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面，喜歡使用現代框架，並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外，柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣，致力於探索硬體和軟體整合的創新方法。閒暇時，他喜歡玩遊戲和製作 Discord 機器人，將他對科技的熱愛與創造力結合。

準備好開始了嗎？
Nuget 下載 17,012,929 | 版本： 2025.12 剛剛發布