如何在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!

將此檔案儲存為"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");
        }
    }
}

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

• 我們首先匯入必要的命名空間，包括IronPDF命名空間，其中包含 HTML 到 PDF 的轉換功能。 然後我們定義 Index 方法，該方法只是向Razor視圖傳回一個項目清單。
• 我們定義了 DownloadPDF 方法，該方法負責產生 PDF 文件。
• 我們先建立一個渲染器ChromePdfRenderer 。 然後使用 RenderRazorViewToPdf 擴充方法產生包含 PDF 檔案中資料的Razor視圖。 然後我們設定 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 檔案新增至專案中

在這個例子中，我們將使用一個範例 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);
        }
    }
}