C#을 사용하여 PDF에 사용자 지정 용지 크기를 설정하는 방법 | IronPDF

C#에서 사용자 지정 용지 크기로 PDF를 렌더링하는 방법

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF를 사용하면 ChromePdfRenderer 클래스를 이용하여 C#에서 사용자 지정 용지 크기로 PDF를 렌더링할 수 있으며, SetCustomPaperSizeInInches()와 같은 메서드를 통해 특정 크기를 설정할 수 있습니다. 이를 통해 포스터나 배너와 같은 특수 레이아웃에 필요한 문서 크기를 정밀하게 제어할 수 있습니다.

사용자 지정 용지 크기란 A4 또는 레터 사이즈(8.5 x 11인치)와 같은 표준 크기가 아닌, 사용자가 직접 정의하는 비표준 용지 크기를 의미합니다. 맞춤 용지 크기는 포스터, 배너 또는 특수 문서와 같이 독특하거나 특정한 레이아웃이 필요한 문서를 인쇄할 때 자주 사용됩니다. 이러한 유연성은 특정 크기가 요구되는 HTML을 PDF로 변환하는 프로젝트를 진행할 때 필수적입니다.

IronPDF에서 제공하는 다양한 용지 크기를 살펴보세요. 필요에 맞는 폭넓은 선택지를 제공합니다!

빠른 시작: IronPDF에서 사용자 지정 용지 크기 정의

이 간편 가이드에서는 IronPDF를 사용하여 단 몇 줄의 코드로 사용자 지정 용지 크기를 설정하는 방법을 알려드립니다. IronPDF를 사용하면 원하는 단위로 정확한 너비와 높이 치수를 정의하여 PDF 크기를 쉽게 조정할 수 있습니다. 이러한 유연성은 포스터나 배너와 같이 독특한 레이아웃이 필요한 문서를 제작하는 데 이상적입니다. 먼저 NuGet을 통해 IronPDF 라이브러리를 다운로드하고 , 이 예제를 따라 원하는 용지 크기를 손쉽게 설정하세요.

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

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

    PM > Install-Package IronPdf

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

    var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } };
    renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7);
    renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf")
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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


표준 용지 크기는 어떻게 사용하나요?

먼저, ChromePdfRenderer 클래스의 인스턴스를 생성합니다. 그런 다음 새로 생성된 개체의 RenderingOptions 속성을 사용하여 PaperSize를 수정합니다. 원하는 용지 크기를 지정하려면 PdfPaperSize 열거형에서 미리 정의된 값 중 하나로 설정하십시오. 편의를 위해 100가지 이상의 표준 용지 크기를 미리 정의해 놓았습니다.

IronPDF는 PDF 렌더링 옵션을 사용할 때 문서 서식 지정 방식을 완벽하게 제어할 수 있는 기능을 제공합니다. 표준 용지 크기에는 A4, Letter, Legal과 같은 일반적으로 사용되는 형식과 여러 국제 표준이 포함됩니다.

사용 가능한 표준 용지 크기는 무엇입니까?

아래는 표준 용지 크기를 설정하는 방법의 예입니다.

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs
using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");
$vbLabelText   $csharpLabel

IronPDF는 다음과 같은 다양한 표준 용지 크기를 지원합니다.

  • ISO 216 시리즈 : A0~A10, B0~B10
  • 북미 : 편지, 법률, 타블로이드, 임원용
  • 건축 규격 : ANSI A부터 E까지
  • 일본어 : JIS B0부터 B10까지
  • 봉투 크기 : 다양한 국제 봉투 표준 규격

사용 가능한 용지 크기 및 치수에 대한 전체 목록은 API 참조 문서를 참조하십시오.

용지 크기를 결정하는 속성은 무엇입니까?

  • PaperSize: 레터, A3, A4 등과 같이 미리 정의된 크기로 PDF 페이지의 출력 용지 크기를 설정합니다.
  • ForcePaperSize: HTML에서 PDF를 생성한 후 페이지 크기를 조정하여 IronPdf.ChromePdfRenderOptions.PaperSize를 통해 지정된 크기와 정확히 일치하도록 페이지 크기를 강제합니다. 이 기능은 용지 크기를 지정하는 CSS 규칙을 우회하는 데 유용합니다.

이러한 속성을 사용자 지정 여백 과 함께 사용하면 PDF 레이아웃을 정밀하게 제어할 수 있습니다.

다양한 단위로 된 표준 용지 크기를 어떻게 구할 수 있나요?

표준 용지 크기의 치수를 알아야 하시나요? ToMillimeters 방법을 사용하면 쉽게 할 수 있습니다. 이 메서드는 표준 용지 크기의 너비와 높이를 Length 객체로 포함하는 튜플을 반환합니다. Length 클래스는 매우 다재다능하여 이러한 치수를 다음과 같은 다양한 단위로 손쉽게 변환할 수 있습니다.

  • 밀리미터
  • 센티미터
  • 인치
  • 픽셀
  • 포인트
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.cs
using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();
$vbLabelText   $csharpLabel

이 기능은 CSS 반응형 레이아웃 과 통합하거나 사용자 지정 레이아웃에 대한 정확한 크기를 계산해야 할 때 특히 유용합니다.


사용자 지정 용지 크기는 어떻게 만드나요?

먼저, ChromePdfRenderer 클래스를 인스턴스화하는 것으로 시작합니다. 새로 생성된 객체에서 RenderingOptions에 접근하여 새로 생성된 PDF 문서에 사용자 지정 용지 크기를 적용할 수 있습니다. PDF 페이지의 출력 용지 크기를 설정하는 데 사용할 수 있는 방법은 네 가지가 있으며, 각 방법은 서로 다른 측정 단위를 기반으로 합니다.

  • SetCustomPaperSizeInCentimeters: 치수는 centimeters에 있습니다.
  • SetCustomPaperSizeInInches: 치수는 inches에 있습니다.
  • SetCustomPaperSizeInMillimeters: 치수는 millimeters에 있습니다.
  • SetCustomPaperSizeInPixelsOrPoints: 치수는 pixels or points에 있습니다.

사용자 지정 용지 크기를 만들 때는 머리글과 바닥글, 그리고 페이지 방향 설정과 의 상호 작용 방식을 고려하는 것이 중요합니다.

사용자 지정 치수에 사용할 수 있는 단위는 무엇입니까?

다음은 용지 크기를 센티미터 단위로 설정하는 방법의 예입니다.

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");
$vbLabelText   $csharpLabel

다음은 각 측정 단위에 대한 추가 예시입니다.

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
$vbLabelText   $csharpLabel

사용자 지정 크기로 작업할 때는 콘텐츠가 사용자 지정 크기에 제대로 맞는지 확인하기 위해 뷰포트 및 확대/축소 설정을 살펴보는 것이 좋습니다.


용지 크기를 어떻게 수정할 수 있나요?

기존 PDF 문서 또는 새로 렌더링된 PDF에서 각 페이지의 크기는 ExtendPage 메서드를 사용하여 수정할 수 있습니다. 이 방법을 사용하면 대상 페이지 색인, 네 면 각각을 수정할 값, 측정 단위를 지정할 수 있습니다. 각 변의 값은 음수일 수도 있고, 양수일 수도 있습니다. 음수이면 해당 변이 줄어들고, 양수이면 해당 변이 늘어납니다.

이 기능은 여러 페이지 크기의 PDF 파일을 병합하거나 인쇄용 문서를 준비하는 등 PDF 파일 생성 후 수정이 필요할 때 특히 유용합니다.

ExtendPage는 어떤 매개변수를 허용합니까?

ExtendPage 메서드는 다음 매개변수를 허용합니다.

  • 페이지 인덱스 : 수정할 페이지의 0부터 시작하는 인덱스입니다.
  • 좌측 확장 : 좌측을 확장/축소할 양
  • 우측 확장 : 우측을 확장/축소하는 양
  • 상단 연장 : 상단 부분을 연장/축소할 양
  • 하단 연장 : 하단 부분을 연장/축소할 양
  • 측정 단위 : 측정 단위 (millimeters, inches, etc.)

다음은 용지 크기를 수정하는 방법의 예입니다.

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.cs
using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");
$vbLabelText   $csharpLabel

다음은 다양한 페이지 수정 사항을 보여주는 보다 포괄적인 예입니다.

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
$vbLabelText   $csharpLabel

맞춤형 용지 크기 제작을 위한 모범 사례

IronPDF에서 사용자 지정 용지 크기를 사용할 때는 다음과 같은 모범 사례를 고려하십시오.

  1. 다양한 단위를 테스트하세요 : 사용자 지정 크기를 사용할 때는 어떤 측정 단위가 사용 사례에 가장 적합한지 테스트해 보세요. 픽셀은 화면 레이아웃에 적합하지만, 밀리미터나 인치는 인쇄에 더 적합합니다.

  2. 인쇄 여백 고려 : 인쇄용 PDF를 만들 때는 프린터 여백을 고려해야 합니다. 대부분의 프린터는 용지 가장자리까지 인쇄할 수 없습니다.

  3. 반응형 디자인 : HTML을 PDF로 변환할 때, 다양한 용지 크기에 맞춰 자동으로 조정되도록 반응형 디자인 원칙을 적용한 HTML을 사용해야 합니다.

  4. 성능 최적화 : 매우 큰 맞춤형 용지 크기는 성능에 영향을 미칠 수 있습니다. 대용량 문서의 경우 압축을 사용하는 것을 고려해 보세요.

  5. 호환성 : 특히 비표준 크기를 사용하는 경우 호환성을 확인하기 위해 다양한 PDF 뷰어에서 사용자 지정 크기의 PDF를 테스트하십시오.

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? PDF 생성 방법 튜토리얼 페이지는 여기에서 확인하세요.

자주 묻는 질문

C#에서 PDF 문서의 사용자 지정 용지 크기를 설정하는 방법은 무엇인가요?

IronPDF를 사용하면 ChromePdfRenderer 클래스를 사용하여 사용자 지정 용지 크기를 설정할 수 있습니다. RenderingOptions에서 PaperSize 속성을 PdfPaperSize.Custom으로 설정한 다음 SetCustomPaperSizeInInches()와 같은 메서드를 사용하여 특정 치수를 정의하면 됩니다. 예를 들어 renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7)과 같이 사용합니다.

사용자 지정 용지 크기에 사용할 수 있는 측정 단위는 무엇입니까?

IronPDF는 SetCustomPaperSize 메서드를 통해 다양한 측정 단위를 지원하여 사용자 지정 용지 크기를 지정할 수 있습니다. 인치, 센티미터, 밀리미터 또는 픽셀 단위로 치수를 지정할 수 있으므로 다양한 국제 표준 및 프로젝트 요구 사항에 유연하게 대응할 수 있습니다.

표준 용지 크기 대신 사용자 지정 용지 크기를 사용해야 하는 경우는 언제입니까?

IronPDF의 사용자 지정 용지 크기 기능은 포스터, 배너, 특수 문서 또는 A4나 Letter와 같은 표준 크기에 맞지 않는 디자인 등 독특한 레이아웃의 PDF를 제작할 때 이상적입니다. 이러한 유연성은 특정 크기가 필요한 HTML을 PDF로 변환하는 프로젝트에서 특히 유용합니다.

미리 정의된 표준 용지 크기는 몇 가지입니까?

IronPDF는 PdfPaperSize 열거형을 통해 A4, Letter, Legal과 같은 일반적인 형식 및 다양한 국제 표준을 포함하여 100개 이상의 사전 정의된 표준 용지 크기를 제공하여 대부분의 문서 요구 사항에 대한 포괄적인 옵션을 제공합니다.

사용자 지정 용지 크기를 구현하는 단계는 무엇입니까?

IronPDF에서 사용자 지정 용지 크기를 구현하려면 다음 단계를 따르세요. 1) NuGet을 통해 IronPDF를 다운로드합니다. 2) ChromePdfRenderer 인스턴스를 생성합니다. 3) RenderingOptions 속성에 접근합니다. 4) 원하는 크기를 지정하여 SetCustomPaperSize 메서드를 호출합니다. 5) PDF 문서를 렌더링하고 저장합니다.

커티스 차우
기술 문서 작성자

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

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

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