Wie man ASP HTML zu PDF in .NET Core konvertiert

Installation über NuGet Package Manager

Der schnellste Weg, IronPDF zu Ihrem ASP.NET-Projekt hinzuzufügen, um HTML in PDF zu konvertieren, erfolgt über den NuGet-Paket-Manager in Visual Studio. Klicken Sie mit der rechten Maustaste auf Ihr Projekt in Lösungsexplorer, wählen Sie "NuGet-Pakete verwalten", und suchen Sie nach IronPDF. Klicken Sie auf Installieren, um die neueste Version zu Ihrem Projekt hinzuzufügen. Für detaillierte Installationsanweisungen siehe das IronPDF-Installationshandbuch.

Install-Package IronPdf

Erforderliche Namespaces hinzufügen

Sobald es installiert ist, fügen Sie den IronPDF-Namespace zu jeder C#-Datei hinzu, in der Sie mit der PDF-Erstellung arbeiten möchten:

using IronPdf;

using IronPdf;

Imports IronPdf

Diese einfache Importanweisung gibt Ihnen Zugriff auf die gesamte Funktionalität von IronPDF, einschließlich der ChromePdfRenderer-Klasse für die HTML-Konvertierung und verschiedener Konfigurationsoptionen zur Anpassung Ihrer PDF-Ausgabe.

Grundkonfiguration

Für die meisten ASP.NET Core-Anwendungen funktioniert IronPDF sofort nach der Installation ohne zusätzliche Konfiguration. Sie können jedoch globale Optionen in Ihrer Program.cs- oder Startup.cs-Datei festlegen:

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Diese Konfigurationsoptionen helfen dabei, IronPDF für Ihre spezifische Hosting-Umgebung zu optimieren, unabhängig davon, ob Sie auf Windows, Linux oder in Docker-Containern arbeiten. Stellen Sie sicher, dass sowohl die Skript- als auch die Anwendungsdateien nicht im selben Verzeichnis gespeichert werden, um Konflikte zu vermeiden.

Arbeiten mit CSS und Bildern

IronPDF unterstützt vollständig CSS-Styling und kann Bilder aus verschiedenen Quellen einbetten, wenn HTML in PDF konvertiert wird. Der PDF-Konverter behandelt HTML-Elemente mit vollständiger Genauigkeit, einschließlich verschiedener HTML-Tags und Bild-URLs:

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der Renderer verarbeitet Inline-Stile, CSS-Dateien und sogar base64-kodierte Bilder. Dadurch wird sichergestellt, dass Ihre PDF-Seiten das exakte Erscheinungsbild Ihrer HTML-Inhalte beibehalten, einschließlich moderner CSS3-Funktionen wie Flexbox und Grid-Layouts. Die HTML-zu-PDF-Konvertierung bewahrt alle HTML-Tags und deren Styling, ohne leere Seiten zu erzeugen.

Konvertierung von Controller-Ansichten

In Ihrem ASP.NET Core-Controller können Sie eine Ansicht in HTML rendern und dann mit den leistungsstarken PDF-Bibliotheks-Rendering-Funktionen von IronPDF in ein PDF-Dokument konvertieren:

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dieser Ansatz rendert zunächst Ihre Razor-Ansicht in einen HTML-String und konvertiert sie dann in PDF. Das PDF wird als Dateidownload mit einem geeigneten Dateinamen an den Browser des Benutzers zurückgegeben. Dies funktioniert nahtlos, unabhängig davon, ob Sie eine ASPX-Datei oder moderne Razor-Ansichten konvertieren.

Konvertierung von URLs zu PDF

Für bestehende Webseiten können Sie IronPDF als leistungsstarken HTML-zu-PDF-Konverter verwenden, um jede angegebene URL direkt in PDF-Dateien umzuwandeln. Geben Sie einfach eine HTTP- oder HTTPS-Adresse als URL-Parameter an:

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Diese Methode ist besonders nützlich, wenn Sie bereits gut formatierte Webseiten haben und sie als herunterladbare PDF-Version anbieten möchten. Die .NET-Bibliothek behandelt alle externen Ressourcen, einschließlich Stylesheets, Skripten und Bildern, und sorgt für vollständige HTML-Darstellung. Der Konverter gibt einen passenden HTTP-Statuscode zurück, wenn er auf eine ungültige URL stößt.

Umgang mit Authentifizierung

Beim Konvertieren authentifizierter Seiten mit .NET-Formular-Authentifizierung oder anderen Sicherheitsmechanismen können Sie Cookies oder Header übergeben, um dieselbe Benutzersitzung beizubehalten. Dies verhindert die Umleitung zu einem Anmeldebildschirm während der PDF-Konvertierung:

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dadurch wird sichergestellt, dass geschützte HTML-Inhalte als PDF-Dateien konvertiert werden können, wobei die Sicherheit gewahrt bleibt. Der PDF-Konvertierungsprozess respektiert die Grundauthentifizierung und Formularauthentifizierung Ihrer Anwendung und verhindert unbefugten Zugriff auf sensible bestehende Dokumente. Sie können auch Benutzername und Passwort-Argumente übergeben, wenn nötig, für Szenarien der Grundauthentifizierung.

Seiteneinrichtung und Ränder

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Diese Einstellungen steuern das physische Layout Ihrer PDF-Seiten, einschließlich sowohl ungerader als auch gerader Seiten. Sie können aus Standardpapiergrößen wählen oder benutzerdefinierte Abmessungen definieren, die Porträt- oder Querformat-Orientierung festlegen und Ränder anpassen, um Ihre Designanforderungen für mehrere Seiten zu erfüllen. Das Grafikvorlagensystem sorgt für ein konsistentes Styling auf nachfolgenden ungeraden und geraden Seiten.

Kopf- und Fußzeilen

Konsistente Kopf- und Fußzeilen wirken sich vorteilhaft auf das professionelle Erscheinungsbild Ihrer PDF-Dokumente aus, wenn Sie HTML-Dokumente konvertieren:

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

Köpfe und Füße unterstützen HTML-Elemente und Formatierungen mit speziellen Platzhaltern für Seitennummern, Daten und andere dynamische Inhalte über alle PDF-Seiten hinweg. Der folgende Code zeigt, wie Sie professionelle Kopfzeilen zu Ihrem dynamisch generierten Dokument oder bestehenden PDF-Dokumenten hinzufügen.