1. IronPDF
  2. Poradniki
  3. Ustaw niestandardowe marginesy
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 umożliwia programistom ustawianie niestandardowych marginesów podczas renderowania plików PDF z HTML poprzez prostą konfigurację ChromePdfRenderer's RenderingOptions, co pozwala na precyzyjną kontrolę nad marginesami górnym, dolnym, lewym i prawym 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, należy utworzyć instancję klasy ChromePdfRenderer. Użyj obiektu RenderingOptions, aby ustawić konkretne marginesy w milimetrach dla góry, dołu, lewej i prawej strony:

: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 cała, natomiast prace dyplomowe mogą wymagać marginesów o szerokości 1,5 cała.

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 cała (38,1 mm) ze wszystkich stron
  • Listy biznesowe: 1 cal po bokach, 2 całe (50,8 mm) u góry i u dołu
  • Europejski standard A4: 20 mm ze wszystkich stron
  • Wąskie marginesy: 0,5 cała (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 mają zastosowania do 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 jednorazowo 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

Jak ustawic niestandardowe marginesy dla PDF w C#?

Dzieki IronPDF mozesz ustawic niestandardowe marginesy, konfigurujac RenderingOptions w ChromePdfRenderer. Po prostu ustaw wlasciwosci MarginTop, MarginBottom, MarginLeft i MarginRight w milimetrach. Na przyklad: new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 } }.

Jakie jednostki sa uzywane do pomiaru marginesow?

IronPDF uzywa milimetrów (mm) jako jednostki dla wszystkich ustawien marginesów w RenderingOptions. Zapewnia to precyzyjna kontrole nad ukladem PDF i zapewnia spojnosc w roznych standardach dokumentow.

Jak marginesy IronPDF wchodza w interakcje z marginesami CSS w HTML?

Marginesy IronPDF sa dodawane do marginesów CSS zdefiniowanych w twoim HTML. Jesli twoje HTML ma marginesy 50mm i ustawisz 30mm w RenderingOptions, ostateczny PDF bedzie mial lacznie 80mm marginesów. Dzieki temu mozliwa jest elastyczna kontrola nad rozstawem przy zachowaniu stylowania HTML.

Czy moge zastosowac marginesy do naglowkow i stopki?

Tak, IronPDF oferuje wlasciwosc UseMarginsOnHeaderAndFooter w RenderingOptions. Ustawienie tej opcji na true powoduje zastosowanie twoich niestandardowych marginesow do naglowkow i stron, zapewniajac spójne odstępy w całym dokumencie PDF.

Jakie sa zalecane wartosci marginesow dla formatów akademickich?

Dla dokumentów akademickich wykorzystujacych IronPDF uzyj 25,4mm (1 cala) dla formatu MLA/APA, 38,1mm (1,5 cala) dla dysertacji lub 20mm dla europejskiego formatu A4. Te wartosci moga byc łatwo ustawione poprzez wlasciwosci MarginTop, MarginBottom, MarginLeft i MarginRight.

Czy silnik renderowania Chrome wplywa na dokladnosc marginesow?

Silnik renderowania Chrome w IronPDF zapewnia wysoka dokladnosc renderowania marginesów, zgodnosc z nowoczesnymi standardami internetowymi. Zapewnia to spójne wyniki przy konwersji HTML do PDF, zachowujac precyzyjny rozstaw zdefiniowany w RenderingOptions.

Czy moge ustawic rozne marginesy dla kazdej strony PDF?

Oczywiscie. IronPDF umożliwia niezalezna kontrole wszystkich czterech marginesów przez osobne wlasciwosci: MarginTop, MarginBottom, MarginLeft i MarginRight. To pozwala na asymetryczne uklady jak w listach biznesowych z wiekszymi marginesami górnym/dolnym.

Jak wdrozyc waskie marginesy dla maksymalnej powierzchni zawartosci?

Dla waskich marginesów w IronPDF ustaw wszystkie wartosci marginesów na 12,7mm (0,5 cala) w RenderingOptions. To maksymalizuje obszar drukowalny przy zachowaniu profesjonalnego wygladu: 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,926,724 | Wersja: 2026.5 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.