C#でCSHTMLをPDFに変換する方法

PDF Converter

PDF コンバーターは、印刷可能なドキュメントまたは Web ページを PDF ドキュメントに変換するツールです。 HTML、Word、Excel、またはその他の印刷可能なドキュメントから PDF ファイルを生成するために使用できます。 PDF コンバーターには、オンライン ツール、デスクトップ ソフトウェア、ライブラリなど、さまざまな形式があります。

Razor ビュー

Razor ビューは、ASP.NET Core で HTML ページを動的に生成するために使用されるビュー エンジンです。 これは、HTML マークアップと C# コードを組み合わせたマークアップ構文です。

! C#でCSHTMLをPDFに変換する方法、図1: Razorビュー レイザービュー

Razor ビューを使用すると、プレゼンテーション ロジックをビジネス ロジックから分離することで、開発者は動的な Web ページを簡単に作成できます。

コントローラークラス

コントローラー クラスは、ASP.NET Core アプリケーションで受信 HTTP 要求を処理する C# クラスです。 特定の 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 ファイルを作成します。 この例では、"Hello, World!"というテキストを表示する簡単なCSHTML チュートリアルファイルを作成します。

@{
    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

このコードをステップごとに見ていきましょう。

• まず、HTML から PDF への変換機能が含まれる IronPDF 名前空間を含む、必要な名前空間をインポートします。
• 次に、項目のリストを Razor ビューに返すだけのIndexメソッドを定義します。
• PDF ドキュメントの生成を担当するDownloadPDFメソッドを定義します。
• まず、レンダラーChromePdfRendererを作成します。
• 次に、 RenderRazorViewToPdf拡張メソッドを使用して、PDF ファイルにデータを含む Razor ビューを生成します。
• 次に、 Content-Dispositionヘッダーを設定して、PDF がブラウザーに表示されるのではなく、強制的にダウンロードされるようにします。
• 最後に、File メソッドを使用して PDF ドキュメントをファイルとして返します。

これは、C# で IronPDF を使用して 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ファイルを追加する

この例では、CSHTMLファイルに変換するサンプルPDFファイルを使用します。この手順では、お好きなPDFファイルを使用できます。

ソリューション エクスプローラーでプロジェクトを右クリックし、コンテキスト メニューから [追加 > 既存の項目] を選択して、PDF ファイルをプロジェクトに追加します。

また、変換された HTML 文字列を保存するために使用する空の CSHTML ファイルを作成する必要があります。 これを行うには、ソリューション エクスプローラーでプロジェクトを右クリックし、コンテキスト メニューから [追加 > 新しい項目] を選択します。 テンプレートのリストから"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