html2pdf-Seitenumbruch in C# behoben (Entwickler-Tutorial)

In modernen Unternehmen sind digitale Dokumente der typische Ort für den Austausch von Informationen und visuellen Präsentationen. Es kann jedoch Zeiten geben, in denen Informationen innerhalb einer einzigen Seite so überladen werden, dass es zu einer Informationsüberflutung kommt, bei der es schwer zu erkennen ist, welcher Inhalt zum Thema gehört. Eine gängige Taktik besteht darin, Seitenumbrüche so zu strukturieren, dass der Präsentierende die Informationen klar vermitteln kann und die Leser die klar definierten Abschnitte im Dokument sehen.

Obwohlseitenumbrüchesind in Dokumenten üblich, manuelles Anpassen ist mühsam und nicht skalierbar. In Unternehmen, in denen Tausende von Dokumenten erstellt werden, ist es weitaus effizienter und idealer, Seitenumbrüche automatisch hinzuzufügen. Dies ermöglicht Entwicklern, das Format anzupassen und auf ihre ausgewählten Dokumente anzuwenden.

In diesem Artikel werden wir das Hinzufügen besprechenseitenumbrüchemit einer C# PDF-Bibliothek namens IronPDF. Die Benutzerfreundlichkeit von IronPDF ermöglicht Entwicklern, Seitenumbrüche in verschiedenen Inhaltsformen schnell einzurichten. Wir werden auch die Verwendung der Bibliothek sowie deren Anpassungs- und Flexibilitätsmöglichkeiten besprechen, um optisch ansprechende Dokumente mit Seitenumbrüchen zu erstellen.

IronPDF: Die C# PDF-Bibliothek

IronPDF ist eine flexible, benutzerfreundliche und hochgradig anpassbare C# PDF-Bibliothek, die es Entwicklern, Anfängern oder erfahrenen Programmierern ermöglicht, PDFs vollständig zu bearbeiten und zu manipulieren. Es bietet Entwicklern viele Möglichkeiten, verschiedene Formate wie HTML, RTF und Bilder in PDFs zu konvertieren und weiter zu bearbeiten, wie diese beim Konvertieren in ein PDF gerendert werden. Darüber hinaus verwendet IronPDF eine Chrome-Rendering-Engine und ist daher äußerst geschickt im Rendern von HTML-Strings. Es ermöglicht Entwicklern, …CSS-Stylingum das HTML-Dokument weiter anzupassen, wodurch Entwicklern ein Vorteil in Bezug auf Anpassung und visuelle Präsentation geboten wird, den Sie nirgendwo anders finden werden.

Da die Bibliothek eine Chrome-Rendering-Engine verwendet, entspricht das, was Sie sehen, dem, was Sie beim Rendern von HTML erhalten, was sie ideal für Vorgänge wie das Erstellen von Vorlagen für Seitenumbrüche macht, sodass es keine Abweichungen von den Vorlagen gibt. Es ist genau so, wie Sie die Vorlagen gestaltet haben, als Sie sie in PDFs konvertierten.

Seitenumbruch in PDF hinzufügen

Um die Flexibilität und Benutzerfreundlichkeit der Bibliothek zu veranschaulichen, verwenden wir ein Codebeispiel, das zeigt, wie man programmgesteuert Seitenumbrüche hinzufügt.

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

Lizenzschlüssel

Bevor wir beginnen, beachten Sie bitte, dass IronPDF einen Lizenzschlüssel für den Betrieb benötigt. Sie können einen Schlüssel als Teil einer kostenlosen Testversion erhalten, indem Sie diese Seite besuchenlink.

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

Nachdem Sie einen Testschlüssel erhalten haben, setzen Sie diese Variable in Ihrem Projekt, und Sie sind bereit.

PDF eingeben

Das folgende PDF wird als Eingabe für unsere Beispiele verwendet. Es ist eine einfache Tabelle mit Daten, die mit separaten Informationen gruppiert sind, was es schwierig macht zu unterscheiden, wo der Inhalt endet.

Codebeispielverwendung

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");

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

1. Zuerst importieren wir das `Ironpdf`-Modul in den Code.

2. Der oben gezeigte HTML-String ist identisch mit dem oben gezeigten Eingabe-PDF-Objekt. Jedoch fügen wir in diesem Fall ` hinzu

   ` als das div-Tag, um sicherzustellen, dass der Seitenumbruch nach der Tabelle erfolgt, um den Inhalt zu trennen.

3. Dann initialisieren wir den Renderer.

4. Wir übergeben den HTML-String an `RenderHtmlAsPdf`.

   5. Speichern Sie das Dokument schließlich als `Page_Break.pdf`.

   Die gängigere Methode ist die Verwendung von CSS, da dies als veraltete Methode angesehen werden kann, um mit HTML Seitenumbrüche in das Inline-Styling einzufügen.

Ausgabe PDF

Wie Sie sehen, erfolgt der Seitenumbruch direkt nach der Tabelle.

Seitenumbrüche mit CSS steuern

Da IronPDF mit CSS angepasst werden kann und es eine Chrome-Render-Engine verwendet, können wir dies nutzen, um CSS zu verwenden, um Seitenumbrüche zu bestimmten Elementen und auch innerhalb dieser hinzuzufügen, sowie anzugeben, welches Element keinen Seitenumbruch enthalten sollte.

Zum Beispiel, obwohl im obigen Bild der Seitenumbruch nach der Tabelle erfolgt, kann es vorkommen, dass er aufgrund von Unordnung innerhalb der Tabelle auftritt.

Um dies zu vermeiden, können wir ein spezifisches 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>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<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. Stellen Sie jedoch bei dieser Operation sicher, dass dies auf den übergeordneten div-Knoten des Elements angewendet wird.

Ein ähnlicher Vorgang kann auch für Elemente verwendet werden, für die Sie das page-break-before spezifizieren 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>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<div style="page-break-inside: avoid;"> <img src="no-break-me.png"> </div>

Da wir HTML nutzen können, können wir die Elemente der Knoten weiter spezifizieren, indem wir die HTML-Knotenstruktur mit Javascript und document.getElementById durchlaufen oder das vertraute `var element document getelementbyid` verwenden, um das Element anhand seiner ID auszuwählen und sicherzustellen, dass jeder Knoten vollständig anpassbar ist.

Optimierung der Bildqualität und Dateigröße

Die Einstellung des Seitenumbruchs steht auch in engem Zusammenhang mit der Bildqualität. Sie möchten sicherstellen, dass die Seiteneinstellung den nächsten Bild nicht in der Qualität beeinträchtigt, indem es verkleinert oder skaliert wird.

Daher können wir auch CSS verwenden, um sicherzustellen, dass die Bildqualität in den Vorlagen einheitlich ist, wenn wir Seitenumbrüche anwenden.

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

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

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<div class="no-break"> <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;" type="image/jpeg" quality="80" compression="high"> </div>

Die obenstehende CSS-Stilgestaltung stellt sicher, dass das Bild nach Seitenumbruch-Operationen konsistent bleibt. Wir setzen zunächst die Breite auf 100% der Seite. Die Höhe kann automatisch skaliert werden. Wir garantieren, dass die Qualität bei 80 liegt, wenn `image.compression` auf hoch eingestellt ist, um einen minimalen Qualitätsverlust zu gewährleisten. Dies gilt insbesondere für die PNG-Bildkomprimierung, und durch das Hinzufügen dieser Eigenschaft wird auch die PNG-Bildkomprimierung aktiviert.

Darüber hinaus bietet IronPDF zusätzliche Rendering-Optionen beim Rendern von HTML. Die Optionen ähneln denen, wenn ein Benutzer auf die druckbare PDF-Aufforderung klickt und es einen Benutzerdownload-Prompt für das PDF mit den Druckeinstellungen erstellt. Für eine vollständige Liste der Attribute, beachten Sie bitte dieAPI-Dokumentation.

Gegenstück mit JavaScript

SeitIronPDFhat den Vorteil, eine Chrome-Rendering-Engine zu verwenden, und bietet auch den Vorteil, mit einer Node.js-Version zu kommen, die es Entwicklern aus verschiedenen Bereichen ermöglicht, diese leistungsstarke Bibliothek zu nutzen.

Mit der Node.js-Variante haben Entwickler noch feinere Kontrolle über das Hinzufügen von Seitenumbrüchen, da sie Zugriff auf die auf Versprechen basierende Nutzung und Methoden wie die `onrejected true promise method` für Debugging oder Fortschrittsverfolgung sowie eigene Zwischenfunktionen haben.

Verglichen mit einer gängigen Bibliothek wiehtml2pdfmit der Ausgabemethode des jsPDF-Objekts ist IronPDF flexibler und unterstützt mehrere Sprachen, was es Entwicklern mit unterschiedlichem Sprachwissen ermöglicht, am selben Projekt zu arbeiten.

Schlussfolgerung

Das Verständnis, wie Seitenumbrüche verwendet werden und wie CSS das gesamte HTML beeinflusst, ist entscheidend für die Erstellung von präsentablen und visuell ansprechenden Dokumenten für Benutzer. Es ermöglicht Lesern, die Informationen, die sie lesen, zu trennen, um Informationsüberlastung und Verwirrung zu vermeiden. Im gesamten Artikel; Wir sprachen darüber, die leistungsstarke Chrome-Rendering-Engine zu nutzen, die IronPDF verwendet, um Seitenumbruch-Vorlagen automatisch für Vorlagen und Automatisierung zu erstellen, wodurch die Effizienz und Skalierbarkeit bei der Erstellung dieser Dokumente optimiert werden und die Anfälligkeit für menschliche Fehler verringert wird.

Für Entwickler, die IronPDF ausprobieren möchten, bietet die Bibliothek einkostenloser Testfür $749 und höher.