Jak wygenerować plik PDF w .NET Core za pomocą IronPDF

W jaki sposób .NET Core generuje pliki PDF?

IronPDF wykorzystuje silnik renderujący oparty na przeglądarce Chrome do konwersji treści HTML na pliki PDF. Takie podejście oznacza, że możesz wykorzystać swoją dotychczasową wiedzę z zakresu HTML i CSS do tworzenia plików PDF bez konieczności nauki skomplikowanych, niskopoziomowych interfejsów API PDF lub zmagania się z trudną krzywą uczenia się. Biblioteka obsługuje automatyczną konwersję stron internetowych, wspierając wykonywanie kodu JavaScript oraz responsywne układy CSS.

API biblioteki pozwala generować dokumenty PDF na podstawie ciągów znaków HTML, adresów URL lub lokalnych plików HTML. Podczas konwersji HTML do PDF IronPDF zachowuje złożone układy, stylizację CSS, działanie JavaScript oraz dynamiczną zawartość stron internetowych. To sprawia, że jest to praktyczny wybór dla programistów .NET, którzy potrzebują niezawodnych funkcji konwersji plików PDF w swoich aplikacjach.

Proces renderowania wykorzystuje tę samą technologię, która zasila przeglądarkę Google Chrome, zapewniając, że konwersje HTML do PDF odpowiadają temu, co użytkownicy widzą w nowoczesnych przeglądarkach. Obejmuje to obsługę funkcji CSS3, czcionek internetowych, grafiki SVG oraz nowoczesnych systemów układów, takich jak Flexbox i CSS Grid. Ponieważ silnik renderujący jest oparty na przeglądarce Chrome, wynik jest przewidywalny i spójny w środowiskach programistycznych, testowych i produkcyjnych.

Jak zainstalować IronPDF w projekcie .NET 10?

Rozpoczęcie pracy wymaga jednorazowej instalacji za pośrednictwem menedżera pakietów NuGet. W zależności od Twojego sposobu pracy masz dwie opcje.

Opcja 1: Konsola menedżera pakietów w Visual Studio

Install-Package IronPdf

Install-Package IronPdf

Opcja 2: .NET CLI

dotnet add package IronPdf

dotnet add package IronPdf

Aby uzyskać szczegółowe instrukcje dotyczące instalacji, zapoznaj się z przewodnikiem instalacji NuGet.

W przypadku wdrożeń Docker lub środowisk Linux mogą być wymagane dodatkowe zależności systemowe. IronPDF obsługuje systemy macOS, Windows, Linux, Azure i AWS Lambda, dzięki czemu można go dostosować do różnych scenariuszy hostingu. Po instalacji dodaj klucz licencji Trial, aby odblokować pełny zestaw funkcji podczas programowania. Wersja próbna jest bezpłatna i nie wymaga podawania danych karty kredytowej, dzięki czemu można w pełni ocenić bibliotekę przed zakupem licencji komercyjnej.

Jak wygenerować plik PDF z ciągu znaków HTML?

Najprostszym sposobem na stworzenie pliku PDF jest konwersja treści HTML. Oto minimalny przykład wykorzystujący instrukcje najwyższego poziomu w języku C#:

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")

Klasa ChromePdfRenderer obsługuje proces konwersji. Zwrócony obiekt PdfDocument zapewnia dostęp do danych binarnych, liczby stron oraz opcji wyjściowych, takich jak zapis do pliku lub strumienia pamięci. Do pliku wyjściowego można również dołączyć metadane, takie jak tytuł, autor i słowa kluczowe dotyczące tematu.

Renderer obsługuje szeroki zakres opcji renderowania. Można konfigurować niestandardowe marginesy, ustawiać rozmiary papieru, kontrolować orientację strony oraz dostosowywać wymiary okna wyświetlania. Te opcje gwarantują, że plik PDF spełnia konkretne wymagania dotyczące formatowania profesjonalnych dokumentów.

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")

Jak przekonwertować adres URL strony internetowej na plik PDF?

IronPDF może generować pliki PDF z aktywnych stron internetowych poprzez przekazanie adresu URL do renderera. Jest to przydatne, gdy trzeba dynamicznie przechwycić zawartość strony internetowej lub zarchiwizować stronę publiczną:

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")

Ustawienie RenderDelay gwarantuje, że treści oparte na JavaScript (wykresy, obrazy ładowane z opóźnieniem, tabele dynamiczne) zostaną w pełni wyrenderowane przed przechwyceniem pliku PDF. Można również skonfigurować warunki WaitFor, aby czekać na zakończenie określonych elementów DOM lub żądań sieciowych. W przypadku stron wymagających uwierzytelnienia biblioteka obsługuje nagłówki żądań HTTP i niestandardowe pliki cookie.

W przypadku złożonych aplikacji jednostronicowych zbudowanych przy użyciu Angular lub React dodatkowe warunki oczekiwania pomagają zagwarantować, że całe renderowanie po stronie klienta zostanie zakończone przed wykonaniem migawki PDF.

Jak zintegrować generowanie plików PDF z kontrolerem ASP.NET Core?

Generowanie plików PDF w ramach interfejsu API ASP.NET Core Web API jest proste. Poniższy przykład przedstawia akcję kontrolera, która tworzy raport HTML i zwraca go jako plik do pobrania:

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

Typ zwracanej wartości File() nakazuje ASP.NET Core przesyłanie strumieniowo surowych bajtów pliku PDF do przeglądarki klienta z prawidłowym typem MIME. Klient otrzymuje plik PDF do pobrania bez żadnych plików pośrednich na dysku. Możesz dodać nagłówki i stopki do każdej strony lub zastosować znaki wodne w przypadku dokumentów roboczych lub poufnych.

W przypadku aplikacji produkcyjnych warto rozważyć użycie asynchronicznego generowania plików PDF, aby potok żądań nie był blokowany, szczególnie podczas generowania dużych lub złożonych dokumentów.

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

<AttributeUsage(AttributeTargets.Method)>
Public Class HttpGetAttribute
    Inherits Attribute
End Class

<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

Jak rozpocząć pracę z IronPDF w .NET 10?

IronPDF sprawia, że generowanie plików PDF w .NET Core jest proste. Silnik renderujący Chrome zapewnia dokładność podczas tworzenia plików PDF z treści HTML, a konstrukcja API eliminuje typową złożoność związaną z manipulacją plikami PDF. Biblioteka zawiera kompletną dokumentację wszystkich funkcji i obsługuje wdrażanie w systemach Windows, Linux, macOS, Azure Functions, AWS Lambda oraz kontenerach Docker.

Niezależnie od tego, czy tworzysz faktury, raporty czy narzędzia do zarządzania dokumentami, IronPDF zapewnia narzędzia niezbędne do profesjonalnego tworzenia plików PDF. Zapoznaj się z pełną listą funkcji, aby zrozumieć pełen zakres możliwości biblioteki, lub sprawdź opcje licencyjne dostosowane do potrzeb indywidualnych programistów i zespołów korporacyjnych.

Rozpocznij bezpłatny okres próbny już dziś, aby przetestować IronPDF w swoim własnym projekcie .NET 10. Licencja Trial obejmuje pełny zestaw funkcji, dzięki czemu przed zakupem licencji można przetestować generowanie plików PDF, scalanie, podpisywanie, wypełnianie formularzy i wyodrębnianie tekstu.

Aby uzyskać dodatkowy kontekst, zapoznaj się ze stroną główną dokumentacji IronPDF, gdzie znajdziesz Dokumentację API, przewodniki po platformach oraz przykłady kodu dotyczące typowych scenariuszy związanych z plikami PDF w środowisku .NET.

Źródła zewnętrzne:

• Dokumentacja Microsoft .NET
• Rejestr pakietów NuGet dla IronPDF
• Chrome dla programistów: Headless Chrome