Comment rendre un fichier HTML en PDF en utilisant C#

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

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.

<TODO : Ajouter une image ici -->

<Description : Diagramme ou capture d'écran illustrant le concept de code -->

en-tête:2(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#.

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()
      .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 grâce à un essai gratuit.
    arrow pointer

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

<TODO : Ajouter une image ici -->

<Description : Capture d'écran montrant la sortie ou les résultats de l'exécution d'un code -->

IronPDF rend 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?

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

<!-- :path=/static-assets/pdf/how-to/html-file-to-pdf/example.html -->
<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>
<!-- :path=/static-assets/pdf/how-to/html-file-to-pdf/example.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#35;?

: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. Le réglage de CssMediaType sur Print applique des règles CSS spécifiques à l'impression, tandis que le réglage des marges crée 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 RenderDelay de 50 millisecondes garantit le chargement de toutes les ressources 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 affectez-la à `RenderingOptions`. Avec ce paramètre, la sortie d'IronPDF correspond exactement à l'aperçu avant impression de Chrome. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf-default-chrome.cs ``` 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](https://ironpdf.com/how-to/html-string-to-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](https://ironpdf.com/how-to/url-to-pdf/). - **Archives ZIP HTML** : Pour les projets complexes comportant de multiples ressources, apprenez à [convertir des fichiers ZIP HTML en PDF](https://ironpdf.com/how-to/html-zip-file-to-pdf/). ## 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](https://ironpdf.com/how-to/async/) 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** : Pour libérer des ressources mémoire, éliminez toujours les objets `PdfDocument` lorsqu'ils sont terminés. 4. **Traitement par lots** : Réutilisez la même instance de `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 : - : 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](https://ironpdf.com/how-to/manage-fonts/). - : Pour les fichiers HTML comportant de nombreuses images ou des mises en page complexes, utilisez [les techniques de compression des PDF](https://ironpdf.com/how-to/pdf-compression/) 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](https://ironpdf.com/tutorials/convert-pdf/)

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.

Regan Pun
Ingénieur logiciel
Regan a obtenu son diplôme de l'Université de Reading, avec une licence en ingénierie électronique. Avant de rejoindre Iron Software, ses rôles précédents le poussaient à se concentrer intensément sur des tâches uniques ; et ce qu'il apprécie le plus chez Iron Software, c'est ...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,685,821 | Version : 2025.12 vient de sortir