RenderHtmlFileAsPdf réalise une tâche : il prend un fichier HTML sur disque et le rend en PDF via un moteur Chrome. Ce qui s'affiche correctement dans Chrome est rendu correctement dans le document, avec un support complet pour CSS3, JavaScript, les images et les polices. La seule distinction qui compte est l'entrée. Cette méthode lit un fichier, donc les chemins relatifs des actifs (logos, feuilles de style, polices) sont résolus à partir de l'emplacement du fichier lui-même, sans nécessiter d'URL de base. Cela décide où il s'adapte le mieux.

Génération de documents basée sur des modèles

Gardez un modèle HTML dans votre projet (facture, devis, certificat, contrat), remplissez-le, écrivez-le sur le disque et rendez-le :

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html")
        .SaveAs("invoice-1042.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html")
        .SaveAs("invoice-1042.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html").SaveAs("invoice-1042.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderHtmlFileAsPdf("templates/invoice-1042.html").SaveAs("invoice-1042.pdf")

Parce que la source est un fichier réel, ./logo.png et styles.css se résolvent naturellement en même temps.

Rendu de site statique et sortie de construction

Les générateurs de sites statiques, les pipelines Markdown et les générateurs de documentation produisent tous des fichiers HTML. Pointez IronPDF vers la sortie pour transformer une page publiée en un PDF archivable, sans avoir besoin de la reconsulter sur HTTP.

Mises en page créées par des designers

Un designer remet un fichier HTML et CSS autonome ; vous le rendez tel quel. Chrome gère la conversion, de sorte que l'aperçu du navigateur du designer correspond au PDF, ce qui élimine toute une classe de litiges "ça avait l'air bien dans la maquette".

Conversion par lot d'un dossier

La méthode est un appel par fichier, donc convertir un répertoire de rapports ou de documents à distribuer est une boucle courte :

var renderer = new ChromePdfRenderer();

foreach (string file in Directory.GetFiles("reports", "*.html"))
{
    string output = Path.ChangeExtension(file, ".pdf");
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output);
}

var renderer = new ChromePdfRenderer();

foreach (string file in Directory.GetFiles("reports", "*.html"))
{
    string output = Path.ChangeExtension(file, ".pdf");
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output);
}

Imports System.IO
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

For Each file As String In Directory.GetFiles("reports", "*.html")
    Dim output As String = Path.ChangeExtension(file, ".pdf")
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output)
Next

Imports System.IO
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

For Each file As String In Directory.GetFiles("reports", "*.html")
    Dim output As String = Path.ChangeExtension(file, ".pdf")
    renderer.RenderHtmlFileAsPdf(file).SaveAs(output)
Next

Rendu hors ligne et isolé

Parce qu'il lit depuis le système de fichiers local plutôt qu'une URL, cela fonctionne là où il n'y a pas de réseau sortant : backends sécurisés, exécuteurs CI, déploiements sur site. L'HTML et ses ressources n'ont besoin d'être présents que sur la machine.

Vérification de modèles d'e-mails

Les équipes stockant des modèles de notification ou d'e-mail sous forme de fichiers HTML peuvent les rendre en PDF pour révision, approbation ou archivage, sans installer un serveur web pour les visualiser.

La règle d'or

IronPDF offre trois points d'entrée, et choisir le mauvais est la source la plus courante de ressources cassées :

• RenderHtmlFileAsPdf lit un fichier depuis le disque ; les ressources relatives se résolvent à partir de l'emplacement du fichier.
• RenderHtmlAsPdf prend une chaîne HTML en mémoire ; vous définissez généralement une URL de base pour que les ressources se résolvent.
• RenderUrlAsPdf récupère sur HTTP, et c'est ici que l'authentification, les cookies et les connexions s'appliquent.

Utilisez la méthode de fichier chaque fois que votre HTML existe déjà sous forme de fichier. Configurez la sortie via RenderingOptions avant de rendre, et vérifiez d'abord la page dans Chrome ; si elle s'affiche là, elle s'affiche dans le PDF.