ASP.NET Core에서 C#으로 HTML을 PDF로 변환하기 - IronPDF 가이드

생성된 PDF 파일은 어떤 모습인가요?

복잡한 렌더링을 처리하는 ChromePdfRenderer 클래스는 HTML 구조, CSS 스타일, 그리고 JavaScript가 최종 PDF 출력에서 올바르게 렌더링되도록 보장합니다. 반환 값은 브라우저에서 파일 다운로드로 직접 스트림할 수 있는 PdfDocument 객체의 BinaryData 속성입니다.

동적 HTML 문자열을 어떻게 변환하나요?

데이터베이스 기반 보고서와 같은 동적 콘텐츠를 다룰 때는 HTML 문자열을 직접 변환하기 위해 RenderHtmlAsPdf를 사용하세요. 이 방법은 모든 유효한 HTML 마크업을 받아 완전히 렌더링된 PDF를 반환합니다:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = BuildDynamicHtml() ' your method to generate HTML
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("dynamic-report.pdf")

이 접근 방식은 실시간 데이터로 채워진 HTML 템플릿에서 PDF 문서를 생성할 때, 폼 제출 또는 모든 동적으로 생성된 콘텐츠에 잘 작동합니다. 렌더링 엔진은 사용자 정의 글꼴, 색상, 테이블 포맷을 포함한 모든 CSS 스타일링을 보존합니다. HTML이 상대 경로를 사용하는 외부 스타일시트나 이미지를 참조할 때, 두 번째 인수로 baseUrl를 전달하여 렌더러가 해당 자산을 올바르게 해결할 수 있도록 합니다.

디스크에서 정적 HTML 파일을 어떻게 변환하나요?

물리 파일로 저장된 HTML 템플릿의 경우, 메모리에 로드하지 않고 먼저 변환하려면 RenderHtmlFileAsPdf를 사용하세요. 이는 큰 템플릿에 효과적이며 문자열 연결을 피합니다:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html")
pdf.SaveAs("report.pdf")

이 방법은 파일에 참조된 CSS 스타일 시트, 이미지 및 기타 외부 리소스의 상대 경로를 자동으로 해결합니다. 디자인 팀이 C# 코드 베이스 외부에 별도의 HTML 템플릿 파일을 유지할 때 잘 작동합니다. CSS 인쇄 미디어 쿼리 및 사용자 지정 글꼴을 지원하므로 인쇄 환경을 위해 구축된 템플릿이 추가 구성 없이 충실하게 렌더링됩니다.

웹 페이지 URL을 PDF로 어떻게 변환하나요?

실시간 웹 페이지를 캡처하거나 URL로 접근 가능한 페이지를 PDF로 렌더링하려면 RenderUrlAsPdf를 사용하세요. 이 방법은 Chrome 엔진을 실행하고, URL로 이동한 후 페이지가 완전히 로드될 때까지 기다린 다음 렌더링된 출력을 캡처합니다:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
Dim pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")
pdf.SaveAs("webpage.pdf")

WaitFor.RenderDelay 옵션은 페이지 로드 후 캡처하기 전에 렌더러가 일시 중지하도록 지시합니다. 이는 초기 HTML 응답이 도착한 후 JavaScript를 통해 DOM을 구축하는 단일 페이지 애플리케이션에 유용합니다. EnableJavaScript = true 설정하면 전체 Chrome JavaScript 엔진이 활성화되어, 차트, 데이터 그리드, 및 기타 JavaScript 렌더링 구성 요소가 브라우저와 마찬가지로 PDF에 나타납니다.

폼 인터페이스가 어떻게 보이나요?

생성된 PDF에서는 폼 데이터가 어떻게 나타나나요?

더 고급 문서 시나리오의 경우, PDF 폼을 통합하거나 사전 채워진 필드를 가진 기존 PDF 템플릿을 편집할 수 있습니다. 라이브러리는 또한 법적 문서 및 계약에 대한 디지털 서명을 지원하여 생성된 문서에 암호학적으로 검증 가능한 서명을 추가할 수 있습니다.

사용자 데이터를 HTML 문자열에 삽입할 때 중요한 고려 사항은 데이터의 정화입니다. 항상 사용자 제공 문자열을 HTML에 삽입하기 전에 이스케이프하여 인젝션 문제를 방지해야 합니다. 각 필드에 대한 간단한 System.Web.HttpUtility.HtmlEncode(model.CustomerName) 호출은 템플릿을 렌더러에 전달하기 전에 안전하게 유지합니다.

헤더, 푸터 및 워터마크를 어떻게 구성하나요?

전문적인 PDF 문서는 종종 모든 페이지에 헤더 및 푸터와 초안 또는 기밀 문서에 대한 워터마크가 필요합니다. IronPDF는 RenderingOptions 객체의 속성과 결과 PdfDocument의 ApplyWatermark 방법을 통해 둘 다 처리합니다:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 20,
    .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>", 30, VerticalAlignment.Middle, HorizontalAlignment.Center)
pdf.SaveAs("report-with-watermark.pdf")

푸터 HTML의 {page} 및 {total-pages} 자리표시자가 렌더링 시 자동으로 대체되어 포스트 프로세싱 없이 올바른 페이지 번호를 얻을 수 있습니다. 페이지 번호, 배경 이미지 또는 전면 오버레이, 사용자 지정 텍스트 또는 이미지 스탬프도 추가할 수 있습니다.

PDF 레이아웃 제어를 위한 CSS 인쇄 미디어를 어떻게 사용합니까?

PDF 출력이 기대에 부합하는지 확인하기 위해 CSS @media print 규칙과 PdfCssMediaType.Print 설정을 사용하세요. IronPDF는 페이지 구분 제어와 사용자 지정 용지 크기를 완전히 지원합니다:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
renderer.RenderingOptions.ViewPortWidth = 1024
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

Dim html As String = "
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

인쇄 CSS를 사용하면 내비게이션 메뉴나 상호작용 버튼과 같은 불필요한 웹 요소를 숨기면서 PDF 문서의 전문적인 포맷을 유지할 수 있습니다. CssMediaType = PdfCssMediaType.Print 설정은 렌더러에게 화면 스타일이 아닌 사용자의 @media print 규칙을 적용하도록 지시하며, 일반적으로 배경 장식 제거하고 인쇄 출력용으로 서체를 조정합니다. 페이지별로 사용자 지정 여백을 구성하고 페이지 방향 및 회전을 제어하여 넓은 형식 또는 회전된 보고서를 생성할 수 있습니다.

W3C CSS 페이지 미디어 사양은 @page, page-break-before 및 widows과 같은 속성이 페이지 출력에서 어떻게 동작해야 하는지 정의합니다. IronPDF의 Chrome 엔진은 이 명세서를 밀접하게 따르므로 CSS 표준에 맞추어 작성된 스타일은 수동 조정 없이 PDF로 정확하게 변환됩니다.