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#35 rendert

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

IronPDF ermöglicht das Rendern von PDFs mit benutzerdefinierten Papiergrößen in C#, indem die ChromePdfRenderer-Klasse verwendet wird und bestimmte Abmessungen durch Methoden wie SetCustomPaperSizeInInches() festgelegt werden.

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 der Arbeit mit HTML-zu-PDF-Konvertierung-Projekten, die bestimmte Abmessungen erfordern, unerlässlich.

Entdecken Sie die umfangreiche Auswahl an Papiergrößen, die mit IronPDF verfügbar sind, und eine große Auswahl bietet, um Ihren Bedürfnissen gerecht zu werden!

als-überschrift:2(Schnellstart: Definieren benutzerdefinierter Papiergrößen in IronPDF)

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.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    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 mit der Nutzung von IronPDF in Ihrem Projekt – 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?

Erstellen Sie zuerst eine Instanz der ChromePdfRenderer-Klasse. Verwenden Sie dann die RenderingOptions-Eigenschaft des neu erstellten Objekts, um die PaperSize zu ändern. Stellen Sie es auf einen der vordefinierten Werte aus dem PdfPaperSize-Enum ein, um die gewünschte Papiergröße festzulegen. Wir bieten über 100 vordefinierte standardisierte Papiergrößen für Ihre Bequemlichkeit an.

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");
$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: Legt eine Ausgabegröße für PDF-Seiten mit vordefinierten Formaten wie Letter, A3, A4, etc. fest.
  • ForcePaperSize: Erzwingt die exakte Anpassung der Seitengröße an die IronPdf.ChromePdfRenderOptions.PaperSize, indem die Größe der Seite nach der Erzeugung 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? Sie können dies einfach mit der ToMillimeters-Methode tun. Diese Methode gibt ein Tupel zurück, das die Breite und Höhe der Standardpapiergröße als Length-Objekte enthält. Die Klasse Length ist unglaublich vielseitig und ermöglicht es Ihnen, diese Dimensionen mühelos in eine Vielzahl von Einheiten zu konvertieren, 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();
$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 beginnen wir mit der Instanziierung der ChromePdfRenderer-Klasse. Von dem neu erstellten Objekt aus können wir auf die RenderingOptions zugreifen, um eine benutzerdefinierte Papiergröße auf das neu generierte PDF-Dokument anzuwenden. Es gibt vier Methoden, die verwendet werden können, um die Ausgabepapiergröße für PDF-Seiten festzulegen, basierend auf unterschiedlichen Maßeinheiten:

  • SetCustomPaperSizeInCentimeters: Abmessungen in Zentimetern.
  • SetCustomPaperSizeInInches: Abmessungen in Inch.
  • SetCustomPaperSizeInMillimeters: Abmessungen in Millimetern.
  • SetCustomPaperSizeInPixelsOrPoints: Abmessungen in Pixel oder Punkte.

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");
$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
$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 kann ich die Papierabmessungen ändern?

In einem vorhandenen PDF-Dokument oder einem frisch erstellten PDF kann die Größe jeder Seite mit der ExtendPage-Methode geändert werden. Diese Methode ermöglicht es Ihnen, den Zielseitenindex, die Werte, um jede der vier Seiten zu ändern, und die Maßeinheiten anzugeben. Die Werte für jede Seite können negativ sein, was diese bestimmte Seite verkürzt, oder positiv, was diese Seite erweitert.

Diese Funktion ist besonders nützlich, wenn Sie PDFs nach ihrer Erstellung anpassen müssen, z. B. beim Zusammenführen mehrerer PDFs mit unterschiedlichen Seitengrößen oder bei der Vorbereitung von Dokumenten für den Druck.

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 (Millimeter, Zoll, 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");
$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);
$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 17,012,929 | Version: 2025.12 gerade veröffentlicht