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

How to Set Custom Margins

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

Beim Arbeiten mit PDFs oder anderen Dokumenttypen besteht häufig die Notwendigkeit, die Ränder anzugeben, um unterschiedliche Standards einzuhalten. Beispielsweise erfordern die MLA- und APA-Formate 1-Zoll-Formate, während einige Universitäten 1,5-Zoll-Ränder für Dissertationen verlangen.

Schnellstart: Implementierung benutzerdefinierter PDF-Ränder mit IronPDf)

IronPDF macht es einfach, benutzerdefinierte Ränder beim Rendern eines PDFs aus HTML festzulegen – es bedarf nur einiger einfacher Konfigurationen.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    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. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

as-heading:3(Minimaler Workflow (5 Schritte):

  1. Laden Sie die IronPDF C#-Bibliothek für die Randkonfiguration von NuGet herunter
  2. Instanziieren Sie die ChromePdfRenderer-Klasse, um eine PDF-Datei zu rendern
  3. Ändern Sie die Randwerte in den RenderingOptions des Chrome Renderers zur Anpassung
  4. Passen Sie die Ränder speziell für Kopf- und Fußzeilen an
  5. Rendern Sie das HTML zu PDF und speichern Sie das Dokument

Beispiel für benutzerdefinierte Randeinstellungen

Um benutzerdefinierte Ränder festzulegen, instanziieren Sie zunächst die ChromePdfRenderer-Klasse. Mit ChromePdfRenderer können Sie auf das RenderingOptions-Objekt zugreifen, über das Sie die spezifischen Ränder in Millimetern für oben, unten, links und rechts festlegen können, wie unten gezeigt:

: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

Beachten Sie, dass dies zu den Rändern hinzukommt, die im style-Abschnitt des HTML festgelegt sind. In dem unten stehenden Beispiel sind die Ränder im HTML zunächst auf 50 mm festgelegt, aber das Festlegen der Ränder für jede Seite in den RenderingOptions fügt den Rändern weitere 30 mm hinzu, sodass diese dann 80 mm betragen:

: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:

Benutzerdefinierter Rand in Kopf-/Fußzeile festlegen

Standardmäßig gelten die in den RenderingOptions festgelegten Ränder nicht für Kopf- und Fußzeilen im Dokument. Um dieselben benutzerdefinierten Ränder des Dokuments in den Kopf- und Fußzeilen festzulegen, konfigurieren Sie die Eigenschaft UseMarginsOnHeaderAndFooter in den RenderingOptions:

: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

Es ist möglich, anzugeben, welche Ränder in Kopf- und Fußzeile festgelegt werden sollen. Für eine detaillierte Konfiguration lesen Sie bitte unseren umfassenden API-Referenz. Einige Beispiele zur Angabe, welche Ränder festgelegt werden sollen, sind unten gezeigt:

: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

Häufig gestellte Fragen

Wie kann ich benutzerdefinierte Ränder in einem PDF-Dokument mit C# festlegen?

Sie können benutzerdefinierte Ränder in einem PDF-Dokument mithilfe der IronPDF-Bibliothek in C# festlegen. Instanziieren Sie die ChromePdfRenderer-Klasse und verwenden Sie die RenderingOptions, um Ränder in Millimetern für die oberen, unteren, linken und rechten Seiten zu spezifizieren.

Welche Schritte sind erforderlich, um benutzerdefinierte Ränder in IronPDF festzulegen?

Um benutzerdefinierte Ränder in IronPDF festzulegen, laden Sie zunächst die IronPDF-Bibliothek von NuGet herunter, instanziieren Sie die ChromePdfRenderer, ändern Sie die Randwerte in den RenderingOptions und rendern und speichern Sie dann das PDF.

Kann ich unterschiedliche Ränder auf die Kopf- und Fußzeile eines PDFs anwenden?

Ja, Sie können unterschiedliche Ränder auf die Kopf- und Fußzeile eines PDFs anwenden, indem Sie die UseMarginsOnHeaderAndFooter-Eigenschaft in IronPDF's RenderingOptions festlegen.

Wie beeinflussen CSS-Ränder die in IronPDF festgelegten Ränder?

In HTML spezifizierte CSS-Ränder werden zu den in IronPDF's RenderingOptions festgelegten Rändern hinzugefügt. Wenn das HTML zum Beispiel einen Rand von 50 mm hat und IronPDF weitere 30 mm hinzufügt, beträgt der Gesamt rand 80 mm.

Gibt es eine Möglichkeit, das Festlegen von Rändern mithilfe eines Videos zu lernen?

Ja, es gibt ein Videotutorial auf YouTube, das Anleitung zum Festlegen benutzerdefinierter Ränder mit IronPDF bietet.

Können Ränder in IronPDF in anderen Einheiten als Millimetern angegeben werden?

Nein, IronPDF verwendet hauptsächlich Millimeter zur Angabe von Rändern. Andere Einheiten werden in der API nicht direkt unterstützt.

Wie verhält sich das Standardrandverhalten für Kopf- und Fußzeilen in IronPDF?

Standardmäßig gelten die in IronPDF's RenderingOptions angegebenen Ränder nicht für Kopf- und Fußzeilen. Um dieselben Ränder anzuwenden, aktivieren Sie UseMarginsOnHeaderAndFooter.

Wo finde ich weitere Beispiele zum Festlegen benutzerdefinierter Ränder in IronPDF?

Für weitere Beispiele zum Festlegen benutzerdefinierter Ränder in IronPDF lesen Sie die ausführliche API-Referenz und die im Artikel bereitgestellten Codebeispiele.

Ist IronPDF bei der Festlegung benutzerdefinierter Ränder vollständig mit .NET 10 kompatibel?

Ja, IronPDF unterstützt .NET 10 vollständig, einschließlich aller Rendering-Optionen wie benutzerdefinierte Ränder, Kopf- und Fußzeilenränder sowie HTML/CSS-Ränderintegrationen. Sie können dieselben Codebeispiele ohne Änderungen in .NET 10-Projekten verwenden.

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 16,154,058 | Version: 2025.11 gerade veröffentlicht