Jak ustawić orientację i obrót strony w .NET C# | IronPDF

Jak ustawić orientację i rotację strony w .NET C

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

IronPDF umożliwia ustawienie orientacji strony (pionowej/poziomej) podczas generowania PDF oraz obracanie istniejących lub nowo utworzonych stron PDF o kąty 0°, 90°, 180° lub 270° za pomocą prostych metod C#.

Orientacja strony odnosi się do tego, jak strona jest ułożona - pionowo (portret) lub poziomo (krajobraz).

Rotacja strony to dostosowanie kąta strony, co pozwala na zmianę jej orientacji, co może być przydatne do poprawy wyrównania lub spełnienia określonych preferencji oglądania. Kąty strony można ustawić na 90, 180 i 270 stopni.

IronPDF pozwala określić orientację jako pionową lub poziomą podczas procesu renderowania. Dodatkowo można indywidualnie obracać nowo renderowane lub istniejące strony PDF do kątów 0, 90, 180 lub 270 stopni, zgodnie z potrzebami.

Szybki start: Ustaw orientację i rotację strony PDF w C#

Ustaw orientację i rotację strony w plikach PDF za pomocą IronPDF w .NET C#. Rozpocznij od załadowania pliku PDF, a następnie zastosuj pożądane rotacje lub orientacje za pomocą prostych wywołań metod. Zapisz zaktualizowany dokument, upewniając się, że układ spełnia określone wymagania. Niniejszy przewodnik pomaga szybko rozpocząć pracę.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf
  2. Skopiuj i uruchom ten fragment kodu.

    IronPdf.PdfDocument.FromFile("file.pdf")
        .SetAllPageRotations(IronPdf.PdfDocument.PageRotation.Rotate90)
        .SaveAs("rotated.pdf");
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer


Jak ustawić orientację strony w IronPDF?

Ustawienie orientacji jest możliwe tylko podczas tworzenia dokumentu PDF z innych formatów. Można uzyskać dostęp do właściwości PaperOrientation z klasy RenderingOptions. Tę właściwość można ustawić jako pionową lub poziomą. Portret jest domyślnym ustawieniem orientacji strony.

Pracując z IronPDF, znajdziesz, że opcje renderowania zapewniają szeroką kontrolę nad sposobem generowania plików PDF. Ustawienie orientacji jest szczególnie ważne podczas konwersji dokumentów HTML, stron internetowych lub innych formatów do PDF, gdyż określa ono podstawowy układ stron.

Kiedy należy korzystać z orientacji poziomej?

Orientacja pozioma jest idealna dla treści, które wymagają większej przestrzeni poziomej, takich jak szerokie tabele, wykresy, pulpity nawigacyjne czy prezentacje. Kiedy konwertujesz pliki HTML na PDF, tryb krajobrazu zapewnia prawidłowe wyświetlanie szerokiej zawartości bez niepożądanego zawijania tekstu lub przepełnień elementów. Ta orientacja jest szczególnie przydatna dla raportów zawierających dane finansowe, harmonogramy projektów lub jakiejkolwiek treści przeznaczonej do oglądania na szerokim ekranie.

: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");
Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape

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

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

Klasa ChromePdfRenderer oferuje dodatkową elastyczność przy ustawianiu orientacji. Można również określić niestandardowe rozmiary papieru obok ustawienia orientacji, aby tworzyć pliki PDF zgodne z dokładnymi specyfikacjami. Jest to szczególnie cenne podczas tworzenia dokumentów dla specjalistycznych wymagań drukowania lub unikalnych formatów wyświetlania.

Jak wygląda wyjście w orientacji poziomej?


Jak obrócić strony PDF w C#?

Istnieją cztery możliwe stopnie rotacji oferowane przez IronPDF:

  • None: 0 stopni lub dokument nieobrócony.
  • Clockwise90: 90 stopni obrócone zgodnie z ruchem wskazówek zegara.
  • Clockwise180: 180 stopni obrócone zgodnie z ruchem wskazówek zegara.
  • Clockwise270: 270 stopni obrócone zgodnie z ruchem wskazówek zegara.

Zwróć uwagęWszystkie pozycje indeksów stron wymienione poniżej są oparte na indeksowaniu od zera.

Rotacja strony jest podstawową funkcją przy programistycznej edycji plików PDF. W przeciwieństwie do ustawień orientacji, które stosuje się podczas renderowania, rotacje można zastosować do istniejących dokumentów PDF. Czyni ją to niezbędnym narzędziem do poprawy zeskanowanych dokumentów, dostosowywania importowanej zawartości lub przygotowywania dokumentów do specyficznych wymagań.

Jakie metody należy użyć do obracania stron?

Użyj poniższych metod, aby ustawić rotację dla jednej strony, wielu stron lub wszystkich stron.

  • SetAllPageRotations: Ustawia stopień rotacji dla wszystkich stron.
  • SetPageRotation: Ustawia stopień rotacji dla jednej strony.
  • SetPageRotations: Ustawia stopień rotacji dla wybranej listy stron.

Metody rotacji IronPDF działają bezproblemowo z innymi funkcjami manipulacji stronami. Można łączyć rotacje z innymi operacjami transformacji, aby osiągnąć złożone układy dokumentów lub używać ich z metodami obrotu tekstu i stron, aby tworzyć zaawansowane struktury dokumentów.

: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");
Imports IronPdf
Imports IronPdf.Rendering
Imports System.Collections.Generic

Private pdf As PdfDocument = PdfDocument.FromFile("landscape.pdf")

' Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90)

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

' Set multiple pages
Dim selectedPages As New List(Of Integer)() From {0, 3}
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270)

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

Pracując z rotacją, ważne jest, aby zrozumieć, że operacja ta wpływa na całą treść strony, w tym tekst, obrazy i dowolne adnotacje. Różni się to od rotacji ukierunkowanej na tekst, która wpływa jedynie na pojedyncze elementy tekstowe. Dla bardziej szczegółowej kontroli nad rozplanowaniem dokumentu, zbadaj kompleksowy przewodnik tworzenia PDF, który obejmuje zaawansowane techniki formatowania.

Jak wygląda obrócony PDF?

Jak można sprawdzić aktualną rotację strony?

Użyj metody GetPageRotation, aby pobrać rotację dowolnej szczególnej strony w dokumencie PDF. Wystarczy przekazać indeks strony do metody.

Ta metoda jest szczególnie użyteczna podczas przetwarzania dokumentów z mieszanymi orientacjami lub gdy trzeba utrzymać spójną rotację w całych dokumentach połączonych. Możliwość pobierania aktualnych stanów rotacji umożliwia inteligentne przepływy przetwarzania dokumentów, szczególnie w połączeniu z innymi przykładami orientacji stron.

: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);
Imports IronPdf
Imports IronPdf.Rendering

Private pdf As PdfDocument = PdfDocument.FromFile("rotatedLandscape.pdf")

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

Najlepsze praktyki dotyczące orientacji i rotacji stron

Podczas implementacji orientacji i rotacji stron w aplikacjach, warto wziąć pod uwagę następujące najlepsze praktyki:

  1. Określenie orientacji przed renderowaniem: Ustaw orientację przed renderowaniem, aby zapewnić optymalny układ.

  2. Przetwarzanie grupowe: Użyj SetPageRotations dla wielu stron, aby poprawić wydajność.

  3. Zachowaj oryginalne pliki: Zapisz obrotowe wersje z nowymi nazwami, aby zachować oryginały.

  4. Uwzględnij doświadczenie użytkownika: Pamiętaj, że rotacja wpływa na sposób wyświetlania pliku PDF w przeglądarce.

  5. Połącz z innymi funkcjami: Użyj rotacji z nagłówkami, scalaniem lub znakami wodnymi.

Rozwiązywanie typowych problemów

Jeśli napotkasz problemy z orientacją lub rotacją strony, rozważ te rozwiązania:

  • Odcięcie treści w orientacji poziomej: Upewnij się, że treść HTML jest responsywna lub dostosuj szerokość widoku
  • Nie zastosowano rotacji: Zweryfikuj, czy wywołujesz SaveAs po zastosowaniu metod rotacji
  • Mieszane orientacje: Przetwarzaj strony pionowe i poziome osobno przed scaleniem

Aby uzyskać dodatkowe wsparcie i zaawansowane techniki, zbadaj kompleksową dokumentację IronPDF lub zapoznaj się z bardziej wyspecjalizowanymi samouczkami na temat manipulacji PDF.

Często Zadawane Pytania

How do I set page orientation to landscape when creating PDFs?

With IronPDF, you can set page orientation using the PaperOrientation property in the RenderingOptions class. Simply set it to landscape or portrait before rendering your PDF from HTML or other formats. Portrait is the default setting.

What's the difference between page orientation and page rotation?

Page orientation in IronPDF determines the initial layout (portrait or landscape) when rendering PDFs from other formats. Page rotation allows you to adjust existing PDF pages to angles of 0°, 90°, 180°, or 270° after creation, perfect for correcting alignment issues.

Can I rotate individual pages or do I have to rotate the entire PDF?

IronPDF provides flexibility to rotate both individual pages and entire PDFs. You can use methods to rotate specific pages by their index or apply rotation to all pages at once using the SetAllPageRotations method.

When should I use landscape orientation for my PDFs?

Landscape orientation in IronPDF is ideal for wide content like tables, charts, dashboards, or presentations. It's particularly useful when converting HTML files containing financial data, project timelines, or any content designed for widescreen viewing to prevent text wrapping or element overflow.

How can I check the current rotation angle of a PDF page?

IronPDF allows you to retrieve the current rotation angle of any PDF page programmatically. This feature helps you determine the existing orientation before making adjustments or verify that your rotation changes have been applied correctly.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.