.NET C#에서 페이지 방향 및 회전을 설정하는 방법 | IronPDF

.NET C#에서 페이지 방향 및 회전을 설정하는 방법

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

IronPDF를 사용하면 PDF 렌더링 중에 페이지 방향(세로/가로)을 설정하고 간단한 C# 메서드를 사용하여 기존 또는 새로 생성된 PDF 페이지를 0°, 90°, 180° 또는 270° 각도로 회전할 수 있습니다.

페이지 방향은 페이지가 세로(세로 방향) 또는 가로(가로 방향)로 배치되는 방식을 나타냅니다.

페이지 회전은 페이지의 각도를 조정하여 방향을 변경하는 기능으로, 정렬을 수정하거나 특정 보기 환경을 설정하는 데 유용할 수 있습니다. 페이지 각도는 90도, 180도, 270도로 설정할 수 있습니다.

IronPDF를 사용하면 렌더링 과정에서 세로 또는 가로 방향을 지정할 수 있습니다. 또한 필요에 따라 새로 렌더링된 PDF 페이지 또는 기존 PDF 페이지를 0도, 90도, 180도 또는 270도 각도로 개별적으로 회전할 수 있습니다.

빠른 시작: C#에서 PDF 페이지 방향 및 회전 설정

.NET C#에서 IronPDF를 사용하여 PDF 파일의 페이지 방향 및 회전을 설정하세요. 먼저 PDF 파일을 불러온 다음, 간단한 메서드 호출을 통해 원하는 회전이나 방향을 적용하세요. 업데이트된 문서를 저장하고 레이아웃이 특정 요구 사항을 충족하는지 확인하십시오. 이 가이드는 빠르게 시작하는 데 도움이 됩니다.

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

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

    PM > Install-Package IronPdf

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

    IronPdf.PdfDocument.FromFile("file.pdf")
        .SetAllPageRotations(IronPdf.PdfDocument.PageRotation.Rotate90)
        .SaveAs("rotated.pdf");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

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


IronPDF에서 페이지 방향을 설정하는 방법은 무엇인가요?

문서 방향을 설정하는 것은 다른 형식의 파일에서 PDF 문서를 생성할 때만 가능합니다. PaperOrientation 속성은 RenderingOptions 클래스에서 접근할 수 있습니다. 이 속성은 세로 또는 가로 방향으로 설정할 수 있습니다. 세로 방향이 기본 페이지 방향 설정입니다.

IronPDF를 사용하면 다양한 렌더링 옵션을 통해 PDF 생성 방식을 폭넓게 제어할 수 있습니다. HTML 문서, 웹 페이지 또는 기타 형식을 PDF로 변환할 때 방향 설정은 페이지의 기본 레이아웃을 결정하기 때문에 특히 중요합니다.

언제 가로 모드를 사용해야 할까요?

가로 방향은 넓은 표, 차트, 대시보드 또는 프레젠테이션과 같이 더 많은 가로 공간이 필요한 콘텐츠에 이상적입니다. HTML 파일을 PDF로 변환할 때 가로 모드를 사용하면 원치 않는 텍스트 줄 바꿈이나 요소 넘침 없이 넓은 콘텐츠가 올바르게 표시됩니다. 이러한 화면 방향은 재무 데이터, 프로젝트 일정 또는 와이드스크린 보기에 적합하게 디자인된 콘텐츠가 포함된 보고서에 특히 유용합니다.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-orientation.cs
using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

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

ChromePdfRenderer 클래스는 방향 설정 시 추가적인 유연성을 제공합니다. 용지 방향 설정과 함께 사용자 지정 용지 크기를 지정하여 정확한 사양에 맞는 PDF를 만들 수도 있습니다. 이는 특수 인쇄 요구 사항이나 고유한 표시 형식에 맞춰 문서를 제작할 때 특히 유용합니다.

풍경 이미지 출력은 어떤 모습인가요?


C#에서 PDF 페이지를 회전하는 방법은 무엇인가요?

IronPDF에서 제공하는 순환 근무 등급은 총 네 가지입니다.

  • None: 0도 또는 회전되지 않은 문서.
  • Clockwise90: 시계 방향으로 90도 회전.
  • Clockwise180: 시계 방향으로 180도 회전.
  • Clockwise270: 시계 방향으로 270도 회전.

참고해 주세요아래에 언급된 모든 페이지 색인 위치는 0부터 시작하는 색인 방식을 따릅니다.

페이지 회전은 PDF를 프로그램으로 편집할 때 필수적인 기능입니다. 렌더링 중에 적용되는 방향 설정과 달리 회전은 기존 PDF 문서에 적용할 수 있습니다. 이러한 특징 덕분에 스캔한 문서를 수정하거나, 가져온 콘텐츠를 조정하거나, 특정 보기 환경에 맞게 문서를 준비하는 데 필수적인 도구가 됩니다.

페이지를 회전하려면 어떤 방법을 사용해야 할까요?

아래 방법을 사용하여 단일 페이지, 여러 페이지 또는 모든 페이지에 대한 페이지 회전을 설정할 수 있습니다.

  • SetAllPageRotations: 모든 페이지의 회전 각도를 설정합니다.
  • SetPageRotation: 단일 페이지의 회전 각도를 설정합니다.
  • SetPageRotations: 선택한 페이지 목록의 회전 각도를 설정합니다.

IronPDF의 페이지 회전 기능은 다른 페이지 조작 기능과 완벽하게 연동됩니다. 회전 기능을 다른 변환 작업 과 결합하여 복잡한 문서 레이아웃을 만들거나, 텍스트 및 페이지 회전 방법과 함께 사용하여 정교한 문서 구조를 만들 수 있습니다.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-set-rotation.cs
using IronPdf;
using IronPdf.Rendering;
using System.Collections.Generic;

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

// Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90);

// Set a single page
pdf.SetPageRotation(1, PdfPageRotation.Clockwise180);

// Set multiple pages
List<int> selectedPages = new List<int>() { 0, 3 };
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270);

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

회전 기능을 사용할 때는 해당 작업이 텍스트, 이미지, 주석을 포함한 페이지 전체 콘텐츠에 영향을 미친다는 점을 이해하는 것이 중요합니다. 이는 개별 텍스트 요소에만 영향을 미치는 텍스트별 회전과는 다릅니다. 문서 레이아웃을 더욱 세밀하게 제어하려면 고급 서식 기법을 다루는 종합적인 PDF 생성 튜토리얼을 참조하세요.

회전된 PDF는 어떤 모습일까요?

현재 페이지 회전 상태를 어떻게 확인할 수 있나요?

PDF 문서에서 특정 페이지의 회전 값을 가져오려면 GetPageRotation 메서드를 사용하십시오. 메서드에 페이지 인덱스를 제공하기만 하면 됩니다.

이 방법은 문서 방향이 혼합된 경우나 병합된 문서 전체에서 일관된 회전을 유지해야 하는 경우에 특히 유용합니다. 현재 회전 상태를 조회하는 기능은 특히 다른 페이지 방향 예시 와 결합될 때 지능적인 문서 처리 워크플로를 가능하게 합니다.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-get-rotation.cs
using IronPdf;
using IronPdf.Rendering;

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

PdfPageRotation rotation = pdf.GetPageRotation(1);
$vbLabelText   $csharpLabel

페이지 방향 및 회전을 위한 모범 사례

애플리케이션에서 페이지 방향 및 회전을 구현할 때 다음 모범 사례를 고려하십시오.

  1. 렌더링 전 방향 설정 : 최적의 레이아웃을 위해 렌더링 전에 방향을 설정하십시오.

  2. 일괄 처리 : 여러 페이지를 일괄 처리하면 성능 향상을 위해 SetPageRotations를 사용하십시오.

  3. 원본 파일 보존 : 원본 파일을 보존하려면 회전된 버전을 새 파일 이름으로 저장하십시오.

  4. 사용자 경험을 고려하세요 : 화면 회전은 PDF 뷰어의 표시 방식에 영향을 미친다는 점을 기억하세요.

  5. 다른 기능과 결합 : 회전 기능을 헤더, 병합 또는 워터마크와 함께 사용하세요.

일반적인 문제 해결

페이지 방향이나 회전에 문제가 발생하는 경우 다음 해결 방법을 고려해 보세요.

  • 가로 모드에서 콘텐츠 잘림 현상 발생 시 : HTML 콘텐츠가 반응형인지 확인하거나 뷰포트 너비를 조정하세요.
  • 회전이 적용되지 않음 : 회전 메서드를 적용한 후 SaveAs를 호출하고 있는지 확인하십시오.
  • 혼합 방향 : 세로 및 가로 페이지를 병합하기 전에 별도로 처리합니다.

추가적인 지원 및 고급 기술에 대해서는 IronPDF의 종합적인 설명서를 참조하거나 PDF 조작에 대한 보다 전문적인 튜토리얼을 확인하십시오.

자주 묻는 질문

PDF 파일을 만들 때 페이지 방향을 가로로 설정하려면 어떻게 해야 하나요?

IronPDF에서는 RenderingOptions 클래스의 PaperOrientation 속성을 사용하여 페이지 방향을 설정할 수 있습니다. HTML 또는 다른 형식에서 PDF를 렌더링하기 전에 이 속성을 가로 또는 세로로 설정하기만 하면 됩니다. 세로 방향이 기본 설정입니다.

페이지 방향과 페이지 회전의 차이점은 무엇인가요?

IronPDF에서 페이지 방향은 다른 형식의 파일을 PDF로 렌더링할 때 초기 레이아웃(세로 또는 가로)을 결정합니다. 페이지 회전 기능을 사용하면 기존 PDF 페이지를 생성 후 0°, 90°, 180° 또는 270° 각도로 조정할 수 있어 정렬 문제를 수정하는 데 매우 유용합니다.

개별 페이지를 회전할 수 있나요, 아니면 PDF 전체를 회전해야 하나요?

IronPDF는 개별 페이지와 전체 PDF를 모두 회전할 수 있는 유연성을 제공합니다. 인덱스를 사용하여 특정 페이지를 회전하거나 SetAllPageRotations 메서드를 사용하여 모든 페이지에 한 번에 회전을 적용할 수 있습니다.

PDF 파일을 가로 방향으로 저장해야 하는 경우는 언제인가요?

IronPDF에서 가로 방향은 표, 차트, 대시보드 또는 프레젠테이션과 같이 가로로 긴 콘텐츠에 이상적입니다. 특히 재무 데이터, 프로젝트 타임라인 또는 와이드스크린 보기용으로 디자인된 콘텐츠가 포함된 HTML 파일을 변환할 때 텍스트 줄 바꿈이나 요소 넘침을 방지하는 데 유용합니다.

PDF 페이지의 현재 회전 각도를 어떻게 확인할 수 있나요?

IronPDF를 사용하면 모든 PDF 페이지의 현재 회전 각도를 프로그램적으로 가져올 수 있습니다. 이 기능을 통해 조정을 하기 전에 기존 방향을 확인하거나 회전 변경 사항이 올바르게 적용되었는지 확인할 수 있습니다.

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

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

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

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