1. IronPDF
  2. Guides pratiques
  3. Taille de papier personnalisée
Comment définir des tailles de papier personnalisées pour les PDF en utilisant C# | IronPDF

Comment rendre des PDF avec une taille de papier personnalisée dans C#;

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

IronPDF vous permet de rendre des PDF avec des tailles de papier personnalisées en C# en utilisant la classe ChromePdfRenderer et en définissant des dimensions spécifiques par le biais de méthodes telles que SetCustomPaperSizeInInches(), ce qui permet un contrôle précis des dimensions du document pour les mises en page spécialisées telles que les affiches ou les bannières.

Un format de papier personnalisé fait référence à un format de papier non standard défini par l'utilisateur plutôt qu'à un format standard tel que A4 ou lettre (8,5 x 11 pouces). Les formats de papier personnalisés sont souvent utilisés lors de l'impression de documents nécessitant une mise en page unique ou spécifique, tels que des affiches, des bannières ou des documents spécialisés. Cette flexibilité est essentielle lorsqu'il s'agit de travailler sur des projets de conversion de HTML en PDF qui nécessitent des dimensions spécifiques.

Découvrez la vaste gamme de formats de papier disponibles avec IronPDF, offrant un large choix pour répondre à vos besoins !

en-tête:2(Démarrage rapide : Définir des formats de papier personnalisés dans IronPDF)

Dans ce guide rapide, apprenez à définir des formats de papier personnalisés en utilisant IronPDF en seulement quelques lignes de code. Avec IronPDF, vous pouvez facilement adapter les dimensions du PDF en définissant des mesures exactes de largeur et de hauteur dans n'importe quelle unité que vous préférez. Cette flexibilité est idéale pour créer des documents avec des exigences de mise en page uniques, tels que des affiches ou des bannières. Commencez par télécharger la bibliothèque IronPDF via NuGet et suivez cet exemple pour définir la taille de papier souhaitée sans effort.

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.

    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. 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 depuis NuGet pour définir des tailles de papier personnalisées dans les PDF
  2. Instancier la classe ChromePdfRenderer en C#
  3. Accédez aux RenderingOptions sur le nouvel objet
  4. Invoquer l'une des méthodes SetCustomPaperSize en fonction de l'unité de mesure
  5. Rendre et exporter le document PDF


Comment utiliser les formats de papier standard?

<TODO : Ajouter une image ici -->

Tout d'abord, créez une instance de la classe ChromePdfRenderer. Ensuite, utilisez la propriété RenderingOptions de l'objet nouvellement créé pour modifier le PaperSize. Définissez-le sur l'une des valeurs prédéfinies de l'enum PdfPaperSize pour spécifier le format de papier souhaité. Nous proposons plus de 100 formats de papier standard prédéfinis pour votre commodité.

Lorsque vous travaillez avec des options de rendu PDF, IronPDF offre un contrôle complet sur la façon dont vos documents sont formatés. Les formats de papier standard comprennent des formats couramment utilisés tels que A4, Letter, Legal, ainsi que de nombreuses normes internationales.

Quels sont les formats de papier standard disponibles ?

Voici un exemple de comment définir un format de papier standard :

: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 prend en charge une vaste collection de formats de papier standard, notamment :

  • Série ISO 216 : A0 à A10, B0 à B10
  • Américain du Nord : Letter, Legal, Tabloïd, Executive
  • Architecture : ANSI A à E
  • Japonais : JIS B0 à B10
  • Tailles des enveloppes : Diverses normes internationales en matière d'enveloppes

Pour obtenir une liste complète des formats de papier disponibles et de leurs dimensions, reportez-vous à la documentation de référence de l'API.

Quelles sont les propriétés qui déterminent le format du papier ?

  • PaperSize : Définit un format de papier de sortie pour les pages PDF avec des tailles prédéfinies telles que letter, A3, A4, etc.
  • ForcePaperSize : Force la taille des pages à correspondre exactement à ce qui est spécifié via IronPdf.ChromePdfRenderOptions.PaperSize en redimensionnant la page après avoir généré un PDF à partir de HTML. Cette fonctionnalité est utile pour contourner les règles CSS qui spécifient la taille du papier.

Lorsque vous utilisez ces propriétés en conjonction avec les marges personnalisées, vous pouvez obtenir un contrôle précis sur votre mise en page PDF.

Comment obtenir des formats de papier standard dans différentes unités?

Besoin de trouver les dimensions des formats de papier standard ? Vous pouvez facilement le faire en utilisant la méthode ToMillimeters. Cette méthode renvoie un tuple contenant la largeur et la hauteur du format de papier standard sous forme d'objets Longueur. La classe Longueur est incroyablement polyvalente, vous permettant de convertir sans effort ces dimensions dans une variété d'unités, y compris :

  • Millimètres
  • Centimètres
  • Pouces
  • Pixels
  • Points
: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

Cette fonctionnalité est particulièrement utile lors de l'intégration avec CSS responsive layouts ou lorsque vous devez calculer les dimensions exactes pour des mises en page personnalisées.

Comment créer des formats de papier personnalisés ?

<TODO : Ajouter une image ici -->

Tout d'abord, nous commençons par instancier la classe ChromePdfRenderer. À partir de l'objet nouvellement créé, nous pouvons accéder au RenderingOptions pour appliquer un format de papier personnalisé au document PDF nouvellement généré. Il existe quatre méthodes qui peuvent être utilisées pour définir le format de papier de sortie pour les pages PDF, chacune basée sur une unité de mesure différente :

  • SetCustomPaperSizeInCentimeters : Les dimensions sont en centimètres.
  • SetCustomPaperSizeInInches : Les dimensions sont en pouces.
  • SetCustomPaperSizeInMillimeters : Les dimensions sont en millimètres.
  • SetCustomPaperSizeInPixelsOrPoints : Les dimensions sont en pixels ou points.

Lors de la création de formats de papier personnalisés, il est important de prendre en compte la manière dont ils interagiront avec les en-têtes et pieds de page ainsi qu'avec les paramètres d'orientation de la page.

Quelles unités puis-je utiliser pour les dimensions personnalisées ?

Voici un exemple de comment définir un format de papier personnalisé en centimètres :

: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

Voici des exemples supplémentaires pour chaque unité de mesure :

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

Lorsque vous travaillez avec des tailles personnalisées, vous pourriez également vouloir explorer les paramètres deviewport et de zoom pour vous assurer que votre contenu s'adapte correctement aux dimensions personnalisées.

Comment modifier les dimensions du papier?

Dans un document PDF existant ou un PDF fraîchement rendu, la taille de chaque page peut être modifiée à l'aide de la méthode ExtendPage. Cette méthode vous permet de spécifier l'index de la page cible, les valeurs pour modifier chacun des quatre côtés, et les unités de mesure. Les valeurs pour chaque côté peuvent être négatives, ce qui réduira ce côté particulier, ou positives, ce qui étendra ce côté.

Cette fonction est particulièrement utile lorsque vous devez ajuster des PDF après leur création, par exemple lorsque vous fusionnez plusieurs PDF avec des tailles de page différentes ou lorsque vous préparez des documents pour l'impression.

Quels sont les paramètres acceptés par ExtendPage?

La méthode ExtendPage accepte les paramètres suivants :

  • Index de la page : L'index à base zéro de la page à modifier
  • Extension gauche : Montant pour étendre/réduire le côté gauche
  • Extension droite : Montant pour étendre/réduire le côté droit
  • Top Extension : Montant permettant d'étendre/réduire le côté supérieur
  • Extension du bas : Montant de l'extension/réduction du côté inférieur
  • Unité de mesure : L'unité de mesure (millimètres, pouces, etc.)

Voici un exemple de comment modifier les dimensions du papier :

: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

Voici un exemple plus complet montrant diverses modifications de pages :

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

Bonnes pratiques pour les formats de papier personnalisés

Lorsque vous travaillez avec des formats de papier personnalisés dans IronPDF, tenez compte de ces meilleures pratiques :

  1. Tester différentes unités : Lorsque vous travaillez avec des tailles personnalisées, testez l'unité de mesure qui convient le mieux à votre cas d'utilisation. Les pixels sont parfaits pour les mises en page à l'écran, tandis que les millimètres ou les pouces sont plus adaptés à l'impression.

  2. <Tenez compte des marges d'impression : Lorsque vous créez des PDF destinés à l'impression, n'oubliez pas de tenir compte des marges d'impression. La plupart des imprimantes ne peuvent pas imprimer jusqu'au bord du papier.

  3. Responsive Design : Lors de la conversion HTML en PDF, veillez à ce que votre HTML utilise les principes du responsive design pour s'adapter aux différentes tailles de papier.

  4. Optimisation des performances : Les très grands formats de papier personnalisés peuvent avoir un impact sur les performances. Pensez à utiliser compression pour les documents volumineux.

  5. Compatibilité : Testez vos PDF personnalisés dans différents lecteurs de PDF pour garantir la compatibilité, en particulier si vous utilisez des dimensions non standard.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriel ici : Créer des PDF

Questions Fréquemment Posées

Comment définir des tailles de papier personnalisées pour les documents PDF en C# ?

Avec IronPDF, vous pouvez définir des tailles de papier personnalisées à l'aide de la classe ChromePdfRenderer. Il suffit de définir la propriété PaperSize sur PdfPaperSize.Custom dans les RenderingOptions, puis d'utiliser des méthodes telles que SetCustomPaperSizeInInches() pour définir vos dimensions spécifiques. Par exemple : renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).

Quelles unités de mesure puis-je utiliser pour les formats de papier personnalisés ?

IronPDF prend en charge plusieurs unités de mesure pour les tailles de papier personnalisées grâce à différentes méthodes SetCustomPaperSize. Vous pouvez spécifier des dimensions en pouces, centimètres, millimètres ou pixels, ce qui permet de s'adapter à diverses normes internationales et exigences de projet.

Quand devrais-je utiliser des formats de papier personnalisés plutôt que des formats standard ?

Les formats de papier personnalisés dans IronPDF sont idéaux pour créer des PDF avec des mises en page uniques telles que des affiches, des bannières, des documents spécialisés ou toute autre conception qui ne correspond pas aux formats standard tels que A4 ou Letter. Cette flexibilité est particulièrement utile pour les projets de conversion de HTML en PDF nécessitant des dimensions spécifiques.

Combien de formats de papier standard prédéfinis sont disponibles ?

IronPDF propose plus de 100 formats de papier standard prédéfinis via l'enum PdfPaperSize, y compris des formats couramment utilisés tels que A4, Letter, Legal, et de nombreuses normes internationales, offrant ainsi des options complètes pour la plupart des exigences en matière de documents.

Quelles sont les étapes à suivre pour mettre en œuvre des formats de papier personnalisés ?

Pour mettre en œuvre des formats de papier personnalisés avec IronPDF : 1) Téléchargez IronPDF via NuGet, 2) Créez une instance de ChromePdfRenderer, 3) Accédez à la propriété RenderingOptions, 4) Appelez une méthode SetCustomPaperSize avec les dimensions souhaitées, et 5) Rendez et enregistrez votre document PDF.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,012,929 | Version : 2025.12 vient de sortir