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)

Tutoriel IronPDF présentant 5 étapes pour convertir du HTML en PDF en C# avec la commande d'installation NuGet
  1. Télécharger la bibliothèque IronPDF pour la conversion HTML en PDF
  2. Instanciez la classe ChromePdfRenderer
  3. Configurez les Options de rendu pour affiner le PDF de sortie
    4. RenderHtmlFileAsPdf
  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 rend les fichiers HTML en PDFs en utilisant 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?

Ceci est le fichier HTML example.html que le code rend :


<!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#
using 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

Dim renderer As 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 VB.NET
Using pdf = renderer.RenderHtmlFileAsPdf("example.html")
    ' Export to a file or Stream
    pdf.SaveAs("output.pdf")
End Using
$vbLabelText   $csharpLabel

La méthode RenderHtmlFileAsPdf() retourne un objet PdfDocument, qui contient les informations du 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 à Print applique des règles CSS spécifiques à l'impression, tandis que les paramètres de marge créent un document en pleine page. Le délai de 120 secondes permet aux fichiers HTML complexes contenant des ressources externes de se charger complètement.

Le RenderDelay de 50 millisecondes garantit que toutes les ressources se chargent avant de créer le 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 assignez-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.

Icon Quote related to Comment utiliser les paramètres d'impression par défaut de Chrome?

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic related to Comment utiliser les paramètres d'impression par défaut de Chrome?

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas
Icon Quote related to Comment utiliser les paramètres d'impression par défaut de Chrome?

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle related to Comment utiliser les paramètres d'impression par défaut de Chrome?

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas
Icon Quote related to Comment utiliser les paramètres d'impression par défaut de Chrome?

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones related to Comment utiliser les paramètres d'impression par défaut de Chrome?

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

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-le sur une langue spécifique avec hyphens: auto dans votre CSS pour activer la coupure automatique des mots dans le PDF généré. Pour des cas d'utilisation avancés, la propriété CustomHyphenation accepte des modèles de césure personnalisés qui priment 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 : Toujours disposer des objets PdfDocument lorsque vous avez terminé pour libérer des ressources mémoire.
  4. Traitement par lots : Réutilisez la même instance ChromePdfRenderer lors de la conversion de plusieurs fichiers pour de meilleures 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 20,296,129 | Version : 2026.7 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.