ASP.NET Core C# 앱에서 Razor Pages를 PDF로 변환하는 방법

소개

Razor Pages는 ASP.NET Core 애플리케이션에서 동적 웹 콘텐츠를 구축하는 강력하고 직관적인 방법을 제공합니다. IronPDF의 렌더링 기능과 결합하면 개발자는 웹 콘텐츠에서 바로 전문가 수준의 PDF 문서를 생성할 수 있습니다. 이 접근 방식은 복잡한 PDF 생성 로직을 제거하고 기존의 HTML 및 CSS 기술을 활용할 수 있도록 해줍니다.

IronPDF와 Razor Pages의 통합은 보고서, 송장, 증명서 및 동적인 데이터 표현이 필요한 기타 문서를 생성하는 데 특히 유용합니다. 이미 익숙한 Razor 구문을 그대로 사용하면 웹 보기와 PDF 출력 간의 일관성을 유지할 수 있습니다.

Razor 파일을 PDF로 변환하려면 어떤 NuGet 패키지가 필요합니까?

IronPdf.Extensions.Razor 패키지는 메인 IronPdf 패키지의 확장 버전입니다. ASP.NET Core 웹 앱에서 Razor Pages를 PDF 문서로 렌더링하려면 IronPdf.Extensions.Razor 및 IronPdf 패키지가 모두 필요합니다. 자세한 설치 지침은 설치 개요 가이드를 참조하세요.

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor

# Command to install IronPdf.Extensions.Razor package using NuGet Package Manager
Install-Package IronPdf.Extensions.Razor

### NuGet을 사용하여 설치하세요

Install-Package IronPdf.Extensions.Razor

NuGet.org/packages/IronPdf.Extensions.Razor/

ASP.NET Core에서 Razor Pages를 PDF로 변환하는 방법은 무엇인가요?

Razor Pages를 PDF 파일로 변환하려면 ASP.NET Core 웹 앱 프로젝트가 필요합니다. 이 과정에는 데이터에 대한 모델을 만들고, 해당 데이터를 표시하기 위한 Razor 페이지를 설정한 다음, IronPDF의 RenderRazorToPdf 메서드를 사용하여 PDF 출력을 생성하는 작업이 포함됩니다.

:path=/static-assets/pdf/content-code-examples/how-to/cshtml-to-pdf-razor-model.cs

namespace RazorPageSample.Models
{
    public class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

@page
@using RazorPageSample.Models;
@model RazorPageSample.Pages.PersonsModel
@{
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in ViewData["personList"] as List<Person>)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<form method="post">
    <button type="submit">Print</button>
</form>

@page
@using RazorPageSample.Models;
@model RazorPageSample.Pages.PersonsModel
@{
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in ViewData["personList"] as List<Person>)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<form method="post">
    <button type="submit">Print</button>
</form>

Razor Pages를 PDF로 렌더링

다음으로, 아래 코드는 먼저 ChromePdfRenderer 클래스를 인스턴스화합니다. 이 값을 RenderRazorToPdf 메서드에 전달하는 것만으로도 이 Razor 페이지를 PDF 문서로 변환할 수 있습니다.

RenderingOptions 에서 제공되는 모든 기능을 완벽하게 사용할 수 있습니다. 이러한 기능에는 생성된 PDF에 페이지 번호를 적용하고, 사용자 지정 여백을 설정하고, 사용자 지정 텍스트와 HTML 머리글 및 바닥글을 추가하는 기능이 포함됩니다. PDF 파일의 메타데이터를 구성하여 문서 식별 및 검색 기능을 최적화할 수도 있습니다.

• "Persons.cshtml" 파일의 드롭다운 메뉴를 열어 "Persons.cshtml.cs" 파일을 확인하세요.
• "Persons.cshtml.cs" 파일을 아래 코드로 수정하세요.

using IronPdf.Razor;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using RazorPageSample.Models;

namespace RazorPageSample.Pages
{
    public class PersonsModel : PageModel
    {
        [BindProperty(SupportsGet = true)]
        public List<Person> Persons { get; set; }

        // Handle GET request to load initial data
        public void OnGet()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;
        }

        // Handle POST request to convert Razor page to PDF
        public IActionResult OnPost()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;

            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render Razor Page to PDF document
            PdfDocument pdf = renderer.RenderRazorToPdf(this);

            // Return the generated PDF file with appropriate content headers
            Response.Headers.Add("Content-Disposition", "inline");
            return File(pdf.BinaryData, "application/pdf", "razorPageToPdf.pdf");

            // Optionally view the output PDF in browser (uncomment below line if needed)
            // return File(pdf.BinaryData, "application/pdf");
        }
    }
}

using IronPdf.Razor;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using RazorPageSample.Models;

namespace RazorPageSample.Pages
{
    public class PersonsModel : PageModel
    {
        [BindProperty(SupportsGet = true)]
        public List<Person> Persons { get; set; }

        // Handle GET request to load initial data
        public void OnGet()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;
        }

        // Handle POST request to convert Razor page to PDF
        public IActionResult OnPost()
        {
            Persons = new List<Person>
            {
                new Person { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
                new Person { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
                new Person { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
            };

            ViewData["personList"] = Persons;

            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Render Razor Page to PDF document
            PdfDocument pdf = renderer.RenderRazorToPdf(this);

            // Return the generated PDF file with appropriate content headers
            Response.Headers.Add("Content-Disposition", "inline");
            return File(pdf.BinaryData, "application/pdf", "razorPageToPdf.pdf");

            // Optionally view the output PDF in browser (uncomment below line if needed)
            // return File(pdf.BinaryData, "application/pdf");
        }
    }
}

RenderRazorToPdf 메서드는 추가 처리 및 편집을 거칠 수 있는 PdfDocument 객체를 반환합니다. PDF 파일을 PDFA 또는 PDFUA 형식으로 내보내거나, 생성된 PDF 문서에 디지털 서명을 적용하거나, PDF 문서를 병합 및 분할할 수 있습니다. 이 방법을 사용하면 페이지를 회전하고, 주석이나 책갈피를 추가하고, PDF에 사용자 지정 워터마크를 삽입할 수도 있습니다.

문서 관리를 더욱 효율적으로 하기 위해 품질 저하 없이 파일 크기를 줄이도록 PDF를 압축할 수도 있습니다. 이는 특히 대용량 보고서를 처리하거나 대역폭이 제한적일 때 유용합니다. 또한 IronPDF에서 제공하는 광범위한 편집 기능은 당사의 종합적인 PDF 편집 튜토리얼에 자세히 설명되어 있습니다.

<header>
    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
        <div class="container">
            <a class="navbar-brand" asp-area="" asp-page="/Index">RazorPageSample</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                    aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
                <ul class="navbar-nav flex-grow-1">
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Index">Home</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Persons">Person</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Privacy">Privacy</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
</header>

<header>
    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
        <div class="container">
            <a class="navbar-brand" asp-area="" asp-page="/Index">RazorPageSample</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
                    aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
                <ul class="navbar-nav flex-grow-1">
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Index">Home</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Persons">Person</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link text-dark" asp-area="" asp-page="/Privacy">Privacy</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
</header>

PDF 생성을 실행하면 어떻게 되나요?

이 문서에서는 프로젝트를 실행하고 PDF 문서를 생성하는 방법을 보여줍니다. "인물" 탐색 링크를 클릭하면 데이터가 표 형식으로 표시됩니다. "인쇄" 버튼을 클릭하면 PDF 생성 프로세스가 시작되어 현재 Razor 페이지 보기가 다운로드 가능한 PDF 문서로 변환됩니다.

생성된 PDF는 Razor 페이지의 모든 스타일과 서식을 유지하므로 웹 보기와 PDF 출력 간의 일관된 모양을 보장합니다. 이 접근 방식은 보고서, 송장 또는 애플리케이션의 데이터베이스나 비즈니스 로직에서 데이터를 가져와야 하는 모든 문서를 생성하는 데 특히 유용합니다.

완전한 ASP.NET Core 웹 앱 예제를 어디에서 다운로드할 수 있나요?

이 가이드의 전체 코드는 압축 파일로 다운로드할 수 있으며, Visual Studio에서 ASP.NET Core 웹 앱 프로젝트로 열 수 있습니다.

RazorPageSample.zip ASP.NET Core 웹 앱 프로젝트를 다운로드하세요.