1. IronPDF
  2. 방법
  3. 렌더링 옵션

C#을 사용하여 IronPDF에서 렌더링 옵션을 사용하는 방법

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF의 렌더링 옵션은 크롬PDF렌더러 클래스를 통해 PDF 생성을 사용자 지정할 수 있으며, 여백, 머리글, 바닥글, 용지 크기, JavaScript 실행 및 CSS 미디어 유형과 같은 설정을 제어하여 HTML, CSS 및 기타 콘텐츠 소스에서 정확하게 서식이 지정된 PDF 문서를 생성할 수 있습니다.

빠른 시작: C#에서 렌더링 옵션 적용

  1. NuGet 패키지 관리자를 통해 IronPDF를 설치합니다.
  2. 크롬PDF렌더러 인스턴스를 생성합니다.
  3. RenderingOptions 속성을 통해 렌더링 옵션을 구성합니다.
  4. 콘텐츠(HTML, Markdown 등)를 PDF로 렌더링합니다.
  5. 생성된 PDF 문서를 저장합니다.

Nuget Icon지금 바로 NuGet을 사용하여 PDF 만들기를 시작하세요.

  1. NuGet 패키지 관리자를 사용하여 IronPDF를 설치하세요.

    PM > Install-Package IronPdf

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

    new IronPdf.크롬PDF렌더러 { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMedia유형 = IronPdf.Rendering.PdfCssMedia유형.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
    .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
    .SaveAs("renderingOptions.pdf");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    지금 바로 무료 체험판을 통해 프로젝트에서 IronPDF를 사용해 보세요.
    arrow pointer

PDF 생성 시 렌더링 옵션은 PDF 문서가 생성, 표시 및 인쇄되는 방식을 결정하는 설정입니다. 이러한 옵션에는 폼 요소 렌더링, JavaScript 활성화, 목차 생성, 머리글 및 바닥글 추가, 여백 조정, 용지 크기 설정 등이 포함됩니다.

IronPDF의 크롬PDF렌더러 클래스는 PDF 생성 방식을 사용자 정의할 수 있는 다양한 렌더링 옵션을 제공합니다. 여기에는 PDF 페이지의 콘텐츠 레이아웃을 제어하는 관리자인 PaperFit가 포함되어 있으며, 반응형 CSS3 레이아웃이나 연속 피드와 같은 다양한 스타일을 제공합니다. 복잡한 문서를 다룰 때는 렌더링 옵션을 적용한 후 PDF를 병합하거나 분할해야 할 수도 있습니다.

### 최소 워크플로우(5단계)
  1. 렌더링 옵션을 사용하려면 C# 라이브러리를 다운로드하세요.
  2. PDF 변환을 위해 HTML 자산 또는 파일을 준비하세요.
  3. **`크롬PDF렌더러`** 클래스의 인스턴스를 생성합니다.
  4. **`RenderingOptions`** 속성에 접근하여 설정을 구성하십시오.
  5. 원하는 형식으로 PDF를 렌더링합니다.


IronPDF에서 렌더링 옵션을 사용하는 방법은 무엇인가요?

많은 렌더링 옵션 속성은 HTML을 PDF로 변환하기 위해 설계되었지만, 다른 유형의 PDF 변환에도 적용됩니다. 마크다운을 PDF로 변환하고 렌더링 옵션을 사용하여 출력 형식을 구성해 보겠습니다. 특히 HTML 변환의 경우, HTML 파일을 PDF로 변환하거나 HTML 문자열을 PDF로 변환하는 방법에 대해 알아보세요.

렌더링 옵션을 구성해야 하는 이유는 무엇입니까?

렌더링 옵션을 구성하면 사용자 지정 용지 크기, 특정 여백, 머리글 및 바닥글, 동적 콘텐츠용 JavaScript 활성화 등 정확한 사양에 따라 PDF가 생성됩니다. 이 기능은 전문 문서나 보고서를 위한 새 PDF 파일을 만들 때 매우 중요합니다.

여러 렌더링 옵션을 적용하면 어떻게 되나요?

여러 렌더링 옵션이 함께 작동하여 최종 PDF 출력물을 생성합니다. 각 옵션은 특정 렌더링 측면을 수정하며, IronPDF는 변환 과정에서 이러한 옵션을 순차적으로 적용합니다. 예를 들어 여백과 헤더를 모두 설정할 때, 헤더 콘텐츠는 UseMarginsOnHeaderAndFooter 속성을 사용하여 재정의하지 않는 한 여백 설정을 따릅니다.

:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;

// Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
// to render HTML/CSS as a PDF document.
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
// Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    // HTML fragment to add a header at the top of every page in the PDF.
    HtmlFragment = "<h1>Header Content</h1>"
};

// Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);

// Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0;

// Define a Markdown string that will be rendered as a PDF.
// Markdown text allows basic formatting like bold and italic styles.
string md = "This is some **bold** and *italic* text.";

// Render the Markdown string to a PDF document.
// The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf");
$vbLabelText   $csharpLabel

고급 렌더링 옵션 예시

이 종합적인 예시는 전문적인 문서 생성을 위해 여러 렌더링 옵션을 결합하는 방법을 보여줍니다. 이 방법은 머리글과 바닥글을 추가 하거나 사용자 지정 용지 크기 로 작업해야 할 때 유용합니다.

using IronPdf;
using IronPdf.Rendering;

// Create renderer with advanced options
var renderer = new 크롬PDF렌더러();

// Configure paper and layout settings
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set margins for professional layout
renderer.RenderingOptions.MarginTop = 40;    // mm
renderer.RenderingOptions.MarginBottom = 40; // mm
renderer.RenderingOptions.MarginLeft = 20;   // mm
renderer.RenderingOptions.MarginRight = 20;  // mm

// Enable JavaScript for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute

// Add professional header with page numbers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    Height = 25,
    HtmlFragment = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");
using IronPdf;
using IronPdf.Rendering;

// Create renderer with advanced options
var renderer = new 크롬PDF렌더러();

// Configure paper and layout settings
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set margins for professional layout
renderer.RenderingOptions.MarginTop = 40;    // mm
renderer.RenderingOptions.MarginBottom = 40; // mm
renderer.RenderingOptions.MarginLeft = 20;   // mm
renderer.RenderingOptions.MarginRight = 20;  // mm

// Enable JavaScript for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute

// Add professional header with page numbers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    Height = 25,
    HtmlFragment = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");
$vbLabelText   $csharpLabel

사용 가능한 모든 렌더링 옵션은 무엇입니까?

고급 옵션에서는 여백, 용지 방향, 용지 크기 등과 같은 PDF 렌더링 설정을 정의합니다. 이러한 옵션을 이해하면 사용자 지정 여백을 설정하거나 다양한 뷰포트 설정 및 확대/축소 수준으로 작업해야 할 때 도움이 됩니다.

어떤 렌더링 옵션이 가장 일반적으로 사용되나요?

가장 일반적으로 사용되는 렌더링 옵션에는 여백 설정, 용지 크기 구성, 머리글/바닥글 설정 및 JavaScript 활성화가 포함됩니다. 이러한 옵션은 대부분의 PDF 사용자 지정 요구 사항을 충족합니다. 웹 기반 콘텐츠의 경우, JavaScript 렌더링 옵션을 통해 동적 요소가 올바르게 렌더링되도록 할 수 있습니다.

어떻게 하면 적절한 렌더링 옵션을 선택할 수 있을까요?

요구 사항에 따라 렌더링 옵션을 선택하십시오. 인쇄 레이아웃에 여백 설정을 사용하고, 동적 웹 콘텐츠를 위해 JavaScript를 활성화하고, 전문적인 문서를 위해 머리글/바닥글을 구성하고, 특정 출력 형식에 맞게 용지 크기를 조정할 수 있습니다. 웹 콘텐츠를 다룰 때는 최적의 렌더링을 위해 CSS 미디어 유형을 고려하세요.

고급 렌더링 옵션은 언제 사용해야 할까요?

사용자 지정 CSS 삽입, LaTeX 수학적 렌더링, 회색조 출력과 같은 특수 기능을 사용하거나 특정 JavaScript 실행 타이밍이 필요한 복잡한 웹 애플리케이션을 작업할 때 고급 렌더링 옵션을 사용하십시오. WaitFor 클래스는 복잡한 시나리오에서 렌더링 지연 시간을 정밀하게 제어할 수 있도록 해줍니다.

형태 요소 작업하기

HTML에 폼 요소가 포함되어 있으면 IronPDF는 이를 자동으로 대화형 PDF 폼으로 변환합니다.

using IronPdf;

var renderer = new 크롬PDF렌더러();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <form>
        <label>Name: <input type='text' name='name' /></label><br>
        <label>Email: <input type='email' name='email' /></label><br>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");
using IronPdf;

var renderer = new 크롬PDF렌더러();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <form>
        <label>Name: <input type='text' name='name' /></label><br>
        <label>Email: <input type='email' name='email' /></label><br>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");
$vbLabelText   $csharpLabel

아래 표는 이용 가능한 다양한 옵션을 보여줍니다.

수업 크롬PDF렌더러
설명 PDF 인쇄 옵션(용지 크기, DPI, 머리글 및 바닥글 등)을 정의하는 데 사용됩니다.
속성/함수 유형 설명
`CustomCookies` `Dictionar` HTML 렌더링을 위한 사용자 지정 쿠키입니다. 쿠키는 렌더링 간에 유지되지 않으므로 매번 설정해야 합니다.
`PaperFit` `VirtualPaperLayoutManager` A manager for setting up virtual paper layouts, controlling how content will be laid out on PDF "paper" pages. Includes options for Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
`UseMarginsOnHeaderAndFooter` `UseMargins` 머리글과 바닥글을 렌더링할 때 메인 문서의 여백 값을 사용합니다.
`CreatePdfFormsFromHtml` `bool` 모든 HTML 폼 요소를 편집 가능한 PDF 폼으로 변환합니다. 기본값은 true입니다.
`CssMedia유형` `PdfCssMedia유형` Media="screen" CSS 스타일 및 스타일시트를 활성화합니다. 기본값은 PdfCssMedia유형.Screen입니다.
`CustomCssUrl` `string` HTML을 렌더링하기 전에 사용자 지정 CSS 스타일시트를 적용할 수 있습니다. 로컬 파일 경로 또는 원격 URL을 사용할 수 있습니다. HTML을 PDF로 렌더링할 때만 적용됩니다.
`EnableJavaScript` `bool` 페이지 렌더링 전에 JavaScript와 JSON을 실행할 수 있도록 합니다. Ajax/Angular 애플리케이션에서 출력할 때 유용합니다. 기본값은 false입니다.
`EnableMathematicalLaTex` `bool` 수학 LaTeX 요소의 렌더링을 활성화합니다.
`Javascript` `string` 모든 HTML이 로드된 후 PDF 렌더링 전에 실행될 사용자 지정 JavaScript 문자열입니다.
`JavascriptMessageListener` `StringDelegate` 브라우저 JavaScript 콘솔 메시지가 표시될 때마다 호출될 메서드 콜백입니다.
`FirstPageNumber` `int` PDF 머리글과 바닥글에 사용할 첫 페이지 번호입니다. 기본값은 1입니다.
`TableOfContents` `TableOfContents유형s` HTML 문서에서 ID가 "ironpdf-toc"인 요소가 있는 위치에 목차를 생성합니다.
`GrayScale` `bool` 흑백 PDF 파일을 출력합니다. 기본값은 false입니다.
`TextHeader` `ITextHeaderFooter` 모든 PDF 페이지의 바닥글 내용을 텍스트로 설정하며, '메일 병합'을 지원하고 URL을 자동으로 하이퍼링크로 변환합니다.
`TextFooter`
`HtmlHeader` `HtmlHeaderFooter` 모든 PDF 페이지의 헤더 내용을 HTML로 설정합니다. '메일 병합' 기능을 지원합니다.
`HtmlFooter`
`InputEncoding` `Encoding` 입력 문자의 인코딩을 문자열로 지정합니다. 기본값은 Encoding.UTF8입니다.
`MarginTop` `double` PDF 상단 "용지" 여백(밀리미터). 테두리 없는 인쇄 및 상업용 인쇄 용도의 경우 0으로 설정하십시오. 기본값은 25입니다.
`MarginRight` `double` PDF 용지 오른쪽 여백(밀리미터)입니다. 테두리 없이 인쇄하거나 상업용 인쇄를 할 경우 0으로 설정하십시오. 기본값은 25입니다.
`MarginBottom` `double` PDF 하단 "용지" 여백(밀리미터). 테두리 없는 인쇄 및 상업용 인쇄 용도의 경우 0으로 설정하십시오. 기본값은 25입니다.
`MarginLeft` `double` PDF 용지 왼쪽 여백(밀리미터). 테두리 없이 인쇄하거나 상업용 인쇄에 사용할 경우 0으로 설정하십시오. 기본값은 25입니다.
`PaperOrientation` `PdfPaperOrientation` PDF 용지 방향(세로 또는 가로)을 지정합니다. 기본값은 세로입니다.
`PaperSize` `PdfPaperSize` 용지 크기를 설정합니다.
`SetCustomPaperSizeinCentimeters` `double` 용지 크기를 센티미터 단위로 설정합니다.
`SetCustomPaperSizeInInches` 용지 크기를 인치 단위로 설정합니다.
`SetCustomPaperSizeinMilimeters` 용지 크기를 밀리미터 단위로 설정합니다.
`SetCustomPaperSizeinPixelsOrPoints` 화면 픽셀 또는 프린터 포인트 단위로 용지 크기를 설정합니다.
`PrintHtmlBackgrounds` `Boolean` HTML에서 배경색과 이미지를 출력할지 여부를 나타냅니다. 기본값은 true입니다.
`RequestContext` `RequestContexts` 이 렌더링에 대한 컨텍스트를 요청하고 쿠키와 같은 특정 리소스의 격리 여부를 결정합니다.
`Timeout` `Integer` 렌더링 시간 제한(초). 기본값은 60입니다.
`Title` `String` PDF 문서 이름 및 제목 메타데이터는 IronPdf MVC 및 Razor 확장 프로그램에서 메일 병합 및 자동 파일 이름 지정에 유용합니다.
`ForcePaperSize` `Boolean` HTML에서 PDF로 변환한 후 페이지 크기를 조정하여 IronPdf.ChromePdfRenderOptions.PaperSize에 지정된 페이지 크기와 정확히 일치하도록 합니다. HTML을 PDF로 렌더링할 때 발생하는 페이지 크기의 작은 오류를 수정하는 데 도움이 됩니다.
`WaitFor` `WaitFor` 사용자가 렌더링 전에 특정 이벤트를 기다리도록 하는 대기 메커니즘의 설정을 저장하는 래퍼 객체입니다. 기본적으로 아무것도 기다리지 않습니다.

더 많은 기능을 살펴볼 준비가 되셨나요? PDF 변환 방법 튜토리얼 페이지를 방문하세요.

자주 묻는 질문

PDF 생성 시 렌더링 옵션에는 어떤 것들이 있나요?

IronPDF의 렌더링 옵션은 ChromePdfRenderer 클래스를 통해 PDF 문서가 생성, 표시 및 인쇄되는 방식을 제어하는 설정입니다. 여기에는 여백, 머리글, 바닥글, 용지 크기, JavaScript 실행, CSS 미디어 유형, 폼 요소 및 목차에 대한 구성이 포함되어 HTML, CSS 및 기타 콘텐츠 소스에서 PDF 출력을 세밀하게 사용자 지정할 수 있습니다.

PDF에 렌더링 옵션을 적용하는 방법은 무엇인가요?

IronPDF에서 렌더링 옵션을 적용하려면 다음 단계를 따르세요. 1) NuGet을 통해 IronPDF를 설치합니다. 2) ChromePdfRenderer 인스턴스를 생성합니다. 3) RenderingOptions 속성을 통해 설정을 구성합니다. 4) 콘텐츠(HTML, Markdown 등)를 PDF로 렌더링합니다. 5) 생성된 PDF 파일을 저장합니다. 여백, CSS 미디어 유형, 헤더, 시간 초과 값 등 여러 옵션을 한 줄에 설정할 수 있습니다.

HTML이 아닌 콘텐츠에도 렌더링 옵션을 사용할 수 있나요?

네, 많은 렌더링 옵션 속성이 HTML을 PDF로 변환하는 데 최적화되어 있지만, IronPDF의 다른 PDF 변환 유형에도 적용됩니다. 마크다운을 PDF 또는 기타 지원되는 형식으로 변환할 때 렌더링 옵션을 적용할 수 있으므로 원본 콘텐츠 유형에 관계없이 최종 PDF 출력물을 동일한 수준으로 제어할 수 있습니다.

PaperFit이란 무엇이며 어떻게 작동합니까?

PaperFit은 IronPDF의 ChromePdfRenderer 클래스 내에 있는 관리자로서 PDF 페이지의 콘텐츠 레이아웃을 제어합니다. 반응형 CSS3 레이아웃이나 연속 피드 옵션 등 다양한 렌더링 스타일을 제공하여 사용자의 특정 요구 사항에 따라 콘텐츠가 PDF 페이지에 적절하게 표시되도록 도와줍니다.

PDF 파일의 렌더링 옵션을 설정해야 하는 이유는 무엇인가요?

IronPDF에서 렌더링 옵션을 구성하면 전문적인 문서 작성에 필요한 정확한 사양으로 PDF를 생성할 수 있습니다. 여기에는 사용자 지정 용지 크기, 특정 여백, 머리글 및 바닥글, 동적 콘텐츠 생성을 위한 JavaScript 활성화 등이 포함됩니다. 이러한 수준의 제어는 보고서, 송장 또는 정확한 서식이 필요한 모든 문서를 작성할 때 매우 중요합니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

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

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

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다