1. IronPDF
  2. Guides pratiques
  3. Définir des marges personnalisées
Comment définir des marges personnalisées dans les PDFs C#

Comment définir des marges personnalisées dans IronPDF C#

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

IronPDF permet aux développeurs de définir des marges personnalisées lors du rendu de PDF à partir de HTML par le biais d'une configuration simple du ChromePdfRenderer's RenderingOptions, permettant un contrôle précis des marges supérieures, inférieures, gauches et droites en millimètres.

Démarrage rapide : mise en œuvre de marges PDF personnalisées avec IronPdf

Définissez des marges personnalisées lors du rendu de PDF à partir de HTML grâce à une configuration simple.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    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. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes):

  1. Téléchargez IronPDF à partir de NuGet
  2. Instanciez la classe ChromePdfRenderer
  3. Définir les valeurs de marge dans RenderingOptions
  4. Configurer le comportement des marges d'en-tête et de pied de page
  5. Transformation de HTML en PDF et enregistrement

Comment définir des marges PDF personnalisées dans IronPDF?

<TODO : Ajouter une image ici -->

Pour définir des marges personnalisées, instanciez la classe ChromePdfRenderer. Accédez à l'objet RenderingOptions pour définir des marges spécifiques en millimètres pour le haut, le bas, la gauche et la droite :

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

Les paramètres de marge fonctionnent avec le moteur de rendu Chrome d'IronPDF, qui assure une conversion HTML vers PDF précise. Pour les paramètres avancés de génération de PDF, voir le guide sur les options de rendu.

Comment les marges interagissent-elles avec les styles CSS?

Les marges s'ajoutent à celles définies dans la section HTML style. Dans l'exemple ci-dessous, les marges HTML sont de 50 mm, et RenderingOptions ajoute 30 mm, ce qui donne des marges totales de 80 mm :

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

<TODO : Ajouter une image ici -->

Le PDF résultant est montré ci-dessous :

Lorsque vous travaillez avec CSS dans des documents HTML, IronPDF prend en charge responsive CSS et media queries, ce qui permet des mises en page professionnelles. Ce comportement marginal est important pour convertir des fichiers HTML en PDF ou pour travailler avec des chaînes HTML.

Quelles sont les valeurs de marge communes aux différentes normes ?

Les documents nécessitent souvent des marges spécifiques pour répondre à diverses normes. Les formats MLA et APA requièrent des marges de 1 pouce, tandis que les dissertations peuvent nécessiter des marges de 1,5 pouce.

Normes de marge courantes et équivalents en millimètres :

  • <Format MLA/APA : 1 pouce (25,4 mm) sur tous les côtés
  • <Format de la dissertation : 38,1 mm (1,5 pouce) de chaque côté
  • Lettres d'affaires : 1 pouce sur les côtés, 2 pouces (50,8 mm) en haut/bas
  • Norme européenne A4 : 20 mm sur tous les côtés
  • Margines étroites : 0,5 pouces (12,7 mm) de tous les côtés

Lors de la mise en œuvre de ces normes, IronPDF prend en charge les formats de papier personnalisés, ce qui permet d'obtenir des documents répondant à des exigences régionales ou organisationnelles spécifiques.

Comment puis-je appliquer des marges personnalisées aux en-têtes et aux pieds de page ?

<TODO : Ajouter une image ici -->

Par défaut, les marges définies dans RenderingOptions ne s'appliquent pas aux en-têtes et aux pieds de page. Pour appliquer les marges du document aux en-têtes et aux pieds de page, configurez la propriété UseMarginsOnHeaderAndFooter :

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;
$vbLabelText   $csharpLabel

Pour la mise en œuvre d'en-têtes et de pieds de page avec un contenu et un style dynamiques, voir le guide sur l'ajout d'en-têtes et de pieds de page.

Comment appliquer des marges de manière sélective aux en-têtes et aux pieds de page ?

Précisez les marges applicables aux en-têtes et aux pieds de page. Voir la référence de l'API pour une configuration détaillée. Exemples :

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

Quand dois-je utiliser différentes configurations de marges d'en-tête et de pied de page ?

Les configurations de marges sélectives pour les en-têtes et les pieds de page conviennent bien aux documents dont la mise en page est asymétrique, comme les livres dont les marges des pages sont alternées ou les en-têtes qui s'étendent jusqu'au bord des pages alors que le corps du texte conserve ses marges.

Cas d'utilisation courants :

  • Édition de livres : Marges intérieures/extérieures alternées pour la reliure
  • Documents à en-tête : En-têtes pleine largeur avec corps contraint
  • Formulaires et modèles : Marges différentes pour les champs et les instructions
  • Mise en page multi-colonnes : En-têtes pleine largeur avec marges de colonne

Considérations avancées sur les marges

Travailler avec les sauts de page et les marges

Les marges personnalisées interagissent avec les sauts de page. IronPDF gère le flux de contenu entre les pages tout en respectant les paramètres de marge, ce qui garantit un formatage cohérent dans les documents multipages.

Unités de marge et précision

IronPDF utilise des millimètres pour les marges. Conversion à partir d'autres unités :

  • Pouces en mm : multiplier par 25,4
  • Points à mm : multiplier par 0,352778
  • Pixels en mm : varie selon le DPI (à 96 DPI, multiplier par 0,264583)

IronPDF prend en charge les valeurs décimales pour une précision submillimétrique lorsque cela est nécessaire.

Optimisation des performances avec les marges

Pour les documents volumineux avec des marges personnalisées :

  1. Définir les marges une fois au niveau du renderer
  2. Utiliser des valeurs cohérentes dans des documents similaires
  3. Combinez les paramètres de marge avec d'autres options de rendu

Intégration avec d'autres fonctionnalités d'IronPDF

Les marges personnalisées fonctionnent avec d'autres fonctionnalités d'IronPDF :

Conclusion

La définition de marges personnalisées dans IronPDF permet un contrôle précis de la mise en page et du formatage des PDF. Qu'il s'agisse de créer des documents commerciaux, des travaux universitaires ou des rapports personnalisés, le système de marge d'IronPDF garantit que les PDF répondent exactement aux spécifications. Explorez la documentation pour découvrir comment IronPDF peut rationaliser votre flux de production de PDF.

Questions Fréquemment Posées

Comment définir des marges personnalisées pour les PDF en C# ?

Avec IronPdf, vous pouvez définir des marges personnalisées en configurant les RenderingOptions du ChromePdfRenderer. Il suffit de définir les propriétés MarginTop, MarginBottom, MarginLeft et MarginRight en millimètres. Par exemple : new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 } }.

Quelles sont les unités utilisées pour mesurer les marges ?

IronPDF utilise le millimètre (mm) comme unité pour tous les paramètres de marge dans les RenderingOptions. Cela permet un contrôle précis de la mise en page des PDF et garantit la cohérence entre les différentes normes de documents.

Comment les marges IronPDF interagissent-elles avec les marges CSS en HTML ?

Les marges IronPDF s'ajoutent aux marges CSS définies dans votre HTML. Si votre HTML a des marges de 50 mm et que vous définissez 30 mm dans RenderingOptions, le PDF final aura des marges totales de 80 mm. Cela permet un contrôle flexible de l'espacement tout en préservant votre style HTML.

Puis-je appliquer des marges aux en-têtes et aux pieds de page ?

Oui, IronPDF fournit la propriété UseMarginsOnHeaderAndFooter dans RenderingOptions. En définissant cette propriété sur true, vous appliquez vos marges personnalisées aux en-têtes et aux pieds de page, ce qui garantit un espacement cohérent dans l'ensemble du document PDF.

Quelles sont les marges recommandées pour les formats académiques ?

Pour les documents universitaires utilisant IronPDF, utilisez 25,4 mm (1 pouce) pour le format MLA/APA, 38,1 mm (1,5 pouce) pour les dissertations, ou 20 mm pour la norme européenne A4. Ces valeurs peuvent être facilement définies à l'aide des propriétés MarginTop, MarginBottom, MarginLeft et MarginRight.

Le moteur de rendu Chrome affecte-t-il la précision des marges ?

Le moteur de rendu Chrome d'IronPDF garantit un rendu très précis des marges qui correspond aux normes web modernes. Cela permet d'obtenir des résultats cohérents lors de la conversion de HTML en PDF, en conservant un espacement précis tel que défini dans vos RenderingOptions.

Puis-je définir des marges différentes pour chaque côté du PDF ?

Absolument. IronPDF permet un contrôle indépendant des quatre marges par le biais de propriétés distinctes : MarginTop, MarginBottom, MarginLeft et MarginRight. Cela permet des mises en page asymétriques telles que des lettres d'affaires avec des marges supérieures et inférieures plus importantes.

Comment mettre en place des marges étroites pour une surface de contenu maximale ?

Pour obtenir des marges étroites dans IronPDF, réglez toutes les valeurs de marge sur 12,7 mm (0,5 pouce) dans les options de rendu. Cela permet de maximiser la zone imprimable tout en conservant une apparence professionnelle : RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }.

Jordi Bardia
Jordi Bardia
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir