如何在C#中將CSHTML轉換為PDF

PDF轉換器

PDF轉換器是一種可以將任何可列印文件或網頁轉換為PDF文件的工具。 它可以用來從 HTML、Word、Excel 或任何其他可列印文件產生 PDF 文件。 PDF轉換器有多種形式，包括線上工具、桌面軟體和函式庫。

剃刀視圖

Razor 視圖是 ASP.NET Core 中用於動態產生 HTML 頁面的視圖引擎。 它是一種將 HTML 標記與 C# 程式碼結合的標記語法。

如何在 C# 中將 CSHTML 轉換為 PDF，圖 1：Razor 視圖 剃刀視圖

Razor視圖透過將表現邏輯與業務邏輯分離，使開發人員能夠輕鬆建立動態網頁。

控制器類

控制器類別是一個 C# 類，用於處理 ASP.NET Core 應用程式中傳入的 HTTP 請求。 它包含與特定 HTTP 動詞（例如 GET、POST、PUT、DELETE）對應的方法，並傳回 HTTP 回應。

NuGet 套件管理器

NuGet 套件管理器是 Visual Studio 中用於管理 .NET 專案中的套件的工具。 它使開發人員能夠在其專案中輕鬆安裝、更新和卸載軟體包。 NuGet 套件是包含可重複使用程式碼的函式庫，並透過 NuGet 套件管理器分發。

依賴注入

依賴注入是一種設計模式，它允許開發人員透過將依賴項注入到應用程式元件的類別中來解耦應用程式元件。 它透過減少依賴項和使程式碼更加模組化，使應用程式的測試和維護變得容易。

現在我們已經了解了重要的概念，讓我們深入了解使用 IronPDF 將 CSHTML 轉換為 PDF 的過程。

步驟 1 安裝 IronPDF

第一步是在 C# 專案中透過 NuGet 套件管理器安裝 IronPDF 。 您可以透過下載 IronPDF.dll 檔案並將其新增至專案引用來安裝 IronPDF。 若要使用 NuGet 套件管理員安裝 IronPDF，請開啟套件管理器控制台並執行下列命令：

步驟 2 建立 CSHTML 文件

接下來，建立一個包含要轉換為 PDF 的內容的 CSHTML 檔案。 在這個範例中，我們將建立一個簡單的CSHTML 教學文件，其中顯示文字"Hello, World!"。

@{
    Layout = null;
}
Hello
Hello, World!

@{
    Layout = null;
}
Hello
Hello, World!

@
If True Then
	Layout = Nothing
End If
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Hello Hello, World!

將此檔案儲存為"Hello.cshtml"到您的專案目錄中。

如何在 C# 中將 CSHTML 轉換為 PDF，圖 4：C# 中的 PDF 文件 C# 中的 PDF 文件

步驟 3：將 CSHTML 轉換為 PDF 文檔

要將CSHTML 文件轉換為 PDF文件，我們將使用 C# 中的 IronPDF 庫。 以下是將"Hello.cshtml"轉換為PDF的程式碼：

using System.IO;
using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace CSHTMLtoPDF.Controllers
{
    public class HomeController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        public HomeController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
        }

        public IActionResult Index()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };
            return View(items);
        }

        public IActionResult DownloadPDF()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };

            // Initialize a new instance of ChromePdfRenderer from IronPDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render the specified Razor view to a PDF document
            PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items);

            // Set the headers to force the browser to download the PDF
            var contentDisposition = new System.Net.Mime.ContentDisposition
            {
                FileName = "Items.pdf",
                Inline = false,
            };
            Response.Headers.Add("Content-Disposition", contentDisposition.ToString());

            // Return the PDF document to the client
            return File(pdf.BinaryData, "application/pdf");
        }
    }
}

using System.IO;
using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace CSHTMLtoPDF.Controllers
{
    public class HomeController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        public HomeController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
        }

        public IActionResult Index()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };
            return View(items);
        }

        public IActionResult DownloadPDF()
        {
            var items = new[] { "Item 1", "Item 2", "Item 3" };

            // Initialize a new instance of ChromePdfRenderer from IronPDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render the specified Razor view to a PDF document
            PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items);

            // Set the headers to force the browser to download the PDF
            var contentDisposition = new System.Net.Mime.ContentDisposition
            {
                FileName = "Items.pdf",
                Inline = false,
            };
            Response.Headers.Add("Content-Disposition", contentDisposition.ToString());

            // Return the PDF document to the client
            return File(pdf.BinaryData, "application/pdf");
        }
    }
}

Imports System.IO
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace CSHTMLtoPDF.Controllers
	Public Class HomeController
		Inherits Controller

		Private ReadOnly _viewRenderService As IRazorViewRenderer
		Public Sub New(ByVal viewRenderService As IRazorViewRenderer)
			_viewRenderService = viewRenderService
		End Sub

		Public Function Index() As IActionResult
			Dim items = { "Item 1", "Item 2", "Item 3" }
			Return View(items)
		End Function

		Public Function DownloadPDF() As IActionResult
			Dim items = { "Item 1", "Item 2", "Item 3" }

			' Initialize a new instance of ChromePdfRenderer from IronPDF
			Dim renderer As New ChromePdfRenderer()

			' Render the specified Razor view to a PDF document
			Dim pdf As PdfDocument = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Index.cshtml", items)

			' Set the headers to force the browser to download the PDF
			Dim contentDisposition = New System.Net.Mime.ContentDisposition With {
				.FileName = "Items.pdf",
				.Inline = False
			}
			Response.Headers.Add("Content-Disposition", contentDisposition.ToString())

			' Return the PDF document to the client
			Return File(pdf.BinaryData, "application/pdf")
		End Function
	End Class
End Namespace

讓我們一步一步地分析這段程式碼：

• 我們首先匯入必要的命名空間，包括 IronPDF 命名空間，其中包含 HTML 到 PDF 的轉換功能。 然後我們定義Index方法，該方法只是簡單地向 Razor 視圖傳回一個項目清單。
• 我們定義了DownloadPDF方法，該方法負責產生 PDF 文件。
• 我們先建立一個渲染器ChromePdfRenderer 。 然後使用RenderRazorViewToPdf擴充方法產生包含 PDF 檔案中資料的 Razor 視圖。 然後，我們設定Content-Disposition標頭，強制將 PDF 下載而不是在瀏覽器中顯示。 最後，我們使用 File 方法將 PDF 文件作為文件傳回。

這是使用 IronPDF 在 C# 中將 CSHTML 轉換為 PDF 的基本程式碼。 但是，您可以使用許多選項和設定來自訂 PDF 輸出。 讓我們來看看其中的一些選項。

測試應用程式

所有必要的程式碼都已就緒，我們現在可以測試應用程式了。 請遵循以下步驟：

• 按 F5 鍵或按一下 Visual Studio 中的綠色"播放"按鈕來執行應用程式。
• 在您的 Web 瀏覽器中，導覽至http://localhost:/Home/Index ，其中 是 Visual Studio 指派的連接埠號碼。
• 確認商品清單顯示正確。
• 點擊"下載 PDF"連結產生並下載 PDF 文件。

如果一切正常，您應該會看到一個 PDF 文檔，其中包含您先前定義的項目清單。

步驟 1 建立一個新的控制台應用程式

開啟 Visual Studio，從選單中選擇"檔案 > 新建 > 專案"，然後從專案範本清單中選擇"控制台應用程式 (.NET Framework)"或"控制台應用程式 (.NET Core)"，建立一個新的控制台應用程式。

步驟 2：安裝 IronPDF NuGet 套件

接下來，我們需要在控制台應用程式中安裝IronPDF NuGet 套件。 為此，請在解決方案資源管理器中右鍵單擊項目，然後從上下文功能表中選擇"管理 NuGet 套件"。

在 NuGet 套件管理員中，搜尋"IronPDF"，然後從搜尋結果中選擇"IronPDF"套件。 點選"安裝"按鈕安裝該軟體套件及其相依性。

步驟 3：將 PDF 和 CSHTML 檔案新增至專案中

在這個例子中，我們將使用一個範例 PDF 文件，並將其轉換為 CSHTML 文件。您可以使用任何您喜歡的 PDF 檔案來完成此步驟。

在解決方案資源管理器中右鍵單擊項目，然後從上下文選單中選擇"新增 > 現有項"，將 PDF 檔案新增至項目。

我們還需要建立一個空的 CSHTML 文件，用於儲存轉換後的 HTML 字串。 為此，請在解決方案資源管理器中右鍵單擊項目，然後從上下文功能表中選擇"新增 > 新項目"。 從範本清單中選擇"HTML頁面"，然後為檔案命名（例如"converted.cshtml"），然後按一下"新增"。

步驟 4：將 PDF 文件轉換為 CSHTML 文件

文件準備好後，我們現在可以使用 IronPDF 編寫程式碼，將 PDF 文件轉換為 CSHTML 文件。 將以下程式碼新增至控制台應用程式的 Main 方法：

using IronPdf;

namespace PdfToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load the PDF file
            PdfDocument pdf = PdfDocument.FromFile("sample.PDF");

            // Convert the PDF to an HTML string
            string html = pdf.ToHtml();

            // Save the HTML string to the CSHTML file
            System.IO.File.WriteAllText("converted.cshtml", html);
        }
    }
}

using IronPdf;

namespace PdfToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load the PDF file
            PdfDocument pdf = PdfDocument.FromFile("sample.PDF");

            // Convert the PDF to an HTML string
            string html = pdf.ToHtml();

            // Save the HTML string to the CSHTML file
            System.IO.File.WriteAllText("converted.cshtml", html);
        }
    }
}

Imports IronPdf

Namespace PdfToHtml
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Load the PDF file
			Dim pdf As PdfDocument = PdfDocument.FromFile("sample.PDF")

			' Convert the PDF to an HTML string
			Dim html As String = pdf.ToHtml()

			' Save the HTML string to the CSHTML file
			System.IO.File.WriteAllText("converted.cshtml", html)
		End Sub
	End Class
End Namespace