html2pdf Seitenumbruch in C# behoben (Entwickler-Tutorial)

IronPDF: Die C#-PDF-Bibliothek

IronPDF ist eine flexible, benutzerfreundliche, hoch anpassbare C#-PDF-Bibliothek, die es Entwicklern, Anfängern oder Veteranen ermöglicht, PDFs vollständig zu manipulieren und zu bearbeiten. Es bietet Entwicklern viele Möglichkeiten, verschiedene Formate wie HTML, RTF und Bilder in PDFs zu konvertieren und weiter zu bearbeiten, wie es beim Konvertieren in ein PDF gerendert wird. Darüber hinaus nutzt IronPDF eine Chrome-Rendering-Engine und ist somit äußerst effizient beim Rendern von HTML-Strings und ermöglicht es Entwicklern, CSS-Styling weiter anzupassen, was den Entwicklern in Bezug auf Anpassung und visuelle Darstellung Vorteile bietet, die Sie sonst nirgendwo finden werden.

Da die Bibliothek eine Chrome-Rendering-Engine verwendet, erhalten Sie beim Rendern von HTML genau das, was Sie sehen, was es ideal für Operationen wie die Erstellung von Vorlagen für Seitenumbrüche macht, sodass es keine Abweichungen von den Vorlagen gibt. Es ist genau so, wie Sie die Vorlagen entworfen haben, wenn sie in PDFs konvertiert werden.

Seitenumbruch in PDF hinzufügen

Um die Flexibilität und Benutzerfreundlichkeit der Bibliothek zu veranschaulichen, verwenden wir ein Codebeispiel, das zeigt, wie Sie Seitenumbrüche programmatisch hinzufügen würden.

In diesem Szenario verwenden wir ein tabellenbasiertes PDF als Eingabe und sehen den Unterschied zwischen dem sofortigen Hinzufügen des Seitenumbruchs und danach für visuelle Klarheit.

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

' Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
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> <!-- Ensures a page break after the table -->
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
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> <!-- Ensures a page break after the table -->
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

Imports IronPdf ' Import the IronPdf library

' Define the HTML content, including a table and an image
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> <!-- Ensures a page break after the table -->
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Create an instance of ChromePdfRenderer
Private renderer = New ChromePdfRenderer()

' Render the HTML content into a PDF
Private pdf = renderer.RenderHtmlAsPdf(html)

' Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf")

Seitenumbrüche mit CSS steuern

Da IronPDF mit CSS angepasst werden kann und eine Chrome-Rendering-Engine verwendet, können wir dies nutzen und CSS verwenden, um Seitenumbrüche zu bestimmten Elementen und Seitenumbrüche in ihnen hinzuzufügen und auch anzugeben, welches Element keinen Seitenumbruch innerhalb davon haben sollte.

Zum Beispiel, obwohl im obigen Bild der Seitenumbruch nach der Tabelle erfolgt, kann es Zeiten geben, in denen er aufgrund von Unordnung innerhalb der Tabelle auftritt.

Um dies zu vermeiden, können wir spezifische CSS-Styling für den Knoten verwenden und angeben, dass wir keinen Seitenumbruch innerhalb hinzufügen möchten.

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

Das Hinzufügen von page-break-inside: avoid verhindert Seitenumbrüche innerhalb des Elements. Wenn Sie diese Operation jedoch ausführen, stellen Sie sicher, dass dies auf den übergeordneten div-Knoten des Elements angewendet wird.

Eine ähnliche Operation kann auch für Elemente verwendet werden, bei denen Sie einen Seitenumbruch-Vorher-Stil hinzufügen möchten.

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

Da wir HTML verwenden können, können wir die Elemente der Knoten weiter spezifizieren, indem wir den HTML-Knotenbaum mit JavaScript document.getElementById durchbohren, um das Element anhand seiner ID auszuwählen und sicherzustellen, dass jeder Knoten vollständig anpassbar ist.

Bildqualität und Dateigröße optimieren

Die Seiteneinstellung für den Umbruch hängt auch eng mit der Bildqualität zusammen. Sie möchten sicherstellen, dass die Seiteneinstellung für den Umbruch die Bildqualität nicht beeinträchtigt, indem sie auf der nächsten Seite verkleinert oder skaliert wird.

Daher können wir CSS verwenden, um sicherzustellen, dass die Bildqualität über Vorlagen hinweg konsistent bleibt, wenn wir Seitenumbrüche anwenden.

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

Das obige CSS-Styling stellt sicher, dass das Bild nach Seitenumbruch-Operationen konsistent bleibt. Wir setzen zuerst die Breite auf 100% der Seite und die Höhe kann zur Beibehaltung des Seitenverhältnisses automatisch skaliert werden.

Darüber hinaus bietet IronPDF zusätzliche Rendering-Optionen beim Umgang mit HTML, die denen der Druckeinstellungen eines Benutzers für herunterladbare druckbare PDF-Eingabeaufforderungen ähneln. Eine vollständige Liste der Attribute finden Sie in der API-Dokumentation.

Gegenstück mit JavaScript

Da IronPDF den Vorteil hat, eine Chrome-Rendering-Engine zu verwenden, gibt es auch eine Node.js-Version, die es Entwicklern mit unterschiedlichem Hintergrund ermöglicht, diese leistungsstarke Bibliothek zu nutzen.

Mit der Node.js-Variante haben Entwickler noch mehr fein abgestimmte Kontrolle über das Hinzufügen von Seitenumbrüchen, da Sie Zugriff auf einsatzbasierte Nutzung und Methoden haben, wie die onRejected-Promise-Methode für Debugging- oder Fortschrittsverfolgung und deren Zwischenfunktionen.

Im Vergleich zu einer gängigen Bibliothek wie html2pdf mit ihrer jsPDF object-Ausgabemethode ist IronPDF flexibler und unterstützt mehrere Sprachen, sodass Entwickler mit unterschiedlicher Sprachkompetenz am selben Projekt arbeiten können.

Abschluss

Das Verständnis, wie man Seitenumbrüche verwendet und wie CSS das gesamte HTML beeinflusst, ist entscheidend für die Erstellung präsentabler und optisch ansprechender Dokumente für Benutzer. Es ermöglicht den Lesern, die Informationen, die sie lesen, zu trennen, um Informationsüberlastung und Verwirrung zu vermeiden. In diesem Artikel haben wir darüber gesprochen, wie die leistungsstarke Chrome-Rendering-Engine von IronPDF genutzt wird, um Vorlagen für Seitenumbrüche automatisch für Vorlagen und Automatisierung zu erstellen, die Effizienz und Skalierbarkeit beim Erstellen dieser Dokumente zu optimieren und das Risiko menschlicher Fehler zu reduzieren.

Für Entwickler, die IronPDF ausprobieren möchten, bietet die Bibliothek eine kostenlose Testversion für $799 und höhere Versionen.