IRONSOFTWAREHOME

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

Curtis Chau
Curtis Chau
Updated: 2026년 6월 4일

IronPDF의 렌더링 옵션은 ChromePdfRenderer 클래스를 통해 PDF 생성과 관련된 설정을 사용자 지정하여, HTML, CSS 및 기타 콘텐츠 소스에서 정확히 형식화된 PDF 문서를 생성할 수 있도록 제어합니다: 마진, 헤더, 풋터, 용지 크기, JavaScript 실행 및 CSS 미디어 유형.

빠른 시작: C#에서 렌더링 옵션 적용
  1. NuGet 패키지 관리자를 통해 IronPDF 설치
  2. ChromePdfRenderer 인스턴스를 생성합니다.
  3. RenderingOptions 속성을 통해 렌더링 옵션을 구성합니다.
  4. 콘텐츠(HTML, Markdown 등)를 PDF로 렌더링하세요
  5. 생성된 PDF 문서를 저장합니다.
  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
    C#
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기
    arrow pointer

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

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


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

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

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

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

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

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

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");

고급 렌더링 옵션 예시

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

using IronPdf;
using IronPdf.Rendering;

// Create renderer with advanced options
var renderer = new ChromePdfRenderer();

// 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.WaitFor.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");
C#

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

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

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

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

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

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

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

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

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

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

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

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

형태 요소 작업하기

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

using IronPdf;

var renderer = new ChromePdfRenderer();

// 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");

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

수업ChromePdfRenderer
설명PDF 인쇄 옵션(용지 크기, DPI, 머리글 및 바닥글 등)을 정의하는 데 사용됩니다.
속성/함수유형설명
CustomCookiesDictionary<string, string>HTML 렌더링을 위한 사용자 지정 쿠키입니다. 쿠키는 렌더링 간에 유지되지 않으므로 매번 설정해야 합니다.
PaperFitVirtualPaperLayoutManagerPDF "종이" 페이지에 콘텐츠가 어떻게 배치될지 제어하는 ​​가상 용지 레이아웃 설정 관리자입니다. 기본 Chrome 동작, 확대/축소, 반응형 CSS3 레이아웃, 페이지 크기 조정 및 연속 공급 스타일 PDF 페이지 설정 옵션을 제공합니다.
UseMarginsOnHeaderAndFooterUseMargins머리글과 바닥글을 렌더링할 때 메인 문서의 여백 값을 사용합니다.
CreatePdfFormsFromHtmlbool모든 HTML 폼 요소를 편집 가능한 PDF 폼으로 변환합니다. 기본값은 true입니다.
CssMedia유형PdfCssMediaTypeMedia="screen" CSS 스타일 및 스타일시트를 활성화합니다. 기본값은 PdfCssMediaType.Screen입니다.
CustomCssUrl 문자열HTML을 렌더링하기 전에 사용자 지정 CSS 스타일시트를 적용할 수 있습니다. 로컬 파일 경로 또는 원격 URL을 사용할 수 있습니다. HTML을 PDF로 렌더링할 때만 적용됩니다.
JavaScript 활성화bool페이지 렌더링 전에 JavaScript 와 JSON을 실행할 수 있도록 합니다. Ajax/Angular 애플리케이션에서 출력할 때 유용합니다. 기본값은 false입니다.
EnableMathematicalLaTexbool수학 LaTeX 요소의 렌더링을 활성화합니다.
JavaScript 문자열모든 HTML이 로드된 후 PDF 렌더링 전에 실행될 사용자 지정 JavaScript 문자열입니다.
JavaScriptMessageListenerStringDelegate브라우저 JavaScript 콘솔 메시지가 표시될 때마다 호출될 메서드 콜백입니다.
첫 페이지 번호INTPDF 머리글과 바닥글에 사용할 첫 페이지 번호입니다. 기본값은 1입니다.
목차목차 유형HTML 문서의 "IronPDF-toc"라는 ID를 가진 요소가 발견된 위치에 목차를 생성합니다.
GrayScalebool흑백 PDF 파일을 출력합니다. 기본값은 false입니다.
TextHeaderITextHeaderFooter모든 PDF 페이지의 바닥글 내용을 텍스트로 설정하며, '메일 병합'을 지원하고 URL을 자동으로 하이퍼링크로 변환합니다.
TextFooter
HtmlHeaderHtmlHeaderFooter모든 PDF 페이지의 헤더 내용을 HTML로 설정합니다. '메일 병합' 기능을 지원합니다.
HtmlFooter
InputEncoding인코딩입력 문자의 인코딩을 문자열로 지정합니다. 기본값은 Encoding.UTF8입니다.
MarginTop더블PDF 상단 "용지" 여백(밀리미터). 테두리 없는 인쇄 및 상업용 인쇄 용도의 경우 0으로 설정하십시오. 기본값은 25입니다.
MarginRight더블PDF 용지 오른쪽 여백(밀리미터)입니다. 테두리 없이 인쇄하거나 상업용 인쇄를 할 경우 0으로 설정하십시오. 기본값은 25입니다.
MarginBottom더블PDF 하단 "용지" 여백(밀리미터). 테두리 없는 인쇄 및 상업용 인쇄 용도의 경우 0으로 설정하십시오. 기본값은 25입니다.
MarginLeft더블PDF 용지 왼쪽 여백(밀리미터). 테두리 없이 인쇄하거나 상업용 인쇄에 사용할 경우 0으로 설정하십시오. 기본값은 25입니다.
PaperOrientationPdfPaperOrientationPDF 용지 방향(세로 또는 가로)을 지정합니다. 기본값은 세로입니다.
PaperSizePdfPaperSize용지 크기를 설정합니다.
SetCustomPaperSize(센티미터 단위)더블용지 크기를 센티미터 단위로 설정합니다.
SetCustomPaperSizeInInches용지 크기를 인치 단위로 설정합니다.
SetCustomPaperSize(밀리미터 단위)용지 크기를 밀리미터 단위로 설정합니다.
SetCustomPaperSize를 픽셀 또는 포인트 단위로 설정화면 픽셀 또는 프린터 포인트 단위로 용지 크기를 설정합니다.
PrintHtmlBackgrounds부울HTML에서 배경색과 이미지를 출력할지 여부를 나타냅니다. 기본값은 true입니다.
RequestContextRequestContexts이 렌더링에 대한 컨텍스트를 요청하고 쿠키와 같은 특정 리소스의 격리 여부를 결정합니다.
타임아웃정수렌더링 시간 제한(초). 기본값은 60입니다.
제목문자열PDF 문서 이름 및 제목 메타데이터는 IronPDF MVC 및 Razor 확장에서 메일 병합 및 자동 파일 이름 지정에 유용합니다.
ForcePaperSize부울HTML에서 PDF로 변환한 후 페이지 크기를 조정하여 IronPDF 의 .ChromePdfRenderOptions.PaperSize에 지정된 페이지 크기와 정확히 일치하도록 합니다. HTML을 PDF로 렌더링할 때 발생하는 페이지 크기의 작은 오류를 수정하는 데 도움이 됩니다.
WaitForWaitFor사용자가 렌더링 전에 특정 이벤트를 기다리도록 하는 대기 메커니즘의 설정을 저장하는 래퍼 객체입니다. 기본적으로 아무것도 기다리지 않습니다.

더 많은 기능을 살펴볼 준비가 되셨나요? 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 활성화 등이 포함됩니다. 이러한 수준의 제어는 보고서, 송장 또는 정확한 서식이 필요한 모든 문서를 작성할 때 매우 중요합니다.

What is the function of the `PaperFit` option in IronPDF?

`PaperFit` in IronPDF’s `ChromePdfRenderer` controls content layout styles on PDF pages, providing options like responsive CSS3 layouts and continuous feed style setups.

How can IronPDF assist with rendering interactive PDF forms?

IronPDF automatically converts HTML form elements into interactive PDF forms when the `CreatePdfFormsFromHtml` property is set to true.

What is the significance of enabling `PrintHtmlBackgrounds` in IronPDF?

Enabling `PrintHtmlBackgrounds` ensures that all background colors and images defined in HTML are printed in the PDF, maintaining the visual integrity of the document.

Can IronPDF merge or split PDFs after applying rendering options?

Yes, IronPDF supports merging and splitting of PDF documents, which can be useful when combining or breaking down complex documents after rendering.

How does IronPDF handle dynamic web content rendering?

IronPDF handles dynamic web content by enabling JavaScript execution and allowing delays for JavaScript execution using the `WaitFor` class to ensure all interactive elements are fully rendered.

Curtis Chau
기술 문서 작성자

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

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.