Como usar C# para converter HTML em PDF com o IronPDF no Azure Functions

Qual pacote do IronPDF devo instalar?

O primeiro passo é instalar o IronPDF usando o NuGet:

• Em Funções do Azure baseadas no Windows, use o pacote IronPdf - Pacote NuGet IronPdf para Windows
• Em Funções do Azure baseadas em Linux, use o pacote IronPdf.Linux - Pacote NuGet IronPdf para Linux

Install-Package IronPdf

Como alternativa, instale manualmente o arquivo .dll usando o link de download direto do pacote IronPDF para Azure .

Para opções de instalação mais avançadas, consulte nosso guia completo de Pacotes NuGet .

Quais opções do Azure preciso configurar?

Qual plano de hospedagem do Azure devo escolher?

O Azure Basic B1 é o nível mínimo de hospedagem necessário para atender às necessidades de renderização. Se você estiver criando um sistema de alto rendimento, talvez seja necessário atualizá-lo. O plano B1 fornece recursos suficientes para o mecanismo de renderização de PDF do Chrome , que é responsável pela conversão de HTML para PDF do IronPDF.

Por que devo desmarcar a opção "Executar a partir do arquivo de pacote"?

Ao publicar seu aplicativo Azure Functions, certifique-se de que Run from package file NÃO esteja selecionado. Esta opção cria uma implantação somente leitura que impede o IronPDF de extrair as dependências de tempo de execução necessárias durante a execução.

Como faço para configurar o .NET 6?

A Microsoft removeu recentemente as bibliotecas de imagens do .NET 6+, o que quebrou muitas APIs legadas. Portanto, é necessário configurar seu projeto para ainda permitir chamadas a essas APIs legadas.

1. No Linux, defina Installation.LinuxAndDockerDependenciesAutoConfig=true; para garantir que libgdiplus esteja instalado na máquina.
2. Adicione o seguinte ao arquivo .csproj do seu projeto .NET 6:

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   XML

3. Crie um arquivo em seu projeto chamado runtimeconfig.template.json e preencha-o com o seguinte:

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

4. Por fim, adicione a seguinte linha ao início do seu programa para habilitar o suporte Unix para 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

Quando devo usar o Docker no Azure?

Uma maneira de obter controle, acesso a fontes SVG e a capacidade de controlar o desempenho no Azure é usar aplicativos e funções do IronPDF dentro de contêineres Docker. Essa abordagem proporciona um melhor controle sobre o ambiente de execução e elimina muitas limitações específicas da plataforma.

Temos um tutorial completo sobre o IronPDF Azure Docker para instâncias Linux e Windows, e recomendamos a sua leitura.

Exemplo avançado de renderização de strings HTML

Para cenários mais complexos que envolvam HTML personalizado com estilos CSS, você pode usar os recursos de conversão de string HTML para 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

Para gerenciar licenças em suas Funções do Azure, consulte nossa documentação sobre como usar chaves de licença .

Por que as fontes SVG não são exibidas em planos de hospedagem compartilhada?

Uma limitação é que a visão geral da plataforma de hospedagem Azure não oferece suporte a servidores que carregam fontes SVG, como o Google Fonts, em seus planos mais baratos de aplicativos web compartilhados. Isso ocorre devido a restrições de segurança que impedem o acesso a objetos gráficos GDI+ do Windows.

Recomendamos o uso de um guia de contêiner Docker para Windows ou Linux para o IronPDF , ou talvez um VPS no Azure, para solucionar esse problema quando a melhor renderização de fontes for necessária.

Por que a hospedagem gratuita do Azure é lenta?

Os planos gratuitos e compartilhados do Azure, assim como o plano de consumo, não são adequados para renderização de PDFs. Recomendamos o plano de hospedagem Azure B1/Premium, que é o que nós mesmos utilizamos. O processo de HTML to PDF exige um esforço considerável de qualquer computador, semelhante a abrir e renderizar uma página da web em sua própria máquina. Um mecanismo de navegador real é utilizado , portanto, precisamos provisionar recursos adequadamente e esperar tempos de renderização semelhantes aos de um computador desktop com capacidade similar.

Como posso depurar o Azure Functions localmente?

Para desenvolvimento e testes locais, consulte nosso guia sobre Depuração de projetos do Azure Functions em uma máquina local . Isso ajuda você a identificar e resolver problemas antes da implantação no Azure.

Onde posso encontrar os logs do Azure?

Ao solucionar problemas de geração de PDFs, os logs do Azure são de valor inestimável. Consulte nosso guia de Arquivos de Log do Azure para obter instruções sobre como acessar e interpretar logs específicos das operações do IronPDF.

Como faço para criar uma solicitação de suporte técnico?

Para criar um ticket de solicitação, consulte o guia Como fazer uma solicitação de suporte técnico para o IronPDF .