1. IronPDF
  2. Anleitungen
  3. Benutzerdefinierte Papiergröße
Wie man benutzerdefinierte Papierformate für PDFs mit C# setzt | IronPDF

Wie man PDFs mit benutzerdefinierter Papiergröße in C# rendert

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

Mit IronPDF können Sie in C# PDFs mit benutzerdefinierten Papierformaten rendern, indem Sie die ChromePdfRenderer- Klasse verwenden und bestimmte Abmessungen über Methoden wie SetCustomPaperSizeInInches() festlegen. Dies ermöglicht eine präzise Kontrolle über die Dokumentabmessungen für spezielle Layouts wie Poster oder Banner.

Eine benutzerdefinierte Papiergröße bezieht sich auf eine nicht standardmäßige Papiergröße, die vom Benutzer definiert wird, anstatt eine Standardgröße wie A4 oder Briefgröße (8,5 x 11 Zoll) zu sein. Benutzerdefinierte Papiergrößen werden häufig beim Drucken von Dokumenten verwendet, die ein einzigartiges oder spezifisches Layout erfordern, wie zum Beispiel Poster, Banner oder spezielle Dokumente. Diese Flexibilität ist bei HTML-zu-PDF-Konvertierung-Projekten, die bestimmte Abmessungen erfordern, unverzichtbar.

IronPDF bietet eine umfangreiche Auswahl an Papierformaten, um allen Anforderungen gerecht zu werden.

Schnellstart: Benutzerdefinierte Papierformate in IronPDF definieren

In diesem kurzen Leitfaden erfahren Sie, wie Sie mit IronPDF benutzerdefinierte Papiergrößen in nur wenigen Codezeilen einstellen. Mit IronPDF können Sie die PDF-Dimensionen problemlos anpassen, indem Sie genaue Breiten- und Höhenmaße in jeder bevorzugten Einheit angeben. Diese Flexibilität eignet sich ideal zum Erstellen von Dokumenten mit einzigartigen Layoutanforderungen, wie zum Beispiel Postern oder Bannern. Beginnen Sie mit dem Herunterladen der IronPDF-Bibliothek über NuGet und folgen Sie diesem Beispiel, um die gewünschte Papiergröße mühelos einzustellen.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } };
renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7);
renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf")

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Herunterladen von IronPDF von NuGet zum Einstellen von benutzerdefinierten Papiergrößen in PDFs
  2. Instanziieren Sie die ChromePdfRenderer-Klasse in C#
  3. Greifen Sie auf die RenderingOptions im neuen Objekt zu
  4. Aufrufen einer der Methoden `SetCustomPaperSize` auf der Grundlage der Maßeinheit
  5. Rendern und exportieren Sie das PDF-Dokument


Wie verwende ich Standardpapierformate?

Zuerst wird eine Instanz der Klasse ChromePdfRenderer erstellt. Verwenden Sie anschließend die RenderingOptions-Eigenschaft des neu erstellten Objekts, um die PaperSize-Eigenschaft zu ändern. Wählen Sie einen der vordefinierten Werte aus dem Enum PdfPaperSize, um das gewünschte Papierformat festzulegen. Wir bieten Ihnen über 100 vordefinierte Standardpapierformate.

Bei der Arbeit mit PDF-Rendering-Optionen bietet IronPDF umfassende Kontrolle darüber, wie Ihre Dokumente formatiert werden. Die Standard-Papierformate umfassen gängige Formate wie A4, Letter, Legal und viele internationale Standards.

Welche Standard-Papierformate sind verfügbar?

Beispiel zur Festlegung einer Standardpapiergröße:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs
using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");
Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>")

pdf.SaveAs("standardPaperSize.pdf")
$vbLabelText   $csharpLabel

IronPDF unterstützt eine umfangreiche Sammlung von Standardpapierformaten, darunter:

  • ISO 216 Serie: A0 bis A10, B0 bis B10
  • Nordamerikanisch: Letter, Legal, Tabloid, Executive
  • Architektonisch: ANSI A bis E
  • Japanisch: JIS B0 bis B10
  • Umschlaggrößen: Verschiedene internationale Umschlagnormen

Eine vollständige Liste der verfügbaren Papierformate und ihrer Abmessungen finden Sie in der API-Referenzdokumentation.

Welche Eigenschaften steuern die Papiergröße?

  • PaperSize: Legen Sie ein Ausgabepapierformat für PDF-Seiten mit vordefinierten Größen wie Letter, A3, A4 usw. fest.
  • ForcePaperSize: Erzwingt, dass die Seitengrößen genau dem entsprechen, was über IronPdf.ChromePdfRenderOptions.PaperSize angegeben ist, indem die Seite nach der Generierung eines PDFs aus HTML angepasst wird. Diese Funktion ist nützlich, um CSS-Regeln zu umgehen, die die Papiergröße angeben.

Wenn Sie diese Eigenschaften in Verbindung mit Benutzerdefinierte Ränder verwenden, können Sie Ihr PDF-Layout präzise steuern.

Wie erhalte ich Standardpapiergrößen in verschiedenen Einheiten?

Müssen Sie die Abmessungen von Standardpapiergrößen finden? Dies können Sie ganz einfach mit der Methode ToMillimeters tun. Diese Methode gibt ein Tupel zurück, das die Breite und Höhe des Standardpapierformats als Length Objekte enthält. Die Klasse Length ist unglaublich vielseitig und ermöglicht es Ihnen, diese Abmessungen mühelos in eine Vielzahl von Einheiten umzurechnen, darunter:

  • Millimeter
  • Zentimeter
  • Inches
  • Pixels
  • Punkte
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.cs
using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();
Imports IronPdf.Rendering

Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()
$vbLabelText   $csharpLabel

Diese Funktionalität ist besonders nützlich bei der Integration mit CSS responsive layouts oder wenn Sie genaue Abmessungen für benutzerdefinierte Layouts berechnen müssen.

Wie erstelle ich individuelle Papierformate?

Zuerst instanziieren wir die Klasse ChromePdfRenderer. Über das neu erstellte Objekt können wir auf RenderingOptions zugreifen, um dem neu generierten PDF-Dokument ein benutzerdefiniertes Papierformat zuzuweisen. Es gibt vier Methoden, die verwendet werden können, um die Ausgabepapiergröße für PDF-Seiten festzulegen, basierend auf unterschiedlichen Maßeinheiten:

  • SetCustomPaperSizeInCentimeters: Die Abmessungen befinden sich in centimeters.
  • SetCustomPaperSizeInInches: Die Abmessungen befinden sich in inches.
  • SetCustomPaperSizeInMillimeters: Die Abmessungen befinden sich in millimeters.
  • SetCustomPaperSizeInPixelsOrPoints: Die Abmessungen sind in pixels or points angegeben.

Bei der Erstellung von benutzerdefinierten Papierformaten ist es wichtig zu bedenken, wie sie mit Kopf- und Fußzeilen sowie Seitenausrichtungseinstellungen interagieren werden.

Welche Einheiten kann ich für benutzerdefinierte Abmessungen verwenden?

Beispiel zur Festlegung einer benutzerdefinierten Papiergröße in cm:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")

pdf.SaveAs("customPaperSize.pdf")
$vbLabelText   $csharpLabel

Hier finden Sie weitere Beispiele für jede Maßeinheit:

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
' Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5)

' Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420) ' A3 size

' Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96) ' 96 DPI
$vbLabelText   $csharpLabel

Wenn Sie mit benutzerdefinierten Größen arbeiten, sollten Sie auch die Ansichtsfenster- und Zoom-Einstellungen prüfen, um sicherzustellen, dass Ihr Inhalt richtig in die benutzerdefinierten Abmessungen passt.

Wie ändere ich die Papierabmessungen?

In einem bestehenden oder neu gerenderten PDF-Dokument kann die Größe jeder Seite mithilfe der Methode ExtendPage geändert werden. Diese Methode ermöglicht die Angabe des Zielseitenindex, der Erweiterungswerte für jede der vier Seiten sowie der Maßeinheit. Negative Werte verkleinern die jeweilige Seite, positive Werte vergrößern sie.

Diese Funktion ist besonders nützlich, wenn PDFs nach ihrer Erstellung angepasst werden müssen — z. B. beim Zusammenführen mehrerer PDFs mit unterschiedlichen Seitengrößen oder bei der Druckvorbereitung von Dokumenten.

Welche Parameter akzeptiert ExtendPage?

Die Methode ExtendPage akzeptiert die folgenden Parameter:

  • Seitenindex: Der nullbasierte Index der zu ändernden Seite
  • Linke Erweiterung: Betrag zur Erweiterung/Verkleinerung der linken Seite
  • Rechte Erweiterung: Betrag zur Erweiterung/Verkleinerung der rechten Seite
  • Erweiterung oben: Betrag zum Erweitern/Verkleinern der Oberseite
  • Bodenverlängerung: Betrag zur Erweiterung/Verkleinerung der Unterseite
  • Maßeinheit : Die Maßeinheit (millimeters, inches, etc.)

Nachfolgend finden Sie ein Beispiel, wie man die Papierabmessungen ändert:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.cs
using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)

pdf.SaveAs("extendedLeftSide.pdf")
$vbLabelText   $csharpLabel

Hier ist ein umfassenderes Beispiel mit verschiedenen Seitenänderungen:

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
' Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter)

' Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter)

' Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter)

' Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch)
$vbLabelText   $csharpLabel

Best Practices für benutzerdefinierte Papierformate

Beachten Sie bei der Arbeit mit benutzerdefinierten Papierformaten in IronPDF die folgenden Best Practices:

  1. Testen Sie verschiedene Einheiten: Testen Sie bei der Arbeit mit benutzerdefinierten Größen, welche Maßeinheit für Ihren Anwendungsfall am besten geeignet ist. Pixel eignen sich hervorragend für bildschirmbasierte Layouts, während Millimeter oder Zoll für den Druck besser geeignet sind.

  2. Berücksichtigen Sie die Druckränder: Wenn Sie PDFs für den Druck erstellen, sollten Sie die Druckränder berücksichtigen. Die meisten Drucker können nicht bis an den Rand des Papiers drucken.

  3. Responsives Design: Achten Sie bei der Konvertierung von HTML in PDF darauf, dass Ihr HTML die Prinzipien des Responsive Design verwendet, um sich an unterschiedliche Papiergrößen anzupassen.

  4. Leistungsoptimierung: Sehr große benutzerdefinierte Papierformate können die Leistung beeinträchtigen. Erwägen Sie die Verwendung von Komprimierung für große Dokumente.

  5. Kompatibilität: Testen Sie Ihre PDF-Dateien in verschiedenen PDF-Viewern, um die Kompatibilität zu gewährleisten, insbesondere wenn Sie nicht standardisierte Abmessungen verwenden.

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich hier unsere Tutorial-Seite an: PDFs erstellen

Häufig gestellte Fragen

Wie kann ich in C# benutzerdefinierte Papierformate für PDF-Dokumente festlegen?

Mit IronPDF können Sie mithilfe der ChromePdfRenderer-Klasse benutzerdefinierte Papiergrößen festlegen. Setzen Sie einfach die Eigenschaft PaperSize in den RenderingOptions auf PdfPaperSize.Custom und verwenden Sie dann Methoden wie SetCustomPaperSizeInInches(), um Ihre spezifischen Abmessungen zu definieren. Zum Beispiel: renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).

Welche Maßeinheiten kann ich für benutzerdefinierte Papierformate verwenden?

IronPDF unterstützt mehrere Maßeinheiten für benutzerdefinierte Papiergrößen durch verschiedene SetCustomPaperSize-Methoden. Sie können Abmessungen in Zoll, Zentimetern, Millimetern oder Pixeln angeben und sind damit flexibel für verschiedene internationale Standards und Projektanforderungen.

Wann sollte ich benutzerdefinierte Papierformate anstelle von Standardformaten verwenden?

Benutzerdefinierte Papierformate in IronPDF sind ideal für die Erstellung von PDFs mit einzigartigen Layouts wie Postern, Bannern, speziellen Dokumenten oder anderen Designs, die nicht in Standardformate wie A4 oder Letter passen. Diese Flexibilität ist besonders nützlich für HTML-zu-PDF-Konvertierungsprojekte, die bestimmte Abmessungen erfordern.

Wie viele vordefinierte Standard-Papierformate gibt es?

IronPDF bietet über 100 vordefinierte Standard-Papierformate durch die PdfPaperSize-Aufzählung, einschließlich häufig verwendeter Formate wie A4, Letter, Legal und vieler internationaler Standards, was umfassende Optionen für die meisten Dokumentanforderungen bietet.

Was sind die Schritte zur Implementierung benutzerdefinierter Papierformate?

So implementieren Sie benutzerdefinierte Papierformate mit IronPDF: 1) Laden Sie IronPDF über NuGet herunter, 2) erstellen Sie eine ChromePdfRenderer-Instanz, 3) greifen Sie auf die Eigenschaft RenderingOptions zu, 4) rufen Sie eine SetCustomPaperSize-Methode mit den gewünschten Abmessungen auf und 5) rendern und speichern Sie Ihr PDF-Dokument.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
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 18,560,885 | Version: 2026.4 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.