RenderingOptions로 CSS @page 규칙 재정의

업데이트됨:6월 9, 2026

Translated

View the article in English

HTML 문서가 CSS @page 규칙을 포함하고 있을 때, 그 값들(페이지 크기, 방향, 여백)이 RenderingOptions에 설정된 해당 속성들보다 우선시됩니다. HTML이 충돌하는 @page 값을 정의하고 있을 때 렌더러에 MarginTop, PaperOrientation, PaperSize 또는 유사한 속성을 설정하는 것은 효과가 없습니다.

IronPDF는 표준 CSS 계단식 규칙을 따르는 Chrome 엔진을 통해 렌더링합니다. @page 규칙은 브라우저가 렌더링 중 평가하는 문서 수준의 CSS 선언으로, 프로그래매틱한 렌더링 힌트를 무시합니다.

해결책

옵션 1: HTML에서 @page 규칙 제거

@page 블록을 주석 처리하거나 삭제하십시오:

<style>
/*
@page {
    size: A3;
    margin-top: 2in;
    margin-bottom: 2in;
    margin-left: 2in;
    margin-right: 2in;
}
*/
</style>

<style>
/*
@page {
    size: A3;
    margin-top: 2in;
    margin-bottom: 2in;
    margin-left: 2in;
    margin-right: 2in;
}
*/
</style>

HTML

규칙이 없을 때 RenderingOptions 속성은 완전히 효과를 발휘합니다.

옵션 2: 프로그래밍 방식으로 @page 규칙 무력화

HTML 템플릿을 수정할 수 없는 경우 렌더링 전에 코드에서 규칙을 무력화하십시오:

string sanitizedHtml = html.Replace("@page", "/* @page */");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 10;
PdfDocument pdf = renderer.RenderHtmlAsPdf(sanitizedHtml);
pdf.SaveAs("output.pdf");

string sanitizedHtml = html.Replace("@page", "/* @page */");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 10;
PdfDocument pdf = renderer.RenderHtmlAsPdf(sanitizedHtml);
pdf.SaveAs("output.pdf");

Imports IronPdf

Dim sanitizedHtml As String = html.Replace("@page", "/* @page */")

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 10
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(sanitizedHtml)
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시