ASP.NET MVC에서 C#을 사용하여 뷰를 PDF로 변환하는 방법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 8월 2일

IronPDF는 ChromePdfRenderer.RenderView() 메서드를 사용하여 ASP.NET MVC 뷰를 PDF 문서로 변환할 수 있게 해주며, 몇 줄의 코드만으로 가능합니다. IronPdf.Extensions.Mvc.Framework 패키지는 CSHTML 뷰를 PDF로 렌더링하기 위한 ASP.NET MVC 프로젝트와의 간단한 통합을 제공합니다.

뷰는 ASP.NET Framework에서 웹 애플리케이션의 HTML 마크업을 생성하는 데 사용되는 구성 요소입니다. 이는 ASP.NET MVC 및 ASP.NET Core MVC 애플리케이션에서 일반적으로 사용되는 모델-뷰-컨트롤러(MVC) 패턴의 일부입니다. 뷰는 HTML 콘텐츠를 동적으로 렌더링하여 사용자에게 데이터를 표시하는 역할을 합니다. IronPDF의 Chrome PDF Rendering Engine의 강력한 기능은 모든 스타일링, 레이아웃 및 상호작용 요소를 유지하면서 뷰를 픽셀 단위의 정확도로 렌더링할 수 있게 해줍니다.

ASP.NET 웹 애플리케이션(.NET Framework) MVC는 마이크로소프트에서 제공하는 웹 애플리케이션 프레임워크입니다. 이는 웹 애플리케이션 개발을 조직화하고 단순화하기 위해 모델-뷰-컨트롤러(MVC)라 불리는 구조적 아키텍처 패턴을 따릅니다.

  • 모델: 데이터, 비즈니스 로직 및 데이터 무결성을 관리합니다.
  • 보기: 사용자 인터페이스를 표시하고 정보를 렌더링합니다.
  • 컨트롤러: 사용자 입력을 처리하고, 요청을 처리하며, 모델과 뷰 간의 상호 작용을 조율합니다.

IronPDF ASP.NET MVC 프로젝트 내의 뷰에서 PDF 파일을 생성하는 과정을 간소화합니다. 이를 통해 ASP.NET MVC에서 PDF를 쉽고 간편하게 생성할 수 있습니다. 웹 페이지에서 송장, 보고서 또는 기타 문서를 생성하든 관계없이 IronPDF 전문적인 PDF 출력을 위한 도구를 제공합니다. 포괄적인 설치 안내를 위해 설치 개요 페이지를 방문하세요.

빠른 시작: ASP.NET MVC 뷰를 PDF로 손쉽게 변환하기

IronPDF 사용하여 ASP.NET MVC 뷰를 PDF 문서로 빠르게 변환하는 방법을 알아보세요. 단 몇 줄의 코드로 CSHTML 뷰를 고품질 PDF로 렌더링하여 애플리케이션 기능을 향상시킬 수 있습니다. IronPDF 프로세스를 간소화하여 모든 수준의 개발자가 쉽게 사용할 수 있도록 합니다. IronPDF ASP.NET Core 프로젝트에 통합하여 뷰에서 PDF를 손쉽게 생성하는 방법을 알아보세요.

  1. 1IronPDF를 NuGet Package Manager로 설치하십시오

    PM > Install-Package IronPdf

  2. 2다음 코드 조각을 복사하여 실행하세요.

    // Install-Package IronPdf.Extensions.Mvc.Framework
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderView(this.HttpContext, "~/Views/Home/Persons.cshtml", persons);
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    오늘 프로젝트에서 IronPDF 사용을 시작해보세요 무료 체험
    arrow pointer

어떤 확장 패키지가 필요합니까?

IronPDF 확장 패키지가 필요한 이유는 무엇입니까?

IronPdf.Extensions.Mvc.Framework 패키지는 IronPDF 메인 패키지의 확장판입니다. ASP.NET MVC에서 뷰를 PDF 문서로 렌더링하기 위해서는 IronPdf.Extensions.Mvc.Framework 및 IronPdf 패키지가 필요합니다. 이러한 분리를 통해 핵심 PDF 렌더링 기능을 유지하면서 MVC 프레임워크에 특화된 최적화된 기능을 구현할 수 있습니다.

확장 패키지를 설치하는 방법은 무엇인가요?

PM > Install-Package IronPdf.Extensions.Mvc.Framework

PDF용 C# NuGet 라이브러리

NuGet을 사용하여 설치하세요

Install-Package IronPdf.Extensions.Mvc.Framework

뷰를 PDF로 렌더링하는 방법은 무엇인가요?

어떤 프로젝트 유형이 필요합니까?

뷰를 PDF 파일로 변환하려면 ASP.NET 웹 애플리케이션(.NET Framework) MVC 프로젝트가 필요합니다. IronPDF는 다양한 MVC 버전을 지원하고 요구 사항에 따라 PDF 출력을 사용자 지정할 수 있는 광범위한 렌더링 옵션을 제공합니다.

모델 클래스를 어떻게 추가하나요?

모델은 어디에 만들어야 할까요?

  • "Models" 폴더로 이동하십시오.
  • Person라는 새 C# 클래스 파일을 만듭니다. 이 클래스는 개별 데이터를 나타내는 모델로서의 기능을 합니다. 다음 코드를 사용하세요:
namespace ViewToPdfMVCSample.Models
{
    public class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

컨트롤러를 어떻게 편집하나요?

컨트롤러에 어떤 코드를 추가해야 할까요?

"Controllers" 폴더로 이동하여 HomeController 파일을 엽니다. 다음 코드를 사용하여 Persons 액션을 추가합니다:

제공된 코드에서는 처음에 ChromePdfRenderer 클래스가 생성됩니다. RenderView 메서드를 사용하려면 HttpContext를 제공하고 "Persons.cshtml" 파일의 경로를 지정하며 필요한 데이터를 포함한 List<Person>을 제공합니다. 뷰를 렌더링할 때 RenderingOptions를 활용하여 여백을 사용자 지정하고 사용자 지정 텍스트 및 HTML 헤더와 푸터를 추가하며,페이지 번호를 적용할 수 있습니다.

유의 사항: 다음 코드를 사용하여 PDF 문서를 컴퓨터에 다운로드할 수 있습니다: File(pdf.BinaryData, "application/pdf", "viewToPdfMVC.pdf").
using IronPdf;
using System.Collections.Generic;
using System.Web.Mvc;
using ViewToPdfMVCSample.Models;

namespace ViewToPdfMVCSample.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        // GET: Person
        public ActionResult Persons()
        {
            // Create a list of Person objects
            var 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" }
            };

            if (HttpContext.Request.HttpMethod == "POST")
            {
                // Define the path to the View file
                var viewPath = "~/Views/Home/Persons.cshtml";

                // Instantiate the ChromePdfRenderer
                ChromePdfRenderer renderer = new ChromePdfRenderer();

                // Render the view to a PDF document
                PdfDocument pdf = renderer.RenderView(this.HttpContext, viewPath, persons);

                // Set headers to view the PDF in-browser
                Response.Headers.Add("Content-Disposition", "inline");

                // Return the generated PDF file
                return File(pdf.BinaryData, "application/pdf");
            }
            return View(persons);
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";
            return View();
        }
    }
}

PDF 렌더링 옵션을 사용자 지정하려면 어떻게 해야 하나요?

보다 고급 시나리오의 경우, 다양한 렌더링 옵션을 사용하여 PDF 출력을 사용자 지정할 수 있습니다. 다음은 사용자 지정 여백, 용지 크기 및 추가 설정을 사용한 예입니다.

// Advanced rendering with custom options
public ActionResult PersonsAdvanced()
{
    var persons = GetPersonsList();

    if (HttpContext.Request.HttpMethod == "POST")
    {
        var viewPath = "~/Views/Home/Persons.cshtml";
        
        // Configure the renderer with custom options
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        
        // Set custom rendering options
        renderer.RenderingOptions.MarginTop = 40;
        renderer.RenderingOptions.MarginBottom = 40;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;
        
        // Set custom paper size
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
        
        // Add header and footer
        renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
        renderer.RenderingOptions.TextHeader.CenterText = "{pdf-title}";
        renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica;
        renderer.RenderingOptions.TextHeader.FontSize = 12;
        
        renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
        renderer.RenderingOptions.TextFooter.Font = IronPdf.Font.FontTypes.Arial;
        renderer.RenderingOptions.TextFooter.FontSize = 10;
        renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}";
        
        // Enable JavaScript execution if needed
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.RenderDelay = 500; // Wait for JS to execute
        
        // Render the view to PDF
        PdfDocument pdf = renderer.RenderView(this.HttpContext, viewPath, persons);
        
        // Optional: Apply compression to reduce file size
        pdf.CompressImages(60);
        
        Response.Headers.Add("Content-Disposition", "inline");
        return File(pdf.BinaryData, "application/pdf");
    }
    
    return View("Persons", persons);
}

여백 최적화에 대한 자세한 정보는 맞춤 여백 설정 가이드를 참조하세요. 특정 용지 크기로 작업할 필요가 있는 경우 맞춤 용지 크기 문서를 확인하세요.

생성된 PDF 파일로 무엇을 할 수 있나요?

RenderView 메서드를 통해 PdfDocument 객체를 얻은 후 다양한 개선 및 조정을 할 수 있습니다. PDF를 PDFA 또는 PDFUA 형식으로 변환하거나, 생성된 PDF에 디지털 서명을 적용하거나, PDF 문서를 병합 및 분할할 수 있습니다. 라이브러리를 사용하여 페이지를 회전하고, 주석 또는 책갈피를 삽입하고, PDF 파일에 독특한 워터마크를 적용할 수 있습니다.

파일 크기 최적화를 위해 PDF 압축 기법을 고려하세요. JavaScript가 많은 콘텐츠를 다룰 때, JavaScript 렌더링 가이드는 사용자 정의 렌더 지연 처리에 대한 자세한 정보를 제공합니다. 다양한 내보내기 옵션에 대해서는 PDF 문서 저장 및 내보내기 가이드를 참조하세요.

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

뷰를 추가하는 방법은 무엇인가요?

뷰를 생성하려면 어떤 단계를 따라야 하나요?

  • 새로 추가된 Person 액션을 오른쪽 클릭하고 "Add View"를 선택하십시오.

    Persons() 액션 메서드를 마우스 오른쪽 버튼으로 클릭했을 때 'Add View...' 옵션이 보이는 Visual Studio 컨텍스트 메뉴

  • 새 스캐폴딩 항목에 대해 "MVC 5 보기"를 선택하십시오.

    MVC 5 View 템플릿이 선택된 Visual Studio의 새로운 스캐폴드 항목 추가 대화 상자

  • "List" 템플릿과 Person 모델 클래스를 선택합니다.

    Visual Studio의 Add View 대화 상자에 List 템플릿과 Person 모델 클래스를 사용한 Persons 뷰 구성

이렇게 하면 "Persons"라는 이름의 .cshtml 파일이 생성됩니다.

뷰에 인쇄 버튼을 추가하는 방법은 무엇인가요?

  • "Views" 폴더 -> "Home" 폴더 -> "Persons.cshtml" 파일로 이동합니다.

Persons 액션을 호출하는 버튼을 추가하려면 아래 코드를 사용하세요:

@using (Html.BeginForm("Persons", "Home", FormMethod.Post))
{
    <input type="submit" value="Print Person" />
}
HTML

상단 탐색 모음에 섹션을 추가하려면 어떻게 해야 하나요?

내비게이션을 어디에서 업데이트해야 하나요?

  • "Views" 폴더에서 "Shared" 폴더 -> "_Layout.cshtml" 파일로 이동하십시오. "Home" 뒤에 "Person" 탐색 항목을 배치합니다.

ActionLink 메서드의 값이 'Persons'라는 파일 이름과 정확히 일치하는지 확인하세요.

<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-dark bg-dark">
    <div class="container">
        @Html.ActionLink("Application name", "Index", "Home", new { area = "" }, new { @class = "navbar-brand" })
        <button type="button" class="navbar-toggler" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" title="Toggle navigation" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
            <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse d-sm-inline-flex justify-content-between">
            <ul class="navbar-nav flex-grow-1">
                <li>@Html.ActionLink("Home", "Index", "Home", new { area = "" }, new { @class = "nav-link" })</li>
                <li>@Html.ActionLink("Persons", "Persons", "Home", new { area = "" }, new { @class = "nav-link" })</li>
                <li>@Html.ActionLink("About", "About", "Home", new { area = "" }, new { @class = "nav-link" })</li>
                <li>@Html.ActionLink("Contact", "Contact", "Home", new { area = "" }, new { @class = "nav-link" })</li>
            </ul>
        </div>
    </div>
</nav>
HTML

프로젝트를 실행하고 테스트하는 방법은 무엇인가요?

프로젝트 실행

이 문서에서는 프로젝트를 실행하고 PDF 문서를 생성하는 방법을 보여줍니다.

Persons 액션 메서드와 PDF 생성 코드가 있는 ASP.NET MVC HomeController를 보여주는 Visual Studio

PDF 출력

전체 프로젝트는 어디에서 다운로드할 수 있나요?

샘플 프로젝트에는 무엇이 포함되어 있나요?

이 가이드의 전체 코드를 다운로드할 수 있습니다. 다운로드한 파일은 압축 파일 형태로 제공되며, Visual Studio에서 ASP.NET 웹 애플리케이션(.NET Framework) MVC 프로젝트로 열 수 있습니다. 이 샘플에는 MVC 애플리케이션에서 PDF 생성을 빠르게 시작하는 데 필요한 모든 구성, 모델 클래스, 컨트롤러 및 뷰가 포함되어 있습니다.

PDF 변환용 MVC 샘플 프로젝트 다운로드

자주 묻는 질문

ASP.NET MVC에서 CSHTML 뷰를 PDF로 변환하는 방법은 무엇인가요?

IronPDF를 사용하여 ASP.NET MVC에서 CSHTML 뷰를 PDF 문서로 변환할 수 있습니다. 이 기능은 ChromePdfRenderer.RenderView() 메서드를 활용하여 레이아웃과 스타일을 유지하면서 매우 정밀하게 뷰를 PDF로 렌더링할 수 있게 합니다.

IronPdf.Extensions.Mvc.Framework 패키지는 무엇에 사용됩니까?

IronPdf.Extensions.Mvc.Framework 패키지는 주로 ASP.NET MVC 뷰를 PDF 문서로 렌더링하기 위해 설계된 IronPDF의 확장입니다. 이 패키지는 MVC 프로젝트에 맞춰 통합을 제공하면서도 기본적인 PDF 기능을 유지합니다.

어떤 유형의 프로젝트에서 IronPDF를 사용해 뷰를 PDF로 렌더링할 수 있습니까?

IronPDF는 ASP.NET 웹 애플리케이션(.NET Framework) MVC 프로젝트를 지원하며, 이러한 프로젝트 내에서 뷰를 PDF 파일로 변환할 수 있습니다.

IronPdf.Extensions.Mvc.Framework 패키지를 어떻게 설치할 수 있습니까?

Visual Studio의 NuGet 패키지 관리자를 사용하여 다음 명령어로 IronPdf.Extensions.Mvc.Framework 패키지를 설치할 수 있습니다: Install-Package IronPdf.Extensions.Mvc.Framework.

ASP.NET MVC 뷰에서 PDF를 생성하는 주요 단계는 무엇입니까?

ASP.NET MVC 뷰에서 PDF를 생성하기 위해서는 C# 라이브러리를 다운로드하고, 모델 클래스를 추가하며, RenderView 메서드를 사용하여 컨트롤러 액션을 생성하고, MVC 5를 사용해 뷰를 스캐폴드해야 합니다.

IronPDF에서 PDF 렌더링 옵션을 어떻게 사용자 정의할 수 있습니까?

IronPDF는 사용자 정의 여백 설정, 용지 크기 설정, 헤더 및 푸터 추가, JavaScript 실행 가능 여부 등의 다양한 옵션을 통해 PDF 렌더링을 커스터마이징할 수 있습니다. 이는 ChromePdfRenderer.RenderingOptions를 구성하여 가능합니다.

IronPDF로 생성된 PDF에 디지털 서명을 적용할 수 있습니까?

네, IronPDF를 사용하면 PDF 문서에 디지털 서명을 추가하여 보안성과 검증성을 높일 수 있습니다.

IronPDF는 PDF 향상을 위해 어떤 추가 기능을 제공합니까?

IronPDF는 PDF를 PDFA 또는 PDFUA로 변환하고, PDF 문서를 병합하거나 분할하며, 페이지를 회전시키고, 주석 또는 책갈피를 추가하며, 워터마크를 적용하는 기능을 제공합니다.

IronPDF를 사용하여 PDF 크기를 최적화할 수 있는 방법은 무엇입니까?

IronPDF의 압축 기법을 사용하여 PDF의 품질을 유지하면서 파일 크기를 줄일 수 있습니다.

ASP.NET MVC에서 PDF 변환을 위한 샘플 프로젝트를 어디에서 찾을 수 있습니까?

IronPDF 웹사이트에서 완전한 샘플 프로젝트를 다운로드할 수 있으며, 이 프로젝트에는 ASP.NET MVC 애플리케이션에서 PDF 생성을 빠르게 시작하는데 필요한 모든 설정이 포함되어 있습니다.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 22,198,312버전:2026.11방금 출시