Erstellen eines PDF-Viewers in ASP.NET Core MVC | Tutorial

Wie installiert man IronPDF in einem ASP.NET Core MVC-Projekt?

Bevor Sie einen PDF-Viewer in ASP.NET Core MVC erstellen, müssen Sie IronPDF zu Ihrem Projekt hinzufügen. Am schnellsten geht es über den NuGet -Paket-Manager in Visual Studio oder über die Befehlszeile mit der .NET CLI oder der Paket-Manager-Konsole.

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

Sobald das Paket installiert ist, fügen Sie den Namespace IronPdf zu Ihren Controller-Dateien hinzu und schon können Sie mit dem Generieren und Bereitstellen von PDF-Dokumenten beginnen. IronPDF zielt auf .NET 8 und .NET 10 ab und funktioniert daher ohne zusätzliche Konfiguration mit den neuesten ASP.NET Core Versionen.

Für Projekte, die eine Offline-Installation oder die Festlegung einer bestimmten Version erfordern, können Sie das NuGet Paket auch direkt herunterladen und als lokalen Feed hinzufügen. Auf der IronPDF -Lizenzseite finden Sie Informationen zu Test- und Produktionslizenzen, falls Sie diese vor der Live-Schaltung benötigen.

Wie werden PDF-Dateien in modernen Browsern angezeigt?

Moderne Browser wie Chrome, Firefox, Edge und Safari bieten native PDF-Anzeigefunktionen. Wenn Ihre ASP.NET Core Anwendung eine Datei mit dem Inhaltstyp application/pdf zurückgibt, rendert der Browser das PDF-Dokument direkt im Browser, ohne dass Adobe Acrobat oder externe Plugins erforderlich sind. Dieser integrierte PDF-Viewer unterstützt Textauswahl, Drucken, Zoom , Lesezeichen und Seitennavigation und bietet so ein Dokumentenanzeigeerlebnis, das den Nutzern bereits vertraut ist.

Um vorhandene Dateien sicher bereitzustellen, ist es am besten, die Hosting-Umgebung zu verwenden, um sie zu finden, anstatt sich auf Verzeichnispfade zu verlassen, die sich zwischen Entwicklung und Produktion ändern können. Die Verwendung eines Dateistreams ist zudem speichereffizienter als das Laden ganzer Byte-Arrays für große Dokumente.

using Microsoft.AspNetCore.Mvc;

public class DocumentController : Controller
{
    public IActionResult ViewPdf()
    {
        // Path to an existing PDF file in the wwwroot folder
        string path = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "documents", "sample.pdf");
        byte[] fileBytes = System.IO.File.ReadAllBytes(path);
        // Return file for inline browser display
        return File(fileBytes, "application/pdf");
    }
}

using Microsoft.AspNetCore.Mvc;

public class DocumentController : Controller
{
    public IActionResult ViewPdf()
    {
        // Path to an existing PDF file in the wwwroot folder
        string path = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "documents", "sample.pdf");
        byte[] fileBytes = System.IO.File.ReadAllBytes(path);
        // Return file for inline browser display
        return File(fileBytes, "application/pdf");
    }
}

Imports Microsoft.AspNetCore.Mvc

Public Class DocumentController
    Inherits Controller

    Public Function ViewPdf() As IActionResult
        ' Path to an existing PDF file in the wwwroot folder
        Dim path As String = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "documents", "sample.pdf")
        Dim fileBytes As Byte() = System.IO.File.ReadAllBytes(path)
        ' Return file for inline browser display
        Return File(fileBytes, "application/pdf")
    End Function
End Class

Wie generiert man dynamisch PDF-Dokumente in ASP.NET Core?

Statische PDF-Dateien sind zwar nützlich, doch viele Webanwendungen benötigen dynamisch generierte Dokumente, die auf den jeweiligen Benutzer oder die Anfrage zugeschnitten sind. Die Klasse ChromePdfRenderer von IronPDF wandelt HTML-Inhalte mithilfe einer echten Chromium-Browser-Engine in professionell gerenderte PDF-Dateien um.

Sie können externe Ressourcen wie CSS für Ihr spezifisches Design oder JavaScript für Diagramme direkt in den HTML-String einbinden. Die Rendering-Engine unterstützt moderne Webstandards wie CSS3, JavaScript ES6+ und Webfonts , sodass das generierte PDF genau so aussieht, wie der Browser die gleiche HTML-Seite rendern würde.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    public IActionResult GenerateReport()
    {
        var renderer = new ChromePdfRenderer();
        // HTML content with CSS styling
        string html = @"
            <html>
            <head>
                <style>
                    body { font-family: Arial, sans-serif; padding: 40px; }
                    h1 { color: #2c3e50; }
                    .report-body { line-height: 1.6; }
                </style>
            </head>
            <body>
                <h1>Monthly Sales Report</h1>
                <div class='report-body'>
                    <p>Generated: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
                    <p>This report contains the latest sales figures.</p>
                </div>
            </body>
            </html>";

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    public IActionResult GenerateReport()
    {
        var renderer = new ChromePdfRenderer();
        // HTML content with CSS styling
        string html = @"
            <html>
            <head>
                <style>
                    body { font-family: Arial, sans-serif; padding: 40px; }
                    h1 { color: #2c3e50; }
                    .report-body { line-height: 1.6; }
                </style>
            </head>
            <body>
                <h1>Monthly Sales Report</h1>
                <div class='report-body'>
                    <p>Generated: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
                    <p>This report contains the latest sales figures.</p>
                </div>
            </body>
            </html>";

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Public Class ReportController
    Inherits Controller

    Public Function GenerateReport() As IActionResult
        Dim renderer As New ChromePdfRenderer()
        ' HTML content with CSS styling
        Dim html As String = "
            <html>
            <head>
                <style>
                    body { font-family: Arial, sans-serif; padding: 40px; }
                    h1 { color: #2c3e50; }
                    .report-body { line-height: 1.6; }
                </style>
            </head>
            <body>
                <h1>Monthly Sales Report</h1>
                <div class='report-body'>
                    <p>Generated: " & DateTime.Now.ToString("MMMM dd, yyyy") & "</p>
                    <p>This report contains the latest sales figures.</p>
                </div>
            </body>
            </html>"

        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        Return File(pdf.BinaryData, "application/pdf")
    End Function
End Class

Wie steuert man die Anzeige im Text im Vergleich zum Dateidownload?

Manchmal müssen Benutzer PDF-Dateien herunterladen, anstatt sie im Browser anzuzeigen. Wie der Browser die Antwort verarbeitet, hängt vom Header Content-Disposition ab. Dieses Unterscheidungsvermögen ist wichtig, um in Ihrer Anwendung das richtige Nutzererlebnis zu bieten.

Wenn Sie den Dateinamenparameter in der File() Methode weglassen, setzt ASP.NET Core keinen Content-Disposition Header, sodass der Browser sein Standardverhalten verwendet -- das ist typischerweise die Inline-Anzeige. Wenn Sie als dritten Parameter einen Dateinamen angeben, fügt ASP.NET Core automatisch Content-Disposition: attachment hinzu und fordert die Benutzer auf, die Datei stattdessen zu speichern.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class PdfController : Controller
{
    public IActionResult DisplayInline()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
        renderer.RenderingOptions.MarginTop = 25;
        renderer.RenderingOptions.MarginBottom = 25;

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        // Display PDF inline in browser -- no filename = inline
        return File(pdf.BinaryData, "application/pdf");
    }

    public IActionResult DownloadPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.EnableJavaScript = true;

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        // Prompt download with specified filename
        return File(pdf.BinaryData, "application/pdf", "webpage-report.pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class PdfController : Controller
{
    public IActionResult DisplayInline()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
        renderer.RenderingOptions.MarginTop = 25;
        renderer.RenderingOptions.MarginBottom = 25;

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        // Display PDF inline in browser -- no filename = inline
        return File(pdf.BinaryData, "application/pdf");
    }

    public IActionResult DownloadPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.EnableJavaScript = true;

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        // Prompt download with specified filename
        return File(pdf.BinaryData, "application/pdf", "webpage-report.pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Public Class PdfController
    Inherits Controller

    Public Function DisplayInline() As IActionResult
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait
        renderer.RenderingOptions.MarginTop = 25
        renderer.RenderingOptions.MarginBottom = 25

        Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")
        ' Display PDF inline in browser -- no filename = inline
        Return File(pdf.BinaryData, "application/pdf")
    End Function

    Public Function DownloadPdf() As IActionResult
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter
        renderer.RenderingOptions.EnableJavaScript = True

        Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")
        ' Prompt download with specified filename
        Return File(pdf.BinaryData, "application/pdf", "webpage-report.pdf")
    End Function
End Class

Wie integriert man Razor Pages in die PDF-Generierung?

Razor Pages in ASP.NET Core MVC bieten einen weiteren Ansatz zur Implementierung eines .NET PDF-Viewers. Das Seitenmodell kann PDF-Dateien generieren und zurückgeben, indem es die gleiche IronPDF Funktionalität nutzt, die auch in Standard-MVC-Controllern verfügbar ist. Dieses Muster eignet sich gut für Anwendungen, die bereits Razor Pages verwenden, da die Logik zur PDF-Generierung an derselben Stelle wie die Seite bleibt, die sie auslöst.

Der OnGet Handler in einer Razor Page verhält sich wie eine Controller-Aktion – er empfängt die Anfrage, führt die Arbeit aus und gibt ein Ergebnis zurück. Die Rückgabe eines FileResult-Objekts aus einem Seitenmodell wird von ASP.NET Core unterstützt und funktioniert auf die gleiche Weise wie die Rückgabe eines File()-Objekts aus einem Controller.

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class InvoiceModel : PageModel
{
    public IActionResult OnGet(int id)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        // Add header and footer
        renderer.RenderingOptions.TextHeader.CenterText = "Invoice Document";
        renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}";
        renderer.RenderingOptions.TextFooter.FontSize = 10;

        string html = $@"
            <html>
            <head>
                <style>
                    body {{ font-family: 'Segoe UI', Arial, sans-serif; padding: 40px; }}
                    h1 {{ color: #1a5490; border-bottom: 2px solid #1a5490; padding-bottom: 10px; }}
                    .invoice-details {{ margin: 20px 0; }}
                    table {{ width: 100%; border-collapse: collapse; }}
                    th, td {{ padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{id}</h1>
                <div class='invoice-details'>
                    <p><strong>Date:</strong> {DateTime.Now:yyyy-MM-dd}</p>
                    <p><strong>Due Date:</strong> {DateTime.Now.AddDays(30):yyyy-MM-dd}</p>
                </div>
                <table>
                    <tr><th>Description</th><th>Amount</th></tr>
                    <tr><td>Professional Services</td><td>$1,500.00</td></tr>
                </table>
                <p style='margin-top: 40px;'>Thank you for your business!</p>
            </body>
            </html>";

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class InvoiceModel : PageModel
{
    public IActionResult OnGet(int id)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        // Add header and footer
        renderer.RenderingOptions.TextHeader.CenterText = "Invoice Document";
        renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}";
        renderer.RenderingOptions.TextFooter.FontSize = 10;

        string html = $@"
            <html>
            <head>
                <style>
                    body {{ font-family: 'Segoe UI', Arial, sans-serif; padding: 40px; }}
                    h1 {{ color: #1a5490; border-bottom: 2px solid #1a5490; padding-bottom: 10px; }}
                    .invoice-details {{ margin: 20px 0; }}
                    table {{ width: 100%; border-collapse: collapse; }}
                    th, td {{ padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{id}</h1>
                <div class='invoice-details'>
                    <p><strong>Date:</strong> {DateTime.Now:yyyy-MM-dd}</p>
                    <p><strong>Due Date:</strong> {DateTime.Now.AddDays(30):yyyy-MM-dd}</p>
                </div>
                <table>
                    <tr><th>Description</th><th>Amount</th></tr>
                    <tr><td>Professional Services</td><td>$1,500.00</td></tr>
                </table>
                <p style='margin-top: 40px;'>Thank you for your business!</p>
            </body>
            </html>";

        PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages

Public Class InvoiceModel
    Inherits PageModel

    Public Function OnGet(id As Integer) As IActionResult
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

        ' Add header and footer
        renderer.RenderingOptions.TextHeader.CenterText = "Invoice Document"
        renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}"
        renderer.RenderingOptions.TextFooter.FontSize = 10

        Dim html As String = $"
            <html>
            <head>
                <style>
                    body {{ font-family: 'Segoe UI', Arial, sans-serif; padding: 40px; }}
                    h1 {{ color: #1a5490; border-bottom: 2px solid #1a5490; padding-bottom: 10px; }}
                    .invoice-details {{ margin: 20px 0; }}
                    table {{ width: 100%; border-collapse: collapse; }}
                    th, td {{ padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{id}</h1>
                <div class='invoice-details'>
                    <p><strong>Date:</strong> {DateTime.Now:yyyy-MM-dd}</p>
                    <p><strong>Due Date:</strong> {DateTime.Now.AddDays(30):yyyy-MM-dd}</p>
                </div>
                <table>
                    <tr><th>Description</th><th>Amount</th></tr>
                    <tr><td>Professional Services</td><td>$1,500.00</td></tr>
                </table>
                <p style='margin-top: 40px;'>Thank you for your business!</p>
            </body>
            </html>"

        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
        Return File(pdf.BinaryData, "application/pdf")
    End Function
End Class

Wie handhaben Sie PDF-Sicherheit und Zugriffskontrolle?

In Produktionsanwendungen ist es oft notwendig, einzuschränken, wer ein PDF-Dokument anzeigen oder ändern darf. IronPDF bietet integrierte Unterstützung für PDF-Passwörter und Berechtigungen , sodass Sie Dokumente verschlüsseln, ein Passwort zum Öffnen verlangen oder das Drucken und Kopieren einschränken können.

Sie können Sicherheitseinstellungen auf jedes PdfDocument Objekt anwenden, bevor Sie es von Ihrem Controller zurückgeben. Dieser Ansatz funktioniert unabhängig davon, ob die PDF-Datei aus HTML generiert, von der Festplatte geladen oder aus einer Datenbank abgerufen wurde.

Bei sensiblen Dokumenten wie Verträgen, Finanzberichten oder Patientenakten ermöglicht die Kombination eines Benutzerpassworts mit eingeschränkten Berechtigungen eine präzise Kontrolle darüber, was Empfänger mit der Datei tun dürfen. Der PDF/A-konforme Modus ist eine weitere Option, die sich für Langzeitarchivierungen eignet, bei denen die Dokumentenintegrität über Jahrzehnte hinweg gewahrt bleiben muss.

Wie optimiert man die Leistung der PDF-Generierung?

Die PDF-Generierung erfordert CPU- und Speicherauslastung, daher ist die Leistung bei Anwendungen mit hohem Datenverkehr von Bedeutung. Die asynchrone Rendering-API von IronPDF ermöglicht es Ihnen, die PDF-Erstellung in einen Hintergrundthread auszulagern, ohne die Anfragepipeline zu blockieren. Dies ist besonders vorteilhaft, wenn mehrere PDFs in einer einzigen Anfrage generiert oder Batch-Aufträge verarbeitet werden.

Für Produktionsumgebungen unter Linux oder in Docker-Containern unterstützt IronPDF die plattformübergreifende Ausführung ohne dass Windows-spezifische Abhängigkeiten erforderlich sind. Die Installationsanleitung für IronPDF Linux und die Docker-Konfigurationsreferenz beschreiben die Einrichtungsschritte. Sowohl das Mozilla PDF.js-Projekt als auch native Browser-Viewer sind mit allen von IronPDF erzeugten PDFs kompatibel, sodass Sie auch bei der Darstellung flexibel sind.

Einige Praktiken zur Verbesserung des Produktionsdurchsatzes:

• Verwenden Sie nach Möglichkeit ChromePdfRenderer Instanzen wieder, anstatt für jede Anfrage eine neue zu erstellen, da die Initialisierung des Renderers einen gewissen Aufwand verursacht.
• Verwenden Sie asynchrone Methoden wie RenderHtmlAsPdfAsync, um den Thread freizugeben, während die Chromium-Engine rendert.
• Zwischenspeicherung der generierten PDFs mittels IMemoryCache oder eines verteilten Caches, wenn dasselbe Dokument wiederholt angefordert wird.
• Bei sehr großen Dokumenten empfiehlt es sich, die Ausgabe zu streamen, anstatt das gesamte Byte-Array im Speicher zu puffern.

Was sind Ihre nächsten Schritte?

Die Entwicklung eines PDF-Viewers in ASP.NET Core MVC kombiniert die nativen Anzeigefunktionen des Browsers mit den Generierungsfunktionen von IronPDF. Der in modernen Browsern integrierte PDF-Viewer übernimmt Anzeige, Druck und Navigation automatisch, wenn Ihr ASP.NET Controller Dateien mit dem korrekten MIME-Typ zurückgibt. IronPDF übernimmt die Generierungsseite – die Umwandlung von HTML, URLs oder bestehenden Dateien in gut formatierte PDF-Dokumente mit voller Unterstützung für CSS, JavaScript, Kopf- und Fußzeilen sowie Sicherheitseinstellungen.

Die wichtigsten in diesem Leitfaden behandelten Funktionen:

• Bereitstellung vorhandener PDF-Dateien inline mithilfe der Methode File() mit dem MIME-Typ application/pdf
• Generieren dynamischer PDFs aus HTML-Strings mit ChromePdfRenderer
• Steuerung der Inline-Anzeige im Vergleich zum Dateidownload über den Content-Disposition Header
• Hinzufügen von Kopf- und Fußzeilen, Rändern und Sicherheitseinstellungen über RenderingOptions
• Verwendung von Razor Pages als Alternative zu MVC-Controllern für die PDF-Generierung
• Anwendung von Passwortschutz und Zugriffsbeschränkungen auf sensible Dokumente
• Verbesserung der Leistung durch asynchrones Rendering und Antwort-Caching

Von hier aus können Sie fortgeschrittenere Arbeitsabläufe erkunden, wie z. B. das Zusammenführen mehrerer PDFs , das Erstellen ausfüllbarer Formulare oder das Generieren von PDFs aus CSHTML Razor Ansichten . Die IronPDF Dokumentation beschreibt alle Funktionen anhand von funktionierenden Codebeispielen.

Starten Sie Ihre kostenlose Testphase , um alle Funktionen von IronPDF kennenzulernen, oder erwerben Sie eine Lizenz für den Produktiveinsatz.