Wie man PDF in .NET Core mit IronPDF generiert

Wie generiert .NET Core PDF-Dateien?

IronPDF verwendet eine auf Chrome basierende Rendering-Engine, um HTML-Inhalte in PDF-Dateien umzuwandeln. Dieser Ansatz bedeutet, dass Sie Ihre vorhandenen HTML- und CSS-Kenntnisse nutzen können, um PDFs zu erstellen, ohne komplexe, Low-Level-PDF-APIs erlernen oder eine steile Lernkurve bewältigen zu müssen. Die Bibliothek übernimmt die automatische Konvertierung von Webseiten und unterstützt die Ausführung von JavaScript sowie responsive CSS-Layouts.

Die API der Bibliothek ermöglicht es Ihnen, PDF-Dokumente aus HTML-Strings, URLs oder lokalen HTML-Dateien zu generieren. Bei der Konvertierung von HTML in PDF bewahrt IronPDF komplexe Layouts, CSS-Styling, JavaScript Ausführung und dynamische Webinhalte. Dies macht es zu einer praktischen Wahl für .NET Entwickler, die in ihren Anwendungen zuverlässige PDF-Konvertierungsfunktionen benötigen.

Der Rendering-Prozess nutzt dieselbe Technologie wie Google Chrome und gewährleistet so, dass die HTML-zu-PDF-Konvertierungen dem entsprechen, was Benutzer in modernen Browsern sehen. Dies umfasst die Unterstützung von CSS3-Funktionen, Webfonts, SVG-Grafiken und modernen Layoutsystemen wie Flexbox und CSS Grid. Da die Rendering-Engine auf Chrome basiert, ist das Ergebnis in Entwicklungs-, Test- und Produktionsumgebungen vorhersehbar und konsistent.

Wie installiert man IronPDF in einem .NET 10-Projekt?

Für den Einstieg ist lediglich eine einmalige Installation über den NuGet Paketmanager erforderlich. Je nach Ihrem Arbeitsablauf haben Sie zwei Möglichkeiten.

Option 1: Paket-Manager-Konsole in Visual Studio

Install-Package IronPdf

Install-Package IronPdf

Option 2: .NET CLI

dotnet add package IronPdf

dotnet add package IronPdf

Eine schrittweise Anleitung zur Installation finden Sie in der NuGet-Installationsanleitung.

Für Docker-Bereitstellungen oder Linux-Umgebungen können zusätzliche Systemabhängigkeiten erforderlich sein. IronPDF unterstützt macOS, Windows, Linux, Azure und AWS Lambda und ist somit für verschiedene Hosting-Szenarien geeignet. Nach der Installation fügen Sie einen Testlizenzschlüssel hinzu, um während der Entwicklung den vollen Funktionsumfang freizuschalten. Die Testversion ist kostenlos und erfordert keine Kreditkarte, sodass Sie die Bibliothek umfassend testen können, bevor Sie eine kommerzielle Lizenz erwerben.

Wie generiert man eine PDF-Datei aus einem HTML-String?

Die direkteste Methode zur Erstellung einer PDF-Datei besteht in der Konvertierung von HTML-Inhalten. Hier ist ein Minimalbeispiel mit C#-Anweisungen auf oberster Ebene:

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>");

// Save to disk
pdf.SaveAs("hello.pdf");

using IronPdf;

// Instantiate the renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>");

// Save to disk
pdf.SaveAs("hello.pdf");

Imports IronPdf

' Instantiate the renderer
Dim renderer As New ChromePdfRenderer()

' Convert an HTML string to PDF
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>")

' Save to disk
pdf.SaveAs("hello.pdf")

Die Klasse ChromePdfRenderer übernimmt den Konvertierungsprozess. Das zurückgegebene PdfDocument-Objekt ermöglicht den Zugriff auf Binärdaten, Seitenzahl und Ausgabeoptionen wie das Speichern in einer Datei oder einem Speicherstrom. Sie können der Ausgabedatei auch Metadaten wie Titel, Autor und Schlagwörter hinzufügen.

Der Renderer unterstützt eine breite Palette von Rendering-Optionen. Sie können benutzerdefinierte Ränder konfigurieren, Papierformate festlegen, die Seitenausrichtung steuern und die Abmessungen des Ansichtsfensters anpassen. Diese Optionen gewährleisten, dass die PDF-Ausgabe spezifische Formatierungsanforderungen für Professional Dokumente erfüllt.

using IronPdf;

var html = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>";

var renderer = new ChromePdfRenderer();

// Apply custom margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

using IronPdf;

var html = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>";

var renderer = new ChromePdfRenderer();

// Apply custom margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

Imports IronPdf

Dim html As String = "
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; font-size: 14px; }
        .invoice-header {
            background-color: #2c3e50;
            color: white;
            padding: 20px;
        }
        .invoice-details { margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        .total {
            font-size: 1.2em;
            font-weight: bold;
            text-align: right;
        }
    </style>
</head>
<body>
    <div class='invoice-header'>
        <h1>Invoice #2026-001</h1>
        <p>Date: February 28, 2026</p>
    </div>
    <div class='invoice-details'>
        <h3>Bill To: Jane Smith</h3>
        <table>
            <tr>
                <th>Item</th>
                <th>Quantity</th>
                <th>Price</th>
            </tr>
            <tr>
                <td>Professional License</td>
                <td>1</td>
                <td>$749.00</td>
            </tr>
        </table>
        <p class='total'>Total: $749.00</p>
    </div>
</body>
</html>"

Dim renderer As New ChromePdfRenderer()

' Apply custom margins
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10

Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("invoice.pdf")

Wie konvertiert man eine Webseiten-URL in PDF?

IronPDF kann PDFs aus Live-Webseiten generieren, indem dem Renderer eine URL übergeben wird. Dies ist nützlich, wenn Sie Webinhalte dynamisch erfassen oder eine öffentliche Seite archivieren müssen:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.WaitFor.RenderDelay(1500); // Allow dynamic content to load

// Render the URL to PDF
var pdf = renderer.RenderUrlAsPdf("https://example.com");

// Save to disk
pdf.SaveAs("webpage.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920;
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.WaitFor.RenderDelay(1500); // Allow dynamic content to load

// Render the URL to PDF
var pdf = renderer.RenderUrlAsPdf("https://example.com");

// Save to disk
pdf.SaveAs("webpage.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Configure viewport and JavaScript settings
renderer.RenderingOptions.ViewPortWidth = 1920
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen
renderer.RenderingOptions.WaitFor.RenderDelay(1500) ' Allow dynamic content to load

' Render the URL to PDF
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")

' Save to disk
pdf.SaveAs("webpage.pdf")

Die Einstellung RenderDelay stellt sicher, dass JavaScript-gesteuerte Inhalte (Diagramme, Lazy-Load-Bilder, dynamische Tabellen) fertig gerendert werden, bevor die PDF-Datei erfasst wird. Sie können die WaitFor-Bedingungen auch so konfigurieren, dass sie auf die Fertigstellung bestimmter DOM-Elemente oder Netzwerkanforderungen warten. Für Seiten, die eine Authentifizierung erfordern, unterstützt die Bibliothek HTTP-Anforderungsheader und benutzerdefinierte Cookies.

Bei komplexen Single-Page-Anwendungen, die mit Angular oder React erstellt wurden, sorgen zusätzliche Wartebedingungen dafür, dass das gesamte clientseitige Rendering abgeschlossen ist, bevor der PDF-Snapshot erstellt wird.

![Vergleich im Splitscreen-Modus: Links wird eine Webseite im Browser gerendert, rechts die PDF-Konvertierung mit IronPDF in .NET Core.] Die PDF-Version behält alle Formatierungen, Bilder und die Layoutstruktur bei und demonstriert damit eine hochwertige HTML-zu-PDF-Konvertierung.](/static-assets/pdf/blog/dotnet-core-generate-pdf/dotnet-core-generate-pdf-2.webp)

Wie integriert man die PDF-Generierung in einen ASP.NET Core -Controller?

Das Generieren von PDFs innerhalb einer ASP.NET Core Web-API ist unkompliziert. Das folgende Beispiel zeigt eine Controller-Aktion, die einen HTML-Bericht erstellt und diesen als Dateidownload zurückgibt:

using Microsoft.AspNetCore.Mvc;
using IronPdf;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate-report")]
    public IActionResult GenerateReport()
    {
        var html = @"
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);

        // Return the PDF bytes as a downloadable file
        return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf");
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate-report")]
    public IActionResult GenerateReport()
    {
        var html = @"
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);

        // Return the PDF bytes as a downloadable file
        return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf");
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports IronPdf

<ApiController>
<Route("api/[controller]")>
Public Class PdfController
    Inherits ControllerBase

    <HttpGet("generate-report")>
    Public Function GenerateReport() As IActionResult
        Dim html As String = "
            <h1>Monthly Sales Report</h1>
            <p>Generated on: " & DateTime.Now.ToString("MMMM dd, yyyy") & "</p>
            <table>
                <tr><th>Product</th><th>Sales</th></tr>
                <tr><td>Product A</td><td>$5,000</td></tr>
                <tr><td>Product B</td><td>$3,500</td></tr>
            </table>"

        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(html)

        ' Return the PDF bytes as a downloadable file
        Return File(pdf.BinaryData, "application/pdf", "monthly-report.pdf")
    End Function
End Class

Der File() Rückgabetyp weist ASP.NET Core an, die Roh-PDF-Bytes mit dem richtigen MIME-Typ an den Client-Browser zu streamen. Der Kunde erhält eine herunterladbare PDF-Datei ohne Zwischenspeicherung auf der Festplatte. Sie können jeder Seite Kopf- und Fußzeilen hinzufügen oder Wasserzeichen für Entwürfe oder vertrauliche Dokumente anwenden.

Für Produktionsanwendungen empfiehlt sich die Verwendung der asynchronen PDF-Generierung, um die Anforderungspipeline nicht zu blockieren, insbesondere bei der Generierung großer oder komplexer Dokumente.

[HttpGet]
public async Task<IActionResult> DownloadInvoice(int id)
{
    // Fetch invoice data from the database
    var model = await GetInvoiceData(id);

    // Render the Razor view to an HTML string
    var html = await RenderViewToString("Invoice", model);

    // Convert the rendered HTML zu PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Return the file to the browser
    return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
}

[HttpGet]
public async Task<IActionResult> DownloadInvoice(int id)
{
    // Fetch invoice data from the database
    var model = await GetInvoiceData(id);

    // Render the Razor view to an HTML string
    var html = await RenderViewToString("Invoice", model);

    // Convert the rendered HTML zu PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Return the file to the browser
    return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
}

Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc

<HttpGet>
Public Async Function DownloadInvoice(id As Integer) As Task(Of IActionResult)
    ' Fetch invoice data from the database
    Dim model = Await GetInvoiceData(id)

    ' Render the Razor view to an HTML string
    Dim html = Await RenderViewToString("Invoice", model)

    ' Convert the rendered HTML to PDF
    Dim renderer = New ChromePdfRenderer()
    Dim pdf = renderer.RenderHtmlAsPdf(html)

    ' Return the file to the browser
    Return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
End Function

Wie fange ich mit IronPDF in .NET 10 an?

IronPDF vereinfacht die PDF-Generierung in .NET Core . Die Chrome-Rendering-Engine gewährleistet eine präzise Wiedergabetreue beim Erstellen von PDFs aus HTML-Inhalten, während das API-Design die typische Komplexität der PDF-Bearbeitung beseitigt. Die Bibliothek bietet eine vollständige Dokumentation für alle Funktionen und unterstützt die Bereitstellung unter Windows, Linux, macOS, Azure Functions, AWS Lambda und Docker-Containern.

Egal ob Sie Rechnungen, Berichte oder Dokumentenmanagement-Tools erstellen möchten, IronPDF bietet Ihnen die Werkzeuge, die Sie für die Professional PDF-Erstellung benötigen. Sehen Sie sich die vollständige Funktionsliste an, um den vollen Funktionsumfang der Bibliothek zu verstehen, oder informieren Sie sich über die Lizenzoptionen, die für einzelne Entwickler und Enterprise geeignet sind.

Starten Sie noch heute eine kostenlose Testversion , um IronPDF in Ihrem eigenen .NET 10-Projekt zu testen. Die Testlizenz umfasst den gesamten Funktionsumfang, sodass Sie die PDF-Erstellung, das Zusammenführen, Signieren, Ausfüllen von Formularen und die Textextraktion testen können, bevor Sie sich für eine Lizenz entscheiden.

Für weiteren Kontext besuchen Sie die IronPDF -Dokumentationsseite. Dort finden Sie API-Referenzen, Plattformleitfäden und Codebeispiele, die gängige .NET -PDF-Szenarien abdecken.

Externe Referenzen:

• Microsoft .NET -Dokumentation
• NuGet Paketregistrierung für IronPDF
• Chrome für Entwickler: Headless Chrome