1. IronPDF
  2. Anleitungen
  3. Benutzerdefinierte Ränder festlegen
Wie man benutzerdefinierte Ränder in PDFs in C# setzt

Einstellen von benutzerdefinierten Rändern in IronPDF C

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

IronPDF ermöglicht es Entwicklern, beim Rendern von PDFs aus HTML benutzerdefinierte Ränder festzulegen, indem sie die ChromePdfRenderer's RenderingOptions einfach konfigurieren. Dadurch wird eine präzise Kontrolle über die oberen, unteren, linken und rechten Ränder in Millimetern ermöglicht.

Schnellstart: Benutzerdefinierte PDF-Ränder mit IronPDF festlegen

Legen Sie beim Rendern von PDFs aus HTML mit einer einfachen Konfiguration benutzerdefinierte Ränder fest.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf

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

    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. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Minimaler Arbeitsablauf (5 Schritte):

  1. IronPDF von NuGet herunterladen
  2. Instanziieren Sie die Klasse ChromePdfRenderer
  3. Legen Sie die Randwerte in RenderingOptions fest.
  4. Konfigurieren Sie das Verhalten von Kopf- und Fußzeilenrändern
  5. HTML in PDF umwandeln und speichern

Wie kann ich benutzerdefinierte PDF-Ränder in IronPDF festlegen?

Um benutzerdefinierte Ränder festzulegen, instanziieren Sie die Klasse ChromePdfRenderer. Greifen Sie auf das Objekt RenderingOptions zu, um spezifische Ränder in Millimetern für oben, unten, links und rechts festzulegen:

: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

Die Randeinstellungen arbeiten mit der Chrome-Rendering-Engine von IronPDF, die eine genaue Konvertierung von HTML in PDF ermöglicht. Erweiterte Einstellungen für die PDF-Erzeugung finden Sie in der Anleitung zu Rendering Options.

Wie interagieren Ränder mit CSS-Stilen?

Die Ränder werden zu denen addiert, die im HTML-Abschnitt style festgelegt sind. Im folgenden Beispiel betragen die HTML-Ränder 50 mm, und RenderingOptions fügt 30 mm hinzu, was zu Gesamträndern von 80 mm führt:

: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

Das resultierende PDF wird unten gezeigt:

Bei der Arbeit mit CSS in HTML-Dokumenten unterstützt IronPDF responsive CSS und Media Queries und ermöglicht so professionelle Layouts. Dieses Randverhalten ist wichtig bei der Konvertierung von HTML-Dateien in PDF oder bei der Arbeit mit HTML-Strings.

Was sind gemeinsame Randwerte für verschiedene Standards?

Die Dokumente erfordern oft bestimmte Ränder, um verschiedenen Standards zu entsprechen. MLA- und APA-Formate erfordern einen 1-Zoll-Rand, während bei Dissertationen ein 1,5-Zoll-Rand erforderlich sein kann.

Gängige Margenstandards und Millimeteräquivalente:

  • MLA/APA-Format: 1 Zoll (25,4 mm) an allen Seiten
  • Format der Dissertation: 1,5 Zoll (38,1 mm) an allen Seiten
  • Geschäftsbriefe: 1 Zoll Seitenlänge, 2 Zoll (50,8 mm) oben/unten
  • Europäischer A4-Standard: 20 mm an allen Seiten
  • Schmale Ränder: 0,5 Zoll (12,7 mm) auf allen Seiten

Bei der Umsetzung dieser Standards unterstützt IronPDF Benutzerdefinierte Papierformate, so dass die Dokumente bestimmten regionalen oder organisatorischen Anforderungen entsprechen.

Wie kann ich benutzerdefinierte Ränder auf Kopf- und Fußzeilen anwenden?

Standardmäßig gelten die in RenderingOptions festgelegten Ränder nicht für Kopf- und Fußzeilen. Um Dokumentränder auf Kopf- und Fußzeilen anzuwenden, konfigurieren Sie die Eigenschaft 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

Für die Implementierung von Kopf- und Fußzeilen mit dynamischem Inhalt und Styling siehe die Anleitung zum Hinzufügen von Kopf- und Fußzeilen.

Wie kann ich Ränder selektiv auf Kopf- und Fußzeilen anwenden?

Geben Sie an, welche Ränder für Kopf- und Fußzeilen gelten. Eine detaillierte Konfiguration finden Sie in der API-Referenz. Beispiele:

: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

Wann sollte ich verschiedene Kopf-/Fußzeilen-Randkonfigurationen verwenden?

Selektive Randkonfigurationen für Kopf- und Fußzeilen eignen sich gut für Dokumente mit asymmetrischem Layout, wie z. B. Bücher mit wechselnden Seitenrändern oder Kopfzeilen, die bis zu den Seitenrändern reichen, während der Textinhalt die Ränder beibehält.

Häufige Anwendungsfälle:

  • Buchveröffentlichung: Abwechselnd innere und äußere Ränder für die Bindung
  • Briefkopf-Dokumente: Kopfzeilen in voller Breite mit eingeschränktem Textkörper
  • Formulare und Vorlagen: Unterschiedliche Ränder für Felder und Anweisungen
  • Mehrspaltige Layouts: Kopfzeilen in voller Breite mit Spaltenrändern

Erweiterte Überlegungen zu Seitenrändern

Arbeiten mit Seitenumbrüchen und Rändern

Benutzerdefinierte Ränder interagieren mit Seitenumbrüchen. IronPDF sorgt für einen seitenübergreifenden Inhaltsfluss unter Berücksichtigung der Randeinstellungen und gewährleistet eine einheitliche Formatierung in mehrseitigen Dokumenten.

Maßeinheiten und Genauigkeit

IronPDF verwendet Millimeter für die Ränder. Umrechnung aus anderen Einheiten:

  • Zoll in mm: mit 25,4 multiplizieren
  • Punkte zu mm: multiplizieren mit 0,352778
  • Pixel zu mm: variiert je nach DPI (bei 96 DPI, multiplizieren Sie mit 0,264583)

IronPDF unterstützt bei Bedarf Dezimalwerte für eine Genauigkeit im Submillimeterbereich.

Leistungsoptimierung mit Rändern

Für große Dokumente mit benutzerdefinierten Rändern:

  1. Legen Sie die Ränder einmalig auf der Ebene renderer fest.
  2. Verwendung einheitlicher Werte in ähnlichen Dokumenten
  3. Kombinieren Sie Randeinstellungen mit anderen Rendering-Optionen

Integration mit anderen IronPDF-Funktionen

Benutzerdefinierte Ränder arbeiten mit anderen IronPDF-Funktionen zusammen:

Abschluss

Die Einstellung von benutzerdefinierten Rändern in IronPDF bietet eine präzise Kontrolle über das PDF-Layout und die Formatierung. Ganz gleich, ob es um die Erstellung von Geschäftsdokumenten, akademischen Arbeiten oder benutzerdefinierten Berichten geht, das IronPDF-Randsystem sorgt dafür, dass die PDFs den genauen Spezifikationen entsprechen. In der Dokumentation erfahren Sie, wie IronPDF Ihre Arbeitsabläufe bei der PDF-Erstellung optimieren kann.

Häufig gestellte Fragen

Wie kann ich in C# benutzerdefinierte Ränder für PDFs festlegen?

Mit IronPDF können Sie benutzerdefinierte Ränder festlegen, indem Sie die RenderingOptions des ChromePdfRenderers konfigurieren. Legen Sie einfach die Eigenschaften MarginTop, MarginBottom, MarginLeft und MarginRight in Millimetern fest. Zum Beispiel: new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 } }.

Welche Einheiten werden für Margenmessungen verwendet?

IronPDF verwendet Millimeter (mm) als Einheit für alle Randeinstellungen in den RenderingOptions. Dies ermöglicht eine präzise Kontrolle über das PDF-Layout und gewährleistet die Konsistenz zwischen verschiedenen Dokumentstandards.

Wie verhalten sich die IronPDF-Ränder zu den CSS-Rändern in HTML?

IronPDF-Ränder sind additiv zu den in Ihrem HTML definierten CSS-Rändern. Wenn Ihr HTML-Code 50 mm Ränder hat und Sie in den RenderingOptions 30 mm einstellen, hat die endgültige PDF-Datei insgesamt 80 mm Ränder. Dies ermöglicht eine flexible Steuerung der Abstände unter Beibehaltung des HTML-Stylings.

Kann ich Ränder für Kopf- und Fußzeilen verwenden?

Ja, IronPDF bietet die Eigenschaft UseMarginsOnHeaderAndFooter in RenderingOptions. Wenn Sie diese Eigenschaft auf true setzen, werden Ihre benutzerdefinierten Ränder auf Kopf- und Fußzeilen angewandt, um konsistente Abstände im gesamten PDF-Dokument zu gewährleisten.

Was sind die empfohlenen Randwerte für akademische Formate?

Für akademische Dokumente, die IronPDF verwenden, sollten Sie 25,4 mm (1 Zoll) für das MLA/APA-Format, 38,1 mm (1,5 Zoll) für Dissertationen oder 20 mm für den europäischen A4-Standard verwenden. Diese Werte können leicht über die Eigenschaften MarginTop, MarginBottom, MarginLeft und MarginRight eingestellt werden.

Beeinträchtigt die Rendering-Engine von Chrome die Genauigkeit der Ränder?

Die Chrome-Rendering-Engine von IronPDF gewährleistet eine hochpräzise Randdarstellung, die den modernen Webstandards entspricht. Dies sorgt für konsistente Ergebnisse bei der Konvertierung von HTML in PDF, wobei die in Ihren RenderingOptions definierten Abstände präzise eingehalten werden.

Kann ich für jede Seite der PDF-Datei unterschiedliche Ränder festlegen?

Unbedingt. IronPDF ermöglicht die unabhängige Steuerung aller vier Ränder über separate Eigenschaften: MarginTop, MarginBottom, MarginLeft, und MarginRight. Dies ermöglicht asymmetrische Layouts wie Geschäftsbriefe mit größeren Rändern oben und unten.

Wie implementiere ich schmale Ränder für einen maximalen Inhaltsbereich?

Für schmale Ränder in IronPDF setzen Sie alle Randwerte in den RenderingOptions auf 12,7 mm (0,5 Zoll). Dadurch wird der druckbare Bereich maximiert und gleichzeitig ein professionelles Erscheinungsbild beibehalten: RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }.

Jordi Bardia
Jordi Bardia
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Jordi ist am besten in Python, C# und C++ versiert. Wenn er nicht bei Iron Software seine Fähigkeiten einsetzt, programmiert er Spiele. Mit Verantwortung für Produkttests, Produktentwicklung und -forschung trägt Jordi mit immensem Wert zur kontinuierlichen Produktverbesserung bei. Die abwechslungsreiche Erfahrung hält ihn gefordert und engagiert, ...
Weiterlesen
Bereit anzufangen?
Nuget Downloads 18,560,885 | Version: 2026.4 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.