C#에서 CSHTML을 PDF로 변환하는 방법

PDF 변환기

PDF 변환기는 인쇄 가능한 문서나 웹 페이지를 PDF 문서로 변환하는 도구입니다. HTML, Word, Excel 또는 기타 인쇄 가능한 문서로부터 PDF 파일을 생성하는 데 사용할 수 있습니다. PDF 변환기는 온라인 도구, 데스크톱 소프트웨어, 라이브러리 등 다양한 형태로 제공됩니다.

Razor 뷰

Razor 뷰는 ASP.NET Core에서 동적으로 HTML 페이지를 생성하는 데 사용되는 뷰 엔진입니다. HTML 마크업과 C# 코드를 결합한 마크업 구문입니다.

Razor 뷰

Razor 뷰는 개발자가 프리젠테이션 로직을 비즈니스 로직과 분리하여 동적인 웹 페이지를 쉽게 만들 수 있게 해줍니다.

컨트롤러 클래스

컨트롤러 클래스는 ASP.NET Core 응용 프로그램에서 들어오는 HTTP 요청을 처리하는 C# 클래스입니다. 특정 HTTP 동사(e.g., GET, POST, PUT, DELETE)에 대응하는 메서드를 포함하며, HTTP 응답을 반환합니다.

NuGet 패키지 관리자

NuGet 패키지 관리자는 .NET 프로젝트에서 패키지를 관리하기 위해 Visual Studio에서 사용하는 도구입니다. 개발자가 프로젝트에서 패키지를 설치, 업데이트 및 제거하는 것을 쉽게 해줍니다. 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!

이 파일을 프로젝트 디렉토리에 'Hello.cshtml'로 저장합니다.

PDF 파일 in C#

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");
        }
    }
}

이 코드를 단계별로 설명하겠습니다:

• 먼저 HTML을 PDF로 변환하는 기능을 포함하는 IronPDF 네임스페이스를 포함한 필수 네임스페이스를 가져옵니다.
• 그런 다음 Index 메서드를 정의하여 Razor 뷰에 항목 목록을 간단히 반환합니다.
• PDF 문서 생성을 담당하는 DownloadPDF 메서드를 정의합니다.
• ChromePdfRenderer 렌더러를 생성하는 것으로 시작합니다.
• 그런 다음 RenderRazorViewToPdf 확장 메서드를 사용하여 데이터를 포함한 Razor 뷰를 PDF 파일로 생성합니다.
• 그런 다음 PDF를 브라우저에서 표시하는 대신 다운로드하도록 Content-Disposition 헤더를 설정합니다.
• 마지막으로 File 메서드를 사용해 PDF 문서를 파일로 반환합니다.

이것이 C#에서 IronPDF를 사용해 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 Install-Package

다음으로, 우리 콘솔 애플리케이션에 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);
        }
    }
}