Blazor Server에서 Razor를 PDF로 변환하기 PdfDocument

Curtis Chau
Curtis Chau
업데이트됨: 2026년 9월 5일

IronPDF의 RenderRazorComponentToPdf 메서드를 사용하여 Blazor Server에서 Razor 구성 요소를 PDF로 변환합니다. 최소한의 코드로 C# UI 컴포넌트를 PDF로 변환하고, 머리글, 바닥글 및 페이지 서식을 완벽하게 사용자 지정할 수 있습니다.

빠른 시작: Razor 컴포넌트를 몇 분 만에 PDF로 변환하기

IronPDF 사용하여 Blazor Server 애플리케이션의 Razor 컴포넌트를 PDF로 변환합니다. RenderRazorComponentToPdf 메서드는 코드 몇 줄로 Razor 구성 요소를 PDF로 변환합니다. 이 가이드를 따라 최소한의 설정과 유연한 사용자 지정 옵션을 통해 Razor 의 PDF 변환 기능을 프로젝트에 통합해 보세요.

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

    PM > Install-Package IronPdf

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

    // Install-Package IronPdf.Extensions.Blazor
    var pdf = new IronPdf.ChromePdfRenderer()
        .RenderRazorComponentToPdf<MyComponent>(new Dictionary<string,object> { {"persons",personsList} })
        .SaveAs("component-to-pdf.pdf");
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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

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

IronPdf.Extensions.Blazor 패키지는 메인 IronPdf 패키지를 확장합니다. 두 패키지 모두 Blazor 서버 앱에서 Razor 컴포넌트를 PDF 문서로 렌더링하는 데 필요합니다. 이 확장 프로그램은 Blazor 서버 애플리케이션과의 통합 지점을 제공하여 대대적인 코드 수정 없이 기존 Razor 컴포넌트를 PDF로 변환할 수 있도록 지원합니다.

IronPdf.Extensions.Blazor 설치는 기본 IronPdf 라이브러리를 종속성으로 자동으로 포함합니다. 확장 패키지는 Blazor의 구성 요소 모델을 이해하고 바인딩된 데이터로 구성 요소를 적절히 렌더링하는 RenderRazorComponentToPdf 같은 메서드를 추가합니다. 최적의 성능과 최신 기능을 사용하려면 두 패키지 모두 최신 버전을 사용하십시오. 업데이트 및 개선 사항에 대해서는 변경 로그를 확인하세요.

PM > Install-Package IronPdf.Extensions.Blazor

PDF용 C# NuGet 라이브러리

NuGet을 사용하여 설치하세요

Install-Package IronPdf.Extensions. Blazor

Blazor Server에서 Razor 컴포넌트를 PDF로 렌더링하는 방법은 무엇인가요?

Razor 컴포넌트를 PDF로 변환하려면 Blazor 서버 앱 프로젝트가 필요합니다. Blazor Server 애플리케이션은 서버에서 실행되고 SignalR 연결을 통해 UI 업데이트를 렌더링하므로 서버 측 처리가 필요한 PDF 생성에 적합합니다. 이 아키텍처는 PDF 렌더링이 서버에서 이루어지도록 보장하여 클라이언트 브라우저나 장치에 관계없이 일관된 결과를 제공합니다.

시작하기 전에 .NET SDK와 ASP.NET 및 웹 개발 워크로드가 포함된 Visual Studio 2019 이상이 설치되어 있는지 확인하십시오. Visual Studio의 프로젝트 템플릿 또는 dotnet new blazorserver를 사용하여 .NET CLI를 통해 새 Blazor Server 앱을 만듭니다. 자세한 설치 지침과 플랫폼별 요구 사항은 설치 개요를 참조하세요.

어떤 모델 클래스 구조를 사용해야 할까요?

표준 C# 클래스 PersonInfo를 추가하세요. 이 클래스는 개인 정보를 저장하기 위한 모델 역할을 합니다. 다음 코드를 삽입하세요:

namespace BlazorSample.Data
{
    public class PersonInfo
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Title { get; set; }
        public string Description { get; set; }
    }
}

이 모델은 Razor 컴포넌트에 전달되어 PDF에 렌더링되는 데이터 구조를 나타냅니다. IronPDF 간단한 POCO부터 복잡한 Entity Framework 모델에 이르기까지 모든 C# 객체 모델과 호환됩니다. PDF 생성 모델을 설계할 때는 최종 문서에 데이터가 어떻게 표시될지 고려하고 그에 따라 속성을 구성해야 합니다.

Razor 컴포넌트를 사용하여 PDF를 생성하는 방법은 무엇인가요?

Razor 구성 요소를 PDF로 변환하기 위해 RenderRazorComponentToPdf 메서드를 사용하세요. 이 메서드는 ChromePdfRenderer 클래스를 인스턴스화하여 액세스할 수 있습니다. 메서드는 내보내거나 추가 수정할 수 있는 PdfDocument 객체를 반환합니다.

반환된 PdfDocument는 PDF/A 또는 PDF/UA 형식으로의 변환을 포함한 추가 수정을 지원합니다. 문서를 병합하거나 분할하고 페이지를 회전하며 주석이나 책갈피를 추가할 수 있습니다. 맞춤 워터마크를 필요에 따라 적용합니다.

Razor 구성 요소 Person.razor를 추가합니다. 다음 코드를 입력하세요:

@page "/Person"
@using BlazorSample.Data;
@using IronPdf;
@using IronPdf.Extensions.Blazor;

<h3>Person</h3>

@code {
    // A parameter to receive a list of persons from the parent component.
    [Parameter]
    public IEnumerable<PersonInfo> persons { get; set; }

    // Dictionary to hold parameters that will be passed to the PDF renderer.
    public Dictionary<string, object> Parameters { get; set; } = new Dictionary<string, object>();

    protected override async Task OnInitializedAsync()
    {
        // Initialize the persons list with some sample data.
        persons = new List<PersonInfo>
        {
            new PersonInfo { Name = "Alice", Title = "Mrs.", Description = "Software Engineer" },
            new PersonInfo { Name = "Bob", Title = "Mr.", Description = "Software Engineer" },
            new PersonInfo { Name = "Charlie", Title = "Mr.", Description = "Software Engineer" }
        };
    }

    private async void PrintToPdf()
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Apply text footer to the PDF pages.
        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            LeftText = "{date} - {time}",
            DrawDividerLine = true,
            RightText = "Page {page} of {total-pages}",
            Font = IronSoftware.Drawing.FontTypes.Arial,
            FontSize = 11
        };

        Parameters.Add("persons", persons);

        // Render Razor component to PDF and save it.
        PdfDocument pdf = renderer.RenderRazorComponentToPdf<Person>(Parameters);
        File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData);
    }
}

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    @foreach (var person in persons)
    {
        <tr>
            <td>@person.Name</td>
            <td>@person.Title</td>
            <td>@person.Description</td>
        </tr>
    }
</table>

<button class="btn btn-primary" @onclick="PrintToPdf">Print to Pdf</button>
Razor

이 메서드는 모든 RenderingOptions 기능에 대한 액세스를 제공합니다. 텍스트 및 HTML 머리글과 바닥글을 추가하고 페이지 번호를 포함하며 페이지 크기와 레이아웃을 조정합니다. RenderingOptions는 맞춤 여백을 지원하고 반응형 디자인을 위한 뷰포트 설정과 동적 콘텐츠를 위한 JavaScript 실행 지연을 지원합니다.

복잡한 레이아웃이나 Bootstrap 같은 CSS 프레임워크의 경우, 반응형 CSS 렌더링 기능을 탐색하여 다양한 페이지 크기에서 PDF가 올바르게 나타나도록 합니다.

Razor 컴포넌트에 내비게이션 기능을 추가하려면 어떻게 해야 하나요?

  • "공유 폴더"로 이동하여 NavMenu.razor을 엽니다. 우리의 Razor 구성 요소를 열 섹션을 추가하세요, Person. 우리의 Person 구성 요소는 두 번째 옵션이 될 것입니다.
<div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
    <nav class="flex-column">
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="" Match="NavLinkMatch.All">
                <span class="oi oi-home" aria-hidden="true"></span> Home
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="Person">
                <span class="oi oi-list-rich" aria-hidden="true"></span> Person
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="counter">
                <span class="oi oi-plus" aria-hidden="true"></span> Counter
            </NavLink>
        </div>
        <div class="nav-item px-3">
            <NavLink class="nav-link" href="fetchdata">
                <span class="oi oi-list-rich" aria-hidden="true"></span> Fetch data
            </NavLink>
        </div>
    </nav>
</div>
Razor

이 탐색 설정은 Blazor의 라우팅 시스템과 통합되어 사용자가 애플리케이션의 기본 탐색 메뉴에서 PDF 생성 기능에 액세스할 수 있도록 합니다. NavLink 구성 요소는 활성 경로의 적절한 강조 표시를 보장합니다.

PDF 생성 과정은 어떻게 진행되나요?

프로젝트를 실행하고 PDF 문서를 생성하세요. "PDF로 인쇄" 버튼을 클릭하세요. IronPDF Razor 컴포넌트를 처리하고 HTML로 변환한 다음, Chrome 기반 렌더링 엔진을 사용하여 PDF로 렌더링합니다. 이를 통해 최신 웹 브라우저에서와 동일한 시각적 품질을 유지합니다.

`ChromePdfRenderer` 및 Razor 컴포넌트를 사용하는 PDF 생성 코드로 Blazor 앱을 디버깅하는 Visual Studio

생성된 PDF 파일은 프로젝트의 출력 디렉토리에 저장됩니다. 저장 위치를 ​​사용자 지정하거나, 브라우저에서 직접 다운로드할 수 있도록 하거나, Azure Blob Storage와 같은 클라우드 스토리지에 PDF를 저장할 수 있습니다. 실제 운영 환경에서는 PDF 생성이 실패하거나 예상 소요 시간을 초과하는 상황에 대비하여 오류 처리 및 사용자 피드백 기능을 구현해야 합니다.

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

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

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

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

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

이 가이드의 전체 코드를 압축 파일로 다운로드하세요. Visual Studio에서 Blazor 서버 앱 프로젝트로 엽니다. 이 샘플에는 Blazor 애플리케이션에서 Razor PDF로 변환하는 데 필요한 모든 종속성, 구성 및 예제 코드가 포함되어 있어 바로 시작할 수 있습니다.

Razor에서 PDF 변환을 위한 Blazor 샘플 프로젝트를 다운로드하십시오

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? 여기에서 PDF 변환 관련 튜토리얼 페이지를 확인하세요.

고급 시나리오에 대한 내용은 Blazor 응용 프로그램에서 IronPDF를 사용하는 추가 통합 패턴 및 모범 사례를 다루는 Blazor 튜토리얼을 참조하십시오.

자주 묻는 질문

Blazor Server 애플리케이션에서 IronPDF가 Razor 컴포넌트를 PDF로 변환할 때 사용되는 주된 방법은 무엇입니까?

주된 방법은 IronPDF의 RenderRazorComponentToPdf로, Razor 컴포넌트를 효율적으로 PDF 문서로 변환합니다.

IronPDF를 사용하여 Razor를 PDF로 변환하는 데 필요한 패키지를 어떻게 설치할 수 있나요?

IronPdf.Extensions.Blazor NuGet 패키지를 설치해야 하며, 이는 Blazor Server 앱에서 Razor 컴포넌트를 PDF로 렌더링하는 핵심 IronPdf 라이브러리를 자동으로 포함합니다.

Blazor Server 애플리케이션에서 Razor 컴포넌트를 PDF로 렌더링하기 위한 주요 단계는 무엇인가요?

주요 단계에는 IronPDF 라이브러리를 다운로드하고, 모델 클래스를 추가하고, Razor 컴포넌트를 생성하고 RenderRazorComponentToPdf 메서드를 사용하는 것, Blazor 애플리케이션의 메뉴에 컴포넌트를 통합하는 것, 그리고 가이드로서 샘플 프로젝트를 다운로드하는 것이 포함됩니다.

IronPDF가 Razor 컴포넌트를 PDF로 변환할 때 복잡한 레이아웃을 처리할 수 있나요?

네, IronPDF는 반응형 CSS 렌더링을 지원하여 PDF가 다양한 페이지 크기에서 올바른 비주얼을 유지하도록 하며, Bootstrap과 같은 복잡한 레이아웃 및 CSS 프레임워크를 지원합니다.

IronPDF로 반환된 `PdfDocument`에 추가로 구현할 수 있는 기능은 무엇이 있나요?

문서를 PDF/A 또는 PDF/UA 형식으로 변환하고, 병합하거나 분할하고, 페이지를 회전하고, 주석이나 책갈피를 추가하는 등의 작업이 가능합니다. 또한 맞춤형 워터마크를 적용할 수도 있습니다.

IronPDF를 사용하여 Blazor Server 앱에서 Razor 컴포넌트를 PDF로 변환하는 다운로드 가능한 예제가 있나요?

네, 모든 필수 종속성과 구성이 포함된 전체 작동 예제를 압축 파일로 다운로드할 수 있으며, Visual Studio에서 즉시 사용할 수 있습니다.

PDF 생성에 Blazor Server를 사용하는 장점은 무엇인가요?

Blazor Server는 서버에서 실행되므로, PDF 렌더링이 서버 측에서 이루어지며, 클라이언트의 브라우저나 장치에 상관없이 일관된 렌더링 결과를 제공합니다.

Blazor 앱에서 PDF 생성을 위한 Razor 컴포넌트를 통합할 때 올바른 탐색을 어떻게 보장할 수 있나요?

NavLink 컴포넌트를 사용하여 Blazor 앱의 탐색 시스템에 Razor 컴포넌트를 통합하십시오. 이를 통해 사용자는 메인 탐색 메뉴에서 PDF 생성 기능에 직접 액세스할 수 있습니다.

IronPDF가 Razor 컴포넌트에서 생성된 PDF에 헤더와 푸터를 추가할 수 있나요?

네, IronPDF는 RenderingOptions 기능을 사용하여 페이지 번호를 포함한 텍스트 및 HTML 헤더와 푸터를 추가할 수 있습니다.

Blazor Server 프로젝트에서 Razor를 PDF로 변환하기 전에 필요한 것은 무엇인가요?

.NET SDK를 설치했는지, ASP.NET 및 웹 개발 워크로드가 포함된 Visual Studio 2019 이상을 설치했는지 확인합니다. Visual Studio 템플릿이나 .NET CLI를 사용하여 새 프로젝트를 시작할 수 있습니다.

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

더 읽기

시작할 준비 되셨나요?

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