IronPDF ile C# kullanarak .NET Core'da HTML'yi PDF'ye dönüştürün

Bu Öğretici Ne İçerir?

• URL, HTML stringi ve Razor görünümü dönüştürme
• Kağıt, kenar boşluğu ve medya türü yapılandırması
• Platformlar arası dağıtım (Windows, Linux, Docker)
• Son işlemler: PDF'leri birleştirme, filigran ekleme, parola koruma ve dijital olarak imzalama
• Uçtan uca örnek: bilet-rezervasyon MVC uygulaması

Nasıl çalışıyor

• ChromePdfRenderer arka planda izole bir Chromium örneği oluşturur—ayrı bir Chrome yüklemesi gerektirmez.
• RenderUrlAsPdf, tam olarak işlenmiş DOM'u, JavaScript ile çalışan içerik, CSS medya sorguları ve yazı tipleri dahil olmak üzere yakalar.
• Ortaya çıkan PdfDocument, birleştirme, parola koruma veya dijital imzalama için yardımcı yöntemleri sunar—bu eğitimde ilerleyen bölümlerde ele alınmıştır.

Dağıtım ayrıntıları (Azure App Service, AWS Lambda, yerel Linux) hakkında daha fazla ayrıntı için özel kurulum kılavuzuna ve gelişmiş NuGet kurulumu sayfalarına bakın. Docker ve K8s küme içi CI/CD ipuçları, Docker dağıtım en iyi uygulamaları başlığı altında ele alınmıştır.

Adım adım örnek

: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

Neden çalışıyor?

• ChromePdfRenderer, bir izole Chromium örneği oluşturur—sistem Chrome bağımlılığı olmadan, Docker imajlarını zayıf tutar.
• RenderUrlAsPdf, anlık görüntü almadan önce DOM ve JavaScript'in tamamlanmasını bekler, böylece tek sayfalık uygulamalar doğru bir şekilde görüntülenir.
• CssMediaType'u Yazdır olarak ayarlamak, motoru yazdırmaya özgü kuralları kullanmak üzere yönlendirir, tarayıcının Yazdır → PDF Olarak Kaydet çıkışına uygun hale getirir.
• Ortaya çıkan PdfDocument şifrelenebilir, dijital olarak imzalanabilir, birleştirilebilir veya rasterize edilebilir—sonraki bölümlerde ele alınan yeteneklerdir.

İlgili kaynaklar

• API referansı – ChromePdfRenderer.RenderUrlAsPdf
• API referansı – PdfDocument.SaveAs
• Eğitim – IronPDF'i Docker konteynerlerine dağıtın

Örnek — bir HTML parçasından PDF oluşturun

: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> }

Kodun gösterdiği şey

• Gömülü Chromium — IronPDF, Chromium motorunu paketler, bu da modern tarayıcılarla HTML5, CSS3 ve JavaScript uyumluluğunu garanti eder.
• Tek bağımlılık — Windows, Linux, Docker ve Azure/AWS için hafif bir NuGet kurulumu ekstra sistem kütüphaneleri olmadan kapsar.
• Görüntüleme seçenekleri — PaperSize, CssMediaType ve RenderDelay tarayıcı yazdırma ayarlarını yansıtıyor, böylece PDF'ler ekran görüntüleriyle eşleşiyor.
• Geleceğe yönelik hedefleme — API yüzeyi .NET 8, .NET 9 STS ve yaklaşan .NET 10 arasında aynıdır, bu nedenle uzun vadeli bakım minimaldir.
• Son işleme kancaları — PdfDocument birleştirme, parola koruma ve dijital imzalar için yardımcıları ortaya çıkarıyor—her biri bu kılavuzda daha sonra ele alınacaktır.

Daha fazla okuma: adım adım HTML-şirket-dizisine-PDF eğitimi ve tam ChromePdfRenderer API belgesi bakın.

Baştan sona kontrolör örneği

// 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

Bu kodun gösterdikleri

• Geçici dosya yok — Razor görünümü bellekte işlenir, ardından doğrudan RenderHtmlAsPdf iletilir, disk G/Ç'si ve geçici klasör yarış koşulları önlenir.
• Bilet boyutunda çıktı — PaperSize = A5 ve dar kenar boşlukları, evde yazdırılan biletleri kompakt tutar.
• Tutarlı yazdırma stilleri — CssMediaType = Print tarayıcıların kullandığı aynı @media print CSS kurallarını uygular.
• İkili akış — pdf.BinaryData belgenin dosya sistemine dokunmadan akışını sağlar; API uç noktaları ve Lambda fonksiyonları için idealdir.
• Yeniden kullanılabilir görüntüleyici — ChromePdfRenderer her kontrolör başına bir kez oluşturulur ve sonra yeniden kullanılır, böylece işlem başlatma yükünü en aza indirir.

Paper & Orientation

PaperSize, PaperOrientation, FitToPaperMode

Margins & Headers / Footers

Margins, Header, Footer, Watermark

Sonraki adım: şifreleme, dijital imzalar ekleyin veya birden fazla bileti tek bir dosyada birleştirin. Birleştirme örneğine ve dijital imza nasıl yapılır rehberine bakın.

---

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Kod örneği - birden fazla seçeneği aynı anda uygulayın

: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

Bu seçeneklerin önemi nedir?

• PaperSize, Margins ve CssMediaType bir tarayıcının yazdırma diyalogunu yansıtır; böylelikle ekran düzenleri ve PDF, Windows, Linux ve Docker'da aynı kalır.
• HTML başlıkları ve alt bilgileri Razor tokenleri, CSS ve JavaScript'i destekler—dinamik sayfa numaraları veya markalama için kullanışlıdır.
• HtmlStamp tam HTML + CSS kontrolü ile markalı filigranları tek bir satırda oluşturmanıza olanak tanır.
• Güvenlik seçenekleri, 128-bit şifreleme, sahip / kullanıcı parolaları ve üçüncü parti araçlar olmadan ayrıntılı izinler sağlar.
• Dijital imzalar, kod içinde doğrudan kriptografik bir mühür ekleyerek yasal özgünlük sağlar ve manipülasyon kanıtı yaratır.
• ExtractAllText ve ExtractAllImages gibi çıkarım yardımcıları, analiz gerektiğinde süreci tersine çevirir.

Hızlı referans — Popüler ayarlar

Sonraki görevler: birden fazla PDF'yi birleştirin, metin & resimleri çıkarın ve Docker'a veya sunucusuz bir platforma dağıtın. Çapraz platform uyumluluğunu sağlamak için dağıtım bölümüne devam edin.

Çok aşamalı 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"]

Baştan sona doğrulama betiği

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

• API eylemi, tıpkı Bölüm2'de olduğu gibi içsel olarak ChromePdfRenderer.RenderUrlAsPdf çağrısı yapar.
• IronPDF, konteyner içinde kendi sanal Chromium sürecini başlatır—çünkü başsız çalıştığı için X sunucusu gerekmez.
• Büyük işlemler sırasında bile bellek kullanımı 200 MB'nin altında kalır.

Dahili kaynaklar

• Eğitim – IronPDF'i Docker konteynerlerine dağıtın
• Nasıl Yapılır – IronPDF'i Azure App Service Linux'ta Çalıştırma
• API referansı – ChromePdfRenderer class

Birlikte örnek — açık → birleştir → filigran → çıkar

: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

Neden önemlidir

• Açık & birleştir – PdfDocument.FromFile her türlü standart uyumlu PDF'i, şifrelenmiş dosyalar dahil yüklerken, PdfDocument.Merge tek bir çağrıda keyfi sayıda belge birleştirir.
• Filigran – ApplyStamp (alias HtmlStamp) tam stilize edilmiş HTML/CSS kaplamaları—logo, QR kodu veya çapraz metin—seçilen sayfalar üzerine yerleştirir, rasterleştirme olmadan.
• İçerik çıkarımı – ExtractAllText ve ExtractAllImages sonradan arşivleme veya AI boru hatları için ham UTF-8 metnini veya ikili resim akışlarını çeker.
• Dijital imzalar hazır – aynı PdfDocument örneği, SignAndStamp ile mühürlenebilir, RFC 3161 uyumlu karmalar üreterek ISO 32000-2 dijital-imza gereksinimleriyle uyumlu hale gelir.
• Açık standart uyumluluğu – IronPDF, orijinal PDF yapısını (yazı tipleri, katmanlar, XMP meta verileri) korur, böylece çıktı Adobe® Reader ve diğer ISO 32000-1 görüntüleyicileriyle uyumlu kalır.
• Geleceğe yönelik – API, interop montajlarını ve Win32 GDI çağrılarını kullanmaktan kaçınır, bu yüzden kod Windows, Linux, Docker ve yaklaşan .NET 10 sunucusuz SKU'lar üzerinde değişmeden çalışır.

Sayfaları ayırma, döndürme veya silme mi gerekiyor? Granül işlemler için sayfa düzeyinde düzenleme eğitimine bakın.

Örnek — 256-bit AES uygulayın, yazdırma haklarını kilitleyin ve görünür bir imza ekleyin

: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

Kulisin arkasında

• AES-256 şifreleme — IronPDF, yükü NIST onaylı AES anahtarları ile sararak yetkisiz açma, yazdırma veya kopyalama-yapıştırmayı engeller.
• Yetkiler ayrıntısı — AllowUserPrinting ve AllowUserFormData gibi özellikler eylem başına hakları değiştirir; herhangi bir kısıtlamanın etkili olması için sahibi parolası gereklidir.
• Dijital imzalar — SignAndStamp, bir RFC 3161 zaman damgası ve sertifika zinciri yerleştirir, böylece oynama belirtileri eğitim sertifikalı karmalar üretir ve Adobe® Acrobat ve diğer ISO 32000-2 görüntüleyiciler tarafından tanınır.
• Tek noktadan API — hem şifreleme hem de imzalama aynı PdfDocument örneğini değiştirerek birden fazla dosya geçişini önleyin ve dahili yazı tipleri, katmanları ve meta verileri koruyun.

Çekirdek güvenlik ayarları

Daha derine dalmak için iç kaynaklar

• Öğretici – PDF'yi Şifreyle Korumak
• Örnek – Bir PDF'yi dijital olarak imzala
• API reference – PdfSecuritySettings

1. Arka plan iş parçacığı havuzunda toplu işlemleri uygulayın

: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 is thread-safe; tek bir örnek, kilitlenme olmadan onlarca aynı anda yapılan göreve hizmet edebilir.
• Parallel.ForEach her CPU çekirdeğini doldurur; tipik sunucular, tek iş parçacıklı bir döngüye kıyasla 4–6× veri aktarım hızı artışı görür.
• Eğer ASP.NET istekleri kuyruğa girerse, ağır işlemleri host edilmiş bir arka plan servisine veya mesaj kuyruğuna taşıyın yanıt sürelerini düşük tutmak için.

2. Headless Chrome başlangıç maliyetini azaltın

IronPDF, kendi Chromium yapısıyla birlikte gelir, ancak her işleme küçük bir başlangıç ücreti eklenir. Havuzlanma yardımcı olur ve Linux konteynerleri iki yerel kütüphane içermelidir:

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

Herhangi bir kitaplığın eksik olması, Docker günlüklerinde bir libnss3.so not found hatası olarak ortaya çıkar.

Önerilen Chrome bayrakları (IronPDF tarafından otomatik olarak uygulanır), kapsayıcılarda bellek ve kök kullanıcı sorunlarını azaltmak için --disable-gpu ve --no-sandbox içerir.

3. Geç JavaScript'i RenderDelay veya WaitFor ile beklet

DOMContentLoaded ardından sayaçları hareketlendiren veya veri getiren sayfalar kısa bir gecikmeye ihtiyaç duyabilir:

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

Özel sözler ve DOM anketleme için özel WaitFor eğitimi'ne bakın.

4. Tek bir istek için hata ayıklama kaydını etkinleştirin

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

Canlı DevTools izlemeleri, eksik yazı tiplerini, 404 resimlerini ve zamanlama olaylarını kodu yeniden derlemeden ortaya koyar.

5. Yeniden işlemek yerine şablon PDF'leri tekrar kullanın

Fatura işlemleri için, [[name]] gibi yer tutucularla bir şablon PDF oluşturun ve karmaşık HTML oluşturmak yerine bir metin değiştirme gerçekleştirin. 10 kat daha hızlı ve hafızayı daha az tüketir.

• Nasıl Yapılır – Async / çoklu iş parçacığı ile PDF'ler oluşturma
• Sorun Giderme – Performans Yardım Merkezi
• Örnek – Thread'li render örneği

Hızlı bağlantılar

Sonraki adımlar

1. Örnek depoyu klonla - MVC görünüm işleme'den AES-256 şifrelemeye kadar her ana özelliği demonstre eder.
2. Deneme anahtarını yerleştirin mevcut bir çözüme ve platformlar arası uyumluluğu doğrulamak için birim testlerini çalıştırın.
3. Proje özel öneriler için mühendislik ekibiyle canlı demo ayırtın.

Bu kaynaklarla, herhangi bir .NET ekibi tek bir sprint içinde üretime piksel mükemmel PDF'ler gönderebilir - yerinde, Docker'da veya sunucusuz.