1. IronPDF
  2. Anleitungen
  3. Benutzerdefinierte Ränder festlegen

Benutzerdefinierte Ränder festlegen

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

von Jordi Bardia

Bei der Arbeit mit PDFs oder anderen Dokumenttypen ist es oft notwendig, die Ränder anzugeben, um unterschiedliche Standards einzuhalten. Die Formate MLA und APA verlangen beispielsweise beide ein 1-Zoll-Format, während einige Universitäten für Dissertationen 1,5-Zoll-Ränder vorschreiben können.

IronPDF macht es einfach, benutzerdefinierte Ränder festzulegen, wenn ein PDF aus HTML gerendert wird - es ist nur eine einfache Konfiguration erforderlich.

Benutzerdefinierte Ränder festlegen

  1. Laden Sie die C#-Bibliothek zum Festlegen benutzerdefinierter Ränder herunter
  2. Instanziieren Sie die ChromePdfRenderer klasse zum Rendern von PDF-Dateien
  3. Ändern Sie die Randwerte im Chrome Renderer's RenderingOptions
  4. Benutzerdefinierte Ränder in Kopf- und Fußzeilen festlegen
  5. Rendering des HTML in PDF und Speichern des Dokuments


C# NuGet-Bibliothek für PDF

Installieren mit NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
oder
Java PDF JAR

Herunterladen DLL

DLL herunterladen

Manuelle Installation in Ihr Projekt

C# NuGet-Bibliothek für PDF

Installieren mit NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
oder
Java PDF JAR

Herunterladen DLL

DLL herunterladen

Manuelle Installation in Ihr Projekt

Fangen Sie noch heute an, IronPDF in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden.

Erster Schritt:
green arrow pointer

Schau dir an IronPDF an Nuget Für schnelle Installation und Bereitstellung. Mit über 8 Millionen Downloads verwandelt es PDF mit C#.

C# NuGet-Bibliothek für PDF nuget.org/packages/IronPdf/ 
Install-Package IronPdf

Erwägen Sie die Installation der IronPDF DLL direkt. Laden Sie es herunter und installieren Sie es manuell für Ihr Projekt oder die GAC-Form: IronPdf.zip

Manuelle Installation in Ihr Projekt

DLL herunterladen

Benutzerdefinierte Marge festlegen Beispiel

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

: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
VB   C#

Beachten Sie, dass dies zu den Rändern hinzufügt, die im Abschnitt style der HTML-Datei festgelegt sind. Im nachstehenden Beispiel sind die Ränder in der HTML-Datei zunächst auf 50 mm eingestellt, aber durch die Einstellung der Ränder für jede Seite in RenderingOptions werden die Ränder um weitere 30 mm erhöht, so dass sie 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")
VB   C#

Die resultierende PDF-Datei ist unten abgebildet:

Benutzerdefinierten Rand in Kopfzeile/Fußzeile festlegen

Standardmäßig werden die in RenderingOptions festgelegten Ränder nicht auf Kopf- und Fußzeilen im Dokument angewendet. Um die gleichen benutzerdefinierten Ränder des Dokuments in den Kopf- und Fußzeilen festzulegen, konfigurieren Sie die Eigenschaft UseMarginsOnHeaderAndFooter in 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
VB   C#

Sie können festlegen, welche Ränder in der Kopf- und Fußzeile gesetzt werden sollen. Eine vollständige Liste der Enums für die Einstellung von Rändern in Kopf- und Fußzeilen finden Sie in unsererAPI-Referenz. Nachfolgend sind einige Beispiele für die Festlegung der Ränder zu sehen:

: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
VB   C#

Jordi Bardia

Software-Ingenieur

Jordi beherrscht vor allem Python, C# und C++. Wenn er seine Fähigkeiten bei Iron Software nicht einsetzt, programmiert er Spiele. Durch seine Mitverantwortung für Produkttests, Produktentwicklung und Forschung trägt Jordi wesentlich zur kontinuierlichen Produktverbesserung bei. Die vielseitigen Erfahrungen, die er sammelt, bieten ihm immer wieder neue Herausforderungen, und er sagt, dass dies einer seiner Lieblingsaspekte bei Iron Software ist. Jordi wuchs in Miami, Florida, auf und studierte Informatik und Statistik an der University of Florida.