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

Quel package IronPDF dois-je installer?

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

• Sur les Azure Functions basées sur Windows, utilisez le package IronPdf - Package NuGet IronPdf pour Windows
• Sur les Azure Functions 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 Exécuter à partir du fichier de package 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 vous assurer 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 ce qui suit :

   {
     "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);

   $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");
    }
}

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 de HTML to PDF représente un travail significatif pour tout ordinateur - similaire à ouvrir et rendre une page web sur votre propre machine. Un véritable moteur de navigateur est utilisé, d'où la nécessité de prévoir en conséquence et de s'attendre à des temps de rendu similaires à ceux d'une machine de bureau de puissance similaire.

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.