How to Convert Razor Views to PDFs Headlessly in C

為什麼我需要使用 Razor.Templating.Co/re 而不是 IronPdf.Extensions.Razor？

Razor.Templating.Co/re 提供真正的無頭渲染功能——無需網頁執行環境或瀏覽器視窗，即可將 Razor 檢視轉換為 HTML。 此方案適用於後台服務、主控台應用程式或無使用者介面的環境。 IronPdf.Extensions.Razor 需在網頁環境中運作。

哪種專案類型最適合用於無頭 PDF 生成？

ASP.NET Core Web App (Model-View-Controller) 專案提供必要的 Razor 視圖基礎架構，並具備靈活的部署選項。 請在背景服務、Azure Functions 或主控台應用程式中使用此方法。 請參閱《將 IronPDF 部署至 Azure》以進行雲端生成。

如何安裝所需的 NuGet 套件？

請使用 NuGet 套件管理員安裝套件。 您需要 IronPdf 和 Razor.Templating.Co/re：

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Co/re

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Co/re" Version="1.x.x" />

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Co/re

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Co/re" Version="1.x.x" />

' Install via Package Manager Console
' Install-Package IronPdf
' Install-Package Razor.Templating.Co/re

' Or add to your .vbproj file
' <PackageReference Include="IronPdf" Version="2024.x.x" />
' <PackageReference Include="Razor.Templating.Co/re" Version="1.x.x" />

我應該在 Razor 視圖中加入哪些 HTML 內容？

請輸入您要渲染為 PDF/A 的 HTML 內容：

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

對於複雜的版面配置，請使用 CSS 和 PRINT 樣式以確保 PDF 完美呈現。 IronPDF 支援現代 CSS3 功能，可實現精緻的文件版面配置。

為何使用表格來顯示 PDF 資料？

表格能提供結構化且條理分明的資訊，非常適合轉譯為印刷文件。 這些工具在各平台上格式一致，且以 PDF 格式呈現時仍具可讀性。 IronPDF 的渲染引擎能妥善處理表格佈局，完整保留邊框、間距及對齊方式。 若需進階排版，請嘗試調整自訂邊距以優化版面配置。

PDF 輸出時常見的樣式考量有哪些？

針對 PDF 輸出，請使用專為列印設計的 CSS 媒體查詢、固定像素值（而非相對單位），並採用內嵌字型以確保渲染效果一致。 IronPDF 支援網頁字型與圖示字型，以確保品牌一致性。 針對多頁文件，請考慮分頁設定，並設定適當的邊距以呈現 Professional 外觀。

我可以對 PDF 檔案套用哪些渲染選項？

IronPDF 提供豐富的渲染選項。 新增頁首與頁尾、設定自訂紙張尺寸、控制頁面方向，以及添加浮水印。 ChromePdfRenderer 提供超過 50 個屬性，用於自訂 PDF 生成。

如何處理 PDF 生成過程中的錯誤？

實作錯誤處理機制以確保 PDF 生成過程的穩健性：

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

Imports IronPdf
Imports System.Threading.Tasks

Public Class PdfGenerator
    Public Shared Async Function GeneratePdfAsync() As Task(Of IResult)
        Try
            Dim html = Await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml")
            Dim renderer = New ChromePdfRenderer()
            Dim pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot")
            Return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf")
        Catch ex As Exception
            ' Log the error details
            IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}")
            Return Results.Problem("Failed to generate PDF", statusCode:=500)
        End Try
    End Function
End Class

何時應啟用詳細記錄？

在開發與疑難排解期間啟用詳細記錄功能。 IronPDF 的日誌記錄功能可提供渲染過程的深入分析，有助於識別 HTML 解析、資源載入或設定相關的問題。 在正式部署時，請使用自訂記錄功能以整合至您的應用程式記錄基礎架構中。

我還應注意哪些與路徑相關的問題？

除波浪號 (~) 路徑問題外，請確保圖片來源使用絕對路徑或正確的相對路徑。 針對外部資源，請使用基礎網址以確保資源能正確載入。 關於 Azure Blob Storage 圖片，請參閱"從 Azure Blob Storage 嵌入圖片"。

靜態資產如何影響 PDF 生成？

靜態資源（CSS、JavaScript、圖片）會影響 PDF 生成效能與品質。 請確保渲染過程中資源可存取，使用最佳化圖片，並考慮將關鍵 CSS 內嵌於頁面中以加快渲染速度。 瞭解 JavaScript 密集型內容的渲染延遲與超時問題。

執行專案以產生 PDF 文件。

輸出 PDF

最終的 PDF 檔案應呈現何種樣貌？

您的 PDF 檔案應完整保留所有 Razor View 格式設定——包括表格結構、字型、顏色及版面配置。 版面應適當調整，邊距整潔且外觀專業。 為驗證輸出品質，請使用 IronPDF 的光柵化功能將頁面預覽為圖片。

如何排除常見的 PDF 渲染問題？

常見問題包括樣式缺失、版面錯亂或內容不完整。 啟用詳細記錄、驗證資產路徑，並確保 HTML 能正確通過驗證。 若遇到複雜的版面配置，請在轉換前使用 Chrome 除錯工具預覽 HTML。 若遇到特定的渲染問題，請使用 WaitFor 延遲機制，以確保內容載入完畢後再進行渲染。

執行範例專案有哪些先決條件？

您需要 Visual Studio 2019 或更新版本，並搭配 .NET 6.0 SDK 或更高版本。 本專案需連線至網際網路以進行 NuGet 套件還原。 執行前請在 Program.cs 中更新您的 IronPDF 授權金鑰。 關於部署，請參閱 Windows 安裝指南以了解其他需求。

如何根據我的使用情境自訂範例？

此範例可作為您根據具體需求進行調整的基礎。 新增動態資料模型、為經常產生的 PDF 實作快取功能，或與現有的驗證機制整合。 針對進階情境，可探索使用非同步 PDF 生成以提升效能，或實作 PDF 壓縮以減小檔案大小。 為文件真實性添加數位簽章，或為敏感文件設定密碼保護。