Icône de message
Passer au contenu du pied de page
  1. IronPDF
  2. Blog IronPDF
  3. Utilisation de ironpdf
  4. ASP HTML en PDF
UTILISATION DE IRONPDF

Comment convertir HTML ASP en PDF dans .NET Core

Curtis Chau
Curtis Chau
Publié:

La conversion de HTML dynamique ASP.NET en documents PDF est une exigence fondamentale dans les applications modernes ASP.NET. Que vous génériez des factures, créiez des rapports ou produisiez des fichiers PDF téléchargeables, la capacité de transformer du contenu HTML en documents PDF professionnels est essentielle pour offrir des expériences utilisateur soignées.

IronPDF simplifie ce processus de conversion ASP HTML en PDF en fournissant un moteur de rendu robuste basé sur Chrome qui préserve parfaitement votre formatage HTML, votre style CSS et la fonctionnalité JavaScript dans les documents PDF résultants. Ce tutoriel vous guidera à travers des méthodes efficaces pour convertir le HTML en PDF dans les applications ASP.NET Core en utilisant la bibliothèque IronPDF.

Pourquoi les développeurs ont-ils besoin de la conversion HTML en PDF ?

Les applications ASP.NET Core génèrent souvent du contenu HTML dynamique que les utilisateurs doivent télécharger, partager ou archiver en fichiers PDF. La conversion HTML en PDF offre plusieurs avantages clés par rapport au simple enregistrement de pages web ou la prise de captures d'écran.

Les documents PDF conservent un formatage cohérent sur tous les appareils et plateformes, garantissant que vos factures ont le même aspect, qu'elles soient vues sur Windows, Mac ou appareils mobiles. Ils sont également idéaux pour les documents existants nécessitant des signatures numériques, des paramètres de sécurité ou une impression professionnelle. La conversion de PDF côté serveur élimine le besoin pour les utilisateurs d'avoir un logiciel spécifique installé et offre un meilleur contrôle sur le résultat final du fichier PDF.

Les cas d'utilisation courants incluent la génération de rapports financiers à partir de données de tableau de bord, la création de factures téléchargeables à partir d'informations de commande, la production de billets et de passes avec des codes QR, et la conversion de soumissions de formulaires en enregistrements permanents. En gérant la conversion HTML ASP en PDF sur le serveur, vous garantissez des résultats cohérents, quel que soit le navigateur ou les capacités de l'appareil de l'utilisateur.

Comment fonctionne l'installation d'IronPDF ?

Commencer avec IronPDF dans votre projet ASP.NET Core est simple. La bibliothèque prend en charge .NET Core 2.0 et plus, ainsi que .NET 5, 6, 7 et 8, la rendant compatible avec toutes les applications modernes ASP.NET Core pour des tâches de conversion HTML en PDF.

Installation via le gestionnaire de packages NuGet

Le moyen le plus rapide d'ajouter IronPDF à votre projet ASP.NET pour convertir du HTML en PDF est via le gestionnaire de packages NuGet dans Visual Studio. Cliquez avec le bouton droit sur votre projet dans l'Explorateur de solutions, sélectionnez "Gérer les packages NuGet" et recherchez IronPDF. Cliquez sur Installer sur la dernière version pour l'ajouter à votre projet. Pour des instructions d'installation détaillées, consultez le guide d'installation d'IronPDF.

Install-Package IronPdf

Ajout des espaces de noms requis

Une fois installé, ajoutez l'espace de noms IronPDF à tout fichier C# où vous travaillerez avec la génération de PDF :

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel

Cette simple déclaration d'importation vous donne accès à toutes les fonctionnalités d'IronPDF, y compris la classe ChromePdfRenderer pour la conversion HTML et diverses options de configuration pour personnaliser votre sortie PDF.

Configuration de base

Pour la plupart des applications ASP.NET Core, IronPDF fonctionne immédiatement après l'installation sans configuration supplémentaire. Cependant, vous pouvez définir des options globales dans votre fichier Program.cs ou Startup.cs :

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;
// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Ces options de configuration aident à optimiser IronPDF pour votre environnement d'hébergement spécifique, que vous fonctionniez sous Windows, Linux ou dans des conteneurs Docker. Assurez-vous que les fichiers de script et d'application ne résident pas dans le même répertoire pour éviter les conflits.

Comment convertir des chaînes HTML en PDF ?

L'opération la plus fondamentale dans IronPDF est la conversion de chaînes HTML directement en documents PDF. Cette approche est parfaite lorsque vous construisez du contenu HTML dynamiquement dans votre application ASP.NET ou que vous travaillez avec des documents HTML comme modèles.

// Create a PDF converter instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF document
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Report</h1><p>Generated on: " + DateTime.Now + "</p>");
// Save the resultant PDF document to a file
pdf.SaveAs("report.pdf");
// Create a PDF converter instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF document
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Report</h1><p>Generated on: " + DateTime.Now + "</p>");
// Save the resultant PDF document to a file
pdf.SaveAs("report.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Cet extrait de code crée une nouvelle instance de ChromePdfRenderer, qui utilise le moteur Chromium pour rendre votre contenu HTML. La méthode RenderHtmlAsPdf accepte toute chaîne HTML valide et retourne un objet PdfDocument. Vous pouvez ensuite enregistrer ce fichier PDF sur disque ou le diffuser directement aux utilisateurs sous forme de tableau d'octets. En savoir plus sur la classe ChromePdfRenderer et ses fonctionnalités.

Travailler avec le CSS et les images

IronPDF prend entièrement en charge le style CSS et peut intégrer des images de diverses sources lorsqu'il convertit du HTML en PDF. Le convertisseur PDF gère les éléments HTML avec une fidélité complète, y compris diverses balises HTML et URL d'image :

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Le moteur de rendu traite les styles en ligne, les fichiers CSS et même les images encodées en base64. Cela garantit que vos pages PDF conservent l'apparence exacte de votre contenu HTML, y compris les fonctionnalités CSS3 modernes comme les mises en page flexbox et grille. La conversion HTML en PDF préserve toutes les balises HTML et leur style sans générer de pages blanches.

Comment convertir des vues ASP.NET Core en PDF ?

Convertir des pages web ou des vues ASP.NET Core entières en PDF est une exigence courante, surtout pour générer des rapports basés sur des documents HTML existants. IronPDF propose plusieurs approches pour ce scénario de conversion HTML en PDF ASP, que vous travailliez avec une seule page ou plusieurs pages.

Conversion des vues de contrôleur

Dans votre contrôleur ASP.NET Core, vous pouvez rendre une vue en HTML et la convertir ensuite en document PDF en utilisant les puissantes capacités de rendu de la bibliothèque PDF d'IronPDF :

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}
[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Cette approche rend d'abord votre vue Razor en une chaîne HTML, puis la convertit en PDF. Le PDF est renvoyé comme un téléchargement de fichier au navigateur de l'utilisateur avec un nom de fichier approprié. Cela fonctionne sans problème que vous convertissiez un fichier ASPX ou des vues Razor modernes.

Conversion des URL en PDF

Pour les pages web existantes, vous pouvez utiliser IronPDF comme un puissant convertisseur HTML en PDF pour transformer toute URL spécifiée directement en fichiers PDF. Il suffit de fournir une adresse HTTP ou HTTPS comme paramètre URL :

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}
[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Cette méthode est particulièrement utile lorsque vous avez déjà des pages web bien formatées et que vous souhaitez les proposer au format PDF téléchargeable. La bibliothèque .NET gère toutes les ressources externes, y compris les feuilles de style, les scripts et les images, garantissant un rendu HTML complet. Le convertisseur retournera un code de statut HTTP approprié s'il rencontre une URL invalide.

Gestion de l'authentification

Lors de la conversion de pages authentifiées avec une authentification par formulaire .NET ou d'autres mécanismes de sécurité, vous pouvez passer des cookies ou des en-têtes pour maintenir la même session de compte utilisateur. Cela empêche la redirection vers un écran de connexion pendant la conversion en PDF :

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");
var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Cela garantit que le contenu HTML protégé peut être converti en fichiers PDF tout en maintenant la sécurité. Le processus de conversion PDF respecte l'authentification de base de votre application et l'authentification par formulaires, empêchant tout accès utilisateur non autorisé aux documents existants sensibles. Vous pouvez également passer des arguments de nom d'utilisateur et de mot de passe lorsque nécessaire pour les scénarios d'authentification de base.

Comment pouvez-vous personnaliser la sortie PDF ?

IronPDF propose de nombreuses options de personnalisation en tant que convertisseur PDF complet pour contrôler comment vos documents PDF sont générés à partir de documents HTML. Ces paramètres vous aident à créer des fichiers PDF professionnels répondant à des exigences spécifiques de mise en page et de formatage.

Configuration de la page et marges

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Ces paramètres contrôlent la mise en page physique de vos pages PDF, incluant à la fois les pages impaires et paires. Vous pouvez choisir parmi des tailles de papier standard ou définir des dimensions personnalisées, régler l'orientation portrait ou paysage, et ajuster les marges pour correspondre à vos besoins de conception pour plusieurs pages. Le système de modèles graphiques assure une cohérence de style sur les pages impaires suivantes et paires.

En-têtes et pieds de page

Ajouter des en-têtes et pieds de page cohérents améliore l'apparence professionnelle de vos documents PDF lors de la conversion de documents HTML :

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Les en-têtes et pieds de page prennent en charge les éléments HTML et le formatage avec des espaces réservés spéciaux pour les numéros de page, les dates, et d'autres contenus dynamiques sur toutes les pages PDF. Le code suivant démontre comment ajouter des en-têtes professionnels à votre document généré dynamiquement ou à des documents PDF existants.

Quelles sont les meilleures pratiques ?

Pour garantir des performances et une qualité optimales lors de la conversion de HTML en PDF, suivez ces pratiques éprouvées pour une conversion PDF réussie.

Testez toujours votre rendu HTML dans un navigateur d'abord pour vérifier le style et la mise en page avant de générer des fichiers PDF. Utilisez des URL absolues pour les ressources externes autant que possible, car les chemins relatifs peuvent causer des problèmes pendant le processus de conversion HTML en PDF. Pour des pages web complexes avec de nombreux éléments HTML et JavaScript, ajoutez des délais de rendu pour garantir un chargement complet. Envisagez de mettre en œuvre le caching pour les documents PDF fréquemment générés afin de réduire la charge du serveur. Pour plus de bonnes pratiques sur ASP.NET Core avec cette bibliothèque .NET, référez-vous à la documentation officielle de Microsoft.

Lors du déploiement en production, configurez des chemins de dossiers temporaires appropriés et assurez-vous que votre environnement d'hébergement a les dépendances nécessaires installées pour la bibliothèque PDF, en particulier pour les déploiements Linux. Évitez de placer à la fois le script et la logique de conversion dans le même répertoire pour éviter les conflits. Consultez notre guide de dépannage pour les scénarios de déploiement courants avec des documents PDF existants. Validez toujours que l'entrée n'est pas une URL lorsque vous avez l'intention de traiter le contenu HTML direct pour éviter un comportement inattendu.

Conclusion

La conversion ASP HTML en PDF dans les applications ASP.NET Core devient simple avec IronPDF. Le moteur de rendu basé sur Chrome de la bibliothèque garantit une conversion précise tout en offrant de nombreuses options de personnalisation pour la génération de documents professionnels.

Que vous travailliez avec des chaînes HTML, une URL, ou des pages web complètes, IronPDF préserve le formatage exact, la mise en forme CSS, et le comportement JavaScript. Cet outil d'application web basé sur .NET gère efficacement l'ensemble du processus de conversion PDF.

Start your free 30-day trial or réservez une démo avec notre équipe.

Questions Fréquemment Posées

Quelle est la fonction principale d'IronPDF dans les applications ASP.NET ?

IronPDF est utilisé pour convertir le contenu HTML en documents PDF professionnels dans les applications ASP.NET. Il permet aux développeurs de générer des factures, de créer des rapports, et de produire des fichiers PDF téléchargeables efficacement.

Pourquoi la conversion de HTML en PDF est-elle importante dans les projets ASP.NET ?

La conversion de HTML en PDF est cruciale dans les projets ASP.NET car elle aide à offrir des expériences utilisateurs soignées en transformant du contenu dynamique en documents PDF professionnels et partageables, tels que des factures et des rapports.

IronPDF peut-il gérer le contenu HTML dynamique dans ASP.NET?

Oui, IronPDF est conçu pour gérer le contenu HTML dynamique, ce qui le rend idéal pour générer des PDFs à partir de pages web et d'applications ASP.NET dynamiques.

Quels sont les cas d'utilisation courants de la conversion HTML en PDF dans ASP.NET ?

Les cas d'utilisation courants incluent la génération de factures, la création de rapports, et la fourniture de fichiers PDF téléchargeables à partir d'applications web.

IronPDF prend-il en charge le style dans les documents PDF convertis?

Oui, IronPDF prend en charge le style CSS, permettant aux développeurs de maintenir l'apparence et le ressenti du contenu HTML original dans les documents PDF convertis.

Comment IronPDF améliore-t-il l'expérience utilisateur dans les applications ASP.NET?

IronPDF améliore l'expérience utilisateur en permettant aux développeurs de proposer des documents PDF de haute qualité, tels que des rapports et des factures, directement depuis leurs applications ASP.NET, assurant ainsi cohérence et professionnalisme.

Est-il possible d'automatiser la génération de PDF avec IronPDF?

Oui, IronPDF permet l'automatisation de la génération de PDF, ce qui permet aux développeurs de créer et de gérer des documents PDF de manière programmatique au sein de leurs applications ASP.NET.

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

Articles connexes

Essai de 30 jours → Produit complet. Pas de limites. Pas de carte. Démarrer l'essai gratuit