1. IronPDF
  2. Guides pratiques
  3. Comment rendre un fichier HTML en PDF
Comment rendre un fichier HTML en PDF en utilisant C#

Rendu d'un fichier HTML en PDF en C# ; avec IronPDF

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

IronPDF convertit les fichiers HTML en documents PDF en C# en les rendant via un moteur basé sur Chrome, ne nécessitant qu'un seul appel de méthode pour transformer n'importe quel fichier HTML accessible en une sortie PDF professionnelle.

IronPDF rend n'importe quel fichier HTML auquel la machine a accès, ce qui en fait une solution simple pour la génération de PDF.

Démarrage rapide : Convertir un fichier HTML en PDF avec IronPDF

Convertissez des fichiers HTML en PDF à l'aide d'IronPDF en seulement quelques lignes de code. La classe ChromePdfRenderer transforme rapidement le contenu HTML en documents PDF. Indiquez le chemin d'accès à votre fichier HTML et IronPDF se charge de la conversion. Ce processus simplifié en fait un outil idéal pour ajouter une fonctionnalité de génération de PDF aux applications C#.

  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()
  .RenderHtmlFileAsPdf("path/to/your/file.html")
  .SaveAs("output.pdf");

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit

    arrow pointer

Flux de travail minimal (5 étapes)

IronPDF tutorial showing 5 steps to convert HTML to PDF in C# with NuGet installation command
  1. Télécharger la bibliothèque IronPDF pour la conversion HTML en PDF
  2. Instantiate the `ChromePdfRenderer` class
  3. Configure the `RenderingOptions` to fine-tune the output PDF
  4. Passer le chemin du fichier HTML au moteur de rendu
  5. Enregistrer et télécharger le PDF

Comment convertir des fichiers HTML en PDF à l'aide d'IronPDF?

IronPDF convertit les fichiers HTML en PDF à l'aide de la méthode RenderHtmlFileAsPdf. Le paramètre est un chemin vers un fichier HTML local.

Cette méthode permet aux développeurs de tester le contenu HTML dans un navigateur pendant le développement. Ils peuvent vérifier la fidélité du rendu avant la conversion. Chrome est recommandé car le moteur de rendu d'IronPDF est basé dessus.

Si le contenu s'affiche correctement dans Chrome, il s'affichera correctement dans IronPDF. Pour connaître les exigences précises en matière de rendu, consultez notre guide sur le débogage HTML avec Chrome pour vous assurer que vos PDF correspondent à vos attentes.

Quel contenu HTML puis-je convertir?

Voici le fichier HTML example.html généré par le code :


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>
HTML

Le fichier HTML rendu sur le web est affiché ci-dessous.

IronPDF prend en charge des fonctionnalités HTML avancées, notamment CSS3, JavaScript, les images et les polices de caractères. Découvrez les options de rendu pour personnaliser votre sortie PDF avec des en-têtes, des pieds de page, des marges et bien plus encore.

Comment mettre en œuvre la conversion en C#?

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf.cs
using IronPdf;
using IronPdf.Engines.Chrome;
using IronPdf.Rendering;


var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        CssMediaType = PdfCssMediaType.Print,
        MarginBottom = 0,
        MarginLeft = 0,
        MarginRight = 0,
        MarginTop = 0,
        Timeout = 120,
    },
};
renderer.RenderingOptions.WaitFor.RenderDelay(50);

// Create a PDF from an existing HTML file using C#
var pdf = renderer.RenderHtmlFileAsPdf("example.html");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf
Imports IronPdf.Engines.Chrome
Imports IronPdf.Rendering


Private renderer = New ChromePdfRenderer With {
	.RenderingOptions = New ChromePdfRenderOptions With {
		.CssMediaType = PdfCssMediaType.Print,
		.MarginBottom = 0,
		.MarginLeft = 0,
		.MarginRight = 0,
		.MarginTop = 0,
		.Timeout = 120
	}
}
renderer.RenderingOptions.WaitFor.RenderDelay(50)

' Create a PDF from an existing HTML file using C#
Dim pdf = renderer.RenderHtmlFileAsPdf("example.html")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

La méthode RenderHtmlFileAsPdf renvoie un objet PdfDocument, qui contient des informations PDF. Vous pouvez manipuler cet objet davantage - par exemple, vous pourriez ajouter des en-têtes et des pieds de page, appliquer des filigranes, ou fusionner plusieurs PDF en un seul document.

Les options de rendu permettent de personnaliser le résultat. Définir CssMediaType sur Print applique des règles CSS spécifiques à l'impression, tandis que les paramètres de marge créent un document à fond perdu. Le délai de 120 secondes permet aux fichiers HTML complexes contenant des ressources externes de se charger complètement.

Le délai de 50 millisecondes RenderDelay garantit que toutes les ressources sont chargées avant la création du PDF. Ceci est utile pour les pages contenant beaucoup de JavaScript. Pour les scénarios complexes avec du contenu dynamique, explorez notre guide sur le rendu JavaScript.

À quoi ressemble le fichier PDF final ?

Voici le fichier PDF que le code a produit :

Comment utiliser les paramètres d'impression par défaut de Chrome?

Pour utiliser les options d'impression par défaut de Chrome, accédez à la propriété DefaultChrome de la classe ChromePdfRenderOptions et attribuez-la à RenderingOptions. Avec ce paramètre, la sortie d'IronPDF correspond exactement à l'aperçu avant impression de Chrome.

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome;
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome
$vbLabelText   $csharpLabel

Les paramètres par défaut de Chrome fonctionnent bien lorsque vous souhaitez que les PDF correspondent à ce que les utilisateurs voient lorsqu'ils impriment à partir de leur navigateur. Cette approche gère automatiquement les paramètres d'impression courants tels que les sauts de page, le formatage des en-têtes/pieds de page et les marges standard.

Options de conversion supplémentaires

IronPDF propose plusieurs fonctionnalités connexes qui améliorent les flux de travail de génération de PDF :

  • Conversion à partir de chaînes HTML : Générez du HTML de manière dynamique et convertissez les chaînes HTML directement en PDF sans enregistrer d'abord dans un fichier.
  • URL en PDF : Convertissez des sites web en direct grâce à notre guide sur la conversion d'URL en PDF.
  • Archives ZIP HTML : Pour les projets complexes comportant de multiples ressources, apprenez à convertir des fichiers ZIP HTML en PDF.
  • Césure personnalisée : ChromePdfRenderOptions prend en charge la césure via la propriété HyphenationLanguage. Définissez-la sur une langue spécifique à côté de hyphens: auto dans votre CSS pour activer la césure automatique dans le PDF généré. Pour les cas d'utilisation avancés, la propriété CustomHyphenation accepte des modèles de césure personnalisés qui prévalent sur l'option basée sur la langue.

Considérations de Performance

Lorsque vous convertissez des fichiers HTML en PDF dans des environnements de production, tenez compte des optimisations suivantes :

  1. Opérations asynchrones : Utilisez les méthodes de génération de PDF asynchrones pour une meilleure réactivité de l'application.
  2. Cache : Mettez en cache les PDF obtenus lors de la conversion multiple d'un même fichier HTML afin d'éviter un rendu répétitif.
  3. Gestion des ressources : veillez à toujours supprimer les objets PdfDocument une fois que vous avez terminé afin de libérer de la mémoire.
  4. Traitement par lots : réutilisez la même instance de ChromePdfRenderer lors de la conversion de plusieurs fichiers pour améliorer les performances.

Résolution des problèmes courants

Si vous rencontrez des problèmes lors de la conversion de HTML en PDF, essayez les solutions suivantes :

  • <Ressources manquantes : assurez-vous que tous les fichiers CSS, JavaScript et images référencés dans votre HTML sont accessibles à partir de l'emplacement du fichier.
  • Rendu des polices : Pour un rendu cohérent des polices sur l'ensemble des systèmes, intégrez les polices dans votre HTML ou explorez notre guide de gestion des polices.
  • <Fichiers volumineux : Pour les fichiers HTML comportant de nombreuses images ou des mises en page complexes, utilisez les techniques de compression des PDF pour réduire la taille des fichiers.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriels ici : Convertir les PDFs

Questions Fréquemment Posées

Quel est le moteur de rendu utilisé pour la conversion de HTML en PDF ?

IronPDF utilise un moteur de rendu basé sur Chrome pour convertir les fichiers HTML en PDF. Cela garantit un rendu précis de votre contenu HTML dans le PDF, correspondant à la façon dont il apparaît dans le navigateur Chrome.

Comment convertir un fichier HTML en PDF en C# ?

Utilisez la classe ChromePdfRenderer d'IronPDF avec la méthode RenderHtmlFileAsPdf. Il suffit de passer le chemin de votre fichier HTML en paramètre et d'enregistrer la sortie à l'aide de la méthode SaveAs. L'ensemble de la conversion ne nécessite que quelques lignes de code.

Quelles sont les fonctionnalités HTML prises en charge dans la conversion PDF ?

IronPDF prend en charge les fonctionnalités HTML avancées, notamment CSS3, JavaScript, les images et les polices de caractères. Le moteur basé sur Chrome assure une compatibilité totale avec les normes web modernes au cours du processus de conversion.

Puis-je personnaliser la sortie PDF avec des en-têtes et des pieds de page ?

Oui, IronPDF permet une personnalisation poussée de la sortie des PDF. Vous pouvez ajouter des en-têtes et des pieds de page, appliquer des filigranes, définir des marges et fusionner plusieurs PDF. La configuration RenderingOptions permet de contrôler finement le document final.

Comment puis-je m'assurer que mon HTML est correctement rendu avant de le convertir en PDF ?

Testez votre contenu HTML dans le navigateur Chrome avant la conversion. IronPDF utilisant un moteur de rendu basé sur Chrome, le contenu qui s'affiche correctement dans Chrome s'affichera avec précision dans le PDF. Pour des besoins précis, utilisez le guide de débogage d'IronPDF pour un rendu au pixel près.

Quel type d'objet la méthode de conversion renvoie-t-elle ?

La méthode RenderHtmlFileAsPdf renvoie un objet PdfDocument. Cet objet contient toutes les informations relatives au PDF et peut être manipulé pour des opérations supplémentaires telles que l'ajout de filigranes ou la fusion avec d'autres 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 18,560,885 | Version : 2026.4 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronPdf
exécuter un échantillon Regardez votre code HTML se transformer en PDF.