Wie man HTML zu PDF-Umbrüche mit C# verwaltet

Add or Avoid Page Breaks in HTML PDFs

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

IronPDF unterstützt Seitenumbrüche innerhalb von PDF-Dokumenten. Ein wesentlicher Unterschied zwischen PDF-Dokumenten und HTML besteht darin, dass HTML-Dokumente tendenziell scrollen, während PDFs mehrseitig sind und gedruckt werden können.

als-Überschrift:2(Schnellstart: Implementierung von Seitenumbrüchen in HTML-zu-PDF-Konvertierung)

Konvertieren Sie mühelos HTML in PDF mit Seitenumbrüchen mit IronPDF. Dieses Beispiel zeigt, wie Sie nach spezifischem HTML-Inhalt einen Seitenumbruch einfügen, um eine ordnungsgemäße Paginierung sicherzustellen. Durch das Hinzufügen des Stils page-break-after: always; können Entwickler steuern, wo Seitenumbrüche auftreten, wodurch die Lesbarkeit und Organisation des resultierenden PDF-Dokuments verbessert wird. Perfekt für diejenigen, die eine schnelle, effiziente PDF-Erstellung aus HTML-Inhalten benötigen.

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()
      .RenderHtmlAsPdf("<html><body><h1>Hello World!</h1><div style='page-break-after: always;'></div></body></html>")
      .SaveAs("pageWithBreaks.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Arbeitsablauf (5 Schritte)

Wie man Seitenumbrüche in HTML-PDFs verwendet
  1. Laden Sie die C#-Bibliothek herunter, um Seitenumbrüche in PDF zu verwenden
  2. Seitenumbrüche auf HTML-String anwenden und in PDF konvertieren
  3. Setzen Sie avoid auf das page-break-inside-Attribut, um Seitenumbrüche in Bildern zu vermeiden
  4. Machen Sie dasselbe für Tabellen, um dort Seitenumbrüche zu vermeiden
  5. Stil auf der CSS-Ebene festlegen


Seitenumbruch hinzufügen

Um einen Seitenumbruch in HTML zu erstellen, können Sie dies in Ihrem HTML-Code verwenden:

<div style="page-break-after: always;"></div>
<div style="page-break-after: always;"></div>
HTML

Demonstration des Erstellens eines Seitenumbruchs

In diesem Beispiel habe ich die folgende Tabelle und das Bild in meinem HTML, und ich möchte, dass sie auf zwei separaten Seiten sind, indem ich einen Seitenumbruch nach der Tabelle hinzufüge.

Tabelle

<table style="border: 1px solid #000000">
  <tr>
    <th>Company</th>
    <th>Product</th>
  </tr>
  <tr>
    <td>Iron Software</td>
    <td>IronPDF</td>
  </tr>
  <tr>
    <td>Iron Software</td>
    <td>IronOCR</td>
  </tr>
</table>
<table style="border: 1px solid #000000">
  <tr>
    <th>Company</th>
    <th>Product</th>
  </tr>
  <tr>
    <td>Iron Software</td>
    <td>IronPDF</td>
  </tr>
  <tr>
    <td>Iron Software</td>
    <td>IronOCR</td>
  </tr>
</table>
HTML

Bild

<img src="/static-assets/pdf/how-to/html-to-pdf-page-breaks/ironpdf-logo-text-dotnet.svg" style="border:5px solid #000000; padding:3px; margin:5px" />
<img src="/static-assets/pdf/how-to/html-to-pdf-page-breaks/ironpdf-logo-text-dotnet.svg" style="border:5px solid #000000; padding:3px; margin:5px" />
HTML
:path=/static-assets/pdf/content-code-examples/how-to/html-to-pdf-page-breaks-page-break.cs
using IronPdf;

const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>

  <div style='page-break-after: always;'> </div>

  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

var renderer = new ChromePdfRenderer();

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("Page_Break.pdf");
Imports IronPdf

Private Const html As String = "
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>

  <div style='page-break-after: always;'> </div>

  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>"

Private renderer = New ChromePdfRenderer()

Private pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("Page_Break.pdf")
$vbLabelText   $csharpLabel

Und der obige Code generiert das untenstehende PDF, das 2 Seiten enthält: die Tabelle auf der ersten Seite und das Bild auf der zweiten:

Vermeidung von Seitenumbrüchen in Bildern

Um einen Seitenumbruch innerhalb eines Bildes oder einer Tabelle zu vermeiden, können Sie das CSS-Attribut page-break-inside auf ein umschließendes DIV-Element anwenden.

<div style="page-break-inside: avoid">
    <img src="no-break-me.png" />
</div>
<div style="page-break-inside: avoid">
    <img src="no-break-me.png" />
</div>
HTML

Vermeidung von Seitenumbrüchen in Tabellen

Wie oben gezeigt, können Seitenumbrüche innerhalb von Tabellen vermieden werden, indem das CSS page-break-inside: avoid verwendet wird. Dies wird besser auf ein umschließendes DIV angewendet als auf die Tabelle selbst, um sicherzustellen, dass der Stil auf einen block-level HTML-Knoten angewendet wird.

Um Tabellenüberschriften und -fußzeilen auf jeder Seite einer großen HTML-Tabelle, die sich über mehrere PDF-Seiten erstreckt, zu duplizieren, können Sie eine <thead>-Gruppe innerhalb der Tabelle verwenden:

<thead>
    <tr>
        <th>C Sharp</th><th>VB</th>
    </tr>
</thead>
<thead>
    <tr>
        <th>C Sharp</th><th>VB</th>
    </tr>
</thead>
HTML

Erweiterte CSS3-Einstellungen

Um mehr Kontrolle zu bieten, möchten Sie möglicherweise CSS3 zusätzlich zu Ihrer thead-Gruppe verwenden:

<style type="text/css">
    table { page-break-inside:auto }
    tr { page-break-inside:avoid; page-break-after:auto }
    thead { display:table-header-group }
    tfoot { display:table-footer-group }
</style>
<style type="text/css">
    table { page-break-inside:auto }
    tr { page-break-inside:avoid; page-break-after:auto }
    thead { display:table-header-group }
    tfoot { display:table-footer-group }
</style>
HTML

Häufig gestellte Fragen

Wie kann ich einen Seitenumbruch hinzufügen, wenn ich HTML in PDF umwandle?

Um einen Seitenumbruch hinzuzufügen, wenn Sie HTML in PDF konvertieren, können Sie ein <div style='page-break-after: always;'></div> in Ihrem HTML-Code einfügen. Dies stellt sicher, dass der Inhalt nach dem Div auf einer neuen Seite beginnt, wenn Sie IronPDF verwenden.

Wie verhindere ich Seitenumbrüche innerhalb eines Bildes bei der PDF-Konvertierung?

Um Seitenumbrüche innerhalb eines Bildes während der PDF-Konvertierung zu verhindern, umwickeln Sie das Bild mit einem <div style='page-break-inside: avoid'> mit IronPDF. Dieser CSS-Stil stellt sicher, dass das Bild nicht über Seiten verteilt wird.

Wie vermeide ich am besten Seitenumbrüche in HTML-Tabellen, wenn ich PDFs erstelle?

Um Seitenumbrüche in HTML-Tabellen während der PDF-Erstellung zu vermeiden, wenden Sie das CSS page-break-inside: avoid auf ein umschließendes <div> Element an. Dies stellt sicher, dass die Tabelle auf der Seite intakt bleibt, wenn Sie IronPDF verwenden.

Wie stelle ich sicher, dass Tabellenüberschriften in PDFs auf jeder Seite wiederholt werden?

Um sicherzustellen, dass Tabellenüberschriften auf jeder Seite eines PDFs wiederholt werden, verwenden Sie ein <thead> Element in Ihrer HTML-Tabelle. Dadurch kann IronPDF Header über mehrere Seiten hinweg duplizieren.

Welche CSS-Einstellungen können Seitenumbrüche in PDF-Dokumenten steuern?

Erweiterte CSS-Einstellungen zur Steuerung von Seitenumbrüchen in PDFs umfassen die Verwendung von page-break-inside: auto für Tabellen, page-break-inside: avoid; page-break-after: auto für Zeilen und die Einstellung display: table-header-group für <thead> und display: table-footer-group für <tfoot> bei der Verwendung von IronPDF.

Wie unterscheidet sich HTML von PDF in Bezug auf das Seitenlayout?

HTML-Dokumente scrollen in der Regel kontinuierlich, während PDFs als mehrseitige Dokumente strukturiert sind, die eine ordnungsgemäße Paginierung erfordern. Dies wird effektiv mit IronPDF verwaltet.

Welche Bibliothek kann dabei helfen, Seitenumbrüche in PDFs über C# hinzuzufügen?

IronPDF ist eine C#-Bibliothek, die verwendet werden kann, um Seitenumbrüche bei der Umwandlung von HTML in PDF zu verwalten. Sie bietet verschiedene Einstellungen zur effizienten Handhabung von Seitenumbrüchen.

Wird das CSS für Seitenumbrüche von IronPDF in .NET 10-Projekten vollständig unterstützt?

Ja – IronPDF ist vollständig mit .NET 10 kompatibel, und seine HTML-zu-PDF-Seitenumbruchfunktionen (wie z. B. page-break-after: always und page-break-inside: avoid ) funktionieren in .NET-10-Umgebungen sofort. Sie können die Bibliothek über NuGet in einem .NET-10-Projekt installieren und dieselben CSS-basierten Seitenumbruchregeln ohne Änderungen verwenden.

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