Konwersja HTML na PDF w .NET Core za pomocą C# z IronPDF

Co obejmuje ten tutorial

• Konwersja URL, ciagu HTML i widoku Razor
• Konfiguracja papieru, marginesu i typu media
• Wdrazanie kross-platformowe (Windows, Linux, Docker)
• Post-procesowanie: lacz, dodaj znaki wodne, chroń hasłem i podpisuj cyfrowo PDFy
• Przykład end-to-end: aplikacja MVC rezerwacji biletów

Jak to działa

• ChromePdfRenderer uruchamia instancję Chromium w powłoce - nie jest wymagana oddzielna instalacja Chrome.
• RenderUrlAsPdf przechwytuje całkowicie wyrenderowany DOM, w tym treści napędzane przez JavaScript, zapytania medialne CSS i czcionki.
• Uzyskany PdfDocument udostępnia metody pomocnicze do łączenia, ochrony hasłem lub cyfrowego podpisywania wyjścia - możliwości omawiane później w tym tutorialu.

Po więcej szczegółów na temat niuansów wdrożeniowych (Azure App Service, AWS Lambda, on-prem Linux) zobacz dedykowany przewodnik instalacji oraz strony zaawansowanej konfiguracji NuGet. Wewnętrzne wskazówki CI/CD dla Docker i klastrów K8s omówiono w najlepszych praktykach wdrażania Docker.

Krok po kroku przykład

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-4.cs

public class ClientServices
{
    private static ClientModel _clientModel;
    public static void AddClient(ClientModel clientModel)
    {
        _clientModel = clientModel;
    }
    public static ClientModel GetClient()
    {
        return _clientModel;
    }
}

Public Class ClientServices
	Private Shared _clientModel As ClientModel
	Public Shared Sub AddClient(ByVal clientModel As ClientModel)
		_clientModel = clientModel
	End Sub
	Public Shared Function GetClient() As ClientModel
		Return _clientModel
	End Function
End Class

Dlaczego to działa

• ChromePdfRenderer uruchamia instancję Chromium w powłoce - brak zależności od systemowego Chrome, co utrzymuje obrazy Docker smukłe.
• RenderUrlAsPdf oczekuje na zakończenie DOM i JavaScript zanim wykona zdjęcie, więc aplikacje jednostronicowe są renderowane prawidłowo.
• Ustawienie CssMediaType na Print mówi silnikowi, aby używał drukowych reguł specyficznych, dopasowując wyjście przeglądarki Print → Save as PDF.
• Uzyskany PdfDocument może być zaszyfrowany, podpisany cyfrowo, złączony lub zrastratoryzowany - możliwości omawiane w późniejszych sekcjach.

Powiązane zasoby

-Dokumentacja API– ChromePdfRenderer.RenderUrlAsPdf -Dokumentacja API– PdfDocument.SaveAs

• Poradnik – Wdrażaj IronPDF w kontenerach Docker

Przykład — generowanie PDF z fragmentu HTML

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-5.cs

@model IronPdfMVCHelloWorld.Models.ClientModel
@{
  ViewBag.Title = "Book Ticket";
}
<h2>Index</h2>
@using (Html.BeginForm())
{
  <div class="form-horizontal">
    @Html.ValidationSummary(true, "", new { @class = "text-danger" })
    <div class="form-group">
      @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Phone, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Phone, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Phone, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Email, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Email, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Email, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
          <i class="fa fa-plus"></i>
          <span>
            Save
          </span>
        </button>
      </div>
    </div>
  </div>
}

model ReadOnly Property () As IronPdfMVCHelloWorld.Models.ClientModel
  ViewBag.Title = "Book Ticket"
End Property
'INSTANT VB TODO TASK: The following line could not be converted:
(Of h2) Index</h2> [using](Html.BeginForm())
If True Then
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'  <div class="form-horizontal"> @Html.ValidationSummary(True, "", New { @class = "text-danger" }) <div class="form-group"> @Html.LabelFor(model => model.Name, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Name, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Phone, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Phone, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Phone, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Email, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Email, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Email, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> <div class="col-md-10 pull-right"> <button type="submit" value="Save" class="btn btn-sm"> <i class="fa fa-plus"></i> <span> Save </span> </button> </div> </div> </div> }

Co demonstracje kod

• Wbudowane Chromium — IronPDF zawiera silnik Chromium, gwarantując równorzędność HTML5, CSS3 i JavaScript z nowoczesnymi przeglądarkami.
• Pojedyncza zależność — lekka instalacja NuGet obejmuje Windows, Linux, Docker i Azure/AWS bez dodatkowych bibliotek systemowych.
• Opcje renderowania — PaperSize, CssMediaType i RenderDelay odzwierciedlają ustawienia drukowania przeglądarek, dzięki czemu PDF-y dopasowują się do układów ekranowych.
• Odporność na przyszłość — powierzchnia API jest taka sama w .NET 8, .NET 9 STS i nadchodzącym .NET 10, dzięki czemu utrzymanie długoterminowe jest minimalne.
• Hooks postprocessingowe — PdfDocument udostępnia pomocne metody do łączenia, ochrony hasłem i podpisy cyfrowe — każde omawiane później w tym przewodniku.

Dalsze czytanie: zobacz krok po kroku Tutorial HTML-string-to-PDF i pełną dokumentację ChromePdfRenderer API.

Przykład kontrolera end-to-end

// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}

// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports YourApp.Models ' TicketViewModel

Public Class TicketsController
    Inherits Controller

    Private ReadOnly _renderer As ChromePdfRenderer

    Public Sub New()
        _renderer = New ChromePdfRenderer With {
            .RenderingOptions = New PdfRenderingOptions With {
                .PaperSize = PdfPaperSize.A5, ' Compact ticket size
                .PaperOrientation = PdfPdfOrientation.Portrait,
                .FitToPaperWidth = True,
                .CssMediaType = PdfCssMediaType.Print,
                .Margins = New PdfMargins(5, 10, 5, 10) ' mm
            }
        }
    End Sub

    ' GET /Tickets/Print/42
    Public Async Function Print(id As Integer) As Task(Of IActionResult)
        Dim vm As TicketViewModel = Await _service.GetTicketAsync(id)

        ' 1. Render the Razor view to an HTML string
        Dim html As String = Await RazorTemplateEngine.RenderViewAsync(
            HttpContext, "~/Views/Tickets/Print.cshtml", vm)

        ' 2. Convert HTML → PDF
        Using pdf As PdfDocument = _renderer.RenderHtmlAsPdf(html)
            ' 3. Stream back as a file
            Return File(pdf.BinaryData, "application/pdf", $"ticket-{id}.pdf")
        End Using
    End Function
End Class

$vbLabelText   $csharpLabel

Co ilustruje ten kod

• Bez plików tymczasowych — widok Razor jest renderowany w pamięci, a następnie przekazywany bezpośrednio do RenderHtmlAsPdf, unikając operacji I/O dysku i wyścigowych warunków folderów tymczasowych .
• Wynik z rozmiarem biletowym — PaperSize = A5 i wąskie marginesy utrzymują bilety do wydruku w domu kompaktowe.
• Spójne style drukowania — CssMediaType = Print stosuje te same zasady CSS @media print, z których korzystają przeglądarki.
• Binarny streaming — pdf.BinaryData strumieniuje dokument bez dotykania systemu plików; idealne dla punktów końcowych API i funkcji Lambda.
• Renderowanie wielokrotnego użytku — ChromePdfRenderer jest instancjonowane raz na kontroler, a następnie wielokrotnie używane, minimalizując koszty uruchamiania procesów.

Paper & Orientation

PaperSize, PaperOrientation, FitToPaperWidth

Margins & Headers / Footers

Margins, Header, Footer, Watermark

Kolejny krok: dodaj szyfrowanie, podpisy cyfrowe, lub złącz wiele biletów w jeden plik. Zobacz przykład łączenia i przewodnik podpisu cyfrowego.

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Próbka kodu — zastosowanie wielu opcji naraz

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-7.cs

[HttpPost]
public ActionResult Index(ClientModel model)
{
    if (ModelState.IsValid)
    {
        ClientServices.AddClient(model);
        return RedirectToAction("TicketView");
    }
  return View(model);
}

<HttpPost>
Public Function Index(ByVal model As ClientModel) As ActionResult
	If ModelState.IsValid Then
		ClientServices.AddClient(model)
		Return RedirectToAction("TicketView")
	End If
  Return View(model)
End Function

Dlaczego te opcje mają znaczenie

• PaperSize, Margins i CssMediaType odwzorowują okno dialogowe drukowania przeglądarki, dzięki czemu układy na ekranie i PDF pozostają identyczne na platformach Windows, Linux i Docker.
• HTML headers and footers wspierają tokeny Razor, CSS i JavaScript — przydatne do dynamicznych numerów stron lub brandingu.
• HtmlStamp umożliwia jednym wierszem tworzenie spersonalizowanych znaków wodnych z pełną kontrolą nad HTML i CSS.
• Opcje zabezpieczeń umożliwiają szyfrowanie 128-bitowe, hasła właściciela/użytkownika i szczegółowe uprawnienia bez użycia narzędzi firm trzecich.
• Podpisy cyfrowe dodają kryptograficzne pieczęcie bezpośrednio w kodzie, zachowując legalną autentyczność i dowód naruszenia.
• Pomocnicy ekstrakcji, tacy jak ExtractAllText i ExtractAllImages, odwracają proces, gdy wymagana jest analiza.

Szybki przegląd — Popularne ustawienia

Następne zadania: złącz kilka PDFów, wyciągnij tekst i obrazy, i wdrażaj na Docker lub bezserwerowo. Przejdź do sekcji wdrożeniowej, aby zapewnić zgodność międzyplatformową.

Wieloetapowy Dockerfile (Ubuntu 22.04)

####### ---------- stage 1 ----------
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyPdfApp.csproj", "."]
RUN dotnet restore

COPY . .
RUN dotnet publish -c Release -o /app/publish

####### ---------- stage 2 ----------
FROM mcr.microsoft.com/dotnet/aspnet:8.0-jammy
######## Install two native libs required by Chromium
RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0 && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyPdfApp.dll"]

Skrypt walidacji end-to-end

docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com

docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com

• Akcja API wewnętrznie wywołuje ChromePdfRenderer.RenderUrlAsPdf, podobnie jak w Sekcji2.
• IronPDF uruchamia swój proces Chromium w trybie piaskownicy wewnątrz kontenera — nie jest wymagany serwer X, ponieważ renderuje w trybie headless.
• Zużycie pamięci pozostaje poniżej 200 MB nawet podczas dużych renderów.

Zasoby wewnętrzne

• Poradnik – Wdrażaj IronPDF w kontenerach Docker
• Jak-to – Uruchom IronPDF na Azure App Service Linux -Dokumentacja API– ChromePdfRenderer class

Przykład zjednoczony — otwórz → połącz → oznakuj znakiem wodnym → wyciągnij

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-10.cs

[HttpPost]
public ActionResult TicketView(TicketModel model)
{
    IronPdf.Installation.TempFolderPath = $@"{Directory.GetParent}/irontemp/";
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    var html = this.RenderViewAsync("_TicketPdf", model);
    var renderer = new IronPdf.ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html.Result, @"wwwroot/css");
    return File(pdf.Stream.ToArray(), "application/pdf");
}

<HttpPost>
Public Function TicketView(ByVal model As TicketModel) As ActionResult
	IronPdf.Installation.TempFolderPath = $"{AddressOf Directory.GetParent}/irontemp/"
	IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
	Dim html = Me.RenderViewAsync("_TicketPdf", model)
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(html.Result, "wwwroot/css")
	Return File(pdf.Stream.ToArray(), "application/pdf")
End Function

Dlaczego to ma znaczenie

• Otwórz i scal – PdfDocument.FromFile ładuje każdy zgodny ze standardami PDF, w tym pliki zaszyfrowane, a PdfDocument.Merge konkatenizuje dowolną liczbę dokumentów w jednym wywołaniu.
• Znak wodny – ApplyStamp (znany również jako HtmlStamp) osadza w pełni stylizowane nakładki HTML/CSS — logo, kod QR lub tekst ukośny — na wybranych stronach bez rastryzacji.
• Ekstrakcja treści – ExtractAllText i ExtractAllImages wyciągają surowy tekst UTF-8 lub strumienie obrazów binarnych do dalszego archiwizowania lub pracy w ramach sztucznej inteligencji.
• Gotowe do podpisów cyfrowych – ta sama instancja PdfDocument może zostać zapieczętowana za pomocą SignAndStamp, tworząc hashe zgodne z RFC 3161, zgodne z wymaganiami dotyczącymi podpisów cyfrowych ISO 32000-2.
• Zgodność ze standardami otwartymi — IronPDF zachowuje oryginalną strukturę PDF (czcionki, warstwy, metadane XMP), dzięki czemu wyjście pozostaje kompatybilne z Adobe® Reader i innymi ISO 32000-1 przeglądarkami.
• Przyszłościowe — API unika asemblerów interop i wywołań Win32 GDI, więc kod działa bez zmian na Windows, Linux, Docker i nadchodzących SKU .NET 10 bezserwerowy.

Potrzebujesz podzielić, obrócić lub usunąć strony? Zobacz tutorial edycji na poziomie strony dla operacji zróżnicowanych.

Przykład — zastosuj AES 256-bitów, zablokuj prawa do wydruku i dodaj widoczny podpis

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-11.cs

using System.IO;
using System.Threading.Tasks;

public static class ControllerExtensions
{
    public static async Task<string> RenderViewAsync<TModel>(this Controller controller, string viewName, TModel model, bool partial = false)
    {
        if (string.IsNullOrEmpty(viewName))
        {
            viewName = controller.ControllerContext.ActionDescriptor.ActionName;
        }
        controller.ViewData.Model = model;
        using (var writer = new StringWriter())
        {
            IViewEngine viewEngine = controller.HttpContext.RequestServices.GetService(typeof(ICompositeViewEngine)) as ICompositeViewEngine;
            ViewEngineResult viewResult = viewEngine.FindView(controller.ControllerContext, viewName, !partial);
            if (viewResult.Success == false)
            {
                return $"A view with the name {viewName} could not be found";
            }
            ViewContext viewContext = new ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, new HtmlHelperOptions());
            await viewResult.View.RenderAsync(viewContext);
            return writer.GetStringBuilder().ToString();
        }
    }
}

Imports System.IO
Imports System.Threading.Tasks

Public Module ControllerExtensions
	<System.Runtime.CompilerServices.Extension> _
	Public Async Function RenderViewAsync(Of TModel)(ByVal controller As Controller, ByVal viewName As String, ByVal model As TModel, Optional ByVal As Boolean = False) As Task(Of String)
		If String.IsNullOrEmpty(viewName) Then
			viewName = controller.ControllerContext.ActionDescriptor.ActionName
		End If
		controller.ViewData.Model = model
		Using writer = New StringWriter()
			Dim viewEngine As IViewEngine = TryCast(controller.HttpContext.RequestServices.GetService(GetType(ICompositeViewEngine)), ICompositeViewEngine)
			Dim viewResult As ViewEngineResult = viewEngine.FindView(controller.ControllerContext, viewName, Not partial)
			If viewResult.Success = False Then
				Return $"A view with the name {viewName} could not be found"
			End If
			Dim viewContext As New ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, New HtmlHelperOptions())
			Await viewResult.View.RenderAsync(viewContext)
			Return writer.GetStringBuilder().ToString()
		End Using
	End Function
End Module

Kulisy działania

• Szyfrowanie AES-256 — IronPDF pakuje ładunek przy użyciu kluczy AES zatwierdzonych przez NIST, blokując nieautoryzowane otwieranie, drukowanie lub kopiowanie.
• Granulacja uprawnień — właściwości takie jak AllowUserPrinting i AllowUserFormData przełączają prawa do działania; wymagane jest hasło właściciela, aby jakiekolwiek ograniczenie mogło mieć skutek.
• Podpisy cyfrowe — SignAndStamp osadza znacznik czasu RFC 3161 i łańcuch certyfikatów, tworząc hashe widoczne dla manipulacji, rozpoznawane przez Adobe® Acrobat i inne przeglądarki ISO 32000-2.
• Jednostopniowe API — zarówno szyfrowanie, jak i podpisywanie modyfikują tę samą instancję PdfDocument, unikając wielokrotnych operacji na plikach i zachowując wewnętrzne czcionki, warstwy i metadane.

Podstawowe ustawienia zabezpieczeń

Zasoby wewnętrzne dla głębszych analiz

• Samouczek – Chron PDF hasłem
• Przykład – Podpisz cyfrowo PDF
• API reference – PdfSecuritySettings

1. Grupowe renderowanie na tle wątków

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-12.cs

IronPdf.License.LicenseKey = "YourLicenseKey";
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set rendering options
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;

renderer.RenderHtmlFileAsPdf(@"testFile.html").SaveAs("GeneratedFile.pdf");

Imports IronPdf

License.LicenseKey = "YourLicenseKey"
Dim renderer As New ChromePdfRenderer()

' Set rendering options
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = Rendering.PdfPaperOrientation.Portrait

renderer.RenderHtmlFileAsPdf("testFile.html").SaveAs("GeneratedFile.pdf")

• ChromePdfRenderer jest bezpieczny dla wątków; jedna instancja może obsługiwać dziesiątki ulewających zadań bez zakleszczeń.
• Parallel.ForEach nasyca każdy rdzeń procesora; typowe serwery osiągają wzrost przepustowości o 4-6× w porównaniu z jednowątkowymi pętlami.
• Jeśli żądania ASP.NET się kolejkowały, przenieś cięższe rysunki do usługi tła hostowanej lub kolejki komunikatów, aby utrzymać niskie czasy odpowiedzi.

2. Ograniczenie kosztu uruchomienia Headless Chrome

IronPDF dostarcza własną wersję Chromium, ale każdy render niesie ze sobą niewielki podatek startowy. Pooling pomaga, a Linux containers muszą zawierać dwa natywne biblioteki:

RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0

Brak którejkolwiek z bibliotek manifestuje się jako błąd libnss3.so not found w logach Dockera.

Zalecane flagi Chrome (automatycznie stosowane przez IronPDF) obejmują --disable-gpu oraz --no-sandbox, aby zmniejszyć problemy z pamięcią i użytkownikami-root w kontenerach.

3. Poczekaj na późny JavaScript używając RenderDelay lub WaitFor

Strony, które animują liczniki lub pobierają dane po DOMContentLoaded, mogą wymagać krótkiego opóźnienia:

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

renderer.RenderingOptions.RenderDelay = 200 ' ms
' OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

Zobacz dedykowany przewodnik WaitFor dla niestandardowych obietnic i odpytywania DOM.

4. Włącz logowanie debugowania dla jednego usługi

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-15.cs

IronPdf.License.LicenseKey = "YourLicenseKey";
PdfDocument pdf = PdfDocument.FromFile("1.pdf");
PdfDocument pdf2 = PdfDocument.FromFile("2.pdf");
pdf.AppendPdf(pdf2);
pdf.SaveAs("appendedFile.pdf");

IronPdf.License.LicenseKey = "YourLicenseKey"
Dim pdf As PdfDocument = PdfDocument.FromFile("1.pdf")
Dim pdf2 As PdfDocument = PdfDocument.FromFile("2.pdf")
pdf.AppendPdf(pdf2)
pdf.SaveAs("appendedFile.pdf")

Ślady Live DevTools ujawniają brakujące czcionki, obrazy 404 i zdarzenia czasowe bez ponownej kompilacji kodu.

5. Ponownie używaj szablonów PDF zamiast ponownego renderowania

Do realizacji faktur, utwórz szablon PDF z zastępczymi miejscami, takimi jak [[name]] i wykonaj zamianę tekstu zamiast odbudowywać złożone HTML. Jest to 10x szybsze i lekkie dla pamięci.

Lista kontrolna szybkiego tuningu

Dalsza lektura

• Jak-to – Generuj PDFy z async / wielowątkowoscia
• Rozwiazywanie problemów – Centrum pomocy technicznej w zakresie wydajności
• Przykład – Demonstracja renderowania wątkowego

Szybkie linki

Następne kroki

1. Sklonuj repozytorium przykładówe, które demonstruje wszystkie glówne funkcje—from MVC view rendering to AES-256 encryption.
2. Podlacz klucz próbny do istniejącego rozwiązania i uruchom testy jednostkowe, aby zweryfikowac zgodność miedzyplatformowa.
3. Zarezerwuj demonstracje na zywo z zespołem inżynieryjnym w celu uzyskania rekomendacji specyficznych dla projektu.

Dzięki tym zasobom kazdy zespół .NET może dostarczyć do produkcji idealnie zgodne z pikselami PDF-y—lokalnie, w Dockerze lub serverless—w ciągu jednego sprintu.