Wie man Seitenorientierung und Rotation in .NET C# setzt | IronPDF

Einstellen der Seitenausrichtung und -drehung in .NET C#35;

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

IronPDF ermöglicht es Ihnen, die Seitenausrichtung (Hochformat/Landschaft) während des PDF-Renderings festzulegen und vorhandene oder neu erstellte PDF-Seiten mit einfachen C#-Methoden in den Winkeln 0°, 90°, 180° oder 270° zu drehen.

Die Seitenorientierung bezieht sich darauf, wie eine Seite layoutet ist, entweder vertikal (Hochformat) oder horizontal (Querformat).

Die Seitendrehung ist die Anpassung des Seitenwinkels, mit der Sie die Ausrichtung ändern können, was nützlich sein kann, um die Ausrichtung zu korrigieren oder bestimmten Betrachtungsvorlieben gerecht zu werden. Seitenwinkel können auf 90, 180 und 270 Grad eingestellt werden.

Mit IronPDF können Sie die Ausrichtung während des Renderingprozesses entweder als Hochformat oder Querformat angeben. Zusätzlich können Sie neu gerenderte oder vorhandene PDF-Seiten bei Bedarf individuell auf Winkel von 0, 90, 180 oder 270 Grad drehen.

Schnellstart: PDF-Seitenorientierung und Drehung in C# festlegen

Festlegen der Seitenausrichtung und -drehung in Ihren PDF-Dateien mit IronPDF in .NET C#. Beginnen Sie damit, Ihr PDF zu laden, und wenden Sie dann gewünschte Drehungen oder Ausrichtungen mit einfachen Methodenaufrufen an. Speichern Sie Ihr aktualisiertes Dokument und stellen Sie sicher, dass Ihr Layout den spezifischen Anforderungen entspricht. Dieser Leitfaden hilft Ihnen, schnell loszulegen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.PdfDocument.FromFile("file.pdf")
        .SetAllPageRotations(IronPdf.PdfDocument.PageRotation.Rotate90)
        .SaveAs("rotated.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer


Wie kann ich die Seitenausrichtung in IronPDF einstellen?

Die Ausrichtung kann nur festgelegt werden, wenn ein PDF-Dokument aus anderen Formaten generiert wird. Sie können auf die PaperOrientation-Eigenschaft der RenderingOptions-Klasse zugreifen. Diese Eigenschaft kann entweder auf Hochformat oder Querformat eingestellt werden. Hochformat ist die standardmäßige Seitenorientierungseinstellung.

Wenn Sie mit IronPDF arbeiten, werden Sie feststellen, dass die Rendering-Optionen eine umfassende Kontrolle darüber bieten, wie Ihre PDFs erzeugt werden. Die Ausrichtungseinstellung ist besonders wichtig bei der Konvertierung von HTML-Dokumenten, Webseiten oder anderen Formaten in PDF, da sie das grundlegende Layout Ihrer Seiten bestimmt.

Wann sollte ich die Querformatierung verwenden?

Das Querformat ist ideal für Inhalte, die mehr horizontalen Platz benötigen, wie breite Tabellen, Diagramme, Dashboards oder Präsentationen. Bei der Konvertierung von HTML-Dateien in PDF sorgt der Querformatmodus dafür, dass breite Inhalte ohne unerwünschten Textumbruch oder Elementüberlauf korrekt angezeigt werden. Diese Ausrichtung ist besonders nützlich für Berichte, die Finanzdaten, Projektzeitpläne oder andere Inhalte enthalten, die für die Anzeige im Breitbildformat konzipiert sind.

: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

Die Klasse ChromePdfRenderer bietet zusätzliche Flexibilität bei der Einstellung der Ausrichtung. Sie können auch Benutzerdefinierte Papierformate sowie Ausrichtungseinstellungen angeben, um PDFs zu erstellen, die genau den Spezifikationen entsprechen. Dies ist besonders wertvoll bei der Erstellung von Dokumenten für spezielle Druckanforderungen oder einzigartige Anzeigeformate.

Wie sieht die Ausgabe im Querformat aus?


Wie drehe ich PDF-Seiten in C#?

Es gibt vier mögliche Drehungsgrade, die von IronPDF angeboten werden:

  • None: 0 Grad oder nicht gedrehtes Dokument.
  • Clockwise90: 90 Grad im Uhrzeigersinn gedreht.
  • Clockwise180: 180 Grad im Uhrzeigersinn gedreht.
  • Clockwise270: 270 Grad im Uhrzeigersinn gedreht.

Hinweis:Alle unten genannten Seitenindexpositionen folgen der nullbasierten Indizierung.

Die Seitendrehung ist eine grundlegende Funktion bei der programmatischen Bearbeitung von PDFs. Im Gegensatz zu den Ausrichtungseinstellungen, die während des Renderns gelten, kann die Drehung auf bestehende PDF-Dokumente angewendet werden. Dies macht es zu einem unverzichtbaren Werkzeug für die Korrektur von gescannten Dokumenten, die Anpassung von importierten Inhalten oder die Vorbereitung von Dokumenten für bestimmte Anzeigeanforderungen.

Welche Methoden sollte ich zum Drehen von Seiten verwenden?

Verwenden Sie die folgenden Methoden, um die Rotation für eine einzelne Seite, mehrere Seiten oder alle Seiten einzustellen.

  • SetAllPageRotations: Legt den Drehungsgrad für alle Seiten fest.
  • SetPageRotation: Legt den Drehungsgrad für eine einzelne Seite fest.
  • SetPageRotations: Legt den Drehungsgrad für eine ausgewählte Liste von Seiten fest.

Die Rotationsmethoden von IronPDF arbeiten nahtlos mit anderen Funktionen zur Seitenmanipulation zusammen. Sie können die Rotation mit anderen Transformationsoperationen kombinieren, um komplexe Dokumentenlayouts zu erzielen, oder sie zusammen mit Methoden zum Drehen von Text und Seiten verwenden, um anspruchsvolle Dokumentenstrukturen zu erstellen.

: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

Bei der Arbeit mit der Rotation ist es wichtig zu verstehen, dass sich der Vorgang auf den gesamten Seiteninhalt auswirkt, einschließlich des Textes, der Bilder und aller Anmerkungen. Dies unterscheidet sich von der textspezifischen Rotation, die nur einzelne Textelemente betrifft. Wenn Sie das Layout Ihres Dokuments genauer kontrollieren möchten, sollten Sie sich das umfassende Tutorial zur PDF-Erstellung ansehen, das fortgeschrittene Formatierungstechniken behandelt.

Wie sieht die gedrehte PDF-Datei aus?

Wie kann ich die aktuelle Seitenrotation überprüfen?

Verwenden Sie die GetPageRotation-Methode, um die Drehung einer bestimmten Seite im PDF-Dokument abzurufen. Geben Sie einfach den Seitenindex an die Methode weiter.

Diese Methode ist besonders nützlich bei der Verarbeitung von Dokumenten mit unterschiedlichen Ausrichtungen oder wenn Sie eine konsistente Rotation über zusammengeführte Dokumente hinweg beibehalten müssen. Die Möglichkeit, den aktuellen Rotationszustand abzufragen, ermöglicht intelligente Arbeitsabläufe bei der Dokumentenverarbeitung, insbesondere in Kombination mit anderen Beispielen für die Seitenausrichtung.

: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

Best Practices für Seitenausrichtung und -drehung

Beachten Sie bei der Implementierung der Seitenausrichtung und -drehung in Ihren Anwendungen die folgenden bewährten Verfahren:

  1. Orientierung vor dem Rendering festlegen: Legen Sie die Orientierung vor dem Rendering fest, um ein optimales Layout zu gewährleisten.

  2. Stapelverarbeitung: Verwenden Sie SetPageRotations für mehrere Seiten, um die Leistung zu verbessern.

  3. Originaldateien beibehalten: Speichern Sie gedrehte Versionen mit neuen Dateinamen, um die Originale zu erhalten.

  4. Berücksichtigen Sie die Benutzerfreundlichkeit: Denken Sie daran, dass die Drehung die Anzeige von PDF-Viewern beeinflusst.

  5. Kombinieren Sie mit anderen Funktionen: Verwenden Sie Rotation mit Kopfzeilen, Zusammenführen oder Wasserzeichen.

Behebung häufiger Probleme

Wenn Sie Probleme mit der Seitenausrichtung oder -drehung haben, sollten Sie diese Lösungen in Betracht ziehen:

  • Inhalt im Querformat abgeschnitten: Stellen Sie sicher, dass der HTML-Inhalt responsiv ist oder passen Sie die Breite des Ansichtsfensters an
  • Rotation nicht angewendet: Vergewissern Sie sich, dass Sie SaveAs nach der Anwendung von Rotationsmethoden aufrufen
  • Gemischte Ausrichtungen: Verarbeiten Sie Seiten im Hoch- und Querformat getrennt, bevor Sie sie zusammenführen

Weitere Unterstützung und fortgeschrittene Techniken finden Sie in der umfassenden IronPDF-Dokumentation oder in speziellen Tutorials zur PDF-Bearbeitung.

Häufig gestellte Fragen

Wie stelle ich die Seitenausrichtung bei der Erstellung von PDFs auf Querformat ein?

Mit IronPDF können Sie die Seitenausrichtung über die Eigenschaft PaperOrientation in der Klasse RenderingOptions festlegen. Stellen Sie sie einfach auf Quer- oder Hochformat ein, bevor Sie Ihre PDF-Datei aus HTML oder anderen Formaten rendern. Hochformat ist die Standardeinstellung.

Was ist der Unterschied zwischen Seitenausrichtung und Seitendrehung?

Die Seitenausrichtung in IronPDF bestimmt das anfängliche Layout (Hoch- oder Querformat) beim Rendern von PDFs aus anderen Formaten. Die Seitendrehung ermöglicht es Ihnen, vorhandene PDF-Seiten nach der Erstellung in einem Winkel von 0°, 90°, 180° oder 270° auszurichten, was sich perfekt zur Korrektur von Ausrichtungsproblemen eignet.

Kann ich einzelne Seiten drehen oder muss ich die gesamte PDF-Datei drehen?

IronPDF bietet die Flexibilität, sowohl einzelne Seiten als auch ganze PDFs zu drehen. Sie können Methoden verwenden, um bestimmte Seiten nach ihrem Index zu drehen oder die Drehung mit der Methode SetAllPageRotations auf alle Seiten gleichzeitig anzuwenden.

Wann sollte ich meine PDFs im Querformat ausgeben?

Das Querformat in IronPDF ist ideal für breite Inhalte wie Tabellen, Diagramme, Dashboards oder Präsentationen. Dies ist besonders nützlich bei der Konvertierung von HTML-Dateien mit Finanzdaten, Projektzeitplänen oder anderen Inhalten, die für die Anzeige im Breitbildformat konzipiert wurden, um Textumbrüche oder Elementüberläufe zu vermeiden.

Wie kann ich den aktuellen Drehwinkel einer PDF-Seite überprüfen?

IronPDF ermöglicht es Ihnen, den aktuellen Drehwinkel einer beliebigen PDF-Seite programmatisch abzurufen. Diese Funktion hilft Ihnen dabei, die bestehende Ausrichtung zu bestimmen, bevor Sie Anpassungen vornehmen, oder zu überprüfen, ob Ihre Rotationsänderungen korrekt angewendet wurden.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht