C#에서 Razor 뷰를 헤드리스로 PDF로 변환하는 방법

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

Razor View를 PDF로 변환하기 위해 C#에서 Razor.Templating.Core을 사용하여 cshtml 파일을 HTML로 변환한 다음, IronPDF의 RenderHtmlAsPdf 메소드를 사용하여 GUI나 브라우저 창 없이 PDF 문서를 생성합니다.

헤드리스 렌더링은 그래픽 사용자 인터페이스 없이 웹 콘텐츠를 처리합니다. 비록 IronPdf.Extensions.Razor가 유용하지만, 헤드리스 렌더링 기능이 부족합니다. 이 가이드는 그러한 공백을 메웁니다.

우리는 Razor.Templating.Core를 사용하여 cshtml를 HTML로 변환한 다음 IronPDF를 사용하여 PDF를 생성할 것입니다.

빠른 시작: Razor 뷰를 몇 초 만에 PDF로 변환

IronPDF의 헤드리스 변환 기능을 사용하여 Razor 뷰를 PDF로 변환하세요. ChromePdfRenderer의 RenderHtmlAsPdf 메소드를 사용하여 Razor View에서 HTML을 PDF로 렌더링하세요. 이 접근 방식은 ASP.NET Core 환경에서 작동합니다.

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

    PM > Install-Package IronPdf

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

    var html = await RazorTemplateEngine.RenderAsync("Views/Template.cshtml", model); 
    new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf(html).SaveAs("output.pdf");
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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

ASP.NET Core 웹 앱에서 Razor View를 HTML로 변환하기 위해 Razor.Templating.Core을 설치하세요.

# Install the Razor.Templating.Core package using NuGet Package Manager
Install-Package Razor.Templating.Core
SHELL

Razor 사용하여 ASP.NET Core 프로젝트를 PDF로 변환하려면 어떻게 설정해야 하나요?

뷰를 PDF로 변환하려면 ASP.NET Core 웹 앱(모델-뷰-컨트롤러) 프로젝트가 필요합니다. 설정 과정에는 Visual Studio에서 프로젝트를 생성하고, NuGet 패키지를 설치하고, 프로젝트 구조를 구성하는 작업이 포함됩니다. 유사한 기술을 위해 MVC Core에서 CSHTML을 PDF로 변환하기 또는 Razor Pages를 사용하여 CSHTML을 PDF로 변환하기를 참조하세요.

IronPdf.Extensions.Razor 대신 Razor.Templating.Core가 필요한 이유는 무엇인가요?

Razor.Templating.Core는 진정한 헤드리스 렌더링을 제공합니다 - 웹 컨텍스트나 브라우저 창 없이 Razor View를 HTML로 변환합니다. 이는 백그라운드 서비스, 콘솔 애플리케이션 또는 사용자 인터페이스가 없는 환경에 적합합니다. IronPdf.Extensions.Razor는 동작하기 위해 웹 컨텍스트가 필요합니다.

헤드리스 PDF 생성에 가장 적합한 프로젝트 유형은 무엇인가요?

ASP.NET Core 웹 앱(모델-뷰-컨트롤러) 프로젝트는 유연한 배포 옵션과 함께 필요한 Razor 뷰 인프라를 제공합니다. 이 접근 방식을 백그라운드 서비스, Azure Functions 또는 콘솔 애플리케이션에서 사용하세요. 클라우드 기반 생성을 위해 IronPDF를 Azure에 배포하기를 참조하세요.

필요한 NuGet 패키지를 어떻게 설치하나요?

NuGet 패키지 관리자를 사용하여 패키지를 설치하세요. 당신은 IronPdf와 Razor.Templating.Core가 필요합니다.

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />
SHELL

PDF 생성을 위한 Razor 뷰를 만들고 구성하는 방법은 무엇인가요?

  • "홈" 폴더를 마우스 오른쪽 버튼으로 클릭합니다. "추가"를 선택한 다음 "뷰 추가"를 선택하세요.
  • "Data.cshtml"이라는 이름의 빈 Razor 뷰를 생성합니다.

Visual Studio 솔루션 탐색기 컨텍스트 메뉴에서 새 MVC 뷰 생성을 위한 추가 > 보기 옵션 보여주는 화면

Razor 뷰에 어떤 HTML 콘텐츠를 추가해야 할까요?

PDF로 렌더링할 HTML 코드를 추가하세요:

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>
HTML

복잡한 레이아웃의 경우 완벽한 PDF 렌더링을 보장하기 위해 CSS 및 인쇄 스타일을 사용하세요. IronPDF 정교한 문서 레이아웃을 위한 최신 CSS3 기능을 지원합니다.

PDF 데이터 표시에 표를 사용하는 이유는 무엇일까요?

표는 구조화되고 정리된 정보를 제공하여 인쇄물에 적용하기에 적합합니다. 이 파일들은 플랫폼 전반에 걸쳐 일관된 형식을 유지하며 PDF 형식으로 읽을 수 있습니다. IronPDF의 렌더링 엔진은 테두리, 간격 및 정렬을 유지하여 표 레이아웃을 잘 처리합니다. 맞춤 마진을 탐색하여 레이아웃을 최적화하기 위한 고급 포맷팅을 수행하세요.

PDF 출력 시 일반적인 스타일링 고려 사항은 무엇입니까?

PDF 출력 시에는 인쇄 전용 CSS 미디어 쿼리, 상대 단위 대신 고정 픽셀 값, 그리고 내장 글꼴을 사용하여 일관된 렌더링을 구현하십시오. IronPDF는 브랜드 일관성을 위해 웹 글꼴 및 아이콘 글꼴을 지원합니다. 다중 페이지 문서와 적절한 마진을 위한 전문가의 외관을 위해 페이지 나누기를 고려하세요.

헤드리스 PDF 렌더링을 위한 Program.cs을 어떻게 구성하나요?

Program.cs에서 이 코드를 추가하세요. Razor View를 HTML로 변환하기 위해 Razor.Templating.Core에서 RenderAsync를 사용한 다음 ChromePdfRenderer을 인스턴스화하고 RenderHtmlAsPdf에 HTML을 전달합니다. 맞춤 텍스트, 헤더, 푸터, 여백, 페이지 번호를 위해 RenderingOptions을 사용하세요.

app.MapGet("/PrintPdf", async () =>
{
    // Set your IronPDF license key
    IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
    
    // Enable detailed logging for troubleshooting
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

    // Render the Razor view to an HTML string
    string html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");

    // Create a new instance of ChromePdfRenderer 
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    
    // Configure rendering options for professional output
    renderer.RenderingOptions.PaperSize = IronPdf.PdfPaperSize.A4;
    renderer.RenderingOptions.MarginTop = 25;
    renderer.RenderingOptions.MarginBottom = 25;
    renderer.RenderingOptions.MarginLeft = 20;
    renderer.RenderingOptions.MarginRight = 20;
   
    // Render the HTML string as a PDF document
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");

    // Return the PDF file as a response
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
});

PDF에 적용할 수 있는 렌더링 옵션은 무엇인가요?

IronPDF 다양한 렌더링 옵션을 제공합니다. 헤더와 푸터를 추가하고, 맞춤 용지 크기를 설정하며, 페이지 방향을 제어하고, 워터마크를 추가하세요. ChromePdfRenderer은 PDF 생성을 사용자 정의하기 위한 50개 이상의 속성을 제공합니다.

PDF 생성 중 발생하는 오류는 어떻게 처리해야 하나요?

신뢰성 있는 PDF 생성을 위한 오류 처리를 구현하세요:

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

상세 로깅은 언제 활성화해야 할까요?

개발 및 문제 해결 중에 상세 로깅을 활성화하십시오. IronPDF의 로깅은 렌더링에 대한 통찰력을 제공하여 HTML 구문 분석, 자산 로딩 또는 구성 문제를 식별하는 데 도움이 됩니다. 프로덕션에서는 애플리케이션의 로깅 인프라에 통합할 수 있도록 맞춤 로깅을 사용하세요.

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

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

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

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

에셋 링크 경로를 수정해야 하는 이유는 무엇인가요?

Views > Shared > _Layout.cshtml로 이동하세요. 링크 태그에서 "~/"를 "./"로 변경하세요. 왜냐하면 "~/"는 IronPDF와 잘 작동하지 않기 때문입니다.

경로와 관련된 다른 어떤 문제들을 주의해야 할까요?

물결표(~) 경로 문제 외에도 이미지 소스가 절대 경로 또는 적절한 상대 경로를 사용하는지 확인하십시오. 외부 리소스의 경우 기본 URL을 사용하여 자산이 올바르게 로드되도록 하세요. Azure Blob Storage 이미지의 경우 Azure Blob Storage에서 이미지 임베딩을 참조하세요.

정적 자산은 PDF 생성에 어떤 영향을 미칠까요?

정적 자산(CSS, JavaScript, 이미지)은 PDF 생성 성능 및 품질에 영향을 미칩니다. 렌더링 중에 자산에 접근할 수 있도록 하고, 최적화된 이미지를 사용하며, 렌더링 속도를 높이기 위해 중요한 CSS를 인라인으로 포함하는 것을 고려하십시오. JavaScript-무거운 콘텐츠를 위한 렌더링 지연 및 시간 초과에 대해 알아보세요.

헤드리스 PDF 생성 기능을 어떻게 테스트하나요?

프로젝트를 실행하여 PDF 문서를 생성하세요.

Program.cs가 열려 있고 성공적인 디버그 출력이 있는 실행 중인 ASP.NET Core MVC 앱을 보여주는 Visual Studio

PDF 출력

최종 PDF 파일은 어떤 모양이어야 할까요?

당신의 PDF는 모든 Razor View 포맷팅 - 테이블 구조, 글꼴, 색상 및 레이아웃을 유지해야 합니다. 크기는 적절해야 하고, 여백은 깔끔해야 하며, 전문적인 느낌을 주어야 합니다. 출력 품질을 확인하기 위해 IronPDF의 래스터화 기능을 사용하여 페이지를 이미지로 미리보세요.

PDF 렌더링 시 발생하는 일반적인 문제를 어떻게 해결할 수 있나요?

흔히 발생하는 문제로는 스타일 누락, 레이아웃 오류 또는 불완전한 콘텐츠 등이 있습니다. 상세 로깅을 활성화하고, 자산 경로를 확인하고, HTML 유효성 검사가 제대로 작동하는지 확인하십시오. 복잡한 레이아웃의 경우 변환 전에 HTML을 미리보기 위해 Chrome 디버깅 도구를 사용하세요. 특정 렌더링 문제에 대해서는 WaitFor 지연을 사용하여 콘텐츠가 로드되기 전에 렌더링 되지 않도록 하세요.

완벽하게 작동하는 예제 파일을 어디에서 다운로드할 수 있나요?

전체 코드를 압축된 Visual Studio ASP.NET Core 웹 앱(모델-뷰-컨트롤러) 프로젝트 파일로 다운로드하세요.

여기를 클릭하여 프로젝트를 다운로드하세요.

샘플 프로젝트를 실행하기 위한 필수 조건은 무엇입니까?

.NET 8.0 SDK 이상(LTS)이 포함된 Visual Studio 2019 이상이 필요합니다. 프로젝트는 NuGet 패키지 복원을 위해 인터넷 연결이 필요합니다. 실행하기 전에 Program.cs에서 IronPDF 라이센스 키를 업데이트하세요. 배포를 위해 추가 요구사항을 확인하려면 Windows 설치 가이드를 검토하세요.

내 사용 사례에 맞게 샘플을 어떻게 사용자 지정할 수 있나요?

이 샘플은 귀하의 특정 요구 사항을 충족하는 데 필요한 기초 자료를 제공합니다. 동적 데이터 모델을 추가하거나, 자주 생성되는 PDF 파일에 대한 캐싱을 구현하거나, 기존 인증 시스템과 통합할 수 있습니다. 고급 시나리오의 경우 성능 개선을 위한 비동기 PDF 생성을 탐색하거나 파일 크기를 줄이기 위한 PDF 압축을 구현하세요. 디지털 서명을 추가하여 문서의 신뢰성을 확보하거나 민감한 문서를 위한 비밀번호 보호를 추가하세요.

자주 묻는 질문

IronPDF의 헤드리스 변환 방법을 사용하는 주요 목적은 무엇인가요?

IronPDF의 헤드리스 변환 방법은 GUI 또는 브라우저 창을 필요로 하지 않고 Razor Views를 PDF 문서로 변환하도록 설계되어, 그래픽 사용자 인터페이스를 지원하지 않는 배경 서비스 및 환경에 적합합니다.

왜 Razor.Templating.Core가 헤드리스 렌더링을 위해 IronPdf.Extensions.Razor보다 선호되나요?

Razor.Templating.Core는 웹 컨텍스트 또는 브라우저 없이 Razor Views를 HTML로 변환하여 진정한 헤드리스 렌더링을 제공하며, 이는 웹 컨텍스트가 필요한 IronPdf.Extensions.Razor와 다르게 UI가 없는 환경에 더욱 적합합니다.

IronPDF를 사용하여 HTML을 PDF로 어떻게 변환하나요?

IronPDF와 함께 ChromePdfRenderer 클래스의 RenderHtmlAsPdf 메서드를 사용하여 HTML을 PDF로 변환하는데, 이는 ASP.NET Core 애플리케이션에 간단하게 통합할 수 있습니다.

ASP.NET Core에서 Razor를 PDF로 변환하기 위해 필수적인 NuGet 패키지는 무엇인가요?

ASP.NET Core에서 Razor를 PDF로 변환하기 위해서는 NuGet 패키지 관리자를 사용하여 IronPdf 및 Razor.Templating.Core 패키지를 설치해야 합니다.

IronPDF로 PDF 생성 시 오류 처리는 어떻게 구현할 수 있나요?

오류 처리는 PDF 생성 코드 내에서 try-catch 블록을 사용하여 예외를 포착하고 오류를 기록함으로써 신뢰할 수 있고 안전한 PDF 생성을 보장하는 방식으로 구현할 수 있습니다.

IronPDF는 PDF 렌더링에 어떤 커스터마이즈를 지원하나요?

IronPDF는 헤더, 푸터, 맞춤형 용지 크기, 페이지 방향, 워터마크 및 전문 문서 생성을 위한 50가지 이상의 속성을 포함한 다양한 커스터마이즈를 지원합니다.

PDF 렌더링을 위한 HTML 콘텐츠 스타일링에 대한 주요 고려사항은 무엇인가요?

PDF를 위한 HTML 스타일링 시 인쇄 전용 CSS, 고정 픽셀 값, 내장 폰트를 사용하여 일관된 렌더링을 보장하고, 적절한 여백 및 페이지 분할을 정의하여 전문적인 출력을 중점적으로 고려해야 합니다.

정적 자산이 IronPDF의 PDF 생성에 어떻게 영향을 미칠 수 있나요?

CSS, JavaScript, 이미지와 같은 정적 자산은 PDF 렌더링의 품질과 속도에 영향을 미칩니다. 자산이 접근 가능하고 최적화되어 있는지 확인하는 것이 일관된 성능과 시각적 정확성을 위해 중요합니다.

PDF 렌더링 시 자산 경로가 문제를 일으키면 어떻게 해야 하나요?

자산 경로가 올바르게 포맷되었는지 확인하고 '~/'와 같은 문제가 되는 경로를 피하며, 절대 경로나 적절한 상대 경로 참조를 사용하여 렌더링 과정 중에 모든 리소스가 로드되도록 보장해야 합니다.

샘플 Razor에서 PDF 변환 프로젝트를 실행하기 위한 전제 조건은 무엇인가요?

샘플 프로젝트를 실행하려면 .NET 8.0 SDK가 포함된 Visual Studio 2019 이상과 NuGet 패키지 복원을 위한 활성화된 인터넷 연결이 필요합니다. 또한 코드에서 IronPDF 라이선스 키를 업데이트해야 합니다.

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

더 읽기

시작할 준비 되셨나요?

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