Rendu d'un fichier HTML en PDF en C# ; avec IronPDF
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 IronPDFConvertissez 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#.
-
1Install IronPDF with NuGet Package Manager
-
2Copiez et exécutez cet extrait de code.
new IronPdf.ChromePdfRenderer() .RenderHtmlFileAsPdf("path/to/your/file.html") .SaveAs("output.pdf");C# -
3Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque IronPDF pour la conversion HTML en PDF
- Instanciez la classe ChromePdfRenderer
- Configurez les Options de rendu pour affiner le PDF de sortie
- Passer le chemin du fichier HTML au moteur de rendu
- Enregistrer et télécharger le PDF
RenderHtmlFileAsPdfComment 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 :
<!-- :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>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#?
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")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.
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.DefaultChromeLes 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 :
ChromePdfRenderOptionsprend en charge la césure via la propriétéHyphenationLanguage. Définissez-le sur une langue spécifique avechyphens: autodans 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éCustomHyphenationaccepte des modèles de césure personnalisés qui priment sur l'option basée sur la langue.
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");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.
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.
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.
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.
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);
}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)
NextRendu 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 :
RenderHtmlFileAsPdflit un fichier depuis le disque ; les ressources relatives se résolvent à partir de l'emplacement du fichier.RenderHtmlAsPdfprend une chaîne HTML en mémoire ; vous définissez généralement une URL de base pour que les ressources se résolvent.RenderUrlAsPdfré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.
Considérations de Performance
Lorsque vous convertissez des fichiers HTML en PDF dans des environnements de production, tenez compte des optimisations suivantes :
- Opérations asynchrones : Utilisez les méthodes de génération de PDF asynchrones pour une meilleure réactivité de l'application.
- 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.
- Gestion des ressources : Toujours disposer des objets
PdfDocumentlorsque vous avez terminé pour libérer des ressources mémoire. - Traitement par lots : Réutilisez la même instance
ChromePdfRendererlors 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.
How can I optimize HTML to PDF conversion performance in IronPDF?
For better performance, consider using async operations, caching PDFs for repeated conversions, disposing of PdfDocument objects promptly, and reusing ChromePdfRenderer instances for batch processing.
Can I convert live websites directly to PDF using IronPDF?
Yes, IronPDF allows you to convert live website URLs directly into PDF documents through its URL to PDF conversion feature.
Does IronPDF support converting HTML strings to PDF?
Yes, IronPDF can convert dynamically generated HTML strings directly to PDF without needing to save them to a file first.
What are some common troubleshooting tips for HTML to PDF conversion with IronPDF?
Ensure all referenced resources are accessible, consider font embedding for consistent rendering, and use PDF compression for large files to troubleshoot conversion issues.
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 et créer des manuels bien structurés et visuellement attrayants.
