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

PDF轉換器

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

Razor視圖

Razor視圖是一個視圖引擎，在ASP.NET Core中用於動態生成HTML頁面。 這是一種將HTML標記與C#代碼結合的標記語法。

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#中的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擴展方法將包含數據的Razor視圖生成為PDF文件。
• 然後，我們設置Content-Disposition標題，以強制PDF下載而不是在瀏覽器中顯示。
• 最後，我們使用File方法將PDF文件作為文件返回。

使用IronPDF在C#中將CSHTML轉換為PDF的基本代碼就是如此。 然而，您可以使用許多選項和設置來自定義PDF輸出。 讓我們來看看這些選項。

測試應用程式

在編寫完成所有必要代碼後，我們現在可以測試應用程式。 按照以下步驟進行：

• 通過按F5或點擊Visual Studio中的綠色"播放"按鈕來運行應用程式。
• 在您的網頁瀏覽器中導航到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文件添加到專案中

在此示例中，我們將使用一個我們想要轉換為CSHTML文件的範例PDF文件。您可以使用任何您喜歡的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