Wie man C#35; für HTML-zu-PDF mit IronPDF auf Azure Function verwendet

Welches IronPDF-Paket sollte ich installieren?

Der erste Schritt besteht darin, IronPDF mit NuGet zu installieren:

• Verwenden Sie für Windows-basierte Azure Functions das IronPdf-Paket - NuGet IronPdf-Paket für Windows
• Verwenden Sie für Linux-basierte Azure Functions das IronPdf.Linux-Paket - NuGet IronPdf-Paket für Linux

Install-Package IronPdf

Alternativ können Sie die .dll manuell über den Link IronPDF direct download package for Azure installieren.

Weitere fortgeschrittene Installationsoptionen finden Sie in unserem umfassenden Leitfaden für NuGet-Pakete.

Welche Azure-Optionen muss ich konfigurieren?

Welche Azure-Hosting-Stufe sollte ich wählen?

Azure Basic B1 ist die Mindest-Hosting-Stufe, die für die Rendering-Anforderungen erforderlich ist. Wenn Sie ein System mit hohem Durchsatz erstellen, muss dies möglicherweise aktualisiert werden. Die B1-Ebene bietet ausreichende Ressourcen für die Chrome PDF Rendering Engine, die IronPDFs HTML-zu-PDF-Konvertierung ermöglicht.

Warum sollte ich die Option "Aus Paketdatei ausführen" deaktivieren?

Stellen Sie bei der Veröffentlichung Ihrer Azure Functions-Anwendung sicher, dass Run from package file NICHT ausgewählt ist. Mit dieser Option wird eine schreibgeschützte Bereitstellung erstellt, die IronPDF daran hindert, während der Ausführung notwendige Laufzeitabhängigkeiten zu extrahieren.

Wie konfiguriere ich mich für .NET 6?

Microsoft hat kürzlich Bildbibliotheken aus .NET 6+ entfernt, was viele Legacy-APIs beeinträchtigt. Daher ist es notwendig, Ihr Projekt so zu konfigurieren, dass diese Legacy-API-Aufrufe weiterhin möglich sind.

1. Unter Linux setzen Sie Installation.LinuxAndDockerDependenciesAutoConfig=true;, um sicherzustellen, dass libgdiplus auf dem Rechner installiert ist
2. Fügen Sie das folgende in die .csproj-Datei für Ihr .NET 6-Projekt ein:

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

   XML

3. Erstellen Sie eine Datei in Ihrem Projekt mit dem Namen runtimeconfig.template.json und füllen Sie sie mit dem folgenden Inhalt:

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

4. Fügen Sie schließlich die folgende Zeile am Anfang Ihres Programms hinzu, um Unix-Unterstützung für System.Drawing zu aktivieren:

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

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

   $vbLabelText   $csharpLabel

Wann sollte ich Docker auf Azure verwenden?

Eine Möglichkeit zur Kontrolle, Zugriff auf SVG-Schriften und zur Steuerung der Leistung auf Azure ist die Nutzung von IronPDF-Anwendungen und -Funktionen innerhalb von Docker-Containern. Dieser Ansatz bietet eine bessere Kontrolle über die Laufzeitumgebung und beseitigt viele plattformspezifische Einschränkungen.

Wir haben ein umfassendes IronPDF Azure Docker Tutorial für Linux- und Windows-Instanzen, das als Lektüre empfohlen wird.

Erweitertes HTML String Rendering Beispiel

Für komplexere Szenarien, die benutzerdefiniertes HTML mit CSS-Styling beinhalten, können Sie die HTML String to PDF-Funktionen nutzen:

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

Informationen zur Verwaltung von Lizenzen in Ihren Azure Functions finden Sie in unserer Verwendung von Lizenzschlüsseln-Dokumentation.

Warum werden SVG-Schriften bei Shared-Hosting-Angeboten nicht gerendert?

Ein Einschränkung besteht darin, dass die Azure-Hosting-Plattformübersicht keine Server unterstützt, die SVG-Schriften wie Google Fonts in ihren günstigeren Shared-Web-App-Ebenen laden. Dies liegt an Sicherheitsbeschränkungen, die den Zugriff auf Windows GDI+ Grafikobjekte verhindern.

Wir empfehlen die Verwendung eines Windows- oder Linux-Docker-Container-Leitfadens für IronPDF oder eventuell eines VPS auf Azure, um dieses Problem zu umgehen, wenn die beste Schriftenrendarbeitung erforderlich ist.

Warum ist Azure Free Tier Hosting langsam?

Die kostenlosen und geteilten Azure-Stufen sowie der Verbrauchsplan sind nicht für die PDF-Renderung geeignet. Wir empfehlen das Azure B1 Hosting/Premium-Plan, welches wir selbst verwenden. Der Prozess von HTML to PDF ist eine bedeutende 'Arbeit' für jeden Computer - ähnlich wie das Öffnen und Rendern einer Webseite auf Ihrem eigenen Computer. Ein echtes Browser-Engine wird verwendet, daher müssen wir entsprechend bereitstellen und ähnliche Renderzeiten wie bei einem Desktop-Rechner von ähnlicher Leistung erwarten.

Wie kann ich Azure Functions lokal debuggen?

Für die lokale Entwicklung und das Testen lesen Sie bitte unseren Leitfaden Debugging Azure Functions Project on Local Machine. Dies hilft Ihnen, Probleme zu erkennen und zu beheben, bevor Sie Azure einsetzen.

Wo kann ich Azure Logs finden?

Bei der Behebung von Problemen mit der PDF-Erzeugung sind die Azure-Protokolle von unschätzbarem Wert. In unserem Leitfaden für Azure-Protokolldateien finden Sie Anleitungen für den Zugriff auf und die Interpretation von Protokollen, die für IronPDF-Operationen spezifisch sind.

Wie erstelle ich eine technische Support-Anfrage?

Um ein Anfrage-Ticket zu erstellen, lesen Sie den Leitfaden Wie man eine technische Support-Anfrage für IronPDF stellt.