IRONSOFTWAREHOME

MaxHeight vs UseMarginToHeaderAndFooter

Curtis Chau
Curtis Chau
Updated: 29. Juni 2026

Wenn Sie ein PDF mit Kopf- und Fußzeilen rendern, werden zwei Eigenschaften häufig verwechselt: MaxHeight und UseMarginToHeaderAndFooter. Sie steuern verschiedene Dinge, und das Mischen führt zu abgeschnittenen Inhalten oder unerwarteten Überlappungen. Hier ist, was jeder von ihnen tut und wann Sie darauf zugreifen sollten.

MaxHeight

MaxHeight legt die maximale Höhe fest, die für die Kopf- oder Fußzeilenabschnitte im gerenderten PDF zugewiesen wird. IronPDF passt diese Höhe standardmäßig dynamisch an, sodass alle Kopf- oder Fußzeileninhalte passen.

Ein manuelles Verringern von MaxHeight führt dazu, dass jeder Inhalt, der den von Ihnen festgelegten Wert überschreitet, abgeschnitten oder ausgeblendet wird. Umgekehrt vergrößert ein zu großer Wert die sichtbare Kopf- oder Fußzeile nicht; IronPDF fällt auf seine Standardgröße zurück, um das Layout stabil zu halten.

Gerendertes PDF mit MaxHeight 10, bei dem der Kopfzeilentext abgeschnitten ist

Gerendertes PDF mit MaxHeight 15, bei dem der Kopfzeilentext teilweise abgeschnitten ist

Gerendertes PDF mit MaxHeight 50, das die vollständige Kopfzeile zeigt

Gerendertes PDF mit MaxHeight 100, das die gleiche Größe wie die Standardgröße anzeigt

Hinweis:: MaxHeight fügt keinen Abstand zwischen der Kopf- oder Fußzeile und dem Hauptdokumentinhalt hinzu. Es begrenzt nur die Höhe des Abschnitts.

UseMarginToHeaderAndFooter

Kopf- und Fußzeilen haben eine eigene Layout-Handhabung, die von den Inhaltsrändern, die über ChromePdfRenderOptions festgelegt wurden, getrennt ist. Für präzise Abstände definieren Sie die Ränder direkt im HTML des Header oder Footer Objekts:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
  DrawDividerLine = true,
  MaxHeight = 30
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
C#

Das Gestalten der Kopfzeile in ihrem eigenen HtmlFragment hält die Abstände vorhersehbar, da die Ränder mit dem Inhalt bestehen, auf den sie angewendet werden.

Die Eigenschaft UseMarginToHeaderAndFooter erweitert die Hauptinhaltsränder (wie links und rechts) auf die Kopf- und Fußzeilenabschnitte. Verwenden Sie es sorgfältig: Das Anwenden von vertikalen Rändern (oben und unten) auf diese Weise führt häufig zu überlappenden Inhalten und anderen Überraschungen.

  • Empfohlen: Wenden Sie es nur für die linke und rechte Randausrichtung an, wenn Sie es benötigen, oder kombinieren Sie es mit der AddHtmlHeaderFooter() Methode, wenn UseMargins.All erforderlich ist.
  • Vermeiden: Verwenden Sie es für obere und untere Ränder, es sei denn, Sie haben das resultierende Layout getestet.
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 Handbücher.

...
Weiterlesen

Bereit anzufangen?

Nuget Downloads 21,105,021Version:2026.9gerade veröffentlicht

Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

OR
bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Kundenlogos von Iron Software
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $