Comment convertir HTML en PDF dans ASP .NET en utilisant C#

Comment convertir HTML en PDF dans ASP.NET avec IronPDF

1. Créez un projet ASP.NET en utilisant Visual Studio ou l'IDE de votre choix.
2. Installez IronPDF et configurez votre clé de licence.
3. Créez un nouveau contrôleur ou une nouvelle page où vous souhaitez gérer la conversion en PDF.
4. Écrivez votre logique de conversion dans le contrôleur.
5. Configurez le routage pour permettre l'accès à votre action de génération de PDF.

Un aperçu d'IronPDF

IronPDF est une puissante bibliothèque PDF qui permet aux développeurs de lire, créer et manipuler des documents PDF. Avec un ensemble de fonctionnalités riches et un processus d'installation rapide et simple, vous pouvez faire passer vos projets PDF au niveau supérieur en un rien de temps grâce à IronPDF. Son API intuitive est facile à apprendre, en faisant un choix idéal si vous cherchez à générer des documents PDF dynamiques, effectuer des tâches de sécurité PDF, des annotations PDF, etc., directement à partir de votre application web.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Visual Studio ou un autre environnement de développement C# configuré.
• Bibliothèque IronPDF installée. Vous pouvez l'obtenir de NuGet ou directement du site d'IronPDF.

Créer un nouveau projet ASP.NET

Lancez Visual Studio et sélectionnez le type de projet ASP.NET qui correspond le mieux à vos besoins. Pour l'exemple d'aujourd'hui, je vais créer une application web ASP.NET Core (Modèle-vue-contrôleur).

Ensuite, entrez le nom de votre projet et choisissez l'emplacement pour héberger le projet.

Enfin, choisissez votre framework .NET pour le projet, et modifiez tous les paramètres supplémentaires pour le projet, tels que le type d'authentification, ou l'activation du support des conteneurs et de docker.

Ajouter du code de conversion HTML en PDF

Maintenant que nous avons créé notre projet ASP.NET, nous pouvons commencer à écrire le code pour convertir le contenu de fichiers HTML en PDF. Nous commencerons par un simple exemple de chaîne HTML à PDF, avant d'examiner la conversion de contenu HTML avec personnalisation.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	Public Class PdfController
		Inherits Controller

		' Action method to generate a PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the HTML string to PDF
			Dim renderer As New ChromePdfRenderer()

			' Convert HTML string to PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Return the generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

ASP.NET MVC utilise des contrôleurs pour gérer les requêtes utilisateur. Lorsqu'un utilisateur navigue vers une URL spécifique, ASP.NET appellera une méthode dans le contrôleur associé à cette route.

• PdfController est une classe héritant de Controller, ce qui signifie qu'elle peut gérer les requêtes web et envoyer des réponses.
• La méthode GeneratePdf à l'intérieur de ce contrôleur gérera une requête pour convertir le HTML en PDF et renvoyer le résultat.

Lorsqu'un utilisateur visite une URL liée à l'action GeneratePdf, la méthode s'exécute.

• IActionResult : Il s'agit du type de retour, représentant la réponse que l'application web enverra à l'utilisateur. Cela pourrait être une vue (page HTML), un téléchargement de fichier, etc. Dans ce cas, c'est un fichier PDF.

  • Méthode GeneratePdf() :

  • À l'intérieur de la méthode, nous définissons une chaîne htmlContent qui contient le HTML que vous souhaitez convertir en PDF. For example, "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>".

  • Nous créons une nouvelle instance de ChromePdfRenderer, qui gère la conversion de HTML en PDF.

  • La méthode RenderHtmlAsPdf() prend la chaîne HTML et renvoie un objet PDF.

Sortie PDF personnalisée

Maintenant que nous avons couvert les bases, examinons la création d'un fichier PDF à partir de contenu HTML avec certains paramètres de personnalisation pour le PDF de sortie. IronPDF provides a powerful set of PDF customization tools, such as margins, headers/footers, custom PDF sizing, and more.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	' Controller for our PDF converter
	Public Class PdfController
		Inherits Controller

		' Action method to generate a customized PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the URL to PDF
			Dim renderer As New ChromePdfRenderer()

			' Creating the cover page
			Dim cover As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>")

			' Adding custom options for our final PDF
			renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape
			renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3
			renderer.RenderingOptions.TextHeader.CenterText = "IronPDF"
			renderer.RenderingOptions.TextHeader.FontSize = 12
			renderer.RenderingOptions.MarginTop = 20
			renderer.RenderingOptions.FirstPageNumber = 2

			' Creating our main PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Appending the cover to the main PDF
			pdf.InsertPdf(cover, 0)

			' Return the customized generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

Conclusion

Aujourd'hui, nous avons examiné de plus près comment la conversion de HTML en PDF peut être utilisée avec ASP.NET, et exploré le processus de création de fichiers PDF à partir de HTML dans un projet ASP.NET. En suivant les étapes décrites ci-dessus, vous pouvez facilement intégrer la génération de PDF dans vos applications web, vous permettant de créer des documents de haute qualité, imprimables à partir de contenu HTML.

IronPDF dispose d'un ensemble riche de fonctionnalités qui peuvent être utilisées pour produire des documents PDF de haute qualité. Pour des fonctionnalités plus avancées et une personnalisation détaillée, veuillez vous référer à la documentation d'IronPDF. Avec son installation rapide, vous pouvez avoir IronPDF configuré dans votre projet en un rien de temps.