1. IronPDF
  2. Poradniki
  3. Niestandardowy rozmiar papieru
Jak ustawić niestandardowe rozmiary papieru dla plików PDF przy użyciu języka C# | IronPDF

Jak renderować pliki PDF z niestandardowym rozmiarem papieru w C

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

IronPDF umożliwia renderowanie plików PDF z niestandardowymi rozmiarami papieru w C# przy użyciu klasy ChromePdfRenderer oraz ustawianiu precyzyjnych wymiarów za pomocą metod takich jak SetCustomPaperSizeInInches(), co pozwala na precyzyjne sterowanie wymiarami dokumentu dla specjalnych układów, takich jak plakaty czy banery.

Niestandardowy rozmiar papieru odnosi się do niestandardowego rozmiaru papieru, który jest definiowany przez użytkownika, a nie jako standardowy rozmiar, taki jak A4 lub rozmiar litery (8.5 x 11 cali). Niestandardowe rozmiary papieru są często używane podczas drukowania dokumentów wymagających unikalnego lub specyficznego układu, takich jak plakaty, banery lub specjalne dokumenty. Ta elastyczność jest niezbędna podczas pracy nad projektami konwersji HTML na PDF, które wymagają określonych wymiarów.

Odkryj szeroką gamę dostępnych rozmiarów papieru z IronPDF, oferując szeroki wybór, aby sprostać Twoim potrzebom!

Quickstart: Zdefiniuj niestandardowe rozmiary papieru w IronPDF

W tym szybkim przewodniku dowiesz się, jak ustawić niestandardowe rozmiary papieru za pomocą IronPDF w zaledwie kilku liniach kodu. Dzięki IronPDF możesz łatwo dostosować wymiary PDF, definiując dokładne szerokości i wysokości w dowolnej preferowanej jednostce. Ta elastyczność jest idealna do tworzenia dokumentów z unikalnymi wymaganiami układu, takich jak plakaty czy banery. Zacznij, pobierając bibliotekę IronPDF przez NuGet i postępuj zgodnie z tym przykładem, aby bez wysiłku ustawić pożądany rozmiar papieru.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

    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. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Pobierz IronPDF z NuGet, aby ustawić niestandardowe rozmiary papieru w plikach PDF
  2. Utwórz instancję klasy ChromePdfRenderer w języku C#
  3. Uzyskaj dostęp do RenderingOptions na nowym obiekcie
  4. Wywołaj jedną z metod SetCustomPaperSize w oparciu o jednostkę miary
  5. Renderuj i eksportuj dokument PDF


Jak korzystać ze standardowych rozmiarów papieru?

Najpierw stwórz instancję klasy ChromePdfRenderer. Następnie użyj właściwości RenderingOptions nowo utworzonego obiektu, aby zmodyfikować PaperSize. Ustaw ją na jedną z wstępnie zdefiniowanych wartości z enuma PdfPaperSize, aby określić pożądany rozmiar papieru. Oferujemy ponad 100 wstępnie zdefiniowanych standardowych rozmiarów papieru dla Twojej wygody.

Podczas pracy z opcje renderowania PDF, IronPDF zapewnia wszechstronne sterowanie sposobem formatowania dokumentów. Standardowe rozmiary papieru obejmują powszechnie używane formaty, takie jak A4, Letter, Legal i wiele międzynarodowych standardów.

Jakie standardowe rozmiary papieru są dostępne?

Poniżej znajduje się przykład jak ustawić standardowy rozmiar papieru:

: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 obsługuje obszerną kolekcję standardowych rozmiarów papieru w tym:

  • ISO 216 Series: A0 do A10, B0 do B10
  • North American: Letter, Legal, Tabloid, Executive
  • Architectural: ANSI A do E
  • Japanese: JIS B0 do B10
  • Rozmiary kopert: Różne międzynarodowe standardy kopert

Dla pełnej listy dostępnych rozmiarów papieru i ich wymiarów, odwołaj się do dokumentacji API Reference.

Jakie właściwości kontrolują rozmiar papieru?

  • PaperSize: Ustaw rozmiar papieru wyjściowego dla stron PDF z wstępnie zdefiniowanymi rozmiarami takimi jak letter, A3, A4, itp.
  • ForcePaperSize: Wymusza rozmiary stron dokładnie takie, jak określone przez IronPdf.ChromePdfRenderOptions.PaperSize, zmieniając rozmiar strony po wygenerowaniu PDF z HTML. Ta funkcja jest użyteczna do obejścia zasad CSS, które określają rozmiar papieru.

Korzystając z tych właściwości w połączeniu z niestandardowymi marginesami, możesz osiągnąć precyzyjne opracowanie układu PDF.

Jak uzyskać standardowe rozmiary papieru w różnych jednostkach?

Potrzebujesz znaleźć wymiary standardowych rozmiarów papieru? Możesz to łatwo zrobić, korzystając z metody ToMillimeters. Ta metoda zwraca krotkę zawierającą szerokość i wysokość standardowego rozmiaru papieru jako obiekty Length. Klasa Length jest niezwykle wszechstronna, pozwalając na bezproblemowe konwertowanie tych wymiarów do różnych jednostek, w tym:

  • Milimetrami
  • Centymetrami
  • Cale
  • Pixele
  • Punkty
: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

Ta funkcjonalność jest szczególnie przydatna podczas integracji z odpowiednio oddzielnymi układami CSS lub gdy potrzebujesz obliczyć dokładne wymiary dla niestandardowych układów.

Jak tworzyć niestandardowe rozmiary papieru?

Najpierw zaczynamy od zainicjowania klasy ChromePdfRenderer. Z nowo utworzonego obiektu możemy uzyskać dostęp do RenderingOptions, aby zastosować niestandardowy rozmiar papieru do nowo wygenerowanego dokumentu PDF. Istnieją cztery metody, które można użyć do ustawienia rozmiaru papieru wyjściowego dla stron PDF, każda oparta na innej jednostce miary:

  • SetCustomPaperSizeInCentimeters: Wymiary są w centimeters.
  • SetCustomPaperSizeInInches: Wymiary są w inches.
  • SetCustomPaperSizeInMillimeters: Wymiary są w millimeters.
  • SetCustomPaperSizeInPixelsOrPoints: Wymiary są w pixels or points.

Podczas tworzenia niestandardowych rozmiarów papieru ważne jest, aby wziąć pod uwagę, jak będą one współdziałać z nagłówkami i stopkami oraz ustawieniami orientacji strony.

Jakie jednostki mogę użyć dla niestandardowych wymiarów?

Poniżej znajduje się przykład, jak ustawić niestandardowy rozmiar papieru w centymetrach:

: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

Oto dodatkowe przykłady dla każdej jednostki miary:

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

Pracując z niestandardowymi rozmiarami, warto również zbadać ustawienia widoku i przybliżenie, aby upewnić się, że zawartość mieści się prawidłowo w niestandardowych wymiarach.

Jak mogę zmodyfikować wymiary papieru?

W istniejącym dokumencie PDF lub świeżo wygenerowanym PDF, rozmiar każdej strony można zmodyfikować za pomocą metody ExtendPage. Ta metoda pozwala określić docelowy indeks strony, wartości do zmodyfikowania każdej z czterech stron oraz jednostki miary. Wartości dla każdej strony mogą być ujemne, co zmniejszy tę stronę, lub dodatnie, co wydłuży tę stronę.

Ta funkcja jest szczególnie użyteczna, gdy trzeba dostosować PDF-y po ich stworzeniu, na przykład przy scalaniu wielu PDF-ów z różnymi rozmiarami stron lub przy przygotowywaniu dokumentów do drukowania.

Jakie parametry akceptuje ExtendPage?

Metoda ExtendPage akceptuje następujące parametry:

  • Indeks strony: Indeks strony od zera do modyfikacji
  • Rozciągnięcie lewej strony: Ilość, o którą wydłużyć/zredukować lewą stronę
  • Rozciągnięcie prawej strony: Ilość, o którą wydłużyć/zredukować prawą stronę
  • Rozciągnięcie górnej strony: Ilość, o którą wydłużyć/zredukować górną stronę
  • Rozciągnięcie dolnej strony: Ilość, o którą wydłużyć/zredukować dolną stronę
  • Jednostka miary: Jednostka miary (millimeters, inches, etc.)

Poniżej znajduje się przykład, jak zmodyfikować wymiary papieru:

: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

Oto bardziej kompleksowy przykład pokazujący różne modyfikacje strony:

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

Najlepsze praktyki dla niestandardowych rozmiarów papieru

Podczas pracy z niestandardowymi rozmiarami papieru w IronPDF, rozważ te najlepsze praktyki:

  1. Testuj różne jednostki: Pracując z niestandardowymi rozmiarami, testuj, która jednostka miary działa najlepiej w Twoim przypadku użycia. Pixele są świetne dla układów ekranowych, natomiast milimetry lub cale są lepsze dla druku.

  2. Rozważ marginesy do druku: Tworząc PDF-y do druku, pamiętaj o uwzględnieniu marginesów drukarki. Większość drukarek nie może drukować do krawędzi papieru.

  3. Responsywny design: Przekształcając HTML na PDF, upewnij się, że Twój HTML wykorzystuje zasady responsywnego projektu, aby dostosować się do różnych rozmiarów papieru.

  4. Optymalizacja wydajności: Bardzo duże niestandardowe rozmiary papieru mogą wpływać na wydajność. Rozważ użycie kompresji dla dużych dokumentów.

  5. Kompatybilność: Testuj swoje PDF-y z niestandardowymi rozmiarami w różnych przeglądarkach PDF, aby zapewnić kompatybilność, szczególnie jeśli używasz niestandardowych wymiarów.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Tworzenie PDF-ów

Często Zadawane Pytania

Jak ustawić niestandardowe rozmiary papieru dla dokumentów PDF w języku C#?

Dzięki IronPDF możesz ustawić niestandardowe rozmiary papieru za pomocą klasy ChromePdfRenderer. Wystarczy ustawić właściwość PaperSize na PdfPaperSize.Custom w RenderingOptions, a następnie użyć metod takich jak SetCustomPaperSizeInInches(), aby zdefiniować konkretne wymiary. Na przykład: renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).

Jakich jednostek miary mogę używać dla niestandardowych rozmiarów papieru?

IronPDF obsługuje wiele jednostek miary dla niestandardowych rozmiarów papieru za pomocą różnych metod SetCustomPaperSize. Wymiary można określać w calach, centymetrach, milimetrach lub pikselach, co zapewnia elastyczność w stosunku do różnych międzynarodowych standardów i wymagań projektowych.

Kiedy należy używać niestandardowych rozmiarów papieru zamiast rozmiarów standardowych?

Niestandardowe rozmiary papieru w IronPDF są idealne do tworzenia plików PDF o unikalnych układach, takich jak plakaty, banery, dokumenty specjalistyczne lub dowolne projekty, które nie mieszczą się w standardowych formatach, takich jak A4 lub Letter. Ta elastyczność jest szczególnie przydatna w projektach konwersji HTML do PDF wymagających określonych wymiarów.

Ile jest dostępnych predefiniowanych standardowych rozmiarów papieru?

IronPDF oferuje ponad 100 predefiniowanych standardowych rozmiarów papieru poprzez wyliczenie PdfPaperSize, w tym powszechnie używane formaty, takie jak A4, Letter, Legal oraz wiele standardów międzynarodowych, zapewniając kompleksowe opcje dla większości wymagań dotyczących dokumentów.

Jakie kroki należy wykonać, aby wdrożyć niestandardowe rozmiary papieru?

Aby zaimplementować niestandardowe rozmiary papieru w IronPDF: 1) Pobierz IronPDF za pośrednictwem NuGet, 2) Utwórz instancję ChromePdfRenderer, 3) Uzyskaj dostęp do właściwości RenderingOptions, 4) Wywołaj metodę SetCustomPaperSize z żądanymi wymiarami oraz 5) Wyrenderuj i zapisz dokument PDF.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.