1. ChromePdfRenderer
  2. 방법
  3. 사용자 지정 여백 설정
C#을 사용하여 PDF에 사용자 지정 여백을 설정하는 방법

IronPDF C#에서 사용자 지정 여백을 설정하는 방법

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

IronPDF를 사용하면 개발자는 ChromePdfRenderer의 RenderingOptions을 간단히 구성하여 HTML에서 PDF를 렌더링할 때 사용자 지정 여백을 설정할 수 있으며, 이를 통해 상단, 하단, 좌측 및 우측 여백을 밀리미터 단위로 정밀하게 제어할 수 있습니다.

빠른 시작: IronPDF 사용하여 사용자 지정 PDF 여백 구현

간단한 설정으로 HTML에서 PDF로 렌더링할 때 사용자 지정 여백을 설정할 수 있습니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPdf 설치하기

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } }
    .RenderHtmlAsPdf("<h1>Hello with margins!</h1>")
    .SaveAs("custom-margins.pdf");

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

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

    arrow pointer

최소 워크플로우(5단계):

  1. NuGet 에서 IronPDF 다운로드하세요.
  2. ChromePdfRenderer 클래스를 인스턴스화합니다
  3. RenderingOptions에서 여백 값 설정
  4. 머리글 및 바닥글 여백 동작 설정
  5. HTML을 PDF로 변환하여 저장합니다.

IronPDF 에서 사용자 지정 PDF 여백을 설정하는 방법은 무엇인가요?

사용자 지정 여백을 설정하려면 ChromePdfRenderer 클래스를 인스턴스화하십시오. RenderingOptions 객체에 액세스하여 상단, 하단, 좌측, 우측의 여백을 밀리미터 단위로 구체적으로 설정할 수 있습니다:

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 40;
Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40
$vbLabelText   $csharpLabel

여백 설정은 IronPDF의 Chrome 렌더링 엔진 과 연동되어 정확한 HTML을 PDF로 변환합니다. 고급 PDF 생성 설정에 대한 자세한 내용은 렌더링 옵션 가이드를 참조하십시오.

여백은 CSS 스타일과 어떻게 상호작용하나요?

여백은 HTML style 섹션에 설정된 여백에 추가됩니다. 아래 예시에서 HTML 여백은 50mm이며, RenderingOptions가 30mm를 추가하여 총 여백은 80mm가 됩니다:

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.cs
const string htmlWithStyle = @"
<!DOCTYPE html>
<html>
    <head>
        <style>
            body {margin: 50mm 50mm 50mm 50mm;}
        </style>
    </head>
<body>
    <h1>Hello World!</h1>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginBottom = 30;

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlWithStyle);
pdf.SaveAs("PdfWithCustomMargins.pdf");
Const htmlWithStyle As String = "
<!DOCTYPE html>
<html>
    <head>
        <style>
            body {margin: 50mm 50mm 50mm 50mm;}
        </style>
    </head>
<body>
    <h1>Hello World!</h1>
</body>
</html>"

Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginLeft = 30
renderer.RenderingOptions.MarginRight = 30
renderer.RenderingOptions.MarginBottom = 30

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlWithStyle)
pdf.SaveAs("PdfWithCustomMargins.pdf")
$vbLabelText   $csharpLabel

생성된 PDF 파일은 아래와 같습니다.

IronPDF HTML 문서에서 CSS를 사용할 때 반응형 CSS와 미디어 쿼리를 지원하여 전문적인 레이아웃을 구현할 수 있도록 합니다. 이 여백 동작은 HTML 파일을 PDF로 변환하거나 HTML 문자열을 다룰 때 중요합니다.

서로 다른 표준에 대한 일반적인 마진 값은 무엇입니까?

문서에는 다양한 기준을 충족하기 위해 특정 여백이 필요한 경우가 많습니다. MLA 및 APA 형식은 1인치 여백을 요구하는 반면, 학위 논문은 1.5인치 여백이 필요할 수 있습니다.

일반적인 여백 기준 및 밀리미터 환산 단위:

  • MLA/APA 형식 : 사방 1인치(25.4mm)
  • 논문 규격 : 사방 1.5인치(38.1mm)
  • 비즈니스 편지 : 가로 1인치, 세로 2인치(50.8mm), 세로 2인치(50.8mm)
  • 유럽 A4 표준 : 사방 20mm
  • 좁은 여백 : 모든 면 0.5인치(12.7mm)

IronPDF 이러한 표준을 구현할 때 사용자 지정 용지 크기를 지원하여 특정 지역 또는 조직 요구 사항을 충족하는 문서를 만들 수 있습니다.

머리글과 바닥글에 사용자 지정 여백을 적용하려면 어떻게 해야 하나요?

기본적으로 RenderingOptions에서 설정된 여백은 머리글과 바닥글에는 적용되지 않습니다. 문서의 머리글과 바닥글에 여백을 적용하려면 UseMarginsOnHeaderAndFooter 속성을 구성하십시오:

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All
$vbLabelText   $csharpLabel

동적 콘텐츠 및 스타일을 사용한 헤더 및 푸터 구현에 대해서는 헤더 및 푸터 추가 가이드를 참조하세요.

머리글과 바닥글에 선택적으로 여백을 적용하는 방법은 무엇인가요?

머리글과 바닥글에 적용할 여백을 지정합니다. 자세한 구성 방법은 API 참조를 확인하세요. 예시:

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-specific-margins-header-footer.cs
// Use only the left margin from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.Left;

// Use only the left and right margins from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.LeftAndRight;
' Use only the left margin from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.Left

' Use only the left and right margins from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.LeftAndRight
$vbLabelText   $csharpLabel

머리글/바닥글 여백 설정을 다르게 해야 하는 경우는 언제일까요?

머리글과 바닥글에 대한 선택적 여백 설정은 페이지 여백이 번갈아 나타나는 책이나 본문 내용은 여백을 유지하면서 머리글이 페이지 가장자리까지 확장되는 경우와 같이 비대칭 레이아웃을 가진 문서에 효과적입니다.

일반적인 사용 사례:

  • 도서 출판 : 제본을 위한 안쪽/바깥쪽 여백 교차 인쇄
  • 레터헤드 문서 : 본문 너비가 제한된 전체 너비 헤더
  • 양식 및 템플릿 : 입력란과 안내문의 여백 설정
  • 다단 레이아웃 : 열 여백이 있는 전체 너비 헤더

고급 마진 고려 사항

페이지 나누기 및 여백 작업

사용자 지정 여백은 페이지 나누기 와 상호 작용합니다. IronPDF 여백 설정을 유지하면서 페이지 간 콘텐츠 흐름을 처리하여 여러 페이지로 구성된 문서에서 일관된 서식을 보장합니다.

마진 단위 및 정밀도

IronPDF 여백에 밀리미터 단위를 사용합니다. 다른 단위에서 변환하기:

  • 인치를 밀리미터로 변환: 25.4를 곱하십시오.
  • 점을 mm로 변환하려면 0.352778을 곱하십시오.
  • 픽셀을 mm로 변환: DPI에 따라 다릅니다 (96 DPI의 경우 0.264583을 곱하십시오).

IronPDF 필요한 경우 1mm 미만의 정밀도를 위해 소수점 값을 지원합니다.

마진을 활용한 성능 최적화

여백을 사용자 지정해야 하는 대용량 문서의 경우:

  1. renderer 레벨에서 여백을 한 번 설정하십시오
  2. 유사한 문서 전반에 걸쳐 일관된 값을 사용하십시오.
  3. 여백 설정을 다른 렌더링 옵션 과 결합합니다.

다른 IronPDF 기능과의 통합

사용자 지정 여백은 IronPDF 다른 기능과 함께 작동합니다.

결론

IronPDF 에서 사용자 지정 여백을 설정하면 PDF 레이아웃 및 서식을 정밀하게 제어할 수 있습니다. 비즈니스 문서, 학술 논문 또는 맞춤형 보고서를 작성하든 IronPDF의 여백 시스템은 PDF가 정확한 사양을 충족하도록 보장합니다. 문서를 살펴보시면 IronPDF PDF 생성 워크플로를 어떻게 간소화할 수 있는지 알아보실 수 있습니다.

자주 묻는 질문

C#에서 PDF의 사용자 지정 여백을 설정하는 방법은 무엇인가요?

IronPDF를 사용하면 ChromePdfRenderer의 RenderingOptions를 구성하여 사용자 지정 여백을 설정할 수 있습니다. MarginTop, MarginBottom, MarginLeft 및 MarginRight 속성을 밀리미터 단위로 설정하기만 하면 됩니다. 예를 들어 다음과 같습니다. new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 } }.

마진 측정에 사용되는 단위는 무엇입니까?

IronPDF는 RenderingOptions의 모든 여백 설정에 밀리미터(mm) 단위를 사용합니다. 이를 통해 PDF 레이아웃을 정밀하게 제어하고 다양한 문서 표준 간의 일관성을 유지할 수 있습니다.

IronPDF의 여백은 HTML의 CSS 여백과 어떻게 상호 작용합니까?

IronPDF의 여백은 HTML에 정의된 CSS 여백에 추가됩니다. 예를 들어 HTML에 50mm 여백이 있고 RenderingOptions에서 30mm로 설정하면 최종 PDF의 총 여백은 80mm가 됩니다. 이를 통해 HTML 스타일을 유지하면서 간격을 유연하게 제어할 수 있습니다.

머리글과 바닥글에 여백을 적용할 수 있나요?

네, IronPDF는 RenderingOptions에 UseMarginsOnHeaderAndFooter 속성을 제공합니다. 이 속성을 true로 설정하면 사용자 지정 여백이 머리글과 바닥글에 적용되어 PDF 문서 전체에 일관된 간격이 유지됩니다.

학술용 서식에 권장되는 여백 값은 얼마인가요?

IronPDF를 사용하여 학술 문서를 작성할 때는 MLA/APA 형식의 경우 25.4mm(1인치), 학위 논문의 경우 38.1mm(1.5인치), 유럽 A4 표준 크기의 경우 20mm의 여백을 사용하십시오. 이러한 값은 MarginTop, MarginBottom, MarginLeft 및 MarginRight 속성을 통해 쉽게 설정할 수 있습니다.

Chrome 렌더링 엔진이 여백 정확도에 영향을 미치나요?

IronPDF의 Chrome 렌더링 엔진은 최신 웹 표준에 부합하는 매우 정확한 여백 렌더링을 보장합니다. 이를 통해 HTML을 PDF로 변환할 때 일관된 결과를 제공하며, RenderingOptions에 정의된 정확한 간격을 유지합니다.

PDF 파일의 각 면에 서로 다른 여백을 설정할 수 있나요?

물론입니다. IronPDF는 MarginTop, MarginBottom, MarginLeft, MarginRight 네 가지 속성을 통해 각 여백을 독립적으로 제어할 수 있습니다. 이를 통해 상단/하단 여백을 크게 설정하여 비즈니스 편지와 같은 비대칭 레이아웃을 만들 수 있습니다.

콘텐츠 영역을 최대화하기 위해 여백을 좁게 설정하는 방법은 무엇인가요?

IronPDF에서 여백을 좁게 설정하려면 RenderingOptions에서 모든 여백 값을 12.7mm(0.5인치)로 설정하십시오. 이렇게 하면 전문적인 모양을 유지하면서 인쇄 영역을 최대화할 수 있습니다. 예: RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }.

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

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

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

시작할 준비 되셨나요?
Nuget 다운로드 19,014,616 | 버전: 2026.5 just released
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPdf
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.