Comment utiliser C# pour la conversion de HTML en PDF avec IronPDF sur Azure Functions

Quel package IronPDF dois-je installer?

La première étape est d'installer IronPDF en utilisant NuGet :

• Sur les fonctions Azure basées sur Windows, utilisez le package IronPdf - Package NuGet IronPDF pour Windows
• Sur les fonctions Azure basées sur Linux, utilisez le package IronPdf.Linux - package NuGet IronPDF pour Linux

Install-Package IronPdf

Alternativement, installez manuellement le .dll en utilisant le lien Package de téléchargement direct de IronPDF pour Azure.

Pour des options d'installation plus avancées, consultez notre guide complet Packages NuGet.

Quelles sont les options Azure que je dois configurer ?

Quel niveau d'hébergement Azure dois-je choisir?

Azure Basic B1 est le niveau d'hébergement minimum requis pour les besoins de rendu. Si vous créez un système à haut débit, cela peut nécessiter une mise à niveau. Le niveau B1 fournit suffisamment de ressources pour le Chrome PDF Rendering Engine qui alimente la conversion HTML vers PDF d'IronPdf.

Pourquoi devrais-je décocher la case "Exécuter à partir d'un fichier paquet" ?

Lors de la publication de votre application Azure Functions, assurez-vous que Run from package file n'est PAS sélectionné. Cette option crée un déploiement en lecture seule qui empêche IronPDF d'extraire les dépendances d'exécution nécessaires pendant l'exécution.

Comment configurer .NET 6?

Microsoft a récemment supprimé les bibliothèques d'imagerie de .NET 6+, cassant de nombreuses API héritées. En tant que tel, il est nécessaire de configurer votre projet pour permettre encore ces appels d'API hérités.

1. Sous Linux, définissez Installation.LinuxAndDockerDependenciesAutoConfig=true; pour garantir que libgdiplus est installé sur la machine
2. Ajoutez ce qui suit au fichier .csproj de votre projet .NET 6 :

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   XML

3. Créez un fichier dans votre projet appelé runtimeconfig.template.json et remplissez-le avec les éléments suivants :

   {
     "configProperties": {
       "System.Drawing.EnableUnixSupport": true
     }
   }

4. Enfin, ajoutez la ligne suivante au début de votre programme pour activer la prise en charge d'Unix pour System.Drawing :

   System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

   System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

   System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)

   $vbLabelText   $csharpLabel

Quand utiliser Docker sur Azure?

Une manière d'obtenir contrôle, accès aux polices SVG, et la capacité de contrôler les performances sur Azure est d'utiliser des applications et fonctions IronPDF depuis les conteneurs Docker. Cette approche permet de mieux contrôler l'environnement d'exécution et d'éliminer de nombreuses limitations liées à la plate-forme.

Nous avons un tutoriel complet Docker Azure IronPDF pour les instances Linux et Windows, et il est recommandé de le consulter.

Exemple de rendu de chaîne HTML avancé

Pour des scénarios plus complexes impliquant du HTML personnalisé avec un style CSS, vous pouvez utiliser les fonctionnalités HTML String to PDF :

[FunctionName("RenderHtmlWithCss")]
public static async Task<IActionResult> RenderHtmlWithCss(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
    ILogger log)
{
    log.LogInformation("Processing HTML to PDF request");

    // Read HTML content from request body
    string htmlContent = await new StreamReader(req.Body).ReadToEndAsync();

    // Configure renderer with custom options
    var renderer = new ChromePdfRenderer()
    {
        RenderingOptions = new ChromePdfRenderOptions()
        {
            MarginTop = 20,
            MarginBottom = 20,
            MarginLeft = 10,
            MarginRight = 10,
            CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
            PrintHtmlBackgrounds = true,
            CreatePdfFormsFromHtml = true
        }
    };

    try
    {
        // Add custom CSS
        string styledHtml = $@"
            <html>
            <head>
                <style>
                    body {{ font-family: Arial, sans-serif; padding: 20px; }}
                    h1 {{ color: #2c3e50; }}
                    .highlight {{ background-color: #f1c40f; padding: 5px; }}
                </style>
            </head>
            <body>
                {htmlContent}
            </body>
            </html>";

        var pdf = renderer.RenderHtmlAsPdf(styledHtml);

        return new FileContentResult(pdf.BinaryData, "application/pdf") 
        { 
            FileDownloadName = "styled-document.pdf" 
        };
    }
    catch (Exception ex)
    {
        log.LogError(ex, "Failed to render HTML to PDF");
        return new BadRequestObjectResult("Error processing HTML content");
    }
}

[FunctionName("RenderHtmlWithCss")]
public static async Task<IActionResult> RenderHtmlWithCss(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
    ILogger log)
{
    log.LogInformation("Processing HTML to PDF request");

    // Read HTML content from request body
    string htmlContent = await new StreamReader(req.Body).ReadToEndAsync();

    // Configure renderer with custom options
    var renderer = new ChromePdfRenderer()
    {
        RenderingOptions = new ChromePdfRenderOptions()
        {
            MarginTop = 20,
            MarginBottom = 20,
            MarginLeft = 10,
            MarginRight = 10,
            CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
            PrintHtmlBackgrounds = true,
            CreatePdfFormsFromHtml = true
        }
    };

    try
    {
        // Add custom CSS
        string styledHtml = $@"
            <html>
            <head>
                <style>
                    body {{ font-family: Arial, sans-serif; padding: 20px; }}
                    h1 {{ color: #2c3e50; }}
                    .highlight {{ background-color: #f1c40f; padding: 5px; }}
                </style>
            </head>
            <body>
                {htmlContent}
            </body>
            </html>";

        var pdf = renderer.RenderHtmlAsPdf(styledHtml);

        return new FileContentResult(pdf.BinaryData, "application/pdf") 
        { 
            FileDownloadName = "styled-document.pdf" 
        };
    }
    catch (Exception ex)
    {
        log.LogError(ex, "Failed to render HTML to PDF");
        return new BadRequestObjectResult("Error processing HTML content");
    }
}

Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.Azure.WebJobs
Imports Microsoft.Azure.WebJobs.Extensions.Http
Imports Microsoft.AspNetCore.Http
Imports Microsoft.Extensions.Logging
Imports IronPdf

Public Module HtmlToPdfFunction

    <FunctionName("RenderHtmlWithCss")>
    Public Async Function RenderHtmlWithCss(
        <HttpTrigger(AuthorizationLevel.Function, "post", Route:=Nothing)> req As HttpRequest,
        log As ILogger) As Task(Of IActionResult)

        log.LogInformation("Processing HTML to PDF request")

        ' Read HTML content from request body
        Dim htmlContent As String = Await New StreamReader(req.Body).ReadToEndAsync()

        ' Configure renderer with custom options
        Dim renderer As New ChromePdfRenderer() With {
            .RenderingOptions = New ChromePdfRenderOptions() With {
                .MarginTop = 20,
                .MarginBottom = 20,
                .MarginLeft = 10,
                .MarginRight = 10,
                .CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print,
                .PrintHtmlBackgrounds = True,
                .CreatePdfFormsFromHtml = True
            }
        }

        Try
            ' Add custom CSS
            Dim styledHtml As String = $"
                <html>
                <head>
                    <style>
                        body {{ font-family: Arial, sans-serif; padding: 20px; }}
                        h1 {{ color: #2c3e50; }}
                        .highlight {{ background-color: #f1c40f; padding: 5px; }}
                    </style>
                </head>
                <body>
                    {htmlContent}
                </body>
                </html>"

            Dim pdf = renderer.RenderHtmlAsPdf(styledHtml)

            Return New FileContentResult(pdf.BinaryData, "application/pdf") With {
                .FileDownloadName = "styled-document.pdf"
            }
        Catch ex As Exception
            log.LogError(ex, "Failed to render HTML to PDF")
            Return New BadRequestObjectResult("Error processing HTML content")
        End Try
    End Function

End Module

Pour la gestion des licences dans vos IronPDF, consultez notre documentation Utilisation des clés de licence.

Pourquoi les polices SVG ne s'affichent-elles pas sur les plans d'hébergement partagés ?

Une limitation est que la plateforme d'hébergement Azure ne prend pas en charge les serveurs chargeant les polices SVG, telles que Google Fonts, dans leurs niveaux de web-apps partagées moins coûteux. Ceci est dû aux restrictions de sécurité empêchant l'accès aux objets graphiques Windows GDI+.

Nous recommandons d'utiliser un guide de conteneur Docker Windows ou Linux pour IronPDF ou peut-être un VPS sur Azure pour contourner ce problème là où le meilleur rendu de police est requis.

Pourquoi l'hébergement Azure Free Tier est-il lent ?

Les niveaux gratuits et partagés d'Azure, ainsi que le plan de consommation, ne conviennent pas au rendu PDF. Nous recommandons l'hébergement Azure B1/plan Premium, que nous utilisons nous-mêmes. Le processus HTML to PDF représente une charge de travail importante pour tout ordinateur, comparable à l'ouverture et à l'affichage d'une page web sur votre propre machine. Un véritable moteur de navigateur est utilisé ; il est donc nécessaire de prévoir les ressources nécessaires et de s'attendre à des temps de rendu similaires à ceux d'un ordinateur de bureau aux performances équivalentes.

Comment déboguer localement Azure Functions?

Pour le développement et les tests locaux, consultez notre guide sur Débogage du projet Azure Functions sur une machine locale. Cela vous aidera à identifier et à résoudre les problèmes avant le déploiement sur Azure.

Où puis-je trouver les journaux Azure ?

Lors de la résolution de problèmes de génération de PDF, les journaux Azure sont d'une valeur inestimable. Consultez notre guide Fichiers journaux Azure pour obtenir des instructions sur l'accès et l'interprétation des journaux spécifiques aux opérations IronPDF.

Comment créer une demande d'assistance technique?

Pour créer un ticket de demande, reportez-vous au guide How to Make an Engineering Support Request for IronPDF.