從HTML文件在C#中建立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文件

接下來，建立一個CSHTML文件，其中包含您想要轉換為PDF的內容。 在此範例中，我們將建立一個簡單的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

讓我們逐步解析此程式碼：

• 我們首先導入必要的命名空間，包括包含HTML到PDF轉換功能的IronPDF命名空間。
• 接著，我們定義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文件新增到項目中

對於此範例，我們將使用一個範例PDF文件，我們想將其轉換為CSHTML文件。您可以使用任何您喜歡的PDF文件完成這一步。

通過在解決方案總覽中右鍵單擊項目，並從上下文選單中選擇"新增 > 現有項目"，將PDF文件新增到項目中。

我們還需要建立一個空的CSHTML文件，用於儲存轉換的HTML字串。 為此，右鍵單擊解決方案總覽中的項目，然後從上下文選單中選擇"新增 > 新項目"。 從模板列表中選擇"HTML Page"，然後給文件命名（例如，"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