1. IronPDF
  2. Poradniki
  3. Set Custom Margins
Jak ustawić niestandardowe marginesy w plikach PDF w języku C#

Jak ustawić niestandardowe marginesy w IronPDF C

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

IronPDF pozwala programistom ustawić niestandardowe marginesy przy renderowaniu plików PDF z HTML poprzez proste skonfigurowanie ChromePdfRenderer RenderingOptions, co umożliwia precyzyjne kontrolowanie górnych, dolnych, lewych i prawych marginesów w milimetrach.

Szybki start: Wdrażanie niestandardowych marginesów PDF za pomocą IronPDF

Ustaw niestandardowe marginesy podczas renderowania plików PDF z HTML za pomocą prostej konfiguracji.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } }
    .RenderHtmlAsPdf("<h1>Hello with margins!</h1>")
    .SaveAs("custom-margins.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 przebieg pracy (5 kroków):

  1. Pobierz IronPDF z NuGet
  2. Utwórz instancję klasy ChromePdfRenderer
  3. Ustaw wartości marginesów w RenderingOptions
  4. Skonfiguruj zachowanie marginesów nagłówka i stopki
  5. Przekonwertuj HTML na PDF i zapisz

Jak ustawić niestandardowe marginesy w pliku PDF w IronPDF?

Aby ustawić niestandardowe marginesy, utwórz instancję klasy ChromePdfRenderer. Uzyskaj dostęp do obiektu RenderingOptions, aby ustawić określone marginesy w milimetrach dla góry, dołu, lewej i prawej:

: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
$vbLabelText   $csharpLabel

Ustawienia marginesów współpracują z silnikiem renderującym IronPDF dla przeglądarki Chrome, który zapewnia dokładną konwersję HTML do PDF. Aby uzyskać informacje na temat zaawansowanych ustawień generowania plików PDF, zapoznaj się z przewodnikiem dotyczącym opcji renderowania.

Jak marginesy współdziałają ze stylami CSS?

Marginesy dodają się do tych ustawionych w sekcji HTML style. W poniższym przykładzie marginesy HTML wynoszą 50 mm, a RenderingOptions dodaje 30 mm, co daje łącznie 80 mm marginesów:

: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")
$vbLabelText   $csharpLabel

Poniżej znajduje się plik PDF z tłumaczeniem:

Podczas pracy z CSS w dokumentach HTML IronPDF obsługuje responsywny CSS i zapytania o media, umożliwiając tworzenie profesjonalnych układów. To zachowanie marginesów ma znaczenie podczas konwersji plików HTML do formatu PDF lub pracy z ciągami znaków HTML.

Jakie są typowe wartości marginesów dla różnych standardów?

Dokumenty często wymagają określonych marginesów, aby spełniały różne standardy. Formaty MLA i APA wymagają marginesów o szerokości 1 cala, natomiast prace dyplomowe mogą wymagać marginesów o szerokości 1,5 cala.

Typowe standardy marginesów i ich odpowiedniki w milimetrach:

  • Format MLA/APA: 1 cal (25,4 mm) ze wszystkich stron
  • Format pracy dyplomowej: 1,5 cala (38,1 mm) ze wszystkich stron
  • Listy biznesowe: 1 cal po bokach, 2 cale (50,8 mm) u góry i u dołu
  • Europejski standard A4: 20 mm ze wszystkich stron
  • Wąskie marginesy: 0,5 cala (12,7 mm) ze wszystkich stron

Wdrażając te standardy, IronPDF obsługuje niestandardowe rozmiary papieru, umożliwiając tworzenie dokumentów spełniających konkretne wymagania regionalne lub organizacyjne.

Jak zastosować niestandardowe marginesy w nagłówkach i stopkach?

Domyślnie, marginesy ustawione w RenderingOptions nie dotyczą nagłówków i stopek. Aby zastosować marginesy dokumentu do nagłówków i stopek, skonfiguruj właściwość UseMarginsOnHeaderAndFooter:

: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
$vbLabelText   $csharpLabel

Aby dowiedzieć się, jak wdrożyć nagłówki i stopki z dynamiczną treścią i stylem, zapoznaj się z przewodnikiem dotyczącym dodawania nagłówków i stopek.

Jak selektywnie zastosować marginesy do nagłówków i stopek?

Określ, jakie marginesy mają zastosowanie do nagłówków i stopek. Szczegółowe informacje na temat konfiguracji można znaleźć w Dokumentacji API. Przykłady:

: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
$vbLabelText   $csharpLabel

Kiedy należy stosować różne konfiguracje marginesów nagłówka/stopki?

Selektywne konfiguracje marginesów dla nagłówków i stopek sprawdzają się dobrze w przypadku dokumentów o asymetrycznym układzie, takich jak książki z naprzemiennymi marginesami stron lub nagłówkami sięgającymi do krawędzi stron, podczas gdy treść zachowuje marginesy.

Typowe zastosowania:

  • Wydawanie książek: Naprzemienne marginesy wewnętrzne/zewnętrzne do oprawy
  • Dokumenty z nagłówkiem: Nagłówki o pełnej szerokości z ograniczoną treścią
  • Formularze i szablony: Różne marginesy dla pól w porównaniu z instrukcjami
  • Układy wielokolumnowe: nagłówki o pełnej szerokości z marginesami kolumn

Zaawansowane kwestie dotyczące marginesów

Praca z podziałami stron i marginesami

Niestandardowe marginesy współdziałają z podziałami stron. IronPDF zarządza przepływem treści między stronami, zachowując ustawienia marginesów, co zapewnia spójne formatowanie w dokumentach wielostronicowych.

Jednostki marginesu i precyzja

IronPDF stosuje milimetry jako jednostkę pomiaru marginesów. Konwersja z innych jednostek:

  • Cale na milimetry: pomnożyć przez 25,4
  • Punkty na mm: pomnożyć przez 0,352778
  • Piksele na milimetry: zależy od DPI (przy 96 DPI należy pomnożyć przez 0,264583)

W razie potrzeby IronPDF obsługuje wartości dziesiętne z dokładnością poniżej milimetra.

Optymalizacja wydajności z marginesami

W przypadku dużych dokumentów z niestandardowymi marginesami:

  1. Ustaw marginesy jeden raz na poziomie renderer
  2. Używaj spójnych wartości w podobnych dokumentach
  3. Łącz ustawienia marginesów z innymi opcje renderowania

Integracja z innymi funkcjami IronPDF

Niestandardowe marginesy działają z innymi funkcjami IronPDF:

Wnioski

Ustawienie niestandardowych marginesów w IronPDF zapewnia precyzyjną kontrolę nad układem i formatowaniem plików PDF. Niezależnie od tego, czy tworzysz dokumenty biznesowe, prace akademickie, czy niestandardowe raporty, system marginesów IronPDF zapewnia spełnienie dokładnych specyfikacji PDF. Zapoznaj się z dokumentacją, aby dowiedzieć się, jak IronPDF może usprawnić Twój przepływ pracy generowania PDF.

Często Zadawane Pytania

How do I set custom margins for PDFs in C#?

With IronPDF, you can set custom margins by configuring the ChromePdfRenderer's RenderingOptions. Simply set the MarginTop, MarginBottom, MarginLeft, and MarginRight properties in millimeters. For example: new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 } }.

What units are used for margin measurements?

IronPDF uses millimeters (mm) as the unit for all margin settings in the RenderingOptions. This provides precise control over PDF layout and ensures consistency across different document standards.

How do IronPDF margins interact with CSS margins in HTML?

IronPDF margins are additive to CSS margins defined in your HTML. If your HTML has 50mm margins and you set 30mm in RenderingOptions, the final PDF will have 80mm total margins. This allows flexible control over spacing while preserving your HTML styling.

Can I apply margins to headers and footers?

Yes, IronPDF provides the UseMarginsOnHeaderAndFooter property in RenderingOptions. Setting this to true applies your custom margins to headers and footers, ensuring consistent spacing throughout your PDF document.

What are the recommended margin values for academic formats?

For academic documents using IronPDF, use 25.4mm (1 inch) for MLA/APA format, 38.1mm (1.5 inches) for dissertations, or 20mm for European A4 standard. These values can be easily set through the MarginTop, MarginBottom, MarginLeft, and MarginRight properties.

Does the Chrome rendering engine affect margin accuracy?

IronPDF's Chrome rendering engine ensures highly accurate margin rendering that matches modern web standards. This provides consistent results when converting HTML to PDF, maintaining precise spacing as defined in your RenderingOptions.

Can I set different margins for each side of the PDF?

Absolutely. IronPDF allows independent control of all four margins through separate properties: MarginTop, MarginBottom, MarginLeft, and MarginRight. This enables asymmetric layouts like business letters with larger top/bottom margins.

How do I implement narrow margins for maximum content area?

For narrow margins in IronPDF, set all margin values to 12.7mm (0.5 inches) in the RenderingOptions. This maximizes the printable area while maintaining professional appearance: RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }.

Jordi Bardia
Jordi Bardia
  Czat z zespołem inżynierów teraz
Inżynier oprogramowania
Jordi jest najbardziej biegły w Pythonie, C# i C++. Kiedy nie wykorzystuje swoich umiejętności w Iron Software, programuje gry. Dzieląc odpowiedzialność za testowanie produktów, rozwój produktów i badania, Jordi wnosi ogromną wartość do ciągłej poprawy produktów. Różnorodne doświadczenia ...
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.